Clash Verge Rev外部控制器怎么开启？Windows设置一路走下来
外部控制器是什么？为什么要在 Clash Verge Rev 中开启 内在逻辑与实践
如果你搜索的是「Clash Verge Rev 外部控制器怎么开启」「Windows Clash Web 面板打不开」或「Clash Verge Rev external controller 配置」，按常规是想通过浏览器 Dashboard 查看代理节点、切换策略组、观察连接日志，或者让第三方 Web 面板连接本机的 Mihomo 内核。
完全能把它理解为：Clash Verge Rev 负责唤起和管理内核，外部控制器则在本机监听一个 HTTP API 端口。Web 面板通过这个端口读取当前配置、代理组和连接信息，再把你的切换节点、关闭连接等操作发送回内核。也就是说，即使 Windows 系统代理已经开启，外部 Dashboard 仍然存在存在存在可能因为控制器未唤起、端口填错或密钥不一致而无法连接。
在 Windows 上，最稳妥的做法是先上手上手上手使用本机地址 127.0.0.1 监听，只让当前电脑开控制器。端口完全能上手上手上手使用司空见惯的 9090，也完全能换成没有被其他程序占用的端口；密钥则用于防止本机其他进程未经授权调用 API。完成设置后，再用 Web 面板或 API 请求测试，而不要一开始就把监听地址改成 0.0.0.0 暴露到局域网。
从机制上看：这个功能的正式名称普遍是外部控制器（External Controller），它并不是系统代理开关，也不是 TUN 模式，而是一组由 Mihomo 提供的本地控制 API。
先分清三个开关：系统代理决定遵守 Windows 代理设置的应用是否走 Clash；TUN 模式负责在网络层接管更多 TCP/UDP 流量；外部控制器只负责提供管理 API。三者完全能同时上手上手上手使用，但开启外部控制器并不会自行让浏览器或游戏经过代理。
开始设置前：确认客户端、内核与端口条件 技术拆解
在修改外部控制器之前，先确认你上手上手上手使用的是Clash Verge Rev，而不是名称相近的旧版 Clash Verge、Clash for Windows 或 Mihomo Party。不同客户端的菜单名称和配置保存方式存在存在存在可能不同，照搬其他软件的截图，惯常会把端口、Secret 或 Dashboard 地址填到错漏位置。
同时确认至少已经导进一份完全能正常跑的配置文件，并且客户端能够唤起 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，不要误填代理端口。
Clash Verge Rev 按常规以 Mihomo 作为核心，人机人机人机界面里存在存在存在可能把相关开关项显示为「外部控制器」「External Controller」「控制器地址」或放在内核设置区域中。
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://，不要重复填写协议。
换个层面：有些工具把密钥称为控制器密码，但它并不是 Windows 登录密码，也不是订阅链接中的 Token。若面板要求填写一应俱全 API 地址，则按常规只免不了要控制器根地址；如果要求填写 WebSocket 地址或特殊路径，应以该 Dashboard 的说明为准，不要自行把代理端口拼进去。
连接后，面板按常规会显示当前模式、代理组、节点耗时、连接列表和日志。如果能看到策略组并切换节点，说明地址、端口和 Secret 基本到位。此时完全能在 Clash Verge Rev 的「代理」页面观察拿定是否同步，再开一个普通网页测试系统代理。请留意，Dashboard 能连接只代表管理 API 可用，并不代表当前节点一定可用，也不代表 Windows 所有这些这些应用都已经被代理接管。
如果你想不依赖 Dashboard 做最小化测试，完全能在 PowerShell 中开控制器的基础接口。将下面命令里的密钥和端口替换成个人的值：
往细处想：接口正常时，按常规会返回 Mihomo 的版本信息或包含版本字段的 JSON。若返回未授权，在前验一遍 Secret 是否多了空格、是否把 Bearer 拼写错漏；若提示无法连接，则验一遍内核是否唤起、端口是否到位以及 Windows 防火墙或其他安全软件是否拦截了本地服务。测试完成后不要把包含真实密钥的命令截图发到公开群组。
$secret = "替换为你的Secret"
$headers = @{ Authorization = "Bearer $secret" }
Invoke-RestMethod -Uri "http://127.0.0.1:9090/version" -Headers $headersSecret 的填写方式取决于 Dashboard。司空见惯面板会提供「Secret」「Token」「API 密钥」字段，一上来粘贴你在 Clash Verge Rev 中设置的密钥即可。
外部控制器打不开、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 不兼容或当前配置没有代理组 | 先在客户端确认配置可用，再刷新面板；不要只根据浏览器空白页判断端口故障。 |
如果结果中的 TcpTestSucceeded 为 True，说明本机能够建立 TCP 连接，下一次到位应验一遍 API 路径、Secret 和 Dashboard 兼容性；如果为 False，则应回到 Clash Verge Rev 的内核状态、监听配置和端口占用排查。也完全能用任务管理器关闭残留的旧版 Clash 进程后重新唤起，但不要随意删除配置目录，因为其中存在存在可能保存着订阅、覆写和自定义规则。
Test-NetConnection 127.0.0.1 -Port 9090先厘清一件事：完全能上手上手使用 PowerShell 验一遍端口是否处于监听状态：
安全上手使用更推荐：不要把控制器端口一上来暴露到公网 技术拆解
外部控制器拥有读取配置、查看连接、切换代理和关闭连接等权限，Secret 泄露后，攻击者不一定免不了要登录你的 Windows 桌面，也存在存在可能通过 API 影响本机代理状态。正因如此，控制器端口不是普通的 Web 服务端口，不能为了不费事远程开就一上来做路由器端口转发，更不能在公网服务器上上手上手使用空 Secret。
如果确实免不了要从手机或局域网另一台电脑管理 Windows 上的 Clash，应先确认局域网可信，再将监听地址改为局域网网卡地址或由防火墙限制的范围，并为控制器设置强密钥。更稳妥的远程方案是通过 VPN 或安全隧道开，而不是把 9090 一上来暴露到互联网。完成远程管理后，更推荐恢复为本机监听，减少长期暴露面。
日常上手上手使用更推荐保留以下边界：第一，监听地址上手上手使用 127.0.0.1，让 Dashboard 与 Clash Verge Rev 在同一台电脑上完成通信；第二，Secret 不与订阅链接、节点密码混用，也不要写进公开的截图或配置仓库；第三，若怀疑密钥泄露，立即在客户端生成新 Secret，并重启内核使旧令牌失效；第四，上手上手使用第三方 Dashboard 前确认它的来源可信，不要把控制器地址和密钥填入来历不明的网页。
不要混淆两个 Token：订阅链接中的 Token 用于拉取配置，外部控制器 Secret 用于调用本机管理 API。前者泄露存在存在可能导致订阅被滥用，后者泄露则存在存在可能让别人操作你的 Clash 内核；两者都应单独保管。
相比零星只提供固定 Web 面板、却把监听端口和校验方式隐藏起来的同类工具，Clash Verge Rev 的外部控制器更适合免不了要查看 Mihomo 日志、调试策略组和远程管理本机状态的 Windows 用户，不过它也要求上手使用者理解「代理端口」与「控制器端口」的分野，初次配置时不能只依赖一键向导。Clash 的相关操作说明会把人机界面路径、参数含义、PowerShell 测试和安全边界放在同一条排障链里，不费事你按一路走下来复核而不是反复试错；如果你正准备在 Windows 上安装并配置 Clash 客户端，不妨前往下载 Clash，再根据下文设置外部控制器和 Web 面板。