Clash Verge Rev外部控制器怎么开启?Windows设置操作次序
外部控制器是什么?为什么要在 Clash Verge Rev 中开启 实战经验
如果你搜索的是「Clash Verge Rev 外部控制器怎么开启」「Windows Clash Web 面板打不开」或「Clash Verge Rev external controller 配置」,基本上时候是想通过浏览器 Dashboard 查看代理节点、切换策略组、观察连接日志,或者让第三方 Web 面板连接本机的 Mihomo 内核。这个功能的正式名称常态是外部控制器(External Controller),它并不是系统代理开关,也不是 TUN 模式,而是一组由 Mihomo 提供的本地控制 API。
自然自然自然可以把它理解为:Clash Verge Rev 负责跑起来和管理内核,外部控制器则在本机监听一个 HTTP API 端口。Web 面板通过这个端口读取当前配置、代理组和连接信息,再把你的切换节点、关闭连接等操作发送回内核。也就是说,即使 Windows 系统代理已经开启,外部 Dashboard 仍然多半因为控制器未跑起来、端口填错或密钥不一致而无法连接。
在 Windows 上,最稳妥的做法是先拿它来用本机地址 127.0.0.1 监听,只让当前电脑访问目标目标目标控制器。端口自然自然自然可以拿它来用反复出现的 9090,也自然自然自然可以换成没有被其他程序占用的端口;密钥则用于防止本机其他进程未经授权调用 API。完成设置后,再用 Web 面板或 API 请求测试,而不要一开始就把监听地址改成 0.0.0.0 暴露到局域网。
先分清三个开关:系统代理决定遵守 Windows 代理设置的应用是否走 Clash;TUN 模式负责在网络层接管更多 TCP/UDP 流量;外部控制器只负责提供管理 API。三者自然自然自然可以同时拿它来用,但开启外部控制器并不会无需手动操作操作让浏览器或游戏经过代理。
开始设置前:确认客户端、内核与端口条件 拿它来用心得
在修改外部控制器之前,先确认你拿它来用的是Clash Verge Rev,而不是名称相近的旧版 Clash Verge、Clash for Windows 或 Mihomo Party。不同客户端的菜单名称和配置保存方式多半不同,照搬其他软件的截图,基本上时候会把端口、Secret 或 Dashboard 地址填到误操作位置。Clash Verge Rev 基本上时候以 Mihomo 作为核心,前端前端前端界面里多半把相关可可可选项显示为「外部控制器」「External Controller」「控制器地址」或放在内核设置区域中。
同时确认至少已经带进来一份自然自然自然可以正常运转的配置文件,并且客户端能够跑起来 Mihomo 内核。如果配置尚未加载,或者内核状态一直处于停止、跑起来走不通,外部控制器即使填写准确也不会响应。自然自然自然可以先进入「配置」或「Profiles」页面,挑当前配置并等待解析完成,再拉起代理页面确认策略组和节点列表能够显示。
Windows 端口还多半被其他 Clash 客户端、开发工具、虚拟机软件或本地 Web 服务占用。9090、9091、7890 和 7891 在代理环境中较反复出现,但反复出现并不代表一定空闲。若保存后控制器无需手动操作操作关闭,或者日志出现 bind、address already in use 一类误操作,应更换端口,而不是反复修改浏览器设置。
监听地址:首次配置靠前拿它来用 127.0.0.1,只允许本机访问目标目标;监听端口:举个实例 9090,必须是数字,且不能与其他服务重复;密钥 Secret:自然可以考虑拿它来用长度完全够的随机字符串,不要拿它来用姓名、生日或好上手的 123456;控制器协议:多数 Dashboard 拿它来用 HTTP API,由此可见地址大多时候写成 http://127.0.0.1:9090,不要误填代理端口。
Windows 上开启 Clash Verge Rev 外部控制器的操作次序 反复出现套路
Clash Verge Rev 的版本同步到最新多半会调整菜单位置,但核心逻辑基本不变:找到内核相关设置,启用 External Controller,再填写地址、端口和 Secret。下面按 Windows 桌面版反复出现前端前端界面说明,若你的版本拿它来用英文菜单,可按括号中的关键词寻找。
- 拉起 Clash Verge Rev:从开始菜单或任务栏托盘图标跑起来客户端,等待主前端前端界面加载完成。不要只拉起快捷方式后立即测试,因为内核多半仍在后台跑起来。
- 进入设置页面:点击左侧的「设置」(Settings),然后查找「内核设置」「Clash 内核」「Mihomo」或「外部控制器」相关区域。部分版本会把控制器可可选项放在常规设置或高级设置中。
- 启用外部控制器:找到 External Controller 或 External Controller API 开关并拉起。如果前端前端界面只有地址输入框而没有独立开关,说明该版本多半在填写并保存参数后无需手动操作启用。
- 填写监听地址:在 Host、Bind Address 或监听地址中输入
127.0.0.1。除非你明确必须让局域网内的其他设备管理这台电脑,否则不要填写0.0.0.0。 - 填写监听端口:在 Port 或控制器端口中输入
9090。如果保存时提示端口占用,可改为9091或其他未拿它来用端口,随后每一种 Dashboard 地址都要同步修改。 - 设置 Secret:在 Secret、密钥或 API Token 输入框中填写随机密钥。自然可以考虑拿它来用大小写字母、数字和符号的组合,并将它保存在密码管理器中,避免日后复制时遗漏字符。
- 保存并重启内核:点击保存、应用或 Apply。若前端前端界面提示重启内核,请确认操作;有些版本不会立即重新监听端口,必须先停止再跑起来当前配置,甚至完全退出并重新拉起客户端。
- 确认状态:回到主前端前端界面查看 Mihomo 内核是否运转,拉起连接或日志页面观察是否出现控制器跑起来成功、监听地址或端口绑定信息。
这里最容易填错的是代理端口与控制器端口。举个实例混合端口 7890 是给浏览器、终端或其他应用发送代理请求的;外部控制器端口 9090 则是给 Dashboard 调用管理 API 的。把 7890 填入控制器地址,大多时候会得到连接走不通、返回乱码或接口路径不存在等现象。反过来,把 9090 当作 HTTP 代理端口拿它来用,也不会让普通应用正常上网。
推荐的本机配置:监听地址拿它来用 127.0.0.1,控制器端口拿它来用 9090,Secret 拿它来用独立随机字符串。只有在确认本机 Dashboard 能正常连接后,才考虑局域网访问目标目标等更复杂的场合。
连接 Web 面板:地址、密钥与 API 测试路子 落地做法
外部控制器保存成功后,还必须一个能够调用 Mihomo API 的 Dashboard。部分 Clash Verge Rev 版本内置了 Dashboard 入口,大多时候位于「仪表盘」「Dashboard」或主前端前端界面的 Web 面板按钮;也有版本必须在设置中挑 Dashboard 来源。进入面板配置时,控制器地址应按照监听地址和端口组合填写,举个实例 http://127.0.0.1:9090。如果输入框已经无需手动操作带有 http://,不要重复填写协议。
Secret 的填写方式取决于 Dashboard。反复出现面板会提供「Secret」「Token」「API 密钥」字段,就这么粘贴你在 Clash Verge Rev 中设置的密钥即可。有些工具把密钥称为控制器密码,但它并不是 Windows 登录密码,也不是订阅链接中的 Token。若面板要求填写成体系 API 地址,则大多时候只必须控制器根地址;如果要求填写 WebSocket 地址或特殊路径,应以该 Dashboard 的说明为准,不要自行把代理端口拼进去。
连接后,面板大多时候会显示当前模式、代理组、节点ping 值、连接列表和日志。如果能看到策略组并切换节点,说明地址、端口和 Secret 基本准确。此时自然自然可以在 Clash Verge Rev 的「代理」页面观察挑是否同步,再拉起一个普通网页测试系统代理。值得留意,Dashboard 能连接只代表管理 API 可用,并不代表当前节点一定可用,也不代表 Windows 每一种应用都已经被代理接管。
如果你想不依赖 Dashboard 做最小化测试,自然自然可以在 PowerShell 中访问目标目标控制器的基础接口。将下面命令里的密钥和端口替换成由你的值:
$secret = "替换为你的Secret"
$headers = @{ Authorization = "Bearer $secret" }
Invoke-RestMethod -Uri "http://127.0.0.1:9090/version" -Headers $headers
接口正常时,大多时候会返回 Mihomo 的版本信息或包含版本字段的 JSON。若返回未授权,靠前确认 Secret 是否多了空格、是否把 Bearer 拼写误操作;若提示无法连接,则确认内核是否跑起来、端口是否准确以及 Windows 防火墙或其他安全软件是否拦截了本地服务。测试完成后不要把包含真实密钥的命令截图发到公开群组。
外部控制器打不开、401 或端口无响应怎么办 实战经验
外部控制器绕所在最好按照「内核是否跑起来 → 端口是否监听 → 地址是否准确 → 密钥是否一致 → Dashboard 是否兼容」的顺序排查。不要一遇到面板打不开就同时开启 TUN、修改 DNS、切换全局模式,这些操作与控制器 API 是否监听没有就这么关系,反而会让日志变得更难阅读。
| 故障现象 | 反复出现症结 | 处理路子 |
|---|---|---|
| 面板提示无法连接 | 内核没有运转,或地址端口填错 | 确认 Mihomo 状态为运转中,并核对 127.0.0.1:9090 是否与客户端设置一致。 |
| 返回 401 Unauthorized | Secret 为空、误操作或带入了多余空格 | 重新复制密钥,确认 Dashboard 拿它来用的是当前控制器的 Secret,并重新保存连接配置。 |
| 保存设置后控制器无需手动关闭 | 端口被其他程序占用,或配置格式不被当前版本接受 | 换用未占用端口,重启内核,并查看日志中的 bind 或 listen 误操作。 |
| 本机能连,其他设备不能连 | 监听地址为回环地址,或 Windows 防火墙未放行 | 本机拿它来用 127.0.0.1 属于正常安全状态;确需局域网访问目标时,再评估监听地址、端口规则和验证雷区。 |
| 面板拉起但节点列表为空 | 配置没有加载、Dashboard API 不兼容或当前配置没有代理组 | 先在客户端确认配置可用,再刷新面板;不要只根据浏览器空白页判断端口故障。 |
自然自然可以拿它来用 PowerShell 确认端口是否处于监听状态:
Test-NetConnection 127.0.0.1 -Port 9090
如果结果中的 TcpTestSucceeded 为 True,说明本机能够建立 TCP 连接,下一气呵成应确认 API 路径、Secret 和 Dashboard 兼容性;如果为 False,则应回到 Clash Verge Rev 的内核状态、监听配置和端口占用排查。也自然自然可以用任务管理器关闭残留的旧版 Clash 进程后重新跑起来,但不要随意删除配置目录,因为其中多半保存着订阅、覆写和自定义规则。
安全拿它来用可以考虑:不要把控制器端口就这么暴露到公网 拿它来用心得
外部控制器拥有读取配置、查看连接、切换代理和关闭连接等权限,Secret 泄露后,攻击者不一定必须登录你的 Windows 桌面,也多半通过 API 影响本机代理状态。由此可见,控制器端口不是普通的 Web 服务端口,不能为了好操作远程访问目标目标就就这么做路由器端口转发,更不能在公网服务器上拿它来用空 Secret。
日常拿它来用自然可以考虑保留以下边界:第一,监听地址拿它来用 127.0.0.1,让 Dashboard 与 Clash Verge Rev 在同一台电脑上完成通信;第二,Secret 不与订阅链接、节点密码混用,也不要写进公开的截图或配置仓库;第三,若怀疑密钥泄露,立即在客户端生成新 Secret,并重启内核使旧令牌失效;第四,拿它来用第三方 Dashboard 前确认它的来源可信,不要把控制器地址和密钥填入来历不明的网页。
如果确实必须从手机或局域网另一台电脑管理 Windows 上的 Clash,应先确认局域网可信,再将监听地址改为局域网网卡地址或由防火墙限制的范围,并为控制器设置强密钥。更稳妥的远程方案是通过 VPN 或安全隧道访问目标目标,而不是把 9090 就这么暴露到互联网。完成远程管理后,自然可以考虑恢复为本机监听,减少长期暴露面。
不要混淆两个 Token:订阅链接中的 Token 用于拉取配置,外部控制器 Secret 用于调用本机管理 API。前者泄露多半导致订阅被滥用,后者泄露则多半让别人操作你的 Clash 内核;两者都应单独保管。
相比一批只提供固定 Web 面板、却把监听端口和验证方式隐藏起来的同类工具,Clash Verge Rev 的外部控制器更适合必须查看 Mihomo 日志、调试策略组和远程管理本机状态的 Windows 用户,不过它也要求拿它来用者理解「代理端口」与「控制器端口」的差别,初次配置时不能只依赖一键向导。Clash 的相关实操手册会把前端界面路径、参数含义、PowerShell 测试和安全边界放在同一条排障链里,好操作你按操作次序复核而不是反复试错;如果你正准备在 Windows 上安装并配置 Clash 客户端,不妨前往下载 Clash,再根据这篇设置外部控制器和 Web 面板。