clashctl

Linux 上的 Mihomo / Clash 安装与管理工具
_{（原 clash-for-linux-install）}

✨ 特性

• 开箱即用：一键部署 mihomo 内核、Web 面板及运行依赖。
• 广泛兼容：支持 root 与普通用户，适配主流 Linux 发行版及容器环境。兼容 systemd、OpenRC 等服务方式，提供 Bash、Zsh 和 Fish 命令集成。
• 功能丰富：涵盖代理开关、内核启停、状态查看、日志追踪等常用操作，支持 Web 面板、TUN 模式、内核升级及 Mixin 配置。
• 订阅管理：支持多订阅添加、切换与更新，集成 subconverter 实现订阅格式转换。

📦 安装

首次安装或从旧版升级，执行以下命令（已加速）：

GH_PROXY=https://gh-proxy.org/
curl -fsSL "${GH_PROXY}https://raw.githubusercontent.com/nelvko/clashctl/HEAD/install.sh" | \
  bash -s -- --gh-proxy "$GH_PROXY"

• GH_PROXY：GitHub 下载加速代理，失效时可更换其他可用地址。
• 没有订阅？click me

🚀 快速上手

添加并启用订阅（安装时已配置可跳过）：

clashctl sub add --use "<订阅链接>"

开启当前终端代理：

# 自动启动内核，并开启当前终端代理
clashctl on

# 测试连通性
curl -I https://www.google.com

⌨️ 命令一览

Usage:
  clashctl COMMAND [OPTIONS]

Commands:
  on                    启用当前终端代理，自动启动内核
  off                   关闭当前终端代理，保留内核运行
  start                 仅启动内核
  stop                  仅停止内核
  status                内核状态
  ui                    面板地址
  sub                   订阅管理
  node                  节点切换
  tun                   Tun 模式
  mixin                 Mixin 配置
  secret                Web 密钥
  log                   查看日志
  upgrade               升级内核
  update                更新 clashctl
  version               脚本和内核版本

Global Options:
  -h, --help            显示帮助信息
  -v, --version         显示版本信息

使用示例与进阶配置，详见 Wiki。

🔄 更新

# 更新 clashctl 上游版本
clashctl update

# 升级代理内核
clashctl upgrade

🗑️ 卸载

# 清理当前 Shell 的代理环境变量（卸载脚本无法清理）
clashctl off

# 执行卸载脚本
bash "$CLASHCTL_HOME/uninstall.sh"

卸载会删除安装目录及其数据，需要保留的内容请提前备份。.clashctl-backups/ 中的恢复资料会保留，确认无需回退后可手动清理。

📖 文档

• Wiki
• 常见问题

⭐ Star History

⚠️ 特别声明

• 编写本项目主要是为了学习和研究 Shell 编程，不得将项目内容用于违反适用法律法规及相关规定的活动。
• 本项目保留对本声明进行补充或修改的权利。使用本项目前，请阅读并遵守本声明。