Gatus 접속
- 브라우저를 열고 방문하세요:
https://<SERVER_IP> - 브라우저 SSL 경고가 예상됩니다 (자체 서명 인증서)
- 인증이 필요합니다 (Basic Auth 팝업)
- 인증 방식: HTTP Basic Auth
- 자격 증명 저장 위치:
/root/.cloudzy-creds
중요한 파일과 디렉토리
- 설치 디렉토리:
/opt/gatus - Docker Compose:
/opt/gatus/docker-compose.yml - 환경 파일:
/opt/gatus/.env - 설정 디렉토리:
/opt/gatus/config/ - 메인 설정 파일:
/opt/gatus/config/config.yaml - 데이터베이스 디렉토리:
/opt/gatus/data/db - Nginx 설정:
/etc/nginx/sites-available/gatus.conf - 활성화된 Nginx 사이트:
/etc/nginx/sites-enabled/gatus.conf - SSL 인증서:
/etc/nginx/ssl/ - HTTP Basic Auth 파일:
/etc/nginx/auth/.gatus-htpasswd - 자격 증명 파일:
/root/.gatus-credentials
구성 동작
- 설정 파일 위치:
/opt/gatus/config/ - YAML는 여러 파일로 분리할 수 있습니다
- 변경 사항은 자동으로 다시 로드됩니다
- 편집 후 재시작이 필요하지 않습니다
스택 관리
설치 디렉토리로 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;
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
