Troubleshooting do Nginx Proxy Manager (HA)
🛠️ Troubleshooting — NPM (HA)
Section titled “🛠️ Troubleshooting — NPM (HA)”🎯 Objetivo
Section titled “🎯 Objetivo”Restaurar acesso com diagnóstico rápido, usando uma sequência única de verificação.
🚨 Triage inicial (sempre nesta ordem)
Section titled “🚨 Triage inicial (sempre nesta ordem)”curl http://192.168.1.20:9080/status.jsonnslookup git.scultetus.dev.brcurl -k -I https://git.scultetus.dev.brdocker ps | grep -E 'nginx-proxy-manager|keepalived'🔎 Matriz de sintomas
Section titled “🔎 Matriz de sintomas”| Sintoma | Verificar primeiro | Ação operacional |
|---|---|---|
| VIP não responde | keepalived / estado MASTER | validar cluster e IP anunciado |
| DNS não resolve | Pi-hole primário/backup | validar DHCP + resolvedor secundário |
resolve, mas retorna 502 | backend do serviço | validar backend direto por IP |
| NAS desatualizado | sync NPM | executar /opt/scripts/npm-sync.sh |
| erro de sync por permissão | arquivos root no container | manter tar com sudo |
| página OpenResty | proxy_pass no host | revisar configuração do host no NPM |
| falha de login externa | Authelia no RPi | validar 192.168.1.11:9091 e snippets |
🔧 Comandos de apoio
Section titled “🔧 Comandos de apoio”ip addr | grep 192.168.1.20arp -a | grep 192.168.1.20curl http://192.168.1.11:9091/api/healthdocker exec -it nginx-proxy-manager curl http://SERVICO_INTERNO🧭 Regra de decisão rápida
Section titled “🧭 Regra de decisão rápida”DNS falha? -> tratar Pi-holeVIP falha? -> tratar keepalivedVIP ok + 502? -> tratar backend/NPMLogin falha? -> tratar Authelia (RPi)