安装
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.targetsudo 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
或反向代理访问;如果要对外暴露,请至少加一层认证。