> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://ajuda.streethosting.com.br/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Erros comuns em VPS e como corrigir

# Erros comuns ao usar VPS e como corrigir rápido (guia de troubleshooting)

Problemas no servidor vão acontecer. O que diferencia um operador experiente é saber diagnosticar rapidamente e agir com segurança. Este guia cobre os cenários mais frequentes com passos claros de resolução.

## Problema 1: não consegue conectar via SSH

### Possíveis causas
* IP incorreto ou servidor desligado.
* Firewall bloqueando porta 22.
* Chave SSH incorreta ou permissões erradas.
* Serviço SSH parado.

### Diagnóstico e solução

1. **Confirme o IP e se o servidor está online** — tente ping: `ping SEU_IP`.
2. **Acesse via console de emergência (VNC)** — disponível no painel do provedor.
3. No console, verifique:

```bash
sudo systemctl status ssh
sudo ufw status
```

4. Se SSH está parado: `sudo systemctl start ssh`.
5. Se firewall bloqueou: `sudo ufw allow OpenSSH`.
6. Se permissões da chave estão erradas:

```bash
chmod 700 ~/.ssh
chmod 600 ~/.ssh/authorized_keys
```

## Problema 2: servidor extremamente lento

### Diagnóstico rápido

```bash
# Load average
uptime

# Processos por consumo de CPU
top -o %CPU

# Uso de memória
free -h

# I/O de disco
iostat -x 1 3
```

### Causas comuns e ações

| Sintoma | Causa provável | Ação |
| ---- |
| Load alto + CPU 100% | Processo pesado ou loop | Identificar e otimizar ou matar |
| Swap alto | RAM insuficiente | Otimizar aplicação ou upgrade |
| I/O wait alto | Disco saturado | Otimizar queries, limpar logs |
| Muitas conexões | Ataque ou mal-configuração | Verificar Nginx, fail2ban |

## Problema 3: disco cheio

### Diagnóstico

```bash
df -h
du -sh /* 2>/dev/null | sort -rh | head -10
```

### Soluções rápidas

```bash
# Limpar logs antigos
sudo journalctl --vacuum-time=3d

# Limpar cache do apt
sudo apt clean

# Encontrar arquivos grandes
find / -type f -size +100M 2>/dev/null | head -20
```

### Prevenção
* Configure rotação de logs (logrotate).
* Defina retenção de backup.
* Monitore espaço com alertas ([Netdata](/pt/article/monitoramento-vps-com-netdata)).

## Problema 4: site fora do ar após mudança

### Checklist de diagnóstico

1. **DNS está apontando certo?**
```bash
dig seusite.com.br +short
```

2. **Nginx está rodando?**
```bash
sudo systemctl status nginx
sudo nginx -t
```

3. **Aplicação está respondendo?**
```bash
curl -I http://localhost:3000
```

4. **Certificado SSL expirou?**
```bash
sudo certbot certificates
```

5. **Firewall bloqueando?**
```bash
sudo ufw status
```

## Problema 5: serviço não reinicia após reboot

### Causa
O serviço não está habilitado para auto-start.

### Solução

```bash
sudo systemctl enable NOME_DO_SERVICO
sudo systemctl start NOME_DO_SERVICO
```

Para Docker Compose, garanta `restart: unless-stopped` no Compose.

Para PM2:
```bash
pm2 startup
pm2 save
```

## Problema 6: site lento para visitantes de outras regiões

### Causa
Servidor longe do público-alvo ou ausência de CDN.

### Solução
* Use CDN (Cloudflare é gratuito e eficaz).
* Escolha datacenter próximo do público.
* Habilite compressão no Nginx.

## Fluxo geral de troubleshooting

1. **Identifique o sintoma** — o que exatamente não está funcionando?
2. **Verifique logs** — `/var/log/syslog`, `/var/log/nginx/error.log`, `journalctl`.
3. **Colete métricas** — CPU, RAM, disco, rede.
4. **Isole a causa** — é aplicação, banco, rede ou sistema operacional?
5. **Aplique correção** — uma mudança por vez, testando após cada uma.
6. **Documente** — anote o que causou o problema e como resolveu.

## Perguntas frequentes (FAQ)

### Perdi acesso total ao servidor, o que faço?
Acesse via console de emergência (VNC) no painel do provedor. Na StreetHosting, o console está disponível no painel de gerenciamento.

### Como evitar que problemas se repitam?
Monitoramento + backup + documentação. Se o mesmo problema acontece duas vezes sem você ter agido, falta automação ou alerta.

### Quando devo pedir ajuda ao suporte?
Se você seguiu os passos de diagnóstico e o problema persiste, entre em contato com o suporte. Na StreetHosting, o suporte técnico entende de infraestrutura e pode ajudar em questões de servidor.

## Próximos passos

* Configure alertas com [Monitoramento com Netdata](/pt/article/monitoramento-vps-com-netdata)
* Revise segurança com [Hardening Linux](/pt/article/hardening-linux-para-vps)