🐧 Clash for Linux

💬 社区交流：Telegram 群

一个更完整、更优雅的 Linux Clash / Mihomo 运行平台。

✨ 核心特性

🚀 自动识别系统架构：自动下载并使用对应 Clash 内核
🧪 端口自动检测与分配：避免冲突
🔄 多订阅管理：可以保存多个订阅，通过 clashctl use 切换当前主订阅。
💫 节点选择：使用编号交互选择策略组和节点。
🌐 Tun 模式：用于透明代理接管场景。
🧠 Mixin 机制：可按需追加/覆盖 Clash 配置
👤 不同权限：兼容 root 与普通用户环境。
🔐 安全默认配置：自动生成或自定义 Secret
🩺 内置诊断工具（doctor）：快速排障

适用场景

Linux 云服务器（VPS / 远程开发环境）
本地开发环境（Ubuntu / Debian / WSL）
路由 / 轻量系统（OpenWrt / NAS / 小主机 x86 / ARM）
需要稳定访问 GitHub、Go / Node / Docker 生态的开发者
不希望手动维护 Clash 运行状态的用户

🚀 一键安装（推荐）

在终端中执行以下命令即可完成安装：

git clone --branch master --depth 1 https://ghfast.top/https://github.com/wnlen/clash-for-linux.git
cd clash-for-linux
bash install.sh

上述命令使用了加速前缀，如失效可更换其他可用链接。
可通过 .env 文件或脚本参数自定义安装选项。

⌨️ 命令一览

〽️ 常用命令
  clashon              🚀 开启代理
  clashoff             ⛔ 关闭代理
  clashctl select      💫 选择节点
🕹️  控制台
  clashui              🕹️  查看 Web 控制台
📦 订阅
  clashctl add         ➕ 添加订阅
  clashctl add local   ➕ 从 runtime/subscriptions 导入本地订阅
  clashctl use         💱 切换订阅
  clashctl ls          📡 查看订阅列表
🔐 密钥管理
  clashctl secret      🔑 查看密钥
  clashctl secret 123  🔐 设置密钥
📌 高级
  clashctl tun       🧪 Tun 模式管理
  clashctl boot      🚦 开机代理接管管理
  clashctl mixin     🧩 Mixin 配置管理
  clashctl relay     🔗 多跳节点管理
  clashctl sub       🧩 订阅高级管理（启用 / 禁用 / 重命名 / 删除）
  clashctl upgrade   🚀 升级当前或指定内核
  clashctl update    🔄 更新项目代码
📜 日志
  clashctl doctor    🩺 诊断面板
  clashctl log/logs  📜 查看日志

💡 显示更多帮助命令：clashctl -h
💡 更多高级能力：clashctl help advanced

🌐 Web 控制台

$ clashui
╔═══════════════════════════════════════════════╗
║                🐱 Web 控制台                  ║
║═══════════════════════════════════════════════║
║                                               ║
║     🔓 注意放行端口：9090                      ║
║     📶 状态：可访问                            ║
║     🏠 内网：http://192.168.0.1:9090/ui       ║
║     ☁️ 公共：http://board.zash.run.place      ║
║     🌏 公网：http://8.8.8.8:9090/ui           ║
║     🔑 密钥：dada289edb457b59                 ║
║                                               ║
╚═══════════════════════════════════════════════╝

$ clashsecret mysecret
🐱 密钥更新成功，已重启生效

$ clashsecret
🐱 当前密钥：mysecret

可通过浏览器打开 Web 控制台进行可视化操作，例如切换节点、查看日志等。
clashctl secret 与 clashsecret 都支持无参数查看、有参数直接设置。
默认使用 zashboard 作为控制台前端，如需更换可自行配置。
若需将控制台暴露到公网，建议定期更换访问密钥，或通过 SSH 端口转发方式进行安全访问。

OpenWrt 脚本模式

当前提供 OpenWrt 脚本模式兼容，适合 x86_64/amd64 与 aarch64/arm64 软路由或设备。该模式复用现有 script 运行后端，不包含 procd 开机自启、LuCI、UCI 或 opkg 包化支持，也不承诺 MIPS 与 armv7 设备可用。

