Clash Controller
一个基于 Textual 构建的、功能丰富的 clash 文本用户界面(TUI)控制器,方便在终端中管理和监控一个或多个 clash 实例。
功能特性
- 现代 TUI 界面:统一页面骨架(顶栏返回 / 折叠菜单 / 底部提示栏 + 状态栏),全键盘 + 全鼠标操作,数据行单击选中、双击执行,非阻塞异步加载与应用内日志。
- 多端点管理:
- 自动保存连接过的 Clash 端点(地址与密钥)。
- 启动时进入类似首页的居中大 LOGO 档案选择页,支持新增 / 编辑 / 删除。
- 支持 HTTP 与 Unix Domain Socket 连接。
- 远程端点支持 SSH 部署(密码 / 私钥文件 / 私钥文本三种认证)。
- 实时监控面板:
- 概览:合并流式监控与连接管理,在一个页面同时显示上/下行流量、内存使用、内核版本,并带每秒自动刷新的当前活动连接表与累计流量;连接表支持关键字(地址 / 规则 / 节点 / 进程)、节点、隐藏 DIRECT 筛选,以及按默认(API 原始顺序)、上/下载速度、流量、时长、地址、规则、节点排序(可切换升/降序)。
- 节点管理:按策略组浏览组内成员(节点 / 嵌套组 / DIRECT / REJECT),显示服务端记录的最新延迟、失败与未测状态;支持单节点测速、整组测速、在组内手动指定当前节点,以及对 URLTest / 故障转移组恢复自动(清除固定选择)。provider 节点测速自动走 provider 作用域接口。
- 配置管理:维护配置提供方列表,一键拉取远端配置、比对时间戳/哈希、部署到目标端点(本地或 SSH)并重载。
- 设置菜单:端点名称置于顶栏,TUN 与规则/全局/直连模式在面板内直接通过 Switch 和 Select 下拉列表即时生效切换(无需手动保存)、重载 GEO、重启 Clash、在线升级内核 / UI / GEO,以及查看运行日志。
界面与快捷键
| 场景 | 快捷键 | 作用 |
|---|---|---|
| 端点选择(根屏) | ↑ / ↓ · 回车 或 单击 |
移动光标 · 连接所选端点 |
1-9 |
按数字直达连接第 N 个端点 | |
Ctrl+N / Ctrl+E / Ctrl+D |
新增 / 编辑 / 删除端点配置 | |
Ctrl+R |
刷新列表 | |
Esc / Ctrl+C |
退出程序 | |
| 主菜单 | 1 / 2 / 3 / 4 / 5 |
直达概览 / 节点 / 配置管理 / 设置 / 切换端点 |
↑ / ↓ · 回车 |
移动光标 · 确认 | |
Esc / Ctrl+C |
退出程序(切换端点请按 5) |
|
| 概览 | ↑ / ↓ / PgUp / PgDn |
滚动连接表 |
/ |
聚焦筛选输入框(地址 / 规则 / 节点 / 进程) | |
Tab / Shift+Tab |
在筛选框、节点 / 排序下拉、隐藏 DIRECT 开关间轮切 | |
Ctrl+R |
刷新(焦点在输入框时让位给文本编辑) | |
| 节点 | ↑ / ↓ · 回车 或 双击行 |
移动光标 · 在组内指定所选节点 |
Ctrl+T |
测所选节点延迟 | |
Ctrl+G |
测整组延迟(URLTest / 故障转移组会清除固定选择,先确认) | |
Ctrl+U |
恢复自动(清除 URLTest / 故障转移组的固定选择) | |
/ |
聚焦节点名称筛选框 | |
Ctrl+R |
刷新策略组与延迟 | |
| 配置管理 | ↑ / ↓ · 回车 或 双击行 |
移动光标 · 部署所选提供方 |
Ctrl+N / Ctrl+E / Ctrl+D |
新增 / 编辑 / 删除提供方 | |
Ctrl+R |
刷新 | |
| 功能页通用 | Home / End / PgUp / PgDn |
页面 / 表格滚动 |
Tab / Shift+Tab |
表单字段轮切焦点 | |
Esc / Ctrl+C |
返回上一页 | |
Ctrl+Q |
任意界面直接退出程序 | |
| 弹窗 | 回车 |
提交(表单)/ 确认(危险操作需点按「确认」) |
Esc / Ctrl+C / 「取消」 |
取消并关闭 |
安装
pip install clash-controller
安装后,可以通过以下命令启动程序:
clashctl
需要 Python 3.10 及以上版本。
可选参数:
clashctl -D /path/to/config/dir # 指定配置目录(默认 ~/.config/clash-controller)
clashctl --debug # 启用 API / SSH 调试日志(显示在应用日志页)
开发者安装
git clone https://github.com/Moha-Master/clash-controller.git
cd clash-controller
python -m venv venv
source venv/bin/activate # 在 Windows 上使用 venv\Scripts\activate
pip install -e ".[dev]"
python -m clash_controller
要求
- Python 3.10+
- 运行中的 Clash 实例,已开启外部控制 API
许可证
MIT
Metadata
Release files for clash-controller 0.2.6
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| clash_controller-0.2.6.tar.gz | 59.4 kB | Without provenance | Details for clash_controller-0.2.6.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| clash_controller-0.2.6-py3-none-any.whl | Python 3 | none | any | Details for clash_controller-0.2.6-py3-none-any.whl |
Total release size: 126.6 kB
Release files / clash_controller-0.2.6.tar.gz
| Download URL | clash_controller-0.2.6.tar.gz |
|---|---|
| Size | 59.4 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
99c7c7380ddcbeb85f78b9094605c8920a6eb28f6300fb86dd29814a4ef3bf9c
|
|
BLAKE2b-256 checksum How to use checksums |
68470023a5bf4c454b12645a4f3d7604c3f83aecb0e8e331dd6e6d93bfc8f2f8
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.15.2
|
Release files / clash_controller-0.2.6-py3-none-any.whl
| Download URL | clash_controller-0.2.6-py3-none-any.whl |
|---|---|
| Size | 67.3 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
7947ea03d87a08efa0fd5a6e02af254ac634173ca2bcbf387170a9f0734093c1
|
|
BLAKE2b-256 checksum How to use checksums |
06a3d22d1128b36b33eba833c81d42614b1d4dc16e8ed0a7bab35ffba569ef83
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.15.2
|
Security for clash-controller 0.2.6
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.