在 Ubuntu Server 上配置 Clash:让终端代理随开机启动

本文最后更新于:2026年10月31日 下午

给 Ubuntu Server 配置代理时,启动 Clash 只是第一步。要让终端里的工具使用它,还需要设置代理地址;想在重启后继续使用,则要把 Clash 交给 systemd 管理。

这篇把这几步串起来:先手动跑通,再配置终端开关,最后设置开机自启。后面需要换配置或排查连接问题时,也能顺着同一条线检查。

先把目录和配置准备好

准备一个与系统架构匹配的 Linux 版 Clash 可执行文件,以及可以使用的 config.yaml。本文沿用 clash 作为程序名,统一放在下面的目录中:

1
2
3
~/workspace/tools/clash/
├── clash
└── config.yaml

可以先创建目录,并查看机器架构:

1
2
mkdir -p ~/workspace/tools/clash
uname -m

x86_64 和 aarch64 对应不同的程序构建,下载时要选对。将程序与配置放好后,添加执行权限:

1
2
cd ~/workspace/tools/clash
chmod u+x clash

下面假设配置中的 HTTP 或混合代理端口是 7890。如果你设置了其他端口,后面的代理地址也要一起替换。

先在前台跑通

进入目录后启动 Clash:

1
./clash -d .

-d . 表示使用当前目录作为工作目录。先保持这个终端开着,观察是否有配置解析、端口占用或节点连接方面的报错。

然后另开一个终端,显式指定代理,测试一次请求:

1
curl --noproxy '' --proxy http://127.0.0.1:7890 -I https://www.example.com

这里的 --noproxy '' 是为了避免已有的直连规则影响测试。能收到目标站点的 HTTP 响应,说明这次请求已经通过指定的代理端口完成;若失败,先看 Clash 的输出,再检查端口和配置。

这一步跑通后,再继续设置终端环境变量,会更容易判断问题出在哪一层。

给终端加一个代理开关

我更愿意把代理做成两个小函数:需要时开启,用完就关闭,也方便临时排查直连与代理的区别。

如果使用 Zsh,把下面的内容放进 ~/.zshrc;如果使用 Bash,则放进 ~/.bashrc。编辑自己的配置文件即可,不需要使用 sudo。

1
2
3
4
5
6
7
8
9
10
proxy_on() {
export http_proxy='http://127.0.0.1:7890'
export https_proxy="$http_proxy"
export no_proxy='localhost,127.0.0.1,::1'
}

proxy_off() {
unset http_proxy https_proxy HTTP_PROXY HTTPS_PROXY
unset all_proxy ALL_PROXY no_proxy NO_PROXY
}

保存后重新加载对应文件。以 Zsh 为例:

1
source ~/.zshrc

之后在当前终端执行:

1
2
proxy_on
curl -I https://www.example.com

关闭则执行:

1
proxy_off

虽然变量名是 https_proxy,这里仍然写 http://127.0.0.1:7890:这个前缀描述的是应用连接本地代理的方式,目标网站仍然可以使用 HTTPS。

环境变量会影响当前 shell 及之后启动、且支持这些变量的程序。sudo、定时任务和 systemd 服务有各自的运行环境,不能假定它们会自动沿用当前终端的设置。上面的关闭函数也会清除常见的大小写代理变量,使用前留意自己是否另有设置。

交给 systemd,重启后自动运行

前台测试通过后,回到运行 Clash 的终端,按 Ctrl+C 停止它,避免稍后的服务重复占用同一个端口。

创建服务文件:

1
sudoedit /etc/systemd/system/clash.service

填入以下内容:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
[Unit]
Description=Clash proxy service
Wants=network-online.target
After=network-online.target

[Service]
Type=simple
User=zzmes
WorkingDirectory=/home/zzmes/workspace/tools/clash
ExecStart=/home/zzmes/workspace/tools/clash/clash -d /home/zzmes/workspace/tools/clash
Restart=on-failure
RestartSec=5

[Install]
WantedBy=multi-user.target

这里的 zzmes 和 /home/zzmes/workspace/tools/clash 是示例中的用户名与绝对路径,请按实际环境替换。服务文件中的路径不要写成 ~;程序、配置文件和目录也需要对运行用户可读。

保存后加载服务,并立即启动、开启自启:

1
2
3
sudo systemctl daemon-reload
sudo systemctl enable --now clash.service
systemctl status clash.service --no-pager

Restart=on-failure 会在进程异常退出后尝试重新启动。查看状态时,除了确认服务处于运行状态,也可以再执行一次前面的 curl 测试,确认代理请求确实可用。

注意,开机自启负责启动 Clash 进程。进入新终端后,仍需执行 proxy_on,让支持代理环境变量的工具使用它。

后续维护时常用的几条命令

修改 config.yaml 后,重启服务加载配置:

1
sudo systemctl restart clash.service

想看最近的日志,或持续跟踪输出:

1
2
journalctl -u clash.service -n 50 --no-pager
journalctl -u clash.service -f

临时停止服务:

1
sudo systemctl stop clash.service

如果以后不再需要开机运行,可以关闭自启并停止进程:

1
sudo systemctl disable --now clash.service

停掉服务后,记得在使用过代理的终端里执行 proxy_off。否则工具仍可能向已经关闭的本地端口发请求,表现为连接被拒绝。

遇到问题时,我会依次检查三个地方:服务有没有运行、代理端口能不能访问、当前应用有没有使用正确的代理地址。把这三件事分开确认,通常比反复改配置更容易定位原因。

参考资料


在 Ubuntu Server 上配置 Clash:让终端代理随开机启动
https://zzmes.github.io/2025/09/10/ubuntu-clash-md/
作者
Zzmes
发布于
2025年9月10日
许可协议