FIND THE NEXT CHECKmihomo.cyou / 独立中文指南
CHECK / 05故障排查 / NOTE 05

address already in use:本地代理端口被谁占了

常见原因是重复客户端或残留内核。先确认占用进程身份,再决定退出还是换端口。

Mihomo 排错手册 · · 约 3 分钟阅读

日志提示 address already in use,意味着当前尝试使用的地址与端口发生冲突。这时配置语法可能完全正确,继续调整规则或 DNS 不会让占用的端口自动空出来。

先找是否重复运行

检查托盘里是否同时开着两个代理客户端,或是否曾经手动启动过独立内核。优先用对应软件的正常退出方式停止重复实例,确认其代理设置已经恢复,再启动你准备使用的那一套。

不要只凭进程名称相似就结束陌生程序。先确认文件路径、启动来源和端口用途,避免停止正常的开发服务或办公应用。

端口冲突:报错端口 → 占用进程 → 恢复或改端口端口冲突 · 概念示意01报错端口02占用进程03恢复或改端口用于解释正文步骤,不是软件操作界面或实时检测结果端口冲突:报错端口 → 占用进程 → 恢复或改端口端口冲突 · 示意01报错端口02占用进程03恢复或改端口
确认进程身份,再退出;改端口时同步应用入口。

代理端口与管理端口分别看

内核可能同时监听多个入口。日志具体报错的是 mixed、HTTP、SOCKS,还是 external-controller,决定了哪项需要处理。改一个未冲突的端口,不会解决另一个监听失败。

如果确实需要两套工具并存,应为它们安排不同端口,并明确哪一套接管系统代理。更改后同步更新浏览器扩展、终端工具和局域网设备保存的代理地址。

改完用新连接确认

启动成功以后,观察一条实际请求是否进入预期客户端。有时旧进程仍在接收应用流量,新界面虽然启动,却没有任何连接记录。只看绿色状态无法证明请求用了新端口。

把当前端口与配置名记在一起。下次升级或迁移设备时,先核对这些本机设置,再搬规则和订阅。端口冲突是进程与监听关系问题,定位占用者通常比重新安装客户端直接得多。

继续核对资料

MetaCubeX / Mihomo 项目Mihomo 文档TUN 配置文档

按 2026-10-21 可读项目资料整理。界面与参数可能随版本变化,请对照实际运行版本。

接下来可以看。

返回全部文章 →