建议先将项目放到持久化目录，避免放在 /tmp、/run 等重启会丢失的位置：

cd /root
git clone --branch master --depth 1 https://ghfast.top/https://github.com/wnlen/clash-for-linux.git
cd clash-for-linux

安装依赖：

opkg update
opkg install bash curl tar gzip coreutils-readlink unzip

安装与手动管理：

bash install.sh
clashon
clashctl status
clashoff

OpenWrt 下 root/system 安装会把 clashctl、clashon、clashoff 等命令入口写入 /usr/bin，运行状态、日志和内核二进制仍保存在项目目录的 runtime/ 下。仅脚本模式不会注册开机自启，设备重启后需要重新执行 clashon。

🧰 常用管理命令

多订阅管理

clashctl add <订阅链接> <名称>
clashctl use
clashctl ls
clashctl sub
clashctl sub list
clashctl sub enable <名称>
clashctl sub disable <名称>
clashctl sub rename <旧名称> <新名称>
clashctl sub remove <名称>

WSL / 普通用户如果无权写入 /etc/environment，clashon 会自动降级：运行时照常启动，当前 Shell 代理变量生效；系统代理持久接管和开机代理保持不可用。

本地配置导入

推荐使用交互导入，放置目录为：$PROJECT_DIR/runtime/subscriptions/

clashctl add local
# 输入：clash.yaml

实际等价于：

clashctl add "file://$PROJECT_DIR/runtime/subscriptions/clash.yaml"

进阶用法：也可以直接使用 file:// 绝对路径导入：

clashctl add "file:///绝对路径/clash.yaml" home

支持格式：

Clash / Mihomo YAML
Base64 订阅
分享链接（vmess / vless / trojan / tuic）

开机接管（内核 + 代理）

clashctl boot status
clashctl boot on
clashctl boot off
clashctl boot runtime on|off|status
clashctl boot proxy on|off|status

boot runtime：只管理内核开机自启（systemd / systemd-user 可用，script 后端为 unsupported）。
boot proxy：只管理 /etc/environment 中的代理持久块（决定开机后是否自动保持代理变量）。
boot：整体接管开关，等价于同时编排 runtime + proxy 两层状态。

OpenWrt 脚本模式

当前提供 OpenWrt 脚本模式兼容，适合 x86_64/amd64 与 aarch64/arm64 软路由或设备。该模式复用现有 script 运行后端，不包含 procd 开机自启、LuCI、UCI 或 opkg 包化支持，也不承诺 MIPS 与 armv7 设备可用。

建议先将项目放到持久化目录，避免放在 /tmp、/run 等重启会丢失的位置：

cd /root
git clone --branch master --depth 1 https://ghfast.top/https://github.com/wnlen/clash-for-linux.git
cd clash-for-linux

安装依赖：

opkg update
opkg install bash curl tar gzip coreutils-readlink unzip

安装与手动管理：

bash install.sh
clashon
clashctl status
clashoff

OpenWrt 下 root/system 安装会把 clashctl、clashon、clashoff 等命令入口写入 /usr/bin，运行状态、日志和内核二进制仍保存在项目目录的 runtime/ 下。仅脚本模式不会注册开机自启，设备重启后需要重新执行 clashon。

🏗️ 架构设计架构简述

项目当前可以按三层理解：

Control

用户入口层。

clashctl
clashon
clashoff
status
doctor
ui
select

Control 层负责把常用动作收口成可理解的命令和反馈。

Build

配置生成层。

多订阅保存
单 active 主订阅
active-only 编译链
订阅下载 / 转换 / 校验
config/mixin.yaml 运行补丁
输出 runtime/config.yaml

当前规则很明确：generate_config 只处理当前 active 主订阅。

Runtime

实际运行层。

runtime/ 是唯一运行时容器
后端可以是 systemd、systemd-user 或 script
运行配置是 runtime/config.yaml
订阅集合状态是 runtime/subscriptions.yaml（历史 config/subscriptions.yaml 仅用于兼容迁移）
日志、状态、缓存和运行时产物都收敛到 runtime 体系

