Accessing Gatus
- 打开浏览器,访问:
https://<SERVER_IP> - 浏览器出现 SSL 警告属于正常现象(自签名证书)
- 需要身份验证(Basic Auth 弹窗)
- 验证方式:HTTP Basic Auth
- 凭据安全存储于:
/root/.cloudzy-creds
重要文件与目录
- Install directory:
/opt/gatus - Docker Compose:
/opt/gatus/docker-compose.yml - Environment file:
/opt/gatus/.env - Config directory:
/opt/gatus/config/ - 主配置文件:
/opt/gatus/config/config.yaml - Database directory:
/opt/gatus/data/db - Nginx config:
/etc/nginx/sites-available/gatus.conf - 已启用的 Nginx 站点:
/etc/nginx/sites-enabled/gatus.conf - SSL certificates:
/etc/nginx/ssl/ - HTTP Basic Auth 文件:
/etc/nginx/auth/.gatus-htpasswd - Credentials file:
/root/.gatus-credentials
Configuration Behavior
- 配置文件位于
/opt/gatus/config/ - YAML 支持拆分为多个文件
- 配置更改后自动重载
- 编辑后无需重启服务
管理 Stack
进入安装目录的 Go:
cd /opt/gatus
常用 Docker Compose 命令:
# Check status
docker compose ps
# View logs (follow live)
docker compose logs -f
# Restart all services
docker compose restart
# Stop services
docker compose down
# Start again
docker compose up -d
禁用 Nginx 中的 HTTP Basic Auth(可选)
编辑 Nginx 站点配置文件: /etc/nginx/sites-available/gatus.conf
删除或注释掉以下行:
auth_basic "Restricted";
auth_basic_user_file /etc/nginx/auth/.gatus-htpasswd;
Reload Nginx:
systemctl restart nginx
通过域名启用 SSL
1. 将你的域名指向服务器 IP。
2. 编辑 Nginx 配置,替换以下两处 server_name <IP>; 使用您的域名(<your-domain>) 适用于 HTTP(端口 80)和 HTTPS(端口 443)的规则块:
vim /etc/nginx/sites-available/gatus.conf
3. Install Certbot:
apt install -y certbot python3-certbot-nginx
4. 运行以下命令,生成有效的 Let's Encrypt 证书:
certbot certonly --nginx --non-interactive --agree-tos --email [email protected] -d yourdomain.com
5. 在 Nginx 配置中替换 SSL 路径:
vim /etc/nginx/sites-available/gatus.conf
# Before:
# ssl_certificate /etc/nginx/ssl/fullchain.pem;
# ssl_certificate_key /etc/nginx/ssl/privkey.pem;
# After:
# ssl_certificate /etc/letsencrypt/live/yourdomain.com/fullchain.pem;
# ssl_certificate_key /etc/letsencrypt/live/yourdomain.com/privkey.pem;
6. 重启 Nginx 以应用更改:
systemctl restart nginx
7. 打开浏览器,访问: https://yourdomain.com