Gatus

Accessing Gatus

• 브라우저를 열고 다음 주소를 방문하세요: https://<SERVER_IP>
• 브라우저에서 SSL 경고가 표시될 수 있습니다(자체 서명 인증서).
• 인증が必要です (기본 인증 팝업)
• 인증 방식: HTTP 기본 인증
• 인증 정보는 다음 위치에 안전하게 저장됩니다: /root/.cloudzy-creds

중요한 파일 및 디렉터리

• 설치 디렉터리: /opt/gatus
• Docker Compose: /opt/gatus/docker-compose.yml
• 환경 파일: /opt/gatus/.env
• Config directory: /opt/gatus/config/
• 주 구성 파일: /opt/gatus/config/config.yaml
• Database directory: /opt/gatus/data/db
• Nginx 설정: /etc/nginx/sites-available/gatus.conf
• Enabled Nginx site: /etc/nginx/sites-enabled/gatus.conf
• SSL 인증서: /etc/nginx/ssl/
• HTTP Basic Auth file: /etc/nginx/auth/.gatus-htpasswd
• 인증 정보 파일: /root/.gatus-credentials

Configuration Behavior

• Configuration files are located in /opt/gatus/config/
• YAML can be split into multiple files
• Changes are auto-reloaded
• No restart is required after edits

스택 관리

Go to the installation directory:

cd /opt/gatus

Common Docker Compose commands:

# 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

Disable HTTP Basic Auth in Nginx (Optional)

Edit the Nginx site file: /etc/nginx/sites-available/gatus.conf

Remove or comment out these lines:

auth_basic "Restricted";
auth_basic_user_file /etc/nginx/auth/.gatus-htpasswd;

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. 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