ClashX Dashboard 使用指南:可视化管理你的代理

Article 9 cover image

訪問和打开 Dashboard

ClashX Dashboard 是一个强大的 Web 控制面板,让你能够通过可视化界面实时監控和管理代理連接。相比菜单栏的简单操作,Dashboard 提供了更详细的信息和更精细的控制能力。

快速訪問方式

有多种方式可以打开 ClashX Dashboard:

方法 1
点击菜单栏图标 > 控制台
方法 2
浏览器訪問 127.0.0.1:9090/ui
方法 3
使用快捷键打开(可自定义)

首次訪問设置

首次打开 Dashboard 时,需要进行简单的初始化设置:

初始化步骤

1. Dashboard 会自動检测 ClashX 的 API 端口(默认 9090)

2. 如需要,输入 API Secret(在配置文件中设置)

3. 选择语言和主题(支持亮色/暗色模式)

4. 点击連接,即可进入主界面

🔐
安全提示

Dashboard 默认只能从本机訪問(127.0.0.1)。如需从其他设备訪問,需要在配置文件中设置 external-controller 和 secret,并确保网络环境安全。

Dashboard 界面介绍

主要功能模块

Dashboard 界面分为五个主要功能區域,每个區域都提供了不同的管理功能:

模块 主要功能 使用频率
概览 系統状态、流量统计、快速设置 高频使用
代理 节点选择、延迟测试、策略组管理 高频使用
規則 查看規則列表、規則匹配状态 中频使用
連接 实时連接監控、連接详情查看 高频使用
日志 实时日志查看、请求记录分析 調試时使用

概览页面详解

概览页面是 Dashboard 的核心,展示了最重要的实时信息:

  • 流量统计:实时上传/下載速度、总流量使用量
  • 活动連接数:当前活跃的网络連接数量
  • 代理模式:快速切换全局/規則/直连模式
  • 系統代理:一键启用/禁用系統代理
  • 流量图表:可视化显示历史流量趋势

快速操作面板

在概览页面,你可以快速执行常用操作:切换代理模式、测试所有节点延迟、刷新配置、清空連接记录等,无需在多个页面間切换。

实时流量監控功能

流量图表分析

Dashboard 提供了直观的实时流量可视化功能,帮助你了解网络使用情况:

上传速度
1.2 MB/s
下載速度
5.8 MB/s
总上传
2.4 GB
总下載
18.6 GB

流量数据解读

通过流量監控,你可以发现和解决各种問題:

  • 异常流量检测:后台程序的异常上传/下載
  • 带宽使用分析:识别占用带宽最多的連接
  • 峰值时段统计:了解流量使用高峰期
  • 配额管理:監控接近流量限额的情况

图表自定义选项

Dashboard 支持多种图表显示方式:

📈
图表设置

• 时間范围:可选择显示最近 1 分钟、5 分钟、15 分钟的数据• 图表类型:折线图、面积图、柱状图• 数据单位:自動切换 KB/s、MB/s、GB/s• 刷新频率:可调整更新間隔(500ms - 5s)

連接管理和查看活动連接

連接列表功能

連接页面显示所有通过 ClashX 的网络連接,提供详细的連接信息:

字段 说明 示例
Host 目标域名或 IP 地址 google.com:443
Network 协议类型 TCP / UDP
Type 連接类型 HTTP / HTTPS / SOCKS5
Chains 使用的代理链 DIRECT / Proxy / Reject
Rule 匹配的規則 DOMAIN-SUFFIX,google.com
Speed 上传/下載速度 ↑12KB/s ↓156KB/s
Source 发起連接的进程 Chrome.app

連接过滤和搜索

当連接数量较多时,可以使用强大的过滤功能:

过滤选项

• 按主机名搜索:快速找到特定域名的連接

• 按代理类型过滤:只显示 DIRECT、PROXY 或 REJECT 的連接

• 按协议过滤:仅显示 TCP 或 UDP 連接

• 按进程过滤:查看特定应用的所有連接

連接操作

Dashboard 允许你对单个或批量連接进行管理:

  • 关闭連接:立即终止选中的連接
  • 清空所有:一键关闭所有活动連接
  • 查看详情:点击連接查看完整的元数据
  • 复制信息:快速复制主机名、IP 等信息
