svcwatch v0.4.2

安装

svcwatch 以单个静态链接的二进制发布,支持 linux/amd64、linux/arm64 与 darwin/amd64。 以下四种方式选一种即可。

下载二进制

从发布页下载对应平台的压缩包,解压后放入 /usr/local/bin:

VERSION=0.4.2
curl -fsSLO https://get.svcwatch.dev/releases/v${VERSION}/svcwatch_${VERSION}_linux_amd64.tar.gz
tar -xzf svcwatch_${VERSION}_linux_amd64.tar.gz
install -m 0755 svcwatch /usr/local/bin/svcwatch
svcwatch version

如需校验完整性,发布页同时提供 sha256sums.txt 与 cosign 签名。

通过 apt 安装

添加软件源之后可以用包管理器升级:

sudo install -m 0755 -d /etc/apt/keyrings
curl -fsSL https://get.svcwatch.dev/apt/key.asc \
  | sudo gpg --dearmor -o /etc/apt/keyrings/svcwatch.gpg

echo "deb [signed-by=/etc/apt/keyrings/svcwatch.gpg] \
https://get.svcwatch.dev/apt stable main" \
  | sudo tee /etc/apt/sources.list.d/svcwatch.list

sudo apt update && sudo apt install -y svcwatch

使用 Docker

容器内默认读取 /etc/svcwatch/config.yaml,需要把宿主机的配置文件挂载进去。 如果配置里包含 exec 类检查,还要挂载对应的可执行文件与 socket。

docker run -d --name svcwatch \
  --restart unless-stopped \
  -p 127.0.0.1:9090:9090 \
  -v /etc/svcwatch:/etc/svcwatch:ro \
  ghcr.io/svcwatch/svcwatch:0.4.2 \
  run -c /etc/svcwatch/config.yaml

以 systemd 运行

推荐使用系统级服务,并开启 ProtectSystem 等加固选项:

[Unit]
Description=svcwatch service health checker
After=network-online.target
Wants=network-online.target

[Service]
User=svcwatch
Group=svcwatch
ExecStart=/usr/local/bin/svcwatch run -c /etc/svcwatch/config.yaml
Restart=on-failure
RestartSec=5s
NoNewPrivileges=true
ProtectSystem=strict
ProtectHome=true
PrivateTmp=true
ReadWritePaths=/var/lib/svcwatch

[Install]
WantedBy=multi-user.target
sudo systemctl daemon-reload
sudo systemctl enable --now svcwatch
sudo systemctl status svcwatch --no-pager

验证安装

服务启动后指标端点应当可以访问:

curl -s http://127.0.0.1:9090/metrics | grep '^svcwatch_'
curl -s http://127.0.0.1:9090/healthz

预期 /healthz 返回 ok。/metrics 在尚未执行第一轮检查时只包含 svcwatch_build_info 与 svcwatch_uptime_seconds 两项。

svcwatch 自身不监听公网地址。默认监听 127.0.0.1:9090,需要由 Prometheus 或反向代理访问;如果要对外暴露,请至少加一层认证。

© 2026 2190911.xyz · MIT License

文档最后更新:2026 年 11 月