# clash-for-linux-install

**Repository Path**: hhqblog/clash-for-linux-install

## Basic Information

- **Project Name**: clash-for-linux-install
- **Description**: No description available
- **Primary Language**: Shell
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2025-02-25
- **Last Updated**: 2025-04-16

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Linux 一键安装 Clash

因为有在服务器上使用代理的需求，试过许多开源脚本，总是遇到各种问题。于是自己动手，丰衣足食：对 `Clash` 内核 的安装过程及功能进行了友好封装，使用起来优雅、简单、明确。

- 默认安装 `mihomo` 内核，[可选](#安装-clash-内核) `clash`。
- 自动进行本地订阅转换。
- 多架构支持，适配主流 `Linux` 发行版：`CentOS 7.6`、`Debian 12`、`Ubuntu 24.04.1 LTS`。

![preview](resources/preview.png)

## 快速开始

### 环境要求

- 需要 `root` 或 `sudo` 权限。
- 具备 `bash` 和 `systemd` 的系统环境。

### 一键安装

下述命令适用于 `x86_64` 架构，其他架构需修改 `--branch` 指定的分支。可通过 `uname -m` 查询系统架构，其与分支的对应关系如下：

| 分支 | master | arch-x86 | arch-arm64 | arch-arm32 |
|:---:| :---:  | :---:    | :---:      | :---:      |
| 架构 | x86_64 | i386, ...| aarch64    | armv7l, ...|

```bash
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 -c '. install.sh; exec bash'
```

> 如遇问题，请在查阅[常见问题](#常见问题)及 [issue](https://github.com/nelvko/clash-for-linux-install/issues?q=is%3Aissue) 未果后进行反馈。

- 上述克隆命令使用了[加速前缀](https://gh-proxy.com/)，如失效请更换其他[可用链接](https://ghproxy.link/)。
- ~~不懂什么是订阅链接的小白可参考~~：[issue#1](https://github.com/nelvko/clash-for-linux-install/issues/1)
- 没有订阅？[click me](https://次元.net/auth/register?code=oUbI)
- 验证是否连通外网：`wget www.google.com`

### 命令一览

执行 `clash` 列出开箱即用的快捷命令。

```bash
$ clash
Usage:
    clash                    命令一览
    clashon                  开启代理
    clashoff                 关闭代理
    clashui                  面板地址
    clashstatus              内核状况
    clashtun     [on|off]    Tun 模式
    clashmixin   [-e|-r]     Mixin 配置
    clashsecret  [secret]    Web 密钥
    clashupdate  [auto|log]  更新订阅
```

### 开始使用

```bash
$ clashoff
😼 已关闭代理环境

$ clashon
😼 已开启代理环境

$ clashui
😼 Web 面板地址...
```

原理：

- 使用 `systemctl` 控制 `clash` 启停，并调整代理环境变量的值（http_proxy 等）。因为应用程序在发起网络请求时，会通过其指定的代理地址转发流量，不调整会造成：关闭代理后仍转发导致请求失败、开启代理后未设置代理地址导致请求不转发。
- `clashon` 等命令封装了上述流程。

### 定时更新订阅

```bash
$ clashupdate [url]
😼 备份配置：/opt/clash/config.yaml.bak
😼 下载成功：内核验证配置...
😾 验证失败：本地订阅转换...
😼 下载成功：内核验证配置...
✅ [2025-02-23 22:45:23] 订阅更新成功：https://xxx.com

$ clashupdate auto [url]
😼 定时任务设置成功

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

- `clashupdate` 会记忆安装/上次更新成功的订阅，后续执行无需再指定订阅url。
- 可通过 `crontab -e` 修改定时更新频率及订阅链接。
- 通过配置文件进行更新：[pr#24](https://github.com/nelvko/clash-for-linux-install/pull/24#issuecomment-2565054701)

### Web 控制台密钥

控制台密钥默认为空，若暴露到公网使用建议更新密钥。

```bash
$ clashsecret xxx
😼 密钥更新成功，已重启生效

$ clashsecret
😼 当前密钥：xxx
```

### `Tun` 模式

```bash
$ clashtun
😾 Tun 状态：关闭

$ clashtun on
😼 Tun 模式已开启
```

- 作用：实现本机及 `Docker` 等容器的所有流量路由到 `clash` 代理、DNS 劫持等。
- 原理：[clash-verge-rev](https://www.clashverge.dev/guide/term.html#tun)、 [clash.wiki](https://clash.wiki/premium/tun-device.html)。

### `Mixin` 配置

```bash
$ clashmixin
😼 查看 mixin 配置（less）

$ clashmixin -e
😼 编辑 mixin 配置（vim）

$ clashmixin -r
😼 查看 运行时 配置（less）
```

- 作用：用来存储自定义配置，防止更新订阅后覆盖丢失自定义配置内容。
- 运行时配置是订阅配置和 `Mixin` 配置的并集。
- 相同配置项优先级：`Mixin` 配置 > 订阅配置。

### 卸载

以下为通用命令，`root` 用户可直接使用： `. uninstall.sh`。

```bash
sudo bash -c '. uninstall.sh; exec bash'
```

## 常见问题

### 配置下载失败或无效

- 下载失败：脚本使用 `wget`、`curl` 命令进行了多次[重试](https://github.com/nelvko/clash-for-linux-install/blob/035c85ac92166e95b7503b2a678a6b535fbd4449/script/common.sh#L32-L46)下载，如果还是失败可能是机场限制，请自行粘贴订阅内容到配置文件：[issue#1](https://github.com/nelvko/clash-for-linux-install/issues/1#issuecomment-2066334716)
- 订阅配置无效：~~[issue#14](https://github.com/nelvko/clash-for-linux-install/issues/14#issuecomment-2513303276)~~
配置下载成功后会对其进行校验，校验失败将在本地进行订阅转换后重试，仍无效请检查是否为有效的 `clash` 订阅。

### bash: clashon: command not found

- 原因：使用 `bash install.sh` 执行脚本不会对当前 `shell` 生效。
- 解决：当前 `shell` 执行下 `bash` 即可。

<details>

<summary>几种运行方式的区别：</summary>

- `bash` 命令运行：当前 `shell` 开启一个子 `shell` 执行脚本，对环境的修改不会作用到当前 `shell`，因此不具备 `clashon`
   等命令。

  ```bash
  # 需要有可执行权限
  $ ./install.sh
   
  # 不需要可执行权限，需要读权限
  $ bash ./install.sh
  ```

- `shell` 内建命令运行：脚本在当前 `shell` 环境中执行，变量和函数的定义对当前 `shell` 有效，`root` 用户推荐这种方式执行脚本。

  ```bash
  # 不需要可执行权限，需要读权限
  $ . install.sh
  $ source uninstall.sh
  ```

</details>

### ping 不通外网

- `ping` 命令使用的是第三层中的 `ICMP` 协议，不依赖 `clash` 代理的上层 `TCP` 协议。
- 执行 `clashtun on` 后~~可以 `ping` 通~~，但得到的是 fake ip，原理详见：[clash.wiki](https://clash.wiki/configuration/dns.html#fake-ip)。

### 服务启动失败/未启动

- [端口占用](https://github.com/nelvko/clash-for-linux-install/issues/15#issuecomment-2507341281)
- [系统为 WSL 环境或不具备 systemd](https://github.com/nelvko/clash-for-linux-install/issues/11#issuecomment-2469817217)

### 安装 `clash` 内核

将 `resources/zip/` 路径下的 `mihomo` 内核压缩包移出或删除即可，安装时会自动下载对应架构版本的 `clash` 内核。

安装逻辑：

- `resources/zip/` 路径下无任何内核压缩包时，默认下载安装 `clash` 。
- 有且仅有一个内核压缩包时，安装该内核。
- `clash` 和 `mihomo` 压缩包共存时，优先安装 `mihomo` 。

注意：手动替换内核或其他命令版本时，需从官方渠道获取软件包且**勿重命名**。

## 引用

- [Clash 知识库](https://clash.wiki/)
- [Clash 全家桶下载](https://www.clash.la/releases/)
- [Clash Premium 2023.08.17](https://downloads.clash.wiki/ClashPremium/)
- [mihomo v1.19.2](https://github.com/MetaCubeX/mihomo)
- [subconverter v0.9.0：本地订阅转换](https://github.com/tindy2013/subconverter)
- [yacd v0.3.8：Web UI](https://github.com/haishanh/yacd)
- [yq v4.45.1：处理 yaml](https://github.com/mikefarah/yq)

## Todolog

- [X] 定时更新配置
- [X] 😼
- [X] 适配其他发行版
- [X] 配置更新日志
- [X] Tun 模式
- [x] mixin 配置
- [x] 适配x86、arm架构
- [x] 本地订阅转换
- [x] 切换 mihomo 内核
- [x] 端口占用时随机分配
- [ ] [bug / 需求](https://github.com/nelvko/clash-for-linux-install/issues)

## Thanks

[@鑫哥](https://github.com/TrackRay)

## 特别声明

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