TAG官网 - TAG VPN套餐价格 | Bronze、Silver、Gold计划 - TAG Pro网络加速返回首页

Mihomo系统代理怎么设置?Windows、macOS、Linux五步完成并验证

更新于 2026-11-14 · tagss11.buzz

简答:先启动 Mihomo 内核并确认本机代理端口,再把系统代理指向 127.0.0.1 和正确端口。多数桌面系统优先使用 mixed-port;Windows、macOS 可在系统设置中填写 HTTP/HTTPS 代理,Linux 桌面可使用系统代理或 http_proxy、https_proxy、ALL_PROXY 环境变量。系统代理和 TUN 不是同一种接管方式,不需要默认同时开启。

定义:Mihomo 系统代理是让浏览器和遵循操作系统代理设置的应用,通过 Mihomo 在本机监听的 HTTP、HTTPS 或 SOCKS 代理端口发送流量。

先看结论:五步设置路径与端口选择

本文是第三方使用指南,不是 Mihomo 官方页面。本文核对日期为 2026-11-14。不同图形客户端的按钮名称、默认端口和配置入口可能不同;没有看到配置原文时,应以当前客户端界面和实际配置为准。

先试这一步:打开 Mihomo 使用的配置文件,确认至少有一个代理端口,例如 mixed-port: 7890,然后确认该端口确实处于监听状态。Mihomo 官方文档说明,port 是 HTTP 代理端口,socks-port 是 SOCKS4/4a/5 端口,mixed-port 同时支持 HTTP(S) 和 SOCKS5。

系统代理端口怎么选
配置字段协议系统设置中怎么填适合场景
portHTTPHTTP 和 HTTPS 代理可填写同一个地址与端口,但要确认客户端支持这样使用只需要 HTTP 代理的应用
socks-portSOCKS4/4a/5只能填到 SOCKS 代理栏目,不能直接填进 Windows 的 HTTP 手动代理框支持 SOCKS 的应用或命令
mixed-portHTTP(S)+SOCKS5优先作为通用示例使用;实际端口以配置文件为准浏览器、终端和多种桌面应用

官方示例中常见的示例端口为 7890、7891 和 7892,但示例不等于你当前配置的默认值。应先查看配置文件,不能只凭记忆填写。参考 Mihomo Proxy Ports 文档。

第一步:启动内核并确认监听端口

如果你使用图形客户端,先导入或打开配置,选择配置并启动内核。按钮可能叫“启动”“运行”“Start”或“核心开关”,具体名称以当前客户端为准。若客户端有 System Proxy 开关,先不要急着打开,先确认内核已经运行。

如果你直接运行 Mihomo 内核,配置文件通常是 YAML 格式。最小检查重点是端口字段是否存在,例如:

mode: rule
mixed-port: 7890

保存后启动 Mihomo。启动失败时,先查看日志和终端输出。常见报错 address already in use 表示端口已被其他进程占用;常见报错 bind: permission denied 表示当前进程没有绑定该地址或端口所需的权限。

Windows PowerShell 可执行:

Get-NetTCPConnection -State Listen -LocalPort 7890 -ErrorAction SilentlyContinue

预期结果是出现本地监听记录;如果没有输出,说明 7890 没有监听,需回到配置文件核对端口。若端口不同,把命令中的 7890 替换成实际端口。

macOS 或 Linux 可执行:

ss -lntp | grep ':7890'
# macOS 没有 ss 时可用:
lsof -nP -iTCP:7890 -sTCP:LISTEN

预期结果是看到 Mihomo 进程或对应 PID。若提示 command not found,只表示当前系统没有该命令,不代表端口没有监听,应改用另一条检查命令。

如果端口被占用,不要直接结束不认识的进程。先记录 PID,再确认进程名称。Windows 可用:

Get-Process -Id <PID>

Linux 或 macOS 可用:

ps -p <PID> -o pid,comm,args

确认是旧的 Mihomo 进程后,再从图形客户端正常停止,或使用系统进程管理工具结束。撤销方式是重新启动原来的进程;如果不确定 PID,改用另一个未占用端口并同步修改系统代理设置。

第二步:按系统设置 127.0.0.1 和端口

Windows 10/11

打开“设置”→“网络和 Internet”→“代理”→“手动设置代理”。微软支持文档给出的路径是进入 Proxy 后,在 Manual proxy setup 中打开 Use a proxy server,再填写代理 IP 地址和端口。参考 Microsoft 使用 Windows 代理服务器。

  1. 打开“使用代理服务器”。
  2. 代理地址填写 127.0.0.1。
  3. 端口填写 Mihomo 实际监听的 mixed-port 或 port,例如 7890。
  4. 保存设置;本地地址通常不需要经过代理,可保留本地地址绕过选项。

