适用范围与准备

适用于Linux或macOS上本人管理的Mihomo已经配置external-controller-unix,控制端却仍尝试连接TCP端口。本文只查询现有本机接口,不新建公网控制入口,不修改其他用户的服务权限。

先区分原因

external-controller-unix提供Unix域套接字接口,与external-controller的TCP地址不同。官方特别说明经Unix socket访问API不会校验secret,因此访问控制要依靠本机文件和目录权限;把socket文件开放给所有用户并不是连接修复。

按顺序操作

  1. 先确认实际运行的Mihomo配置里确有external-controller-unix,并定位已经创建的socket文件。若采用相对路径,应结合服务的实际运行环境确认位置,不猜测固定目录。
  2. 核对调用程序与Mihomo所在用户、容器和文件系统范围。宿主机路径不自动等于容器内路径;看不到文件时先查挂载与真实路径,不复制一个普通空文件冒充socket。
  3. 使用支持Unix socket的curl发起一次只读查询。下方路径是占位;http://localhost/version表示通过该socket发出的HTTP资源路径,不表示另外监听了localhost的TCP端口。
  4. 若报告权限不足,检查socket及父目录的访问权限和服务所属用户,交对应管理员调整最小必要访问。不要chmod 777,不通过开放0.0.0.0控制端口绕过本地问题。
  5. 核对返回版本是否属于预期内核,再检查需要连接的控制程序是否支持Unix socket。浏览器直接输入路径或只支持TCP的面板不能因此自动使用该接口。
Linux / macOS shell;仅查询自己有权访问的现有socket,路径须替换;无需管理员权限
curl -q --unix-socket "/path/to/mihomo.sock" --connect-timeout 5 --max-time 10 --output version.json "http://localhost/version"
观察项含义与下一步
external-controllerTCP控制接口
external-controller-unixUnix socket控制接口
Unix接口的secret官方说明不验证,需依靠本机访问权限

怎样确认有效

只读/version返回预期内核的信息,且调用者的访问范围符合本机策略,才说明这条控制链路可用。socket文件存在本身不能证明进程仍在监听,也不证明节点已经联网。

无效时恢复与下一步

本次只读查询无需回滚;删除测试命令即可。若需改变服务接口配置,应先保留可恢复的管理通道,不能在仍依赖该连接时盲目重启;未授权用户不应获得socket访问权限。