为什么「开面板」首先要谈 external-controller?
在 Clash Verge Rev 这类图形客户端背后,真正对外提供控制能力的是内核(常见为 Mihomo/Clash Meta)暴露的一组 RESTful API:查询实时连接、切换出站组、热重载配置乃至触发升级与调试端点。配置文件里的 external-controller 字段,就是这组 Web 面板、第三方脚本和自动化工具共同的「门把手」。用户搜索「Clash Verge Rev Web 面板」「external-controller 怎么设」时,往往已经意识到:门把手装错了方向,比不开门更危险。
与承载数据面流量的混合端口不同,控制面的接口语义是“管理整条链路的策略”,一旦能被同一局域网里的其它设备直接访问,就等价于把切换节点、导出日志、甚至触发重载的权限拱手让人。更糟糕的是,许多教程习惯性地把监听写成 0.0.0.0 或仅写端口以图省事——这在会议室、宿舍、酒店客房等共享网段几乎是送分题。本文按「单一功能点」只拆控制面:bind-address 收到 127.0.0.1、secret 做 Bearer 鉴权、再用可重复命令验收只在本机访问路径上成立。
威胁模型:你到底在防谁?
把目标说清楚,安全配置才有意义。默认我们假设攻击者能与你处在同一二层或三层局域网:咖啡馆 WiFi、公司访客网、室友路由器,都满足这一点。对他们而言,扫描常见 RESTful API 端口比猜中你的代理密码成本低得多。若控制面还允许无鉴权访问,拿到的就是近乎脚本小子的胜利;若只加了短密令而无监听收缩,被枚举或从日志中旁路截获的概率仍然不可忽视。
把 external-controller 绑回 127.0.0.1 的意义,是把「谁能发管理请求」压缩到「同一台操作系统里运行的进程」。再配合强健的 secret,即便本地有恶意扩展或木马,也要多跨过一道意图门槛——这不是银弹,但相比把端口摊到所有网卡上,已是现代桌面客户端的理性基线。至于公网侧扫描,只要你没有手工做端口映射,通常不应出现;若你为了远程管理刻意映射,请另配 TLS、最小来源 IP、失败登录限速与专门审计,这已经超出本篇「本机绑定」的讨论边界。
四个关键词:端口、bind-address、Secret、Web UI
在阅读界面与 YAML 时,可以把它们对齐到下面这张心智表,避免把「代理口」和「控制口」混谈:
- external-controller:写成
127.0.0.1:9090这种「地址+端口」时,同时表达了 bind-address 与监听端口。只写:9090是否等同于全零绑定,取决于内核版本与默认行为——生产习惯上不要依赖隐式默认,而是显式写回环。 - 127.0.0.1:IPv4 回环,只接受来自本机的连接。把它写进控制面是最直接的「本机访问」声明。需要 IPv6 回环时再讨论
::1,并注意不要顺手把[::]这种宽绑定抄进配置。 - secret:控制面 HTTP 头部
Authorization: Bearer <token>的对称密钥。空白 secret 在多数发行内核上意味着「谁来都能调 REST」,只适合全封闭调试容器。 - Web 面板:浏览器里那套静态页面最终也是向同一 RESTful API 拉数据。面板是否舒适是体验问题,端口与密钥是否收束是安全问题——二者必须在配置层一起过关。
在 Clash Verge Rev 里落地:覆写而不是手搓临时文件
社区维护的 Clash Verge Rev 会在导入订阅后做字段合并,直接改生成目录往往会被下一次同步覆盖。更稳妥的路径是使用图形界面提供的「覆写/补丁/Merge」能力(具体菜单文案随版本略有出入),把你对控制面的最终意图写成一份高优先级片段,让它在每次合并后仍然盖在最上层:
-
打开“当前配置/Profile”页,找到覆写入口
目标是把下列键写入会被内核实际加载的合并结果,而不是仅停留在订阅商给你的原始片段里。 -
显式写全监听三元组:地址、端口、密钥
下面是一段结构与字段名常见的示例,端口请按你本地空闲端口调整;务必把示例密钥换成随机长串:
# Merge snippet example — replace port and secret
external-controller: 127.0.0.1:9090
secret: "change-me-to-long-random"
若你的发行内核还支持单独的 external-controller-tls 等字段,请只在确有需要时引入;对绝大多数「桌面自管」场景,先完成回环绑定与 Secret 再谈传输层加固,更符合ROI。保存覆写后,按界面提示「重载/重启内核」,不要用浏览器缓存判断生效与否,下面会给标准化的 API 探针。
本机验收:带 Secret 的 RESTful 探针
面板文案有时会撒谎,curl 不会。请在同一台运行 Verge 的机器上打开终端,先验证最小只读端点 /version 或 /configs(以你实际内核文档为准),携带 Bearer 头:
curl -fsS \
-H "Authorization: Bearer change-me-to-long-random" \
http://127.0.0.1:9090/version
期望现象:返回一段 JSON 文本,包含内核名与版本字段;若返回空响应、连接被拒或 401,请对照三项:服务是否真的监听在既定端口、合并后的 YAML 是否就是你以为的那份、以及头部拼写是否正好是 Authorization: Bearer。把 URL 里的主机从 127.0.0.1 换成 localhost 一般等价,但在个别解析顺序怪异的环境里,坚持用数字回环更不容易踩坑。
进一步,你可以用浏览器的开发者工具面板观察 Web UI 发起的 XHR:路径前缀应与上述控制器一致,且请求头里同样应自动附带密钥。若你看到的是裸奔请求,说明前端仍假设“本机无鉴权”——这通常意味着 secret 仍为空或面板缓存了旧连接,请回到覆写层复查。
对照验收:证明局域网打不通
仅能在本机访问还不能只靠「我感觉」:找一台同网段手机或平板,安装任意可自定义 Host 的 HTTP 客户端,直接向 http://你的电脑局域网IP:9090/version 发起请求(不要带密钥,先看 TCP 是否能通)。在你已将 bind-address 收缩到回环的前提下,理想结果应是连接超时或连接被拒,而不是 JSON 正文。
如果对照实验仍然能通,优先检查三类失误:其一,覆写没有真正合并进活动配置,活动配置仍监听 0.0.0.0;其二,你还有第二份进程沿用旧端口(常见于忘记关闭的旧服务或残留 helper);其三,系统防火墙规则把回环与共享误放行。逐条用系统自带的端口监听列表工具核对「哪个 PID 绑在哪个地址」,比在社群里提问更快闭环。
加固清单(在 127.0.0.1 之外的增量)
完成基线后,如果你仍希望进一步挤压风险,可以按需启用下列增量措施,它们不是每人都必须,但出现在大量企业内网与国际赛事新闻稿的 hardening 列表里:
- 操作系统防火墙出站/入站_profiles:即便监听在回环,也保持“公共网络”配置为默认拒绝,避免其它进程意外代播。
- 最小权限账户:日常办公用非管理员账号运行浏览器,降低恶意扩展直接读本地 Bearer 的能力(无法根除,但可抬高成本)。
- 定期的端口审计:每次大版本升级 Verge 或内核后,重复「本机成功/对照失败」实验,防止默认模板回潮。
- 远程管理走隧道:SSH 本地转发是最朴素的“把 127.0.0.1 的另一端搬到握手信道里”,比直接对0.0.0.0开洞省心得多。
常见问题(与「怎么用代理」类教程的边界)
问:我只想看点连接曲线,也要搞这么严肃吗?答:看曲线依然是管理权限的一部分。你可以关闭面板,但不能假装风险不存在——最小路径仍是回环加 secret。
问:Secret 写在 YAML 里算不算泄露?答:磁盘上的明文当然是攻击面,所以要配合文件权限与全盘加密;但它的对手盘是“局域网里任意人都能调 API”,两者不是一个量级。更高级的做法是分层密钥与外部秘管集成,但那只适合团队场景。
问:本文为何几乎不提 TUN 与 DNS?答:那是数据面可达性与解析路径问题;而 external-controller 讨论的是控制面能命令内核做什么。把两类问题拆开,你排查卡顿时才不会动一下面板就把全局 DNS 行为误判。
问:我复制了 GitHub gist 里的「一键 Prometheus」脚本后要改吗?答:要。任何Exporter 默认都会假设控制器地址与权限模型。把脚本里的 http://0.0.0.0:9090 改成先 SSH 到机器再抓 127.0.0.1,通常一行 diff 就能少一场事故。
结语:把总闸放回桌面本体
相比之下,部分同类图形代理客户端要么把 RESTful API 包装在不可审计的二进制里,让你在出问题时难以确认监听到底落在哪个 bind-address;要么为了「手机也能看板」一类需求,诱导用户一键全局放行,却在文章里轻描淡写跳过对照实验。传统「能上网就行」的路径,很少教人用两步 curl 证明局域网另一侧确实摸不到控制器——于是事故总在聚会现场而非实验室复现。
Clash 系路线的好处,是把这些旋钮都结构化写进 YAML:你可以像对待防火墙规则一样对待 external-controller 与 secret,升级后还能用同一张验收脚本回归。Mihomo 的可观测性与生态工具越多,越要把“谁能调用这些能力”收紧到本机访问默认,这也是 professional 用户与临时脚本党之间的分水岭。
若希望先把客户端来源统一到可核验渠道,再结合本文微调控制面,可到本站客户端下载页获取当前平台构建。