不要把 socks-port 直接填入 Windows 的 HTTP 手动代理框,除非你确认该客户端或应用明确支持这种协议映射。若只使用 SOCKS 端口,应在支持 SOCKS 的应用中单独填写。

macOS

打开“系统设置”→“网络”→选择当前网络服务→“详细信息”→“代理”。Apple 文档列出的入口和选项包括 Web Proxy(HTTP)、Secure Web Proxy(HTTPS)和 SOCKS Proxy。参考 Apple 更改 Mac 代理设置。

  1. 使用 mixed-port 时,可在“Web Proxy(HTTP)”和“Secure Web Proxy(HTTPS)”中填写 127.0.0.1 与实际端口。
  2. 如果应用明确要求 SOCKS,则在“SOCKS Proxy”中填写 127.0.0.1 与 socks-port。
  3. 点击“好”或“应用”,然后重新打开需要使用代理的应用。

如果你只在 SOCKS 栏填写端口,使用系统 HTTP/HTTPS 代理的浏览器未必会跟随;如果只填写 HTTP/HTTPS 栏,要求 SOCKS 的应用也不会自动改用它。

Linux 桌面

以 GNOME 为例,打开“活动”概览,搜索 Network,进入 Network → Network Proxy。GNOME 文档提供 None、Manual 和 Automatic 三种代理方式;选择 Manual 后,分别填写 HTTP、HTTPS 或 SOCKS 地址和端口。参考 GNOME Define proxy settings。

终端程序不一定读取桌面代理设置,可在当前终端会话中临时设置:

export http_proxy=http://127.0.0.1:7890
export https_proxy=http://127.0.0.1:7890
export ALL_PROXY=http://127.0.0.1:7890

如果要使用 SOCKS5,可按程序支持情况改为:

export ALL_PROXY=socks5h://127.0.0.1:7891

curl 官方手册说明,http_proxy、HTTPS_PROXY 和 ALL_PROXY 可用于指定代理,socks5h:// 会让 SOCKS 代理处理域名解析。参考 Debian curl 手册。这些 export 只对当前终端会话有效;关闭终端后会失效。若写入 shell 配置文件,撤销时删除对应行并重新打开终端。

第三步:判断是否需要 TUN、规则模式和全局模式

系统代理只接管遵循系统代理设置的应用;TUN 则通过虚拟网络接口和路由接管更多系统流量。Mihomo 官方入站文档将代理端口和 TUN 作为不同的流量入口,TUN 适合自动路由、DNS 劫持和更广泛的系统流量接管。参考 Mihomo inbound configuration。

系统代理、TUN 与运行模式区别
方式主要作用是否默认同时开启常见限制
系统代理让遵循系统代理的浏览器和应用使用本地端口不需要游戏、部分 UWP、Docker、后台服务可能不遵循
TUN通过虚拟网卡和路由接管更多流量不需要可能需要权限、虚拟网卡或防火墙放行,配置错误可能导致断网
规则模式按规则把请求分为代理、直连或拒绝可与系统代理或 TUN 配合规则命中结果会影响最终是否走代理
全局模式把符合入口条件的流量统一交给代理组可与系统代理或 TUN 配合不能解决端口未监听、应用不遵循代理等问题

第一次设置建议只开启系统代理,确认浏览器和 curl 能正常访问后,再考虑 TUN。若使用 TUN,配置字段必须以当前 Mihomo 文档为准;官方文档列出了 tun.enable、stack、auto-route、auto-detect-interface 等字段。不同版本和客户端可能对权限、虚拟网卡以及 DNS 行为有差异,不能把图形客户端的 TUN 开关当成原生内核的统一要求。参考 Mihomo TUN 配置文档。

如果开启 TUN 后断网,先关闭 TUN,再关闭系统代理,恢复直连;不要在无法确认配置的情况下同时修改 DNS、MTU、IPv6 和路由字段。

第四步:用浏览器、curl、日志和出口 IP 验证

验证不能只看“开关是否变蓝”,至少按以下顺序测试:

  1. 检查端口:重新执行 Windows 的 Get-NetTCPConnection 或 macOS/Linux 的 ss、lsof 命令,确认端口仍处于 LISTEN 状态。
  2. 测试 HTTP 代理:在支持 curl 的终端执行 curl -v -x http://127.0.0.1:7890 https://example.com。预期结果是出现与代理建立连接的过程,并收到 HTTP 响应;若出现 Connection refused,通常表示地址或端口没有监听。
  3. 测试 SOCKS5:如果使用 SOCKS 端口,执行 curl -v --proxy socks5h://127.0.0.1:7891 https://example.com。若出现 Unsupported proxy syntax 或类似错误,检查协议前缀和 curl 版本。
  4. 看日志:访问一个明确需要代理的地址,观察 Mihomo 日志是否出现连接记录、规则结果和代理组名称。只看到“连接成功”不等于一定使用了目标节点,还要结合规则和代理组结果判断。
  5. 对比出口 IP:先关闭系统代理记录一次公网 IP,再开启代理后重新查询。只有在两次结果不同且日志有对应连接记录时,才能说明该请求的出口发生了变化;不能仅凭 IP 变化推断所有应用都已接管。

