Logo

菜单

yanchang
yanchang
发布于 2026-06-01 / 12 阅读
0
0

在命令行下部署clash实现代理(最新版)

#运维#linux

下载clash项目

git clone https://github.com/wnlen/clash-for-linux.git

进入到项目目录，编辑.env文件，修改变量 CLASH_SUBSCRIPTION_URL的值，修改为你的订阅链接。

cd clash-for-linux
vim .env

启动程序

直接运行start.sh脚本

cd clash-for-linux
# 普通安装请执行：bash install.sh；系统级安装请显式执行：sudo bash install.sh system
bash install.sh 
✨ 订阅已生效

🎉 安装完成

🚀 当前内核：mihomo
🧬 系统架构：amd64
💻 环境模式：主机
📁 安装路径：/opt/clash/clash-for-linux
👤 安装方式：user / user
🔧 运行后端：systemd-user
📦 订阅：已配置
🔢 节点数量：35

╔════════════════════════════════════════════════════════════╗
║                       🐱 Web 控制台                        ║
╠════════════════════════════════════════════════════════════╣
║                                                            ║
║      🔓 注意放行端口：9090                                  ║
║      📶 状态：可访问                                        ║
║      🏠 内网：http://***.***.**.**:9090/ui                 ║
║      📡 公共：http://board.zash.run.place                  ║
║      🌏 公网：http://[**********************]:9090/ui      ║
║      🔑 密钥：********************                         ║
║                                                            ║
╚════════════════════════════════════════════════════════════╝

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

💡 显示更多帮助命令：clashctl -h

💡 clashon / clashoff 为 shell 快捷入口；新终端会自动生效
💡 当前终端若暂不可用，请先使用 clashctl on / clashctl off

通过对ui访问即可

🌐 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 作为控制台前端，如需更换可自行配置。

  • 运行配置会把 external-ui 指向本地 Dashboard 目录，并把 external-ui-url 指向 zashboard 的 dist.zip 下载地址；面板内 /upgrade/ui 会使用该地址更新前端。

  • 若需将控制台暴露到公网，建议定期更换访问密钥，或通过 SSH 端口转发方式进行安全访问。

🏠 局域网代理

项目默认开启局域网代理：运行配置会写入 allow-lan: true，并把 external-controller 绑定到 0.0.0.0，避免订阅文件里的 allow-lan: false 覆盖项目默认值。

clashctl lan status
clashctl lan on
clashctl lan off

开启后，同一局域网设备可把 HTTP / SOCKS 代理地址设置为 http://<本机局域网IP>:<mixed-port>，端口默认是 7890；如访问不了，请检查系统防火墙是否放行该端口。

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 编译链

  • 订阅下载 / 转换 / 校验

  • runtime/mixin.yaml 运行补丁（兼容读取 config/mixin.yaml）

  • 输出 runtime/config.yaml

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

Runtime 说明（重要）

runtime/ 是运行时目录，不是配置目录。

它的作用是作为“唯一运行容器”，用于存放：

- 运行内核（mihomo / clash） - 运行配置（config.yaml） - 订阅状态（subscriptions.yaml） - dashboard 前端 - 日志（logs） - 构建中间文件（tmp）

这些内容都是 install / 运行过程中动态生成的，不会作为仓库内容长期维护。

配置说明

.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.9
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>。

runtime/mixin.yaml（兼容 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 是运行配置补丁，不是订阅管理。它优先通过 runtime/mixin.yaml（兼容读取 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

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

多跳节点

多跳节点会写入 runtime/mixin.yaml（兼容读取 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 on-proxy-off
clashctl tun off-proxy-on
clashctl tun doctor
clashctl tun logs

Tun 用于透明接管链路。tun on 只负责开启 Tun，不会自动关闭系统代理；如需切换到 Tun 接管并关闭系统代理，使用 clashctl tun on-proxy-off。如需关闭 Tun 并恢复普通系统代理模式，使用 clashctl tun off-proxy-on。

clashctl doctor 会检查 Tun 与系统代理是否同时开启；如果同时开启，会提示 clashctl tun on-proxy-off，避免流量接管路径重复或排障混淆。

tun on 是动作反馈，展示当前关键配置和简短状态；完整证据请看：

clashctl tun doctor

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

🧹 卸载

bash uninstall.sh

设置代理

  1. 开启 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

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

#!/bin/bash
iptables-restore < /etc/iptables.rules
exit 0
chmod +x /etc/rc.local

完整版自建邮局架构笔记 (Post...
如何用 Prominence (突...

评论