访问
- 打开浏览器并访问:
https://<SERVER_IP> - A browser SSL warning is expected (self-signed certificate)
Create Admin Account
Before logging in, you must create an admin account.
Run the following command:
docker exec -it healthchecks /opt/healthchecks/manage.py createsuperuser
Follow the prompts to enter:
- Email address
- 密码
Once completed, you can log in using the newly created credentials.
重要文件和目录
- 安装目录:
/root/healthchecks - 环境文件:
/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证书:
/etc/nginx/ssl/fullchain.pem,/etc/nginx/ssl/privkey.pem - Admin credentials:
/root/.cloudzy-creds
Manage the 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
Email Settings Configuration (Optional)
Email configuration is required to enable notifications (e.g., alerts, reports).
Ensure SMTP connections are allowed on this server. Request SMTP access if it is currently disabled.
Edit the environment file:
nano /root/healthchecks/.env
Uncomment and configure the following variables with your SMTP provider details:
# 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
Apply the changes by restarting the service:
docker compose up -d
Enabling SSL with a Domain (Optional)
1. 将您的域名指向服务器IP地址。
2. Edit .env to set your domain as 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. 安装 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 配置文件中替换 SSL 路径(TLS 部分):
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
