客户端下载与教程

clashtui 下载与使用教程

先选择 clashtui 的当前发布版和对应设备文件,再按教程完成安装、订阅导入与连接。

更新

直接答案

直接答案

clashtui 可在 Windows、macOS、Linux 使用,容易上手。当前发布版为 v0.3.1,按设备和处理器选择文件后即可跟随教程导入订阅。

开始前确认

这个客户端适不适合你

支持设备
  • Windows
  • macOS
  • Linux
上手难度
容易上手
适合谁
适合第一次在 Windows、macOS、Linux 配置订阅,希望从安装一路做到连接成功的人。
开始前提示
先按设备下载安装,再导入订阅、选择节点并检查连接;按钮名称和位置以当前版本界面为准。

来源与下载

最新版 v0.3.1

查看 GitHub 发布说明
Windows2 个文件
macOS2 个文件
Linux2 个文件

安装与配置

clashtui 下载与使用教程 · 通用配置路径

clashtui 目前没有与当前界面逐步对应的安全截图。这一页只提供 Windows、MacOS、Linux 的设备与软件类型通用路径,不会套用其他客户端的按钮名称。界面可能随版本变化,具体入口以软件当前说明为准。

  1. 确认配置格式

    先查看 clashtui 当前版本的项目文档,确认配置格式、必填字段和校验方法。普通订阅地址不一定能直接读取,不执行来源不明的转换脚本。

    完成后会看到

    配置来源和格式已经核对,并且保留原网络设置。

    卡住时先检查
    • 订阅已经到期或地址曾经泄露,继续操作只会得到空列表或更新错误。
    • 没有先确认设备平台和恢复方法,连接失败后不知道怎样回到原网络。
  2. 确认来源并安装

    从页面列出的项目来源进入 clashtui 安装说明,再按当前设备的平台、CPU 架构和版本选择官方包、包管理器或配置方式。移动端、桌面端与路由器端的步骤不能互相套用。

    完成后会看到

    clashtui 能正常打开,来源与设备平台已经核对。

    卡住时先检查
    • 下载了不适合当前平台或架构的 clashtui 文件,安装程序无法运行。
    • 从转载页取得旧版本,界面与当前项目文档无法对应。
  3. 按项目文档导入

    先按 clashtui 的项目文档准备配置文件或订阅,再从终端界面载入。终端中的快捷键和路径以当前版本帮助页为准,不照搬图形客户端菜单。

    完成后会看到

    配置已经通过项目文档要求的语法或启动前检查。

    卡住时先检查
    • 订阅地址缺少字符、夹带空格或已经失效,配置无法更新。
    • 软件要求配置文件,但输入的是普通订阅 URL,导入方式彼此不兼容。
  4. 载入配置并观察状态

    在 clashtui 中载入已经校验的配置,按当前帮助页选择运行方式并观察状态输出。先让一个终端请求经过代理,确认退出快捷键与恢复方法有效。

    完成后会看到

    终端测试请求成功,退出后原网络恢复。

    卡住时先检查
    • 配置已经导入却没有选中活动节点,开启连接后仍然没有可用出口。
    • 同时修改代理模式、DNS 和系统权限,失败后难以定位具体原因。
  5. 验证端口与退出路径

    按 clashtui 的项目文档检查监听地址、端口和日志,只让一个测试请求经过代理。停止进程后再次确认原网络与 DNS 已恢复。

    完成后会看到

    测试请求与停止恢复均成功,错误日志已经留存。

    卡住时先检查
    • 只测试受地区限制的目标,无法区分客户端配置和目标服务本身的问题。
    • 测试后没有关闭代理并检查恢复路径,原网络异常时缺少参照。

连接不成功

按现象继续排查

先找到最接近的现象,再逐项检查。这样比反复重装客户端更快。

软件资料说明

clashtui 适用于 Windows、MacOS、Linux。项目仍在维护,安装前请确认当前版本支持你的设备。

进入下载区查看可用版本和安装入口,安装后按教程导入订阅并完成连接测试。