适用范围与准备
适用于Linux或macOS上本人管理的Mihomo已经配置external-controller-unix,控制端却仍尝试连接TCP端口。本文只查询现有本机接口,不新建公网控制入口,不修改其他用户的服务权限。
先区分原因
external-controller-unix提供Unix域套接字接口,与external-controller的TCP地址不同。官方特别说明经Unix socket访问API不会校验secret,因此访问控制要依靠本机文件和目录权限;把socket文件开放给所有用户并不是连接修复。
按顺序操作
- 先确认实际运行的Mihomo配置里确有external-controller-unix,并定位已经创建的socket文件。若采用相对路径,应结合服务的实际运行环境确认位置,不猜测固定目录。
- 核对调用程序与Mihomo所在用户、容器和文件系统范围。宿主机路径不自动等于容器内路径;看不到文件时先查挂载与真实路径,不复制一个普通空文件冒充socket。
- 使用支持Unix socket的curl发起一次只读查询。下方路径是占位;http://localhost/version表示通过该socket发出的HTTP资源路径,不表示另外监听了localhost的TCP端口。
- 若报告权限不足,检查socket及父目录的访问权限和服务所属用户,交对应管理员调整最小必要访问。不要chmod 777,不通过开放0.0.0.0控制端口绕过本地问题。
- 核对返回版本是否属于预期内核,再检查需要连接的控制程序是否支持Unix socket。浏览器直接输入路径或只支持TCP的面板不能因此自动使用该接口。
curl -q --unix-socket "/path/to/mihomo.sock" --connect-timeout 5 --max-time 10 --output version.json "http://localhost/version"| 观察项 | 含义与下一步 |
|---|---|
| external-controller | TCP控制接口 |
| external-controller-unix | Unix socket控制接口 |
| Unix接口的secret | 官方说明不验证,需依靠本机访问权限 |
怎样确认有效
只读/version返回预期内核的信息,且调用者的访问范围符合本机策略,才说明这条控制链路可用。socket文件存在本身不能证明进程仍在监听,也不证明节点已经联网。
无效时恢复与下一步
本次只读查询无需回滚;删除测试命令即可。若需改变服务接口配置,应先保留可恢复的管理通道,不能在仍依赖该连接时盲目重启;未授权用户不应获得socket访问权限。