Linux 一键安装 Clash

• 默认安装 mihomo 内核，可选安装 clash。
• 支持使用 subconverter 进行本地订阅转换。
• 多架构支持，适配主流 Linux 发行版：CentOS 7.6、Debian 12、Ubuntu 24.04.1 LTS。

快速开始

环境要求

• 用户权限：root 或 sudo 用户。普通用户请戳：#91
• shell 支持：bash、zsh、fish。

一键安装

目前 master 分支仅适用于 x86_64 架构且使用 systemd 的系统环境，其他初始化系统 / 架构请使用 feat-init 分支：一键安装-多架构

git clone --branch master --depth 1 https://gh-proxy.com/https://github.com/nelvko/clash-for-linux-install.git \
  && cd clash-for-linux-install \
  && sudo bash install.sh

如遇问题，请在查阅常见问题及 issue 未果后进行反馈。

• 上述克隆命令使用了加速前缀，如失效请更换其他可用链接。
• 默认通过远程订阅获取配置进行安装，本地配置安装详见：#39
• 没有订阅？click me

命令一览

Usage: 
  clashctl COMMAND [OPTIONS]

Commands:
    on                    开启代理
    off                   关闭代理
    proxy                 系统代理
    ui                    面板地址
    status                内核状况
    tun                   Tun 模式
    mixin                 Mixin 配置
    secret                Web 密钥
    update                更新订阅
    upgrade               升级内核

Global Options:
    -h, --help            显示帮助信息

💡clashon 同 clashctl on，Tab 补全更方便！

优雅启停

$ clashon
😼 已开启代理环境

$ clashoff
😼 已关闭代理环境

• 在启停代理内核的同时，自动同步设置系统代理。
• 亦可通过 clashproxy 单独控制系统代理。

Web 控制台

$ clashui
╔═══════════════════════════════════════════════╗
║                😼 Web 控制台                  ║
║═══════════════════════════════════════════════║
║                                               ║
║     🔓 注意放行端口：9090                      ║
║     🏠 内网：http://192.168.0.1:9090/ui       ║
║     🌏 公网：http://255.255.255.255:9090/ui   ║
║     ☁️ 公共：http://board.zash.run.place      ║
║                                               ║
╚═══════════════════════════════════════════════╝

$ clashsecret 666
😼 密钥更新成功，已重启生效

$ clashsecret
😼 当前密钥：666

• 通过浏览器打开 Web 控制台，实现可视化操作：切换节点、查看日志等。
• 若暴露到公网使用建议定期更换密钥。

升级内核

$ clashupgrade
😼 请求内核升级...
{"status":"ok"}
😼 内核升级成功

• 代理内核会自动处理升级流程，并从 GitHub 获取最新软件包。为避免因网络原因导致拉取失败，建议为相关域名配置代理规则。
• 可使用 -v 参数查看代理内核的升级日志。

更新订阅

$ clashupdate https://example.com
👌 正在下载：原配置已备份...
🍃 下载成功：内核验证配置...
🍃 订阅更新成功

$ clashupdate auto [url]
😼 已设置定时更新订阅

$ clashupdate log
✅ [2025-02-23 22:45:23] 订阅更新成功：https://example.com

• clashupdate 会记住上次更新成功的订阅链接，后续执行无需再指定。
• 可通过 crontab -e 修改定时更新频率及订阅链接。
• 通过配置文件进行更新：pr#24

Tun 模式

$ clashtun
😾 Tun 状态：关闭

$ clashtun on
😼 Tun 模式已开启

• 作用：实现本机及 Docker 等容器的所有流量路由到 clash 代理、DNS 劫持等。
• 原理：clash-verge-rev、 clash.wiki。
• 注意事项：#100

Mixin 配置

$ clashmixin
😼 查看 Mixin 配置

$ clashmixin -e
😼 编辑 Mixin 配置

$ clashmixin -o
😼 查看原始订阅配置

$ clashmixin -r
😼 查看运行时配置

• 通过 Mixin 自定义的配置内容会与原始订阅深度合并生成运行时配置，其中 Mixin 的优先级最高。
• Mixin 可通过前置、后置或覆盖方式，对原始订阅中的规则、节点和策略组进行新增或修改。
• 内核启动时加载的是运行时配置，因此直接修改原始订阅内容并不会生效。

卸载

sudo bash uninstall.sh

常见问题

wiki

引用

• Clash 知识库
• Clash 家族下载
• Clash Premium
• mihomo
• subconverter: 订阅转换
• yacd: Web 控制台
• yq: 处理 yaml

Star History

Thanks

@鑫哥

特别声明

1. 编写本项目主要目的为学习和研究 Shell 编程，不得将本项目中任何内容用于违反国家/地区/组织等的法律法规或相关规定的其他用途。
2. 本项目保留随时对免责声明进行补充或更改的权利，直接或间接使用本项目内容的个人或组织，视为接受本项目的特别声明。