浏览器仍直连时,检查浏览器是否单独配置了代理、是否使用了扩展或自己的网络设置。终端测试成功但浏览器失败,通常应优先检查浏览器代理入口和绕过列表;浏览器成功但游戏或 Docker 失败,则更可能是应用不遵循系统代理,需要查看该应用是否支持 HTTP、SOCKS 或 TUN。

第五步:关闭代理、恢复网络和分层排错

关闭时按“应用代理→系统代理→TUN”的顺序回退:

  1. 在图形客户端中关闭 System Proxy 或系统代理开关。
  2. 在 Windows“设置”→“网络和 Internet”→“代理”中关闭手动代理;macOS 在“网络”→当前网络→“详细信息”→“代理”中取消 HTTP、HTTPS 或 SOCKS 选项;Linux GNOME 选择 None。
  3. 如果启用了 TUN,关闭 TUN 后再退出 Mihomo。
  4. 重新打开浏览器,测试普通网页;必要时新开终端,避免旧终端仍保留 http_proxy 等变量。

Windows 代理残留导致无法联网时,微软支持建议检查并关闭手动代理设置。参考 Microsoft Windows Wi-Fi 连接排查。

常见现象与处理顺序
现象先查什么撤销或恢复
Connection refused地址、端口、内核是否监听关闭系统代理,恢复直连;修正端口后重新开启
系统代理已开但网页打不开规则模式、代理组、日志和节点连接切换直连或关闭系统代理,确认基础网络正常
浏览器可以,终端不行终端是否读取环境变量执行 unset http_proxy https_proxy ALL_PROXY,或在 Windows 新开终端
系统代理关闭后仍无法联网TUN、路由、虚拟网卡和代理残留关闭 TUN,恢复系统代理为关闭,重启相关客户端;不要直接删除系统路由
端口冲突占用端口的 PID 和进程名称正常停止确认过的旧进程,或更换一个空闲端口

若修改配置文件,建议先复制一份原文件再保存。Linux 使用 cp config.yaml config.yaml.before-proxy,macOS 同样可用;Windows PowerShell 使用 Copy-Item .\config.yaml .\config.yaml.before-proxy。恢复时把备份文件复制回原路径,并重新启动 Mihomo。不要把示例路径直接执行,先替换成你的真实配置文件路径。

常见问题

Mihomo系统代理应该填 port 还是 mixed-port?

优先填写配置中实际存在且处于监听状态的 mixed-port;它同时支持 HTTP(S) 和 SOCKS5。若没有 mixed-port,再根据应用协议使用 port 或 socks-port。不要只根据网上示例端口填写。

Mihomo系统代理和 TUN 模式需要同时开启吗?

通常不需要。系统代理适合浏览器等遵循系统代理的应用;TUN 用于接管更多系统流量。建议先单独验证系统代理,再按需要测试 TUN,避免两种接管方式同时启用后难以定位问题。

为什么系统代理已开启,但游戏、Docker 或部分软件仍然直连?

这些应用可能不读取操作系统 HTTP/HTTPS 代理设置,或者只支持 SOCKS、专用代理配置或 TUN。先用 curl 和浏览器确认端口及规则正常,再查看目标应用是否提供代理设置;不要仅凭系统代理开关判断所有流量都已接管。

关闭 Mihomo 后 Windows 不能上网怎么办?

先进入“设置”→“网络和 Internet”→“代理”,关闭手动代理;如果启用了 TUN,也关闭 TUN。然后关闭残留终端中的代理环境变量并重新打开浏览器。若仍异常,再检查虚拟网卡和路由,不要直接删除不认识的系统路由。

Linux 设置了桌面代理,curl 为什么仍然直连?

桌面代理和终端环境变量不一定完全同步。先在当前终端设置 <code>http_proxy</code>、<code>https_proxy</code> 或 <code>ALL_PROXY</code>,再用 <code>curl -v -x http://127.0.0.1:端口 https://example.com/</code> 验证。测试完成后可用 <code>unset</code> 清除临时变量。

相关阅读

参考资料

  1. Proxy Port - mihomo docs
  2. inbound configuration - mihomo docs
  3. Meta-Docs/docs/config/inbound/tun.en.md
  4. Use a proxy server in Windows
  5. Change proxy settings on Mac
  6. Define proxy settings(help.gnome.org)
  7. curl(1) — curl — Debian testing — Debian Manpages(manpages.debian.org)
  8. Fix Wi-Fi connection issues in Windows