Files
clash-for-linux-install/README.md
T
2025-07-12 17:27:17 +08:00

184 lines
6.7 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Linux 一键安装 Clash
![GitHub License](https://img.shields.io/github/license/nelvko/clash-for-linux-install)
![GitHub top language](https://img.shields.io/github/languages/top/nelvko/clash-for-linux-install)
![GitHub Repo stars](https://img.shields.io/github/stars/nelvko/clash-for-linux-install)
![preview](resources/preview.png)
- 默认安装 `mihomo` 内核,[可选安装](https://github.com/nelvko/clash-for-linux-install/wiki/FAQ#%E5%AE%89%E8%A3%85-clash-%E5%86%85%E6%A0%B8) `clash`。
- 自动使用 [subconverter](https://github.com/tindy2013/subconverter) 进行本地订阅转换。
- 多架构支持,适配主流 `Linux` 发行版:`CentOS 7.6`、`Debian 12`、`Ubuntu 24.04.1 LTS`。
## 快速开始
### 环境要求
- 用户权限:`root`、`sudo`。(无权限可参考:[#91](https://github.com/nelvko/clash-for-linux-install/issues/91))
- `shell` 支持:`bash`、`zsh`、`fish`。
### 一键安装
下述命令适用于 `x86_64` 架构,其他架构请戳:[一键安装-多架构](https://github.com/nelvko/clash-for-linux-install/wiki#%E4%B8%80%E9%94%AE%E5%AE%89%E8%A3%85-%E5%A4%9A%E6%9E%B6%E6%9E%84)
```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 install.sh
```
> 如遇问题,请在查阅[常见问题](https://github.com/nelvko/clash-for-linux-install/wiki/FAQ)及 [issue](https://github.com/nelvko/clash-for-linux-install/issues?q=is%3Aissue) 未果后进行反馈。
- 上述克隆命令使用了[加速前缀](https://gh-proxy.com/),如失效请更换其他[可用链接](https://ghproxy.link/)。
- 默认通过远程订阅获取配置进行安装,本地配置安装详见:[#39](https://github.com/nelvko/clash-for-linux-install/issues/39)
- 没有订阅?[click me](https://次元.net/auth/register?code=oUbI)
### 命令一览
执行 `clashctl` 列出开箱即用的快捷命令。
> 同 `clash`、`mihomo`、`mihomoctl`
```bash
$ clashctl
Usage:
clash COMMAND [OPTION]
Commands:
on 开启代理
off 关闭代理
ui 面板地址
status 内核状况
proxy [on|off] 系统代理
tun [on|off] Tun 模式
mixin [-e|-r] Mixin 配置
secret [SECRET] Web 密钥
update [auto|log] 更新订阅
```
### 优雅启停
```bash
$ clashon
😼 已开启代理环境
$ clashoff
😼 已关闭代理环境
```
- 启停代理内核的同时,设置系统代理。
- 亦可通过 `clashproxy` 单独控制系统代理。
### Web 控制台
```bash
$ 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 控制台,实现可视化操作:切换节点、查看日志等。
- 控制台密钥默认为空,若暴露到公网使用建议更新密钥。
### 更新订阅
```bash
$ clashupdate https://example.com
👌 正在下载:原配置已备份...
🍃 下载成功:内核验证配置...
🍃 订阅更新成功
$ clashupdate auto [url]
😼 已设置定时更新订阅
$ clashupdate log
✅ [2025-02-23 22:45:23] 订阅更新成功:https://example.com
```
- `clashupdate` 会记住上次更新成功的订阅链接,后续执行无需再指定。
- 可通过 `crontab -e` 修改定时更新频率及订阅链接。
- 通过配置文件进行更新:[pr#24](https://github.com/nelvko/clash-for-linux-install/pull/24#issuecomment-2565054701)
### `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)。
- 注意事项:[#100](https://github.com/nelvko/clash-for-linux-install/issues/100#issuecomment-2782680205)
### `Mixin` 配置
```bash
$ clashmixin
😼 less 查看 mixin 配置
$ clashmixin -e
😼 vim 编辑 mixin 配置
$ clashmixin -r
😼 less 查看 运行时 配置
```
- 持久化:将自定义配置写在 `Mixin` 而不是原配置中,可避免更新订阅后丢失自定义配置。
- 运行时配置是订阅配置和 `Mixin` 配置的并集。
- 相同配置项优先级:`Mixin` 配置 > 订阅配置。
### 卸载
```bash
sudo bash uninstall.sh
```
## 常见问题
[wiki](https://github.com/nelvko/clash-for-linux-install/wiki/FAQ)
## 引用
- [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 控制台](https://github.com/haishanh/yacd)
- [yq v4.45.1:处理 yaml](https://github.com/mikefarah/yq)
## Star History
<a href="https://www.star-history.com/#nelvko/clash-for-linux-install&Date">
<picture>
<source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=nelvko/clash-for-linux-install&type=Date&theme=dark" />
<source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=nelvko/clash-for-linux-install&type=Date" />
<img alt="Star History Chart" src="https://api.star-history.com/svg?repos=nelvko/clash-for-linux-install&type=Date" />
</picture>
</a>
## Thanks
[@鑫哥](https://github.com/TrackRay)
## 特别声明
1. 编写本项目主要目的为学习和研究 `Shell` 编程,不得将本项目中任何内容用于违反国家/地区/组织等的法律法规或相关规定的其他用途。
2. 本项目保留随时对免责声明进行补充或更改的权利,直接或间接使用本项目内容的个人或组织,视为接受本项目的特别声明。