Accessing Gatus
- Otwórz przeglądarkę i przejdź pod adres:
https://<SERVER_IP> - Ostrzeżenie przeglądarki o SSL jest oczekiwane (certyfikat z podpisem własnym)
- Wymagane uwierzytelnienie (okno Basic Auth)
- Metoda uwierzytelniania: HTTP Basic Auth
- Dane uwierzytelniające są przechowywane bezpiecznie w:
/root/.cloudzy-creds
Ważne pliki i katalogi
- Install directory:
/opt/gatus - Docker Compose:
/opt/gatus/docker-compose.yml - Environment file:
/opt/gatus/.env - Config directory:
/opt/gatus/config/ - Główny plik konfiguracyjny:
/opt/gatus/config/config.yaml - Database directory:
/opt/gatus/data/db - Nginx config:
/etc/nginx/sites-available/gatus.conf - Aktywna witryna Nginx:
/etc/nginx/sites-enabled/gatus.conf - SSL certificates:
/etc/nginx/ssl/ - Plik Basic Auth HTTP:
/etc/nginx/auth/.gatus-htpasswd - Credentials file:
/root/.gatus-credentials
Configuration Behavior
- Pliki konfiguracyjne znajdują się w
/opt/gatus/config/ - YAML można podzielić na wiele plików
- Zmiany są przeładowywane automatycznie
- Po edycji nie jest wymagany restart
Zarządzanie stosem
Go do katalogu instalacyjnego:
cd /opt/gatus
Najczęstsze polecenia 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
Wyłącz Basic Auth HTTP w Nginx (opcjonalnie)
Edytuj plik witryny Nginx: /etc/nginx/sites-available/gatus.conf
Usuń lub zakomentuj te linie:
auth_basic "Restricted";
auth_basic_user_file /etc/nginx/auth/.gatus-htpasswd;
Reload Nginx:
systemctl restart nginx
Włączanie SSL z własną domeną
1. Wskaż domenę na adres IP serwera.
2. Edytuj konfigurację Nginx i zamień obie wartości server_name <IP>; na swoją domenę (<your-domain>) w blokach HTTP (port 80) i HTTPS (port 443):
vim /etc/nginx/sites-available/gatus.conf
3. Install Certbot:
apt install -y certbot python3-certbot-nginx
4. Uruchom następujące polecenie, aby wygenerować ważny certyfikat Let's Encrypt:
certbot certonly --nginx --non-interactive --agree-tos --email [email protected] -d yourdomain.com
5. Zaktualizuj ścieżki SSL w konfiguracji Nginx:
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. Zrestartuj Nginx, aby zastosować zmiany:
systemctl restart nginx
7. Otwórz przeglądarkę i przejdź pod adres: https://yourdomain.com
