Clash Verge Rev Windows外部控制器怎么设置?
先理解外部控制器与代理端口的区别
Clash Verge Rev 中的外部控制器不是代理端口。代理端口用于接收浏览器、终端和其他应用的网络请求,例如 mixed-port: 7890;外部控制器则是 Mihomo 提供的管理接口,供图形界面或 Web 面板读取连接记录、切换策略组、查看流量和修改运行状态。两者即使使用不同端口,也可能同时存在于同一份配置中。
在 Windows 版 Clash Verge Rev 中,外部控制器通常由 Mihomo 内核配置项控制。常见字段是 external-controller,访问密钥字段是 secret。如果控制器监听在 127.0.0.1,只有当前 Windows 电脑上的程序能够访问;如果监听在局域网地址或所有网卡,就可能被同一网络中的其他设备发现,因此必须同时考虑密钥和防火墙。
external-controller: 127.0.0.1:9090
secret: "change-this-secret"
Clash Verge Rev 的具体菜单名称会随版本、语言和内核设置页面的调整而变化。遇到“外部控制器”“External Controller”“控制器地址”或“API 地址”等类似字段时,重点不是菜单标题,而是确认最终生效的地址、端口和密钥。若界面设置与 YAML 内容不一致,应以当前运行内核日志或配置预览中显示的生效值为准。
在 Clash Verge Rev 中填写控制器参数
开始设置前,先退出其他可能占用控制器端口的 Clash 客户端,例如旧版 Clash for Windows、其他 Mihomo 图形客户端或独立的 Web 控制器服务。多个实例可以分别使用不同的代理端口,但如果它们同时监听 127.0.0.1:9090,后启动的实例就可能无法绑定端口,最终表现为控制器连接失败。
- 打开设置页面。启动 Clash Verge Rev,进入设置、内核设置或 Mihomo 相关配置区域,查找外部控制器地址和密钥字段。部分版本会把它放在常规设置、配置管理或高级设置中。
- 填写本机地址。在只需要本机 Web 面板的情况下,将地址设为
127.0.0.1:9090。也可以使用localhost:9090,但排查时更建议使用数字回环地址,避免主机名解析造成额外干扰。 - 设置控制密钥。填写长度足够、难以猜测的字符串,例如由大小写字母、数字和符号组成。不要直接使用订阅密码、Windows 登录密码或公开教程中的示例密钥。
- 保存并重新载入。点击保存、应用、重载配置或重启内核。只修改文本框但没有让内核重新载入,旧的控制器地址仍可能继续生效。
- 记录实际配置。如果客户端提供“查看配置”“运行配置”或日志入口,应确认其中确实出现了
external-controller。配置订阅更新后,某些字段可能被覆盖,长期需要保留的设置应放入客户端支持的覆写区域。
如果直接编辑本地 YAML,建议先复制一份备份,再修改顶层字段。YAML 使用空格缩进,控制器字段通常位于顶层,不应误放到 dns、proxy-groups 或其他段落内部:
mixed-port: 7890
allow-lan: false
mode: rule
external-controller: 127.0.0.1:9090
secret: "use-a-long-random-secret"
这里的 allow-lan 只控制代理服务是否允许局域网设备接入,并不等于控制器接口的访问权限。即使 allow-lan: false,如果把外部控制器绑定到局域网地址,也不能因此认为控制器已经安全隔离。
使用 Web 面板连接外部控制器
控制器配置完成后,需要使用兼容 Mihomo API 的 Web 面板连接。打开面板时,通常要填写三项信息:控制器地址、控制器端口和密钥。有些面板把地址拆成“主机”“端口”两个输入框,有些则要求完整填写 http://127.0.0.1:9090。如果界面单独提供协议选项,应选择 HTTP;除非你明确配置了 HTTPS 反向代理,否则不要自行填写 https://。
| 项目 | 本机示例 | 填写注意 |
|---|---|---|
| 控制器地址 | 127.0.0.1 |
只在本机访问时优先使用回环地址 |
| 控制器端口 | 9090 |
必须与运行配置中的端口一致 |
| 控制密钥 | use-a-long-random-secret |
区分大小写,不要带多余空格 |
| 代理端口 | 7890 |
仅用于应用代理,不填到控制器端口栏 |
连接成功后,Web 面板一般能够显示当前模式、代理组、连接列表、流量统计和内核信息。可以先切换一个策略组或打开连接记录,确认面板操作确实作用于正在运行的 Clash Verge Rev 实例。如果面板显示的是空列表,但 Windows 上浏览器正在使用代理,可能是浏览器连接到了另一个 Clash 实例,或者面板连接的端口与当前内核不一致。
部分面板会保存控制器地址和密钥。若电脑由多人共用,建议避免在公共浏览器配置中长期保存密钥。完成远程管理后,可以清除浏览器保存的数据,并在不再需要时更换控制密钥。控制接口一旦泄露,攻击者可能切换代理节点、读取域名连接记录,甚至通过控制 API 修改运行状态。
用 Windows 命令验证端口和密钥
当 Web 面板提示连接失败时,不要先反复更换节点。可以在 Windows PowerShell 中直接测试控制器 API,从而把问题拆成“端口是否监听”“密钥是否正确”和“面板是否兼容”三部分。下面的地址仅适用于本文示例,实际测试时替换为 Clash Verge Rev 当前显示的端口和密钥。
先查看端口是否被程序监听:
netstat -ano | findstr :9090
Get-NetTCPConnection -LocalPort 9090 -State Listen
如果没有监听结果,说明控制器没有启动、端口填写错误,或者内核启动时配置解析失败。若能看到监听进程,再使用 PowerShell 请求控制器的版本接口:
$secret = "use-a-long-random-secret"
$headers = @{ Authorization = "Bearer $secret" }
Invoke-RestMethod `
-Uri "http://127.0.0.1:9090/version" `
-Headers $headers
请求成功时通常会返回内核版本或版本相关信息。如果返回未授权、401 或类似错误,优先检查 secret 是否完全一致,包括大小写、引号内容和首尾空格。若返回拒绝连接,则重点检查控制器地址、端口、内核状态和 Windows 防火墙,而不是修改订阅节点。
也可以使用 Windows 自带的 curl.exe 进行验证:
curl.exe -i ^
-H "Authorization: Bearer use-a-long-random-secret" ^
http://127.0.0.1:9090/version
如果命令行请求成功而 Web 面板失败,通常说明控制器本身没有问题,可能是面板地址格式、协议选项、浏览器缓存或面板对 Mihomo API 的兼容性导致。若命令行也失败,再回到 Clash Verge Rev 的运行日志查看是否存在端口占用、配置字段不支持或内核启动失败。
远程访问时的安全设置与排查
如果只是在本机使用 Web 面板,建议始终保持 127.0.0.1 监听,不要为了方便把地址改成 0.0.0.0:9090。后者会让控制器绑定所有网络接口,局域网设备可能直接访问该接口;如果 Windows 防火墙规则或路由器端口转发配置不当,甚至可能被暴露到更大的网络范围。
确实需要使用手机或另一台电脑管理 Windows 上的 Clash Verge Rev 时,应同时完成以下设置:
- 限制监听范围。优先绑定局域网网卡的具体地址,而不是无条件使用
0.0.0.0。确认该地址属于可信的家庭或办公网络。 - 设置强密钥。控制密钥不能留空,也不能使用
123456、设备名称或订阅服务名称等容易猜测的值。 - 检查 Windows 防火墙。只允许可信网络配置文件和必要的来源访问控制器端口,不要直接创建对所有公网开放的入站规则。
- 避免路由器端口转发。通常不需要把 9090 映射到互联网。远程管理应使用受控的内网、VPN 或其他经过认证的安全通道。
- 完成后恢复本机监听。临时远程管理结束后,将地址改回
127.0.0.1,重载内核并更换一次密钥。
排查时还要注意浏览器的安全策略。如果 Web 面板页面来自其他域名,浏览器可能因为跨域限制阻止它请求本机控制器;这时命令行请求成功并不代表网页一定能直接调用。优先使用面板支持的连接方式,确认其允许访问目标控制器,并避免随意安装来源不明的浏览器扩展。
常见错误的处理顺序
提示连接被拒绝:先使用 netstat 检查端口,再查看 Clash Verge Rev 是否正在运行 Mihomo 内核。端口没有监听时,修改 Web 面板地址没有意义;端口已监听时,再确认面板使用的协议和端口是否正确。
提示未授权或密钥错误:检查是否把 secret 的引号也复制进了输入框,确认没有把订阅密码误当成控制密钥。控制器密钥由配置中的 secret 决定,不等于节点认证信息。
控制器能连接但看不到最新状态:检查面板是否连接到正确的实例。Windows 上同时运行多个代理客户端时,最容易出现端口记忆错误。关闭旧客户端,确认当前 Clash Verge Rev 的内核版本和监听端口,再重新建立连接。
重启后设置消失:检查配置来源。订阅更新可能覆盖手工修改的 YAML,客户端覆写设置也可能与订阅内容合并。应把控制器地址和密钥放到 Clash Verge Rev 当前版本支持的持久化配置或覆写位置,并在重载后再次查看运行配置。
局域网设备无法访问:确认 Windows 主机与手机处于同一网络,检查控制器是否绑定了局域网地址、入站防火墙规则是否允许访问,以及面板填写的地址是否为 Windows 主机的局域网 IP。不要直接关闭全部防火墙作为长期解决方案。
完成设置后,推荐按“本机端口监听、命令行 API 请求、Web 面板登录、策略组状态读取、远程访问边界”这一顺序验证。每一步只验证一个环节,能够更快判断问题来自 Clash Verge Rev 配置、Mihomo 内核、Windows 网络权限,还是 Web 面板本身。