Access
- 打开浏览器,访问:
https://<SERVER_IP> - 浏览器出现 SSL 警告属于正常现象(自签名证书)
创建管理员账户
登录前,你需要先创建一个管理员账户。
运行以下命令:
docker exec -it healthchecks /opt/healthchecks/manage.py createsuperuser
按照提示依次输入:
- Email address
- Password
完成后,即可使用新创建的凭据登录。
重要文件与目录
- Install directory:
/root/healthchecks - Environment file:
/root/healthchecks/.env - Docker Compose 文件:
/root/healthchecks/docker-compose.yml - SQLite database:
/var/lib/docker/volumes/healthchecks_healthchecks-data/_data - Nginx 站点配置:
/etc/nginx/sites-available/healthchecks - Enabled site:
/etc/nginx/sites-enabled/healthchecks - SSL certificates:
/etc/nginx/ssl/fullchain.pem,/etc/nginx/ssl/privkey.pem - Admin credentials:
/root/.cloudzy-creds
管理 Stack
cd /root/healthchecks
# Start services
docker compose up -d
# Stop services
docker compose down
# Restart services
docker compose restart
# View logs
docker compose logs -f
邮件设置配置(可选)
启用通知功能(如告警、报告)需要先完成邮件配置。
请确认服务器已允许 SMTP 连接。如当前未开放,请申请 SMTP 访问权限。
编辑环境配置文件:
nano /root/healthchecks/.env
取消注释并填写以下变量,填入你的 SMTP 服务商信息:
# DEFAULT_FROM_EMAIL=fixme-email-address-here
# EMAIL_HOST=fixme-smtp-host-here
# EMAIL_HOST_PASSWORD=fixme-smtp-password-here
# EMAIL_HOST_USER=fixme-smtp-username-here
# EMAIL_PORT=587
# EMAIL_USE_TLS=True
重启服务以使更改生效:
docker compose up -d
为域名启用 SSL(可选)
1. 将你的域名指向服务器 IP。
2. Edit .env 将你的域名设置为 SITE_ROOT: SITE_ROOT=https://yourdomain.com
3. 重新创建服务:
cd /root/healthchecks/
docker compose up -d
4. 编辑 Nginx 配置,将以下两处 server_name <IP>; 使用您的域名(<yourdomain.com>) 适用于 HTTP(端口 80)和 HTTPS(端口 443)的规则块:
vim /etc/nginx/sites-available/healthchecks
5. Install Certbot:
apt install -y certbot python3-certbot-nginx
6. 运行以下命令以生成有效的 Let's Encrypt 证书:
certbot certonly --nginx --non-interactive --agree-tos --email [email protected] -d yourdomain.com
7. 替换 Nginx 配置(TLS 部分)中的 SSL 路径:
vim /etc/nginx/sites-available/healthchecks
# 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;
8. 重启 Nginx 以应用更改:
systemctl restart nginx
9. 打开浏览器,访问: https://yourdomain.com