项目
在 GitHub 查看
JohanChane/clashtui
JohanChane/clashtui has 715 GitHub stars and 30 forks. GitHot measured +1 stars in 24 hours. Last checked 2026-11-15 18:45 UTC. Last push 2026-11-08.
可以做什么
- Dual Core Support — Compatible with both Mihomo and sing-box; switch anytime in the UI
- Subscription Management — Supports File, URL, and Template (ClashTui template) profile types
- Proxy Switching — Switch by group or by node, with latency testing
- Connection Monitoring — View all active connections in real time; close individual or all connections
实测星标增长
- 24小时
- +1
- 7天
- 更新延迟
- 15天
- 更新延迟
- 1个月
- 更新延迟
各周期内的星标净变化,周期相互重叠,并非每日新增。缺失的测量保持空白。星标代表关注度,不代表软件质量。
关于
Mihomo (Clash.Meta) / sing-box TUI Client
开发工具README_ZH.md
原文ClashTui
ClashTui 是一个终端用户界面(TUI)代理管理工具,支持 Mihomo(Clash.Meta)和 sing-box 两种代理核心。你可以在终端里完成切换节点、更新订阅、管理连接和控制服务启停等操作。
特性
- 双核心支持 — 同时兼容 Mihomo 和 sing-box,可在界面中随时切换
- 订阅管理 — 支持 File、URL、Template (ClashTui 的 template) 三种 profiles。
- 代理切换 — 按组/按节点切换,支持延迟测试
- 连接监控 — 实时查看所有活动连接,可关闭单个或全部连接
- 服务控制 — 通过 systemd 管理核心的启动、停止和重启
- 日志查看 — 在界面内实时查看核心日志
- 命令行模式 — 支持
profile、mode、service、update等子命令,适合脚本和自动化 - 配置覆盖 — 通过
core_override_config在不修改订阅原始文件的前提下改写最终配置 - Template 模板 — 用模板 + 节点分组自动生成配置文件,支持变量展开 (对 singbox 建议使用该功能, 能解决烦人的配置的版本问题)
- 自定义按键 — 每个标签页的快捷键都可以通过
keymap.yaml自行定义 - 自定义主题 - 通过
theme.yaml自行定义 - which panel - 方便用户操作
- 支持 fzf - 用户可以使用 fzf 进行选择
支持的平台
- Linux
- macOs
- Windows
安装
依赖
Linux and macOS:
- sudo
- fzf
Windows:
- nssm
想开启 tun 并有 root 权限
Linux
- [可选] 从仓库中安装 mihomo 和 clashtui:
sudo pacman -S mihomo sing-box clashtui # ArchLinux
这一步的目的是保证当前环境中包含 mihomo, sing-box 和 clashtui,这样安装脚本会跳过安装它们的步骤。你也可以手动下载这两个工具,然后运行 which mihomo sing-box clashtui 来检查是否已正确配置。
- 运行安装脚本
bash <(curl -fsSL https://raw.githubusercontent.com/JohanChane/clashtui/refs/heads/main/installs/install) --core all
提示:由于安装脚本使用的资源是从 GitHub 上下载的,所以如果总是下载失败,可以先开启代理再运行脚本。
- [可选] 将
clashtui_mihomo.service/clashtui_singbox.service设置为开机启动
sudo systemctl enable clashtui_mihomo.service
# OR
sudo systemctl enable clashtui_singbox.service
macOS
- [可选] 从仓库中安装 mihomo 和 clashtui:
brew install mihomo sing-box # 目前 clashtui 还没有上传, 请手动安装 clashtui
- 运行安装脚本
和 Linux 一样
- [可选] 将
clashtui_mihomo.service/clashtui_singbox.service设置为开机启动
sudo launchctl load -w /Library/LaunchDaemons/clashtui_mihomo.plist
# 或
sudo launchctl load -w /Library/LaunchDaemons/clashtui_singbox.plist
Windows
- [可选] 从仓库中安装 mihomo 和 clashtui:
scoop install mihomo sing-box clashtui
# 验证
Get-Command mihomo sing-box clashtui
- 运行安装脚本
# 默认安装到 D:\ClashTui
irm https://raw.githubusercontent.com/JohanChane/clashtui/refs/heads/main/installs/install.ps1 | iex
# 安装到自定义目录 (路径不能有空格)
iex "& {$(irm https://raw.githubusercontent.com/JohanChane/clashtui/refs/heads/main/installs/install.ps1)} -Core all -InstallDir 'D:\MyTools\ClashTui'"
# 只安装 mihomo core
iex "& {$(irm https://raw.githubusercontent.com/JohanChane/clashtui/refs/heads/main/installs/install.ps1)} -Core mihomo"
- 启动 clashtui 安装 clashtui_mihomo/clashtui_singbox 服务
安装脚本不注册 Windows Service。启动 clashtui 后,使用 CoreSrvCtl 安装并启动 core 服务。 将其中一个服务设置为开机启动即可 (不要两个同时开机启动)
没有 root 权限 (不开启 tun)
Linux
bash <(curl -fsSL https://raw.githubusercontent.com/JohanChane/clashtui/refs/heads/main/installs/install) --core all --is-user
开机启动:
systemctl --user enable clashtui_mihomo.service
# 或
systemctl --user enable clashtui_singbox.service
macOS
bash <(curl -fsSL https://raw.githubusercontent.com/JohanChane/clashtui/refs/heads/main/installs/install) --core all --is-user
开机启动:
launchctl load -w ~/Library/LaunchAgents/clashtui_mihomo.plist
# 或
launchctl load -w ~/Library/LaunchAgents/clashtui_singbox.plist
FAQ
- 文件权限之类的问题: 因为 clashtui 需要用到组权限, 所以请重新登录使组权限生效。
- connection refused 的问题: 比如: mihomo, 请使用
netstat -utapln | grep 9090检查 clash api 端口有没有打开。
文档
| 文档 | 说明 |
|---|---|
| 使用指南 | 详细使用教程:界面操作、命令行、订阅管理、配置说明、常见问题 |
| 手动安装 | system/user 模式手动安装步骤 |
| 功能设计 | 功能设计文档:配置结构、订阅管理、Template 展开、sing-box 合并算法 |
| 架构 | 代码架构文档:模块结构、启动流程、TUI 事件循环、Tab 体系 |
| 开发约定 | 分支命名、提交规范、CHANGELOG 约定 |
参与开发
欢迎提交 Issue 和 Pull Request。参与开发前请先阅读开发约定。
快速了解项目, 加入开发: