Appearance
clashtui 快速配置与详细使用指南
clashtui 是一款专为极客和服务器管理员打造的 TUI (Terminal User Interface，终端用户界面) 代理客户端。顾名思义，它抛弃了臃肿的图形界面 (GUI)，完全运行在您的命令行终端里。
基于成熟的 Clash/Mihomo 内核，它可以通过键盘快捷键在终端画出的“界面”中实现节点的切换、订阅更新与路由策略管理。对于那些重度使用 Linux 服务器、没有桌面环境，或者纯粹追求键盘流操作的极客用户来说，clashtui 是目前体验最好的命令行翻墙方案之一。
1. 软件下载与运行环境准备
clashtui 是一个纯粹的命令行交互工具，通常由 Rust 或 C++ 编写，您需要通过终端指令进行安装。
第一步：获取与安装
根据您的操作系统，最直接的方式是使用包管理器或去 Github 获取预编译好的二进制文件。
- Arch Linux 用户：可以直接通过 AUR 安装（如
yay -S clashtui）。 - 其他 Linux / Mac 用户：前往其 GitHub Release 页面，下载对应架构的压缩包。
- 解压后，将其中的二进制文件（通常名为
clashtui）移动到您的环境变量路径下，例如：bashsudo mv clashtui /usr/local/bin/ sudo chmod +x /usr/local/bin/clashtui
第二步：准备底层内核
clashtui 只是一个前端控制面板，它需要调用底层的内核来完成实际的代理工作。 请确保您的系统中已经安装并配置好了 clash 或 mihomo (Clash.Meta) 二进制核心，并将其路径正确填写到 clashtui 的初始化配置文件中（通常位于 ~/.config/clashtui/）。
2. 获取机场订阅链接
在终端里使用代理，同样需要稳定的节点来源。
- 登录您所购买的机场服务商后台（如果没有优质节点，强烈建议参考 👉 2026 高端抗封锁机场精选 选购）。
- 在控制面板中找到 “一键订阅”。
- 请点击 “复制 Clash 订阅链接” 或者 “复制 Clash.Meta 订阅”。因为底层依然是 Clash 内核，常规链接完全通用。
3. 在终端中导入节点并开启代理
当您的环境变量和配置文件都就绪后，打开终端，输入 clashtui 并回车即可启动。以下是终端下的核心操作逻辑：
步骤一：添加订阅 (Profile)
在 TUI 界面中，使用方向键导航，按下特定的快捷键（通常是 i 或进入 Profiles 菜单选项）来添加新的订阅地址。将您在机场后台复制的 URL 粘贴进去并保存为对应的 .yaml 文件配置。
步骤二：更新与下载节点
选中您刚刚添加的配置项目，按下对应的更新快捷键（如 u 或 Enter 触发动作），程序会在后台使用 curl 或内置网络组件将节点文件下载到本地目录。
步骤三：载入配置与启动内核
在配置列表中按下 Enter 键载入该配置，clashtui 会通过 API 与后台正在运行的 clash/mihomo 内核通信，让其重新加载这份新的节点配置。
步骤四：在面板中切换节点
使用快捷键 Tab 或数字键切换到 代理 (Proxies) 选项卡。在这里您可以看到所有节点。使用键盘 ↑ ↓ 选择延迟最低的节点并按 Enter 切换。
步骤五：设置终端环境变量代理
内核运行后，还需要让终端知道通过 7890 端口走代理。您需要在终端外壳 (Bash/Zsh) 执行：export http_proxy="http://127.0.0.1:7890"export https_proxy="http://127.0.0.1:7890"
之后，您的终端就可以无障碍 wget 或 git clone 境外资源了。
4. 进阶玩法：通过 TUN 模式实现 Linux 透明代理
在 Linux 环境下，配置环境变量 http_proxy 往往对很多复杂的网络调用不生效（如 Docker pull, Pterodactyl 等）。借助 Mihomo 内核的 TUN 模式，clashtui 可以帮您管理真局域网级别的透明代理。
- 内核配置：确保您的内核二进制文件具有最高权限（或授予其 CAP_NET_ADMIN 权限：
sudo setcap cap_net_admin=ep /usr/local/bin/mihomo）。 - TUI 调整：在 clashtui 的配置文件中启用 TUN 功能。一旦启动内核，它会自动创建名为
utun的虚拟网卡接管系统底层路由表，无需再繁琐地配置export命令，服务器所有出站流量均会自动科学上网。
5. 常见问题排查与 FAQ
对于使用 TUI 的高阶玩家来说，问题往往出在环境配置上：
1. 终端启动 clashtui 时提示“找不到 clash 内核进程”？
clashtui 需要通过 RESTful API (默认端口通常是 9090) 连接底层的内核。 解决办法：请确保您已经通过 Systemd 或手动后台运行了内核（如 mihomo -d ~/.config/clash/），或者在 clashtui 配置文件中正确指定了内核的绝对路径让它代为拉起进程。
2. 更新订阅时终端疯狂报错，或者没有任何反应？
这通常是因为 Linux 服务器本身由于某些网络原因无法解析机场订阅域名的 DNS，导致 curl 请求失败。 解决办法：先手动在命令行尝试使用现有的环境变量代理更新配置，或者在另一台能够翻墙的电脑上把下载好的 .yaml 文件通过 SCP 传到服务器的 profiles 目录下。
3. clashtui 界面显示乱码或边框错位怎么办？
TUI 依赖于终端的字体渲染和字符集编码。 解决办法：请确保您的终端环境使用的是 UTF-8 编码（如 export LANG=en_US.UTF-8），并使用了兼容 Nerd Fonts 的编程字体。如果是在较老的 Putty 客户端上使用，可能会有线框显示异常。
4. 系统代理或环境变量设置了，为什么 Docker 拉镜像还是卡住？
Docker 的 Daemon 服务 (守护进程) 并不读取用户层面的 Bash 环境变量（export http_proxy 对它无效）。 解决办法：您需要为 docker 的 systemd 服务单独配置 proxy 参数，或者更简单粗暴的方式：直接在内核开启 TUN 模式接管底层路由。
5. 如何熟练掌握所有的快捷键操作？
在 clashtui 的任何主界面按下 ? 或 h 键，通常会呼出帮助面板，里面罗列了所有的视图切换和动作快捷键。熟练记忆后，您的操作效率将远超点击鼠标。