运行基础 · 使用说明

Clash 服务运行时如何检查进程状态和定位日志

后台进程可交给 systemd 管理,也可按容器方式运行。先确认文件路径与配置位置,再分别处理服务加载、启动、日志查看和停止。

  • systemd
  • Docker
  • config.yaml
  • 后台进程
  • journalctl
阅读索引

旧配置与现用环境的区别

旧版内核的参数约定与现用软件可能不同。遇到权限要求、平台边界或增强功能说明时,应结合正在使用的程序核查;不要把历史配置直接覆盖到现有环境。

核对正在使用的内核时,可阅读 现行参数说明;涉及应用界面或系统授权,再查阅 应用项目的操作说明 确认具体操作。

前台启动与长期后台运行需要不同的管理方式。服务管理器可以接管进程;下面分别列出 systemd 单元文件和容器编排示例。

systemd

示例把可执行程序放入 /usr/local/bin,运行目录中的配置和地址库则放入 /etc/clash。

shell
cp clash /usr/local/bin
cp config.yaml /etc/clash/
cp Country.mmdb /etc/clash/

服务单元文件的示例路径为 /etc/systemd/system/clash.service,内容如下。

ini
[Unit]
Description=按配置目录运行的规则代理进程
After=network-online.target

[Service]
Type=simple
Restart=always
ExecStart=/usr/local/bin/clash -d /etc/clash

[Install]
WantedBy=multi-user.target

单元文件写好后,先通知 systemd 重新读取定义:

shell
systemctl daemon-reload

若需要随开机加载,使用 enable 设置启动关系:

shell
systemctl enable clash

当前会话要立即运行服务,可调用 start:

shell
systemctl start clash

检查进程是否启动成功,再结合日志定位异常:

shell
systemctl status clash
journalctl -xe

服务示例的关联说明见 贡献记录(讨论记录)。

Docker

容器方式使用预构建镜像;Linux 环境的编排写法可以参考 容器编排说明 。旧文对容器中的 增强内核 另有使用限制提示。

环境要求

旧示例对 macOS 容器环境的限制来自主机网络与虚拟设备条件,照用前应核对当前容器环境是否满足这些条件。

yaml
services:
  clash:
    image: ghcr.io/dreamacro/clash
    restart: always
    volumes:
      - ./config.yaml:/root/.config/clash/config.yaml:ro
      # 参数按使用环境填写
    ports:
      - "7890:7890"
      - "7891:7891"
      # - "8080:8080" # 参数按使用环境填写
    network_mode: "bridge"
yaml
services:
  clash:
    image: ghcr.io/dreamacro/clash-premium
    restart: always
    volumes:
      - ./config.yaml:/root/.config/clash/config.yaml:ro
      # 参数按使用环境填写
    ports:
      - "7890:7890"
      - "7891:7891"
      # - "8080:8080" # 参数按使用环境填写
    cap_add:
      - NET_ADMIN
    devices:
      - /dev/net/tun
    network_mode: "host"

编排文件命名为 docker-compose.yaml,并让 config.yaml 与它处于同一目录。

时间设置

协议运行可能受到系统时间偏差影响。启动前可先检查设备的时间同步设置。

目录和文件确认后,用下面的命令运行容器:

shell
docker-compose up -d

容器运行记录可通过日志命令读取:

shell
docker-compose logs

需要结束运行时,执行:

shell
docker-compose stop