Mihomo mixed-port 是什么?配置、连接与端口占用排查
简答:Mihomo mixed-port 是一个可同时接收 HTTP(S) 和 SOCKS5 请求的代理端口。把它写入当前生效配置后,应用使用同一地址和端口接入,再分别用 HTTP 与 SOCKS5 命令验证;若失败,按未监听、应用未接入、规则直连和远端连接逐层排查。
定义:Mihomo mixed-port 是 Mihomo 提供的混合代理入口,同一个监听端口可供支持 HTTP(S) 或 SOCKS5 的程序连接。
先看结论:mixed-port 应该填什么
本页是第三方使用指南,Mihomo 的具体字段和界面可能随客户端或内核版本变化,实际配置以当前版本文档为准。官方配置文档将 mixed-port 定义为同时支持 HTTP(S) 与 SOCKS5 的特殊端口;示例中的端口数字只是示例,不是固定要求。查看 Mihomo 官方代理端口文档。
| 项目 | 作用 | 应用里怎么填 | 是否等同于 mixed-port |
|---|---|---|---|
mixed-port | 同一入口接受 HTTP(S) 与 SOCKS5 | 地址通常为 127.0.0.1,端口填配置中的实际数字 | 是本文重点 |
port | HTTP(S) 代理入口 | 协议选择 HTTP 或 HTTPS,按应用支持情况填写 | 不是 |
socks-port | SOCKS4、SOCKS4a 或 SOCKS5 入口 | 协议选择 SOCKS5 等应用支持的类型 | 不是 |
redir-port | 透明代理入口,适用范围受系统和配置限制 | 普通浏览器通常不能直接填写 | 不是 |
tproxy-port | 透明代理入口,可处理 TCP 与 UDP 的特定系统场景 | 通常由透明代理配置调用 | 不是 |
external-controller | 控制 API 或面板连接入口 | 不要把它当作浏览器代理端口 | 不是 |
最短做法:先找到当前生效配置中的 mixed-port 数字,例如 你的混合端口;应用代理地址填本机地址,端口填这个数字。若应用只支持一种代理协议,仍可尝试连接混合端口,但要在应用中选择它实际支持的 HTTP 或 SOCKS5 类型。
配置 mixed-port:改哪里、怎么避免改错
- 先确认当前配置。不要只改下载目录里的旧文件、订阅原文件或未启用的配置。应在 Mihomo 客户端中确认当前激活的配置文件,再进行备份。
- 备份后编辑顶层字段。
mixed-port与allow-lan、authentication等属于顶层配置,不要把它缩进到tun:或dns:下。YAML 对缩进敏感,只使用空格,不要使用 Tab;可参考 Mihomo 官方 YAML 语法说明。 - 写入一个未被其他程序占用的端口。示例中的数字仅用于说明格式,实际端口请以客户端当前配置和系统监听结果为准。
- 保存并重新加载。仅保存文件不一定代表内核已经使用新配置;需要在客户端执行重新加载、重启内核或切换到该配置,具体入口以当前客户端界面为准。
- 再验证当前运行配置。如果启用了
external-controller,官方 API 的/configs接口可返回当前运行配置,其中包含mixed-port等字段;接口可能需要配置中的密钥。查看 Mihomo 官方 API 文档。
mixed-port: 你的混合端口
allow-lan: false
# authentication:
# - "用户名:密码"这段配置应合并到配置文件的顶层,而不是放入 tun: 或 dns:。修改前先备份;确认本机和应用都能正常连接后,再考虑恢复原值或继续调整。若只是本机使用,通常不要为了测试随意开启局域网访问;官方文档说明 allow-lan 用于允许其他设备通过代理端口访问,并可配合绑定地址、允许网段和认证设置。查看 Mihomo 官方全局配置文档。
浏览器、系统代理和命令行怎么接入
mixed-port 只是“监听入口”,不等于所有应用已经自动使用代理。浏览器可以填写 HTTP 或 SOCKS5 代理;系统代理需要在操作系统网络设置中打开;TUN 则是另一种接管系统流量的方式,不能把 TUN 开关、代理端口和控制 API 混为一谈。
| 使用场景 | 地址 | 端口 | 协议选择 |
|---|---|---|---|
| 本机浏览器 HTTP 代理 | 127.0.0.1 | 你的混合端口 | HTTP;若应用将 HTTPS 作为代理类型单独列出,按应用提示选择 |
| 本机浏览器 SOCKS5 | 127.0.0.1 | 你的混合端口 | SOCKS5 |
| 同一局域网其他设备 | Mihomo 所在设备的局域网地址 | 你的混合端口 | HTTP 或 SOCKS5 |
| 控制面板或 API | external-controller 配置的地址 | 控制端口 | API,不是 HTTP/SOCKS 代理 |
如果要让局域网设备连接,需要同时检查 allow-lan、bind-address、防火墙和认证;官方文档明确提示,把无 TLS 的 HTTP、SOCKS 或 Mixed 入口直接暴露到互联网存在风险。局域网测试应限定在可信网络,并优先使用认证和明确的允许地址范围。
分别验证 HTTP 与 SOCKS5 是否真的接入
下面的命令只验证“应用能否连到本地 mixed-port 并发起请求”,不能单独证明节点质量、规则一定走代理或所有 UDP 流量都已接管。请把 你的混合端口 替换为实际数字,把测试网址替换为你能正常访问的 HTTPS 地址。
Windows
curl.exe -I --proxy http://127.0.0.1:你的混合端口 https://example.com/
curl.exe -I --proxy socks5h://127.0.0.1:你的混合端口 https://example.com/正常结果通常是返回 HTTP 响应头,并出现 HTTP/ 开头的状态行,例如 200 或 3xx;状态码本身不代表代理线路一定优良。若命令提示无法连接本地端口,可先执行:
netstat -ano | findstr :你的混合端口正常结果应能看到对应端口处于监听状态,并能进一步用任务管理器或进程命令核对 PID。若没有输出,优先检查内核是否启动、配置是否已加载以及端口是否写错。
macOS
curl -I --proxy http://127.0.0.1:你的混合端口 https://example.com/
curl -I --proxy socks5h://127.0.0.1:你的混合端口 https://example.com/正常结果同样应返回 HTTP 响应头。若本地连接失败,可执行:
lsof -nP -iTCP:你的混合端口 -sTCP:LISTEN正常结果会列出监听该端口的进程;没有输出时,先检查 Mihomo 是否运行以及配置是否为当前激活文件。Windows 和 macOS 的命令不要混用;Android 厂商路径不同,可在系统设置中搜索“代理”或“VPN”,但普通应用是否支持 HTTP/SOCKS5 仍以应用本身为准。
连接失败时按四层定位,不要先改 DNS
| 现象 | 日志或命令关键词 | 优先处理动作 |
|---|---|---|
| 本地端口连接失败 | connection refused、无法连接 127.0.0.1 | 确认内核运行、当前配置已加载、端口正在监听;检查端口冲突 |
| 端口能连,但应用没有请求记录 | 命令成功但客户端连接页无记录,或应用仍直连 | 检查应用代理开关、协议类型、地址和端口;关闭可能覆盖设置的浏览器扩展或系统代理工具 |
| 有连接记录但网页仍打不开 | 出现请求、规则命中或出站错误 | 区分命中规则与使用策略:规则类型可能是 Domain、GEOIP 或 MATCH,策略组或节点是实际出站选择,二者不是同一概念;再检查策略组和节点状态 |
| 改了端口仍提示旧端口占用 | address already in use 或仍显示旧端口 | 确认修改的是当前生效配置,停止残留内核,检查系统监听进程,再重新加载配置 |
| 局域网设备无法接入 | 本机可用,其他设备超时 | 检查 allow-lan、绑定地址、局域网 IP、防火墙和认证;不要直接暴露到公网 |
排查顺序建议固定为:监听 → 应用接入 → 规则与策略 → 节点或远端连接。只有在确认请求已经进入 Mihomo 后,才有必要继续分析 DNS、延迟、丢包或节点问题。日志中的命中规则和出站策略应分开阅读:例如 DomainSuffix 是规则匹配类型,Proxy 可能只是策略组名称,不能把策略组名称当成规则类型。
mixed-port、系统代理、TUN 和控制接口的区别
- mixed-port:给支持 HTTP(S) 或 SOCKS5 的应用提供代理入口。
- 系统代理:操作系统把部分应用的 HTTP 代理设置指向 Mihomo;是否生效取决于应用是否遵循系统代理。
- TUN:通过虚拟网卡和路由等方式接管系统流量,属于不同于手动填写代理的入口。官方文档将 TUN 作为独立的入站方式,并说明其配置包含自动路由、DNS 劫持等不同字段。查看 Mihomo 官方 TUN 文档
- external-controller:供面板或 API 管理内核,不是给浏览器填写的代理端口。控制接口需要单独注意监听地址、密钥和访问范围。
因此,开启 mixed-port 后网页仍打不开,并不必然说明 mixed-port 错误:可能是应用没有使用该端口、系统代理没有打开、规则选择了直连,或者远端节点本身连接失败。
常见修改错误与回滚方法
- 把字段放进 tun 或 dns:将
mixed-port移回 YAML 顶层,并检查缩进。 - 只改了订阅源:订阅更新可能重新生成配置;应确认客户端实际启用的配置来源,并在更新后再次检查运行配置。
- 端口被其他程序占用:先用系统监听命令找到进程,停止不需要的残留内核或改用未占用端口,再同步应用代理设置。
- 把控制端口当代理端口:浏览器应使用
mixed-port,不能填写external-controller的端口。 - 改完后断网:先关闭系统代理或 TUN,恢复到原配置备份;确认普通网络恢复后,再只改一个字段进行对照测试。
如果需要确认实际运行状态,可优先查看客户端连接记录和当前配置接口;官方 API 文档列出了版本、运行配置和日志等接口,但具体访问地址、密钥和客户端入口仍以你的配置为准。
常见问题
Mihomo mixed-port 默认一定是 7890 吗?
不应把 7890 当作固定要求。官方文档页面展示过 7892 等示例数字,实际端口取决于当前配置、客户端和是否存在端口冲突,请以运行配置和监听结果为准。
HTTP 和 SOCKS5 可以共用同一个 mixed-port 吗?
可以,mixed-port 的用途就是让支持 HTTP(S) 或 SOCKS5 的程序连接同一个代理入口。应用仍需选择它实际支持的协议类型,不能把 SOCKS5 地址写成 HTTP 代理格式。
mixed-port 和 external-controller 有什么区别?
mixed-port 接收应用的代理请求;external-controller 是控制 API 或面板管理入口。浏览器、下载器等应用应填写 mixed-port,不要填写控制端口。
mixed-port 能自动代理所有应用和 UDP 流量吗?
不能直接这样判断。mixed-port 主要是应用代理入口,是否接管某个应用取决于应用是否使用代理;系统范围流量通常还涉及系统代理或 TUN,UDP 行为则取决于应用、协议和当前配置。
为什么 mixed-port 能监听,但网页还是打不开?
监听只证明本地入口存在,不代表应用已接入、规则已选择预期策略或远端节点可用。先看应用代理地址和协议,再查看连接记录中的规则匹配、策略组和出站错误。
修改 mixed-port 后提示端口占用怎么办?
先停止可能残留的 Mihomo 进程,用 Windows 的 netstat 或 macOS 的 lsof 检查监听者;确认当前配置没有重复监听,再选择未占用端口,并同步修改浏览器、系统代理或命令行设置。