首页/博客/Clash Dashboard 使用指南
入门

Clash Dashboard 使用指南:可视化面板配置与常用功能

发布于 2026-06-02 · 阅读约 8 分钟 · 适用于所有基于 Clash / mihomo 内核的客户端

如果你已经能正常连接 Clash,但每次切换节点、查看流量都要翻配置文件,效率会很低。Dashboard 是一个运行在浏览器里的网页控制面板,能够实时查看连接状态、流量图表、日志,还可以直接点击切换节点、在线编辑规则——本质上它是通过 Clash 内核暴露的一个本地 API 接口来完成这些操作的。

01Dashboard 是怎么工作的

Clash 内核在运行时可以额外开启一个「外部控制」接口(external-controller),Dashboard 网页本质上就是一个调用这个接口的前端页面。也就是说,Dashboard 本身不处理任何代理流量,它只是内核状态的一个可视化窗口。常见的 Dashboard 项目有 yacd(界面偏经典)和 metacubexd(界面更新、功能更全,目前主流客户端大多内置)。多数图形客户端(Clash Verge Rev、Clash for Windows 等)已经内置了 Dashboard,不需要额外配置就能直接使用;如果你用的是纯命令行的 mihomo 内核,则需要按下面的方法手动开启。

02手动开启 external-controller

config.yaml 里加入以下两行配置,重启内核后即可通过浏览器访问控制面板:

# 允许本地 9090 端口访问控制接口
external-controller: 127.0.0.1:9090
# 可选:设置访问密钥,避免局域网内其他设备随意访问
secret: "your-own-secret"

配置生效后,用浏览器打开 http://127.0.0.1:9090/ui(部分内核版本需要额外挂载 UI 静态文件,具体路径可查看内核发布页说明),如果设置了 secret,首次访问时需要在页面里填入这个密钥。

03日常最常用的四个功能

  • Proxies(节点面板):查看所有策略组与节点,点击某个节点即可立即切换,还能对整组节点一键测速,比在客户端菜单里逐个找方便很多。
  • Connections(连接面板):实时查看当前有哪些程序在联网、每条连接命中了哪条规则、走的是直连还是代理,用来排查"为什么这个网站没走代理"非常直接。
  • Logs(日志面板):内核运行日志的实时流,规则不生效或者节点连接失败时,日志面板通常能直接看到报错原因。
  • Rules(规则面板):查看当前生效的全部规则及其顺序,部分 Dashboard 还支持临时在线编辑测试,但要注意这类修改一般不会持久化到配置文件里,重启后会丢失,仅适合临时调试。
面板解决的问题
Overview查看实时上下行流量曲线,判断当前是否真的在走代理、流量是否异常。
Proxies切换节点、测速、查看策略组结构,最高频使用的面板。
Connections查看每条连接命中的规则与去向,排查分流是否正确。
Logs查看内核运行日志,排查连接失败、规则报错等问题。
Config查看当前生效的运行模式、端口设置等全局配置项。
提示:如果你在局域网内的其他设备(比如手机)访问电脑上的 Dashboard,需要把 external-controller 监听地址改为 0.0.0.0:9090,并务必配合 secret 设置密钥,否则局域网内任何设备都能无授权控制你的 Clash,属于明显的安全隐患。

04常见问题

打开 Dashboard 页面一片空白?多数是因为只开启了 external-controller 接口,但没有挂载 UI 静态文件。图形客户端一般会自动处理这一步;如果是纯命令行使用 mihomo,需要单独下载 UI 资源包并在配置里通过 external-ui 字段指定资源目录路径。

切换节点后 Dashboard 显示的策略组没有变化?检查是不是修改的策略组类型是 url-testfallback——这两种类型由内核自动选择节点,手动点击不会生效,只有 select 类型的策略组才支持手动选择。