💡
調試技巧

如果某个网站无法訪問,可以在連接列表中搜索该域名,查看它匹配了哪条規則、使用了什么代理,这是排查問題的最快方法。

規則調試和規則匹配查看

規則列表展示

規則页面以清晰的格式展示所有配置的分流規則:

規則信息

DOMAIN-SUFFIX,google.com,Proxy
DOMAIN-KEYWORD,youtube,Proxy
GEOIP,CN,DIRECT
IP-CIDR,192.168.0.0/16,DIRECT
FINAL,Proxy

規則匹配测试

Dashboard 提供了規則测试功能,帮助你验证規則配置:

  1. 在規則页面顶部输入要测试的域名或 IP
  2. 系統会按顺序匹配所有規則
  3. 高亮显示匹配的第一条規則
  4. 展示该请求会使用的代理策略
🔍
規則調試示例

测试 "twitter.com" 时,如果高亮显示 "DOMAIN-SUFFIX,twitter.com,Proxy",说明该域名会通过 Proxy 策略组訪問。如果匹配到 FINAL 規則,则说明没有其他規則匹配成功。

規則性能分析

部分 Dashboard 版本提供規則性能统计:

規則总数
2,847
域名規則
2,134
IP 規則
658
平均匹配时間
< 1ms

实时規則匹配日志

结合日志页面,可以看到每个请求的規則匹配过程:

日志示例

[INFO] TCP 127.0.0.1:54321 → google.com:443 match DOMAIN-SUFFIX(google.com) using Proxy
[INFO] TCP 127.0.0.1:54322 → baidu.com:443 match GEOIP(CN) using DIRECT
[WARN] TCP 127.0.0.1:54323 → ad.doubleclick.net:443 match DOMAIN-KEYWORD(ad) using REJECT
性能優化建议

規則顺序很重要!将最常用的規則放在前面可以减少匹配时間。使用 DOMAIN-SUFFIX 比 DOMAIN-KEYWORD 更高效。过多的規則会影响性能,建议控制在 5000 条以内。

Dashboard 设置和自定义

外观自定义

Dashboard 提供了丰富的个性化选项:

  • 主题模式:亮色、暗色、自動切换(跟随系統)
  • 语言设置:中文、英文、日语等多语言支持
  • 字体大小:小、中、大三种尺寸
  • 配色方案:多种主题色可选

功能配置

根据使用需求调整 Dashboard 的功能选项:

选项 说明 推荐设置
自動刷新連接 实时更新連接列表 开启(1-2 秒間隔)
自動关闭連接 自動清理已完成的連接 关闭(手动管理)
日志級别 控制日志详细程度 INFO / DEBUG
流量图表 是否显示历史图表 开启
自動延迟测试 定期测试节点延迟 每 10 分钟

外部訪問配置

如果需要从其他设备訪問 Dashboard,需要修改配置文件:

External Controller 配置

# 在 config.yaml 中添加
external-controller: 0.0.0.0:9090
secret: "your-secret-key-here"

# 然后可以从局域网其他设备访问
# http://your-mac-ip:9090/ui
⚠️
安全警告

启用外部訪問时,务必设置强密码的 secret!否则任何能訪問该端口的人都可以控制你的代理设置。不要在公共网络中暴露 Dashboard。

键盘快捷键

Dashboard 支持多种快捷键提高操作效率:

⌨️
常用快捷键

• G → 切换到全局模式• R → 切换到規則模式• D → 切换到直连模式• T → 测试所有节点延迟• C → 清空所有連接• / → 快速搜索

数据导出功能

Dashboard 支持导出各种数据用于分析:

  • 連接记录:导出为 CSV 格式,包含所有連接详情
  • 流量统计:导出历史流量数据,制作报表
  • 日志文件:保存完整日志用于問題诊断
  • 規則快照:备份当前規則配置

最佳實踐

建议定期备份 Dashboard 配置和数据。将 ~/.config/clash 目录整体备份可以保留所有设置。使用版本控制(如 Git)管理配置文件,方便追踪变更和回滚。

评论

💬

评论功能即将上線,敬請期待!