配置说明

`.env`

.env 用于覆盖安装和运行参数。常用项包括：

KERNEL_TYPE=mihomo
MIXED_PORT=7890
EXTERNAL_CONTROLLER=0.0.0.0:9090
CLASH_CONTROLLER_SECRET=your-secret
CLASH_SUBSCRIPTION_URL=https://example.com/sub
MIHOMO_VERSION=latest
CLASH_VERSION=latest
YQ_VERSION=v4.44.3
SUBCONVERTER_VERSION=v0.9.0
MIHOMO_DOWNLOAD_BASE=https://github.com/MetaCubeX/mihomo/releases/download
CLASH_DOWNLOAD_BASE=https://github.com/WindSpiritSR/clash/releases/download
CLASH_BUNDLED_ASSET_ENABLED=true

按需设置即可，不需要每项都写。

内置运行依赖

当前正式支持的架构为 amd64、arm64、armv7。超出这三种架构时会明确失败，不会伪装成已支持。

如果安装环境访问 GitHub 很慢，可以把 Mihomo、yq、subconverter 的刚需文件跟随项目一起分发。安装和 clashctl upgrade 会优先读取 resources/bin 中与当前版本、架构对应的精确文件名；本地没有对应文件时，会回退到原来的远程下载逻辑，不影响后续升级内核。

Clash 仅作为兼容内核处理，固定走远程下载，不会命中 resources/bin 中的本地资源。

推荐路径直接放在分类目录下：

resources/bin/mihomo/mihomo-linux-amd64-compatible-v1.19.23.gz
resources/bin/mihomo/mihomo-linux-arm64-v1.19.23.gz
resources/bin/mihomo/mihomo-linux-armv7-v1.19.23.gz
resources/bin/yq/yq_linux_amd64.tar.gz
resources/bin/yq/yq_linux_arm64.tar.gz
resources/bin/yq/yq_linux_arm.tar.gz
resources/bin/subconverter/subconverter_linux64.tar.gz
resources/bin/subconverter/subconverter_aarch64.tar.gz
resources/bin/subconverter/subconverter_armv7.tar.gz
resources/geo/Country.mmdb

版本仍由 .env 中的 MIHOMO_VERSION、CLASH_VERSION、YQ_VERSION、SUBCONVERTER_VERSION 控制。脚本不会扫描目录，也不会自动选择最高版本；如果升级版本，请同步放入新版本对应文件，或让脚本回退到远程下载。

也可以设置 CLASH_BUNDLED_ASSET_ENABLED=false 强制跳过内置文件，或用 CLASH_BUNDLED_ASSET_DIR=/path/to/assets 指向项目外的资源目录。Mihomo、yq、subconverter 兼容旧路径 resources/bin/<category>/<version>/<file>。

`config/mixin.yaml`

用于对最终运行配置做补丁：

override 覆盖字段
prepend 把数组项放到原始配置前面
append 把数组项放到原始配置后面

查看当前模板：

clashctl mixin

编辑：

clashctl mixin edit

查看最终运行配置：

clashctl mixin runtime

🔄 更新

clashctl update
clashctl upgrade
clashctl upgrade mihomo
clashctl upgrade clash

update 用于更新项目代码与运行依赖。upgrade 用于升级当前或指定代理内核。

🧩 Mixin 配置

clashctl mixin
clashctl mixin edit
clashctl mixin raw
clashctl mixin runtime

Mixin 是运行配置补丁，不是订阅管理。它通过 config/mixin.yaml 对当前 active 订阅生成的运行配置执行：

override
prepend
append

示例：

override:
  dns:
    enable: true

prepend:
  proxies: []
  proxy-groups: []
  rules:
    - DOMAIN-SUFFIX,example.com,DIRECT

append:
  proxies: []
  proxy-groups: []
  rules:
    - MATCH,节点选择

编辑后执行：

clashctl mixin edit

它会重新生成配置；如果代理正在运行，会自动重启应用。

多跳节点

多跳节点会写入 config/mixin.yaml，通过 Mihomo/Clash 的 relay 策略组串联已有订阅节点。节点名称必须与订阅生成的节点名完全一致，可先通过 Web 控制台确认：

