Acessando Gatus
- Abra o seu browser e visite:
https://<SERVER_IP> - É esperado um aviso SSL no browser (certificado autoassinado)
- A autenticação é necessária (pop-up de autenticação básica)
- Método de autenticação: autenticação básica HTTP
- As credenciais são armazenadas com segurança em:
/root/.cloudzy-creds
Ficheiros e diretórios importantes
- Diretório de instalação:
/opt/gatus - Composição do Docker:
/opt/gatus/docker-compose.yml - Ficheiro de ambiente:
/opt/gatus/.env - Diretório de configuração:
/opt/gatus/config/ - Arquivo de configuração principal:
/opt/gatus/config/config.yaml - Diretório do banco de dados:
/opt/gatus/data/db - Configuração Nginx:
/etc/nginx/sites-available/gatus.conf - Site Nginx habilitado:
/etc/nginx/sites-enabled/gatus.conf - Certificados SSL:
/etc/nginx/ssl/ - Arquivo de autenticação básica HTTP:
/etc/nginx/auth/.gatus-htpasswd - Arquivo de credenciais:
/root/.gatus-credentials
Comportamento de configuração
- Os arquivos de configuração estão localizados em
/opt/gatus/config/ - YAML pode ser dividido em vários arquivos
- As alterações são recarregadas automaticamente
- Nenhuma reinicialização é necessária após as edições
Gerenciar a pilha
Vá para o diretório de instalação:
cd /opt/gatus
Comandos comuns do 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
Desative a autenticação básica HTTP no Nginx (opcional)
Edite o arquivo do site Nginx: /etc/nginx/sites-available/gatus.conf
Remova ou comente estas linhas:
auth_basic "Restricted";
auth_basic_user_file /etc/nginx/auth/.gatus-htpasswd;
Recarregue o Nginx:
systemctl restart nginx
Ativar SSL com um domínio
1. Aponte o seu domínio para o IP do servidor.
2. Edite a configuração do Nginx e substitua ambos server_name <IP>; com o seu domínio (<your-domain>) para ambos os blocos HTTP (porta 80) e HTTPS (porta 443):
vim /etc/nginx/sites-available/gatus.conf
3. Instalar o Certbot:
apt install -y certbot python3-certbot-nginx
4. Execute o seguinte comando para gerar um certificado Let’s Encrypt válido:
certbot certonly --nginx --non-interactive --agree-tos --email [email protected] -d yourdomain.com
5. Substitua os caminhos SSL na configuração do 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. Reinicie o Nginx para aplicar as alterações:
systemctl restart nginx
7. Abra o seu browser e visite: https://yourdomain.com
