Tutoriais de VPS
Corrigir Cloudflare 525 e 526 no VPS: TLS da origem e Full (strict) (2026)
Identifique a origem afetada, teste TLS com SNI, corrija a cadeia e valide requisições novas da Cloudflare mantendo a verificação de identidade.

Se um site com proxy da Cloudflare apresenta 525 SSL handshake failed ou 526 Invalid SSL certificate, normalmente é preciso investigar o HTTPS entre a Cloudflare e o VPS de origem. Um certificado válido da Cloudflare no navegador não comprova que o certificado e a configuração TLS da origem estejam corretos.
Este guia trata de sites HTTPS com proxy convencional, usando Linux, Nginx, curl e OpenSSL. Identifique o erro, confirme a origem real, teste TLS mantendo o domínio, corrija o certificado ou a negociação e valide uma requisição nova pela Cloudflare. Tunnel, Spectrum e Zero Trust Gateway usam conexões diferentes; consulte também a documentação específica desses produtos.
| Erro | Onde ocorre | Por onde começar |
|---|---|---|
525 SSL handshake failed | Negociação TLS entre Cloudflare e origem | Escuta HTTPS, SNI, protocolos/cifras, conexões interrompidas e certificado de cliente |
526 Invalid SSL certificate | Validação do certificado da origem | Validade, domínio, emissor, cadeia e certificado realmente entregue |
Em um site convencional com proxy, 525 pode ocorrer nos modos Full ou Full (strict). O 526 costuma envolver a validação do certificado no Full (strict). Certificados podem participar dos dois erros, mas a ordem de investigação muda. Consulte a documentação de 525 e 526.
São duas conexões: visitante → Cloudflare → VPS de origem. O certificado de borda protege a primeira; o da origem, a segunda. Trocar o certificado de borda pode não alterar o problema da origem.
Guarde domínio completo, horário, código e Ray ID. Em falhas intermitentes, registre também os períodos de funcionamento. No painel da Cloudflare, confira:
- O modo SSL/TLS e as regras que possam sobrescrevê-lo para esse domínio.
- Se o endereço de origem configurado no DNS ainda corresponde ao VPS atual.
- Vários registros A/AAAA, origens do balanceador e portas de origem personalizadas.
- Origin Rules que alterem destino, Host ou SNI.
Com o proxy ativo, consultas DNS públicas normalmente retornam endereços da Cloudflare. A IP de borda obtida com dig example.com não é a IP do VPS. Confirme a origem no painel e nos dados da instância.
Um certificado vencido em apenas um servidor pode dar a impressão de que atualizar a página resolve. Verifique todos os endereços capazes de receber requisições de origem, incluindo IPv4 e IPv6, e suas escutas reais.
Substitua example.com pelo domínio com erro e 203.0.113.10 pela IP da origem. A opção --resolve do curl escolhe temporariamente o endereço e mantém o domínio na URL:
curl -v --connect-timeout 5 --max-time 15 --noproxy '*' \
--resolve example.com:443:203.0.113.10 \
https://example.com/ -o /dev/null
A requisição vai para essa IP, enquanto example.com continua definindo SNI, validação do nome no certificado e Host HTTP. --noproxy '*' impede que um proxy HTTP local encaminhe o teste. Isso não altera DNS nem o arquivo hosts. Consulte o manual do curl.
Usar somente curl https://203.0.113.10, ou acrescentar apenas o cabeçalho HTTP Host, pode selecionar outro virtual host TLS. Certificados geralmente são emitidos para domínios: um nome incompatível em acesso por IP não prova que a Cloudflare encontre o mesmo erro.
| Resultado direto | Próxima investigação |
|---|---|
| Conexão recusada ou timeout | Escuta, porta, firewall e permissão para a origem do teste |
Interrupção na negociação ou wrong version number | Se a porta serve TLS e se proxy/mapeamento aponta ao serviço correto |
| Certificado vencido, domínio incorreto ou cadeia inválida | Verificações de 526; interpretar Origin CA separadamente |
| TLS validado e resposta HTTP | Essa rota funciona; revisar a rota de origem e as regras da Cloudflare |
HTTP 403, 404 ou 500 da aplicação não é falha de negociação TLS. Separe validação do certificado, estabelecimento da conexão e resposta da aplicação.
O bloqueio do acesso direto do seu computador pode ser intencional. Preserve a proteção: teste a escuta real no próprio VPS ou libere brevemente uma IP administrativa confiável. O teste local ajuda a validar o serviço, mas não comprova a conectividade da Cloudflare.
Authenticated Origin Pulls (AOP) pode exigir certificado de cliente. Um curl comum sem ele pode ser rejeitado corretamente. Confira AOP no painel, a CA de clientes na origem e os logs antes de concluir que HTTPS está quebrado. Veja a explicação de AOP.
No VPS, consulte as escutas, valide a configuração e leia os erros:
sudo ss -lntp
sudo nginx -t
sudo tail -n 100 /var/log/nginx/error.log
sudo journalctl -u nginx -b --no-pager -n 100
Use a porta definida nas regras de origem; pode não ser 443. Em Docker, confirme que a porta pública chega ao terminador TLS, e não a uma aplicação que aceita somente HTTP. Se usa Caddy, Apache ou outro proxy, consulte os logs dele; comandos de Nginx não ajudam em uma máquina que não o executa.
Compare os registros com o horário da falha:
- Procure erros de protocolo, cifra ou certificado de cliente perto de
SSL_do_handshake() failed. - Confira resets restritos a determinadas origens, domínios ou endereços.
- Verifique certificados e chaves ilegíveis ou incompatíveis e mudanças não carregadas.
- Confira se a porta HTTPS não foi direcionada a HTTP puro.
Veja os campos TLS da configuração efetiva do Nginx:
sudo nginx -T 2>&1 | grep -E 'listen|server_name|ssl_certificate|ssl_protocols|ssl_ciphers|ssl_verify_client|ssl_client_certificate'
O bloco HTTPS esperado deve corresponder a server_name. Quando vários domínios compartilham uma IP, SNI influencia o certificado entregue. Site padrão incorreto, nomes sobrepostos e escutas erradas podem selecionar outro certificado. Consulte HTTPS no Nginx.
Identifique a incompatibilidade concreta e use configurações compatíveis com a versão do serviço e com a Cloudflare. Ativar TLS obsoleto, remover todas as restrições de cifras ou desabilitar autenticação de cliente não constitui correção duradoura.
Full (strict) exige certificado válido, emitido por uma CA pública confiável ou pela Cloudflare Origin CA, que cubra o nome solicitado ou de destino. Veja os requisitos do Full (strict).
Inspecione o certificado realmente enviado pela origem, usando SNI:
timeout 15 openssl s_client \
-connect 203.0.113.10:443 \
-servername example.com -showcerts </dev/null
-showcerts mostra os certificados enviados; não comprova uma validação completa da confiança. Para um certificado comum de CA pública, confira também nome e confiança:
timeout 15 openssl s_client \
-connect 203.0.113.10:443 -servername example.com \
-verify_hostname example.com -verify_return_error </dev/null
O OpenSSL pode informar erros e continuar a negociação. -verify_return_error interrompe quando a validação falha. Consulte s_client. A confiança local não é idêntica à avaliação da Cloudflare: considere também tipo de certificado, painel e resultado real com proxy.
Se usa Certbot, examine os arquivos locais:
sudo certbot certificates
sudo openssl x509 -in /etc/letsencrypt/live/example.com/cert.pem \
-noout -subject -issuer -dates -ext subjectAltName
Confira estes dados do certificado:
notBeforeenotAfterprecisam incluir a data atual.- O SAN deve cobrir o domínio:
*.example.comnão cobre o domínio raizexample.comnema.b.example.com. - Descarte certificados de outro site ou arquivos renovados ainda não carregados.
- Confira intermediários ausentes ou incorretos.
Arquivo novo não prova que a escuta o utiliza. Compare seus dados com o certificado servido, inclusive entre blocos, servidores e montagens de contêineres.
Em uma instalação comum do Certbot, confira estes campos no bloco HTTPS existente:
ssl_certificate /etc/letsencrypt/live/example.com/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/live/example.com/privkey.pem;
São exemplos de campos, não um arquivo para sobrescrever o site inteiro. Para outra CA, siga a cadeia e a ordem indicadas por ela. O Nginx exige o certificado do servidor antes dos intermediários no arquivo combinado; veja SSL certificate chains. Não misture certificados sem relação nem inclua a chave privada na cadeia. Mantenha a chave em arquivo restrito da origem, fora de logs e capturas públicas.
Um certificado Cloudflare Origin CA pode atender ao Full (strict), mas navegadores e curl locais normalmente não confiam nessa CA por padrão. Ao desativar o proxy, pausar a Cloudflare ou acessar diretamente a origem, unknown CA ou NET::ERR_CERT_AUTHORITY_INVALID podem refletir justamente esse limite. Consulte Origin CA e sua solução de problemas.
Para validar em uma máquina administrativa confiável, obtenha na documentação oficial da Cloudflare a raiz adequada ao tipo de emissor, confira a procedência, salve o arquivo e use-o explicitamente:
curl -v --connect-timeout 5 --max-time 15 --noproxy '*' \
--cacert /path/to/cloudflare-origin-ca-root.pem \
--resolve example.com:443:203.0.113.10 \
https://example.com/ -o /dev/null
Substitua o caminho de exemplo pelo arquivo verificado. --cacert seleciona um certificado público de CA para confiar no servidor; não é a chave privada do site nem a CA de autenticação de clientes AOP.
curl -k ignora a validação do certificado. Um teste assim não comprova a correção do 526. Se a origem também precisa atender navegadores sem Cloudflare, instale um certificado de confiança pública nessa entrada. Um aviso local isolado não justifica mudar o modo de criptografia do site inteiro.
Registre modo, regras, caminhos e configurações originais. Faça backup do arquivo real do site; este é apenas um exemplo de caminho comum:
sudo cp -a /etc/nginx/sites-available/example.com \
/etc/nginx/sites-available/example.com.backup.$(date +%Y%m%d%H%M%S)
Depois de corrigir cadeia, caminhos ou TLS, valide antes de recarregar:
sudo nginx -t && sudo systemctl reload nginx
Se falhar, corrija ou restaure a configuração antes de reiniciar. Resolva a renovação na tarefa e no processo de emissão. A Cloudflare documenta trocar strict por Full como alternativa temporária para 526, mas isso reduz a verificação da identidade da origem. Só considere uma recuperação breve com esse risco aceito; o certificado continua sem reparo.
O objetivo é a origem correta negociar TLS, apresentar certificado aceito pelo modo escolhido e atender requisições e funções da aplicação. Flexible, desativar o proxy ou ver uma página antiga em cache não comprovam esse resultado.
Teste novamente cada origem, domínio, porta e certificado; depois acesse o domínio público com proxy. Use uma URL que você tenha confirmado que não será respondida apenas por cache antigo e relacione o horário aos logs da origem. Confira status HTTP, login e APIs importantes, além da página inicial.
Em falhas intermitentes, compare certificados de todos os nós, registros A/AAAA e pools do balanceador. Guarde horário, Ray ID, logs e alterações. Um nó funcionando não comprova o funcionamento de todo o grupo.
- Se o erro virou 521/522: escuta, firewall e conexão com a origem.
- Se a renovação venceu ou não entrou em uso: Let's Encrypt, Certbot e DNS-01.
- Se a configuração não carrega: validação e reload do Nginx.
Localize a conexão TLS, a origem e o certificado servido que falham antes de alterar ajustes. Isso permite verificar a correção e manter a validação da identidade da origem.