Clash 的外部控制器与代理入站是两套监听。把控制器端口填进浏览器、下载器或开发工具的「代理服务器」栏,等于让应用用代理协议去打控制面。官方全局配置里,外部控制器示例为 external-controller: 127.0.0.1:9090,用途是 RESTful API;而 http(s)、socks、mixed 才是需要 authentication 的代理类型。两者即使用同一个数字端口(实际部署中应避免),语义也不互换。
适用条件:什么情况下算「用错端口」
出现下列任一情形,就可以按「把控制器端口当代理端口」来排查。应用的代理主机、端口与 external-controller(或 external-controller-tls)一致。应用发出的是 HTTP CONNECT、普通 HTTP 代理请求或 SOCKS 握手,而不是带 API 路径的 REST 调用。你把 API 的 secret 填进了代理用户名或密码,或反过来把 authentication 里的 user1:pass1 当成了 API 密钥。你把 Unix socket、namedpipe 或 external-doh-server 的路径当成了「另一种代理」。
文档允许把 API 的 127.0.0.1 改成 0.0.0.0 以监听所有 IP,并提供 CORS、external-controller-unix、external-controller-pipe、external-controller-tls。这些都是控制面选项。Unix socket 与 Windows namedpipe 访问 API 时不会验证 secret;在 REST 端口上开启的 DOH 路径同样不验证 secret。它们再宽松,也不等于 mixed/http/socks 代理已经在该地址上工作。
会出现哪些问题
协议不匹配是第一类问题。代理客户端期望收到代理握手应答;API 期望的是 REST 访问密钥、路径与 CORS 策略。结果通常是连接被重置、返回非代理语义的 HTTP 响应,或应用提示代理不可用。此时即使 mode 设为 global 或 rule,也不会把 API 端口变成入站代理,因为运行模式只作用于已经进入代理管道的流量。
第二类是鉴权被用错对象。代理入站走 authentication 与 skip-auth-prefixes;API 走 secret。混用后,本机回环可能因默认跳过代理验证而「像是连上了某个端口」,实际打到的仍是控制面;或者局域网设备在 allow-lan 为 true 时以为自己在用代理端口,其实在扫描 API。allow-lan 的官方表述是允许其他设备经过「代理端口」访问互联网,并不授权把外部控制器当作网关。
第三类是安全边界被削弱。API 若监听所有地址,又把该端口当「代理」告诉其他设备,等于扩大控制面暴露面。文档对 unix、pipe、DOH 明确写出「不会验证 secret,若开启请自行保证安全」。把这些入口误认成代理,排查时还会漏掉真正的 mixed/http/socks 入站是否在工作。
判断依据与失败时下一步
先并列抄出两处地址:external-controller(及 TLS/unix/pipe 变体)与 http(s)/socks/mixed 对应的代理端口。应用填写项若命中前者,即可判定用错。再看鉴权字段:出现的是 secret 还是 authentication 列表。最后用 log-level 观察:info 或 debug 应能区分 API 访问与代理入站;silent 无法核对,error 只能看到无法使用级别的记录。
纠正步骤是:应用改回真正的代理端口;API 仅留给控制页面或脚本;需要本机免验证时改 skip-auth-prefixes,而不是关掉 secret。若改完仍失败,检查是否把 external-controller-tls 的证书端口或 DOH 路径残留在代理设置里,并确认 bind-address、lan-allowed-ips、lan-disallowed-ips 作用对象是代理端口而非 API。IPv6 场景还要核对 ipv6 是否允许内核接受 IPv6 流量,避免 ::1 打到错误的监听上。