clashon
clashui

按域名小范围测试：

clashctl relay add 多跳-示例 节点A 节点B --domain example.com
clashctl relay list

也可以使用快捷入口：clashrelay list。

全局接管：

clashctl relay add 全局多跳 节点A 节点B --match

--match 会让所有未提前命中的流量走多跳，建议先用 --domain 验证链路。删除多跳配置：

clashctl relay remove 多跳-示例

🌐 Tun 模式

clashctl tun on
clashctl tun off
clashctl tun doctor
clashctl tun logs

Tun 用于透明接管链路。tun on 是动作反馈，展示当前关键配置和简短状态；完整证据请看：

clashctl tun doctor

Tun 判断不会简单把 root 等同于拥有 CAP_NET_ADMIN，也不会把 main table 默认路由未切换直接等同于 Tun 未生效。诊断会结合运行后端、容器环境、进程能力、Tun adapter、policy routing、路由表和日志证据。

🧹 卸载

bash uninstall.sh

设置代理

开启 IP 转发

echo "net.ipv4.ip_forward = 1" | tee -a /etc/sysctl.conf
sysctl -p

2.配置iptables

# 先清空旧规则
iptables -t nat -F

# 允许本机访问代理端口
iptables -t nat -A OUTPUT -p tcp --dport 7890 -j RETURN
iptables -t nat -A OUTPUT -p tcp --dport 7891 -j RETURN
iptables -t nat -A OUTPUT -p tcp --dport 7892 -j RETURN

# 让所有 TCP 流量通过 7892 代理
iptables -t nat -A PREROUTING -p tcp -j REDIRECT --to-ports 7892

# 保存规则
iptables-save | tee /etc/iptables.rules

让 iptables 规则开机生效在 /etc/rc.local（或 /etc/rc.d/rc.local）加上：

#!/bin/bash
iptables-restore < /etc/iptables.rules
exit 0

chmod +x /etc/rc.local

🔗 引用

常见问题

部分Linux系统默认的 shell /bin/sh 被更改为 dash，运行脚本会出现报错（报错内容一般会有 -en [ OK ]）。建议使用 bash xxx.sh 运行脚本。
部分用户在UI界面找不到代理节点，基本上是因为厂商提供的clash配置文件是经过base64编码的，且配置文件格式不符合clash配置标准。

目前此项目已集成自动识别和转换clash配置文件的功能。如果依然无法使用，则需要通过自建或者第三方平台（不推荐，有泄露风险）对订阅地址转换。
程序日志中出现error: unsupported rule type RULE-SET报错，解决方法查看官方WIKI

⭐ Star History

⚠️ 特别声明

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

Name		Name	Last commit message	Last commit date
Latest commit History 515 Commits
.github		.github
config		config
resources		resources
runtime		runtime
scripts		scripts
.env		.env
.gitattributes		.gitattributes
.gitignore		.gitignore
LICENSE		LICENSE
README.md		README.md
install.sh		install.sh
uninstall.sh		uninstall.sh

Uh oh!

Folders and files

Latest commit

History

Repository files navigation

🐧 Clash for Linux

一个更完整、更优雅的 Linux Clash / Mihomo 运行平台。

✨ 核心特性

适用场景

🚀 一键安装（推荐）

⌨️ 命令一览

🌐 Web 控制台

OpenWrt 脚本模式

🧰 常用管理命令

多订阅管理

本地配置导入

开机接管（内核 + 代理）

OpenWrt 脚本模式

🏗️ 架构设计架构简述

Control

Build

Runtime

配置说明

.env

内置运行依赖

config/mixin.yaml

🔄 更新

🧩 Mixin 配置

多跳节点

🌐 Tun 模式

🧹 卸载

设置代理

🔗 引用

常见问题

⭐ Star History

⚠️ 特别声明

About

Topics

Resources

License

Uh oh!

Stars

Watchers

Forks

Releases 1

Sponsor this project

Uh oh!

Packages 0

Uh oh!

Contributors

Uh oh!

Languages

`.env`

`config/mixin.yaml`

Packages