Gatus是开箱即用的静态链接二进制文件，官方仅提供GitHub预编译包，未纳入apt/yum等发行版源；需手动下载、配置YAML、通过systemd托管运行，且conditions等关键字段不可省略。
Gatus 不能直接“安装”成传统意义上的系统服务，它本身就是一个开箱即用的二进制可执行文件，没有依赖、不需编译、不改系统配置——你下载完就能跑。
为什么不用 apt/yum 安装 Gatus
Gatus 没有进入任何 Linux 发行版的官方软件源（Debian/Ubuntu 的 apt、CentOS/RHEL 的 yum 或 dnf），也没有提供 RPM/DEB 包。官方只维护 GitHub Release 页面上的预编译二进制文件，这是它的设计哲学：极简交付，避免包管理器引入的版本碎片和权限干扰。
常见错误现象：apt install gatus 或 yum search gatus 返回空结果或 No package gatus available；手动添加第三方 repo 后仍失败，因为根本不存在适配你系统的仓库配置。
- 它不依赖 libc 版本兼容性（静态链接 Go 运行时）
- 不需要
systemd单元文件也能运行（但建议加，下文说明） - 不写入
/etc、不修改PATH、不注册服务用户——所有配置靠一个 YAML 文件驱动
正确下载与启动 Gatus 的三步操作
以 amd64 架构的 Linux 服务器为例（x86_64），直接从 GitHub 获取最新稳定版：
cd /tmp curl -fsSL https://github.com/TwiN/gatus/releases/download/v4.12.0/gatus_4.12.0_linux_amd64.tar.gz | tar xz sudo mv gatus /usr/local/bin/ sudo chmod +x /usr/local/bin/gatus
创建最小可用配置（gatus.yaml）：
echo 'web:
http:
port: 8080
endpoints:
- name: api-health
url: https://api.example.com/health
interval: 30s' | sudo tee /etc/gatus.yaml立即运行验证：
gatus -c /etc/gatus.yaml —— 成功则访问 http://your-server-ip:8080 看到仪表盘；Ctrl+C 停止。
Zynq‑7000 / Zynq UltraScale+ 硬件调试技能。适用于 Xilinx Zynq（Cortex‑A9/A53 + FPGA）Linux 环境，调试 I2C、I2S、UART、GPIO 等外设。包括设备树配置、内核驱动、用户空间调试工具、交叉编译和常见问题排查，支持 PetaLinux 开发。
- 必须指定
-c参数，否则报错failed to load configuration: open gatus.yaml: no such file or directory - 端口若被占用（如 8080 已运行 Nginx），会直接 panic 并退出，不会自动降级或提示“请换端口”
- URL 必须带协议（
https://或http://），api.example.com/health会解析失败
如何让 Gatus 在后台长期运行（systemd 方式）
生产环境不能靠前台 nohup 或 & 启动——它无法自动重启、没日志轮转、不响应 systemctl stop。正确做法是写一个轻量 systemd service：
sudo tee /etc/systemd/system/gatus.service <<'EOF' [Unit] Description=Gatus Health Dashboard After=network.target <p>[Service] Type=simple User=nobody WorkingDirectory=/etc ExecStart=/usr/local/bin/gatus -c /etc/gatus.yaml Restart=always RestartSec=10 StandardOutput=journal StandardError=journal</p><p>[Install] WantedBy=multi-user.target EOF
启用并启动：
sudo systemctl daemon-reload sudo systemctl enable --now gatus
检查状态：
systemctl status gatus 应显示 active (running)；journalctl -u gatus -n 20 -f 可实时看探测日志。
- 别用 root 用户跑，
User=nobody是安全底线（Gatus 不需要特权） -
WorkingDirectory必须设为配置文件所在目录，否则相对路径引用会失败 - 如果配置里用了
notifications（如 Slack webhook），确保防火墙放行出站 HTTPS（ufw allow out 443）
配置文件里最容易被忽略的三个细节
Gatus 的 gatus.yaml 表面简单，但几个字段不填对会导致探测静默失败或误报：
-
conditions字段必须显式定义，否则即使 HTTP 状态码是 200，也会标为FAILED；例如：- "[STATUS] == 200" -
group不是必填，但多个 endpoint 共享 group 后，仪表盘会自动聚合显示整体健康率（比如group: "backend-api"） -
icon值只能是✅、❌、⚠️等 Unicode 符号，填"success"或"up"会被忽略，图标不显示
真实场景中，很多人卡在第一个条件没写，看着页面全是红叉，但日志里却显示 status=200——其实是默认无条件判定为失败。
