Clash 中文网搜索

Mihomo Web 控制面板教程：metacubexd、zashboard、yacd 安装与使用

Clash 中文网编辑部 · 更新于 2026/10/22 · 对照版本 Mihomo（Clash.Meta 内核） v1.19.33

Mihomo 内核本身没有界面，可以通过 Web 控制面板管理：在配置中设置 external-controller 和 external-ui，然后在浏览器打开 http://IP:端口/ui。 常用面板有 metacubexd（MetaCubeX 官方）、zashboard 和 yacd。

面板对比

面板 特点
metacubexd MetaCubeX 官方面板，功能完整，适配 Mihomo 新特性
zashboard 界面现代，移动端体验好，信息展示丰富
yacd（Meta 版） 老牌面板，简洁轻量

面板能做什么

  • 切换代理模式（规则 / 全局 / 直连）与选择节点；
  • 单个或批量测试延迟；
  • 查看实时连接，按规则、进程、节点筛选，关闭连接；
  • 查看实时日志；
  • 查看规则、代理集合、规则集合，并手动更新；
  • 重新加载配置、更新 GeoData、升级内核（部分面板）；
  • 查看流量与内存占用。

方法一：本地面板（推荐）

让内核自己下载面板文件，并通过控制器端口提供访问。在 config.yaml 中加入：

external-controller: 0.0.0.0:9090
secret: "设置一个复杂的密码"
external-ui: ui
external-ui-url: "https://github.com/MetaCubeX/metacubexd/archive/refs/heads/gh-pages.zip"
字段 作用
external-controller API 监听地址，0.0.0.0 允许其他设备访问，127.0.0.1 仅本机
secret API 密钥
external-ui 面板文件所在目录（相对工作目录）
external-ui-url 面板 zip 下载地址，内核启动时自动下载解压

重启内核后，浏览器打开：

http://服务器IP:9090/ui

首次进入时，在面板设置页填写后端地址 http://服务器IP:9090 和密钥，保存即可连接。

换成其他面板

zashboard：

external-ui-url: "https://github.com/Zephyruso/zashboard/releases/latest/download/dist.zip"

修改 external-ui-url 后，删除工作目录中的 ui 文件夹再重启，内核会重新下载。部分面板还提供“更新面板”按钮。

手动放置面板文件

服务器无法访问 GitHub 时，在本地下载面板的构建文件（metacubexd 的 gh-pages 分支 zip、zashboard 的 dist.zip），解压后上传到工作目录的 ui 文件夹，并只保留 external-ui: ui。

方法二：在线面板

不想在服务器上放文件，可以直接打开面板的在线地址，再填写你的后端地址：

面板 在线地址
metacubexd https://metacubex.github.io/metacubexd/
yacd https://yacd.metacubex.one/
zashboard https://board.zash.run.place/

在线面板运行在你的浏览器里，直接连接你的内核。注意：

  • HTTPS 网页连接 HTTP 控制器属于混合内容，浏览器可能拦截。可以在浏览器的网站设置中允许“不安全内容”，或改用本地面板；
  • 需要在内核中允许面板的来源（跨域），见下文。

跨域设置

浏览器中的在线面板调用 API 属于跨域请求，可以在配置中允许：

external-controller-cors:
  allow-origins:
    - "https://metacubex.github.io"
    - "https://board.zash.run.place"
  allow-private-network: true

allow-private-network 允许公网网页访问本机/局域网中的控制器（Chrome 的私有网络访问限制）。

在图形客户端中使用面板

客户端 方法
Clash Verge Rev 「设置 → Clash 设置」开启外部控制器，再在「网页界面」中打开，见 Clash 设置详解
FlClash 设置中开启「外部控制器」（9090 端口）
Clash Party 「内核设置」中设置监听地址与访问密钥，「设置」中可启用内置控制器面板
Clash Meta for Android 「覆写」中设置外部控制器与密钥

安全提醒

外部控制器拥有完全控制内核的权限（切换节点、修改配置、查看所有连接）：

  1. external-controller 监听 0.0.0.0 时，必须设置复杂的 secret；
  2. 公网服务器应使用防火墙限制 9090 端口的访问来源；
  3. 更安全的做法：只监听 127.0.0.1，通过 SSH 隧道访问：
ssh -L 9090:127.0.0.1:9090 user@服务器IP

然后在本地浏览器打开 http://127.0.0.1:9090/ui。

常见问题

现象 原因与解决
打开 /ui 显示 404 面板未下载成功，检查 external-ui-url 能否访问，或手动放置文件
面板提示连接失败 后端地址或密钥错误；控制器只监听了 127.0.0.1；防火墙未放行
在线面板连不上本地控制器 混合内容或跨域被拦截，见上文
修改面板地址后没变化 删除 ui 文件夹后重启内核

相关教程

常见问题

面板打开后连不上内核？

检查面板里填写的后端地址是否与 external-controller 一致、密钥是否与 secret 相同；从其他设备访问时 external-controller 需要监听 0.0.0.0，并确认防火墙放行端口。

图形客户端也能用这些面板吗？

可以。Clash Verge Rev 的「网页界面」就是用来打开这些面板的，需要先启用外部控制器，地址会自动带上控制器和密钥。

在线面板（github.io 网址）安全吗？

在线面板是纯前端页面，运行在你的浏览器中，直接连接你的内核，不会把数据发到面板网站。但使用 HTTPS 网页连接 HTTP 控制器时，浏览器可能拦截，需要允许不安全内容或使用本地面板。

还没安装 Mihomo（Clash.Meta 内核）？

最新版 v1.19.33，直链 GitHub 官方安装包。

前往下载