Dashboard 是 Clash 客户端的图形管理界面，无法访问时无法进行节点切换和规则配置，本文提供系统化的排查思路，帮助快速恢复 Dashboard 正常访问。
检查 Dashboard 配置是否正确
Dashboard 无法连接的首要原因是配置文件参数错误，Clash 核心配置中需要正确设置 external-controller 参数，指定 Dashboard 监听地址和端口。
external-controller: 127.0.0.1:9090 external-ui: ./dashboard
配置要点：
- 监听地址建议使用
0.0.1（仅本机访问）或0.0.0（局域网访问） - 端口默认 9090，确保未被其他程序占用
external-ui指向 Dashboard 静态文件目录路径
修改配置后记得重启 Clash 核心,使配置生效。
端口占用与防火墙排查
即使配置正确，端口被占用或防火墙拦截也会导致 Dashboard 无法连接。
排查步骤：
- 使用命令
netstat -ano | findstr 9090检查端口占用情况 - 若端口被占用，修改配置文件中的端口号后重启
- 关闭防火墙测试，或在防火墙中添加规则放行对应端口
Windows 用户注意：系统防火墙可能阻止 Clash 进程监听端口,需在防火墙设置中允许通过。
客户端版本兼容性问题
部分旧版 Clash 客户端存在 Dashboard 兼容性问题,建议使用最新版本：
- Windows：推荐 Clash Verge Rev，从 GitHub Release 页下载
- Mac：ClashX 或 ClashX Pro，M 系列芯片选 arm64 版本
- Android：FlClash 或 Clash for Android，华为设备需手动下载 APK 安装
客户端版本过旧可能导致 external-controller 接口不兼容，更新后一般可解决 Dashboard 无法连接问题。
TUN 模式与系统代理的区别
理解两种模式有助于定位问题：
| 特性 | TUN 模式 | 系统代理 |
|---|---|---|
| 流量接管 | 所有流量（含 UDP/游戏） | 仅 HTTP/HTTPS |
| 配置复杂度 | 需额外配置 TUN 网卡 | 直接启用 |
| Dashboard 访问 | 需确保 TUN 接口正常 | 通常无影响 |
若使用 TUN 模式后 Dashboard 无法连接，可能是 TUN 网卡配置异常,尝试切换回系统代理模式测试。
FAQ：常见问题速查
现象：浏览器访问 127.0.0.1:9090 显示拒绝连接
- 原因：Clash 核心未启动或配置未生效
- 解决：确认 Clash 核心进程运行中，检查配置文件语法
现象：局域网其他设备无法访问 Dashboard
- 原因：external-controller 绑定地址为 127.0.0.1
- 解决：改为
0.0.0:9090，并注意局域网防火墙规则
现象：Dashboard 页面加载但节点列表为空
- 原因：订阅链接未正确加载或节点已失效
- 解决：检查订阅链接有效性，重新更新订阅
节点选择建议：日常办公访问国际学术资源，建议选择普通中转节点，延迟 100ms 以内稳定性较好；4K 视频需求则需要高带宽专线，选择节点服务商时，关注其是否提供实时客服和节点刷新频率,避开跑路风险较高的免费渠道。
