Clash面板、控制接口与密钥各是什么

面板与运行核心

在 Linux 无头服务器、软路由或 NAS 环境中,Clash 核心是以纯命令行守护进程运行的。为了在网页端直观查看实时上传下载速率、切换节点或查看活跃连接,我们通常借助外部 Web 管理面板(如 Yacd 或 Metacubexd)。

组件名称 程序实体 运行形态 通信协议
Mihomo / Clash 核心 mihomo 后台二进制 监听本地指定端口(如 9090) 提供标准的 RESTful API 与 WebSocket 实时数据流
Web 管理面板 Yacd, Metacubexd, Razord 纯前端 HTML/CSS/JS 静态应用(可通过浏览器直接访问) 通过 AJAX / Fetch 跨域向核心发起控制请求

接口地址与授权

为了允许 Web 面板与本地核心安全通信,必须在 config.yaml 中正确配置 external-controller 与 secret 密钥字段:

配置字段 字段含义 默认取值 安全风险提示
external-controller 核心开放的 RESTful API 监听地址与端口 127.0.0.1:9090 若设为 0.0.0.0:9090 且无密钥,局域网内任何人均可篡改你的代理设置
secret API 请求身份验证令牌(Token) "" (默认空字符串) 在公网或局域网开放时,必须设置高强度密码;面板连接时需在 Authorization 请求头附带此密钥
external-ui 本地静态面板的存储路径 "" 填写后,直接在浏览器打开 http://127.0.0.1:9090/ui 即可加载面板

本机连接验证

当 Web 面板提示“无法连接到核心 / API Disconnected”时,按以下两步诊断网络:

  1. 本地端口探测:确认 9090 端口处于 LISTEN 状态。
  2. RESTful API 握手:直接通过 curl 访问 http://127.0.0.1:9090/version,核验返回的 JSON 数据。

用最小示例核对概念

以下演示标准 API 配置段与通过终端直接测试核心版本与流量接口的指令:

external-controller 配置与 API 接口核验

            
1 # 外部控制器与授权凭据
2 external-controller: 127.0.0.1:9090
3 secret: "my-secure-dashboard-token-2026"
4 external-ui: /etc/mihomo/ui

            
1 # 携带 Bearer Token 访问核心版本 API
2 curl -H "Authorization: Bearer my-secure-dashboard-token-2026" http://127.0.0.1:9090/version
{"version":"Mihomo Meta v1.18.10","meta":true}
📖 深入关联

前置阅读:Clash 配置文件规范 · 若面板提示连接超时?前往 Clash无法连接排查指南。