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

📊

访问和打开 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)管理配置文件,方便追踪变更和回滚。

评论

💬

评论功能即将上线,敬请期待!