Pular para o conteúdo
Documentação

Certificados SSL

Como emitir, renovar e acompanhar certificados Let's Encrypt (HTTP-01 e DNS-01 Cloudflare) no miniProxy e resolver os erros mais comuns.

R Regis Manze 20/11/2026 8 min de leitura

O miniProxy emite certificados gratuitos da Let's Encrypt, publica cada um no HAProxy e os renova automaticamente. A tela Certificados SSL mostra todos os certificados em uso, avisa quando algum está vencendo e permite emitir, renovar e remover.

Como funciona

  • O certificado é emitido pelo certbot. Na validação HTTP-01, a Let's Encrypt acessa http://seu-dominio/.well-known/acme-challenge/... e o HAProxy encaminha esse caminho para o certbot (porta interna 8888).
  • O caminho do desafio é liberado no topo da configuração, então restrição por IP, blocklist, GeoIP, limites, WAF e regras não barram a emissão nem a renovação.
  • O arquivo .pem final (certificado + chave) é gravado em /etc/haproxy/certs/, e o HAProxy escolhe o certificado certo pelo nome do site.
  • O domínio precisa apontar para o IP público deste servidor antes de gerar o certificado (no método HTTP-01).

A lista de certificados

O card Certificados em /etc/haproxy/certs/ mostra:

Coluna O que significa
Arquivo Nome do .pem, normalmente o domínio principal.
Dominio (CN) Nome principal do certificado.
Validade Dias restantes e a data de vencimento.
Estado valido, expira <15d ou EXPIRADO. A etiqueta drift indica que o certbot já renovou, mas o HAProxy ainda serve a versão antiga.
Acoes Botões de renovação, reemissão por DNS e remoção. O default.pem aparece como default e não pode ser removido.

Quando há certificado expirado, vencendo em menos de 15 dias ou com drift, um aviso aparece no topo da tela.

Dica: a coluna Certificado da lista de Dominios e a tabela Hosts de cada domínio mostram qual arquivo cobre cada host. Use-as para achar hosts que ficaram sem certificado.

Gerar um certificado

  1. Clique em Gerar Certificado.
  2. Preencha:
Campo O que informar
Dominio Nome principal, por exemplo loja.exemplo.com.br.
Email (para avisos Let's Encrypt) E-mail que recebe os avisos da Let's Encrypt. Vem preenchido com o e-mail configurado em Configs.
Incluir www.dominio tambem Inclui www.loja.exemplo.com.br no mesmo certificado.
Metodo de validacao HTTP-01 (padrão) ou DNS-01 (Cloudflare). O DNS-01 só fica disponível depois de configurado (veja abaixo).
  1. Clique em Gerar Certificado.

Ao terminar, o certificado é publicado e o HAProxy é recarregado.

Emitir pela tela do domínio

Para cobrir todos os hosts de um domínio (inclusive aliases), use a tela do domínio:

  1. Abra o domínio em Dominios.
  2. Abra Emitir / expandir certificado Let's Encrypt.
  3. Marque os hosts, confira o Email, escolha a Validacao (HTTP (porta 80) ou DNS Cloudflare) e clique em Emitir.

Se o domínio já tinha certificado, ele é expandido para incluir os hosts novos. O assistente Adicionar Dominio também pode emitir o certificado na criação, pela opção Gerar certificado Let's Encrypt para todos os hosts.

E-mail padrão

O e-mail usado nos certificados vem do e-mail do responsável configurado em Configs. Se ele não estiver preenchido, a tela do domínio usa o e-mail da conta Let's Encrypt já registrada no servidor. Você pode trocar o e-mail em cada emissão.

Validação DNS-01 pela Cloudflare

A validação DNS-01 prova a posse do domínio criando um registro TXT pela API da Cloudflare, sem precisar acessar o site pela porta 80. Use quando:

  • o domínio está com proxy da Cloudflare ligado (nuvem laranja) e o HTTP-01 falha com 403;
  • você quer um certificado curinga (wildcard, *.exemplo.com.br).

Para configurar, no card Validacao DNS-01 (Cloudflare):

  1. Se Plugin aparecer como nao instalado, clique em Instalar plugin e confirme.
  2. Crie na Cloudflare um API token com permissão Zone → DNS → Edit nas zonas dos seus domínios.
  3. Cole o token no campo e clique em Salvar token.

Quando plugin e token estiverem prontos, o card mostra pronto. O token é guardado em /etc/haproxy/cloudflare-dns.ini, com permissão restrita (600). Para trocar, cole um token novo e salve de novo.

Reemitir um certificado existente por DNS

Com o DNS-01 pronto, cada certificado da lista ganha o botão DNS (Reemitir via DNS-01 (Cloudflare)). Ele emite de novo o certificado com os mesmos nomes, agora validando por DNS, e publica no HAProxy. A partir daí, as renovações desse certificado também passam a usar DNS-01, automaticamente.

Dica: para um certificado curinga, inclua o host *.exemplo.com.br na lista de hosts do domínio (Editar hosts) e emita pela tela do domínio com DNS Cloudflare.

Renovação automática

Os certificados da Let's Encrypt valem 90 dias. A renovação é automática:

  • O certbot.timer do sistema roda duas vezes por dia e renova os certificados perto do vencimento.
  • Um gancho de publicação (deploy hook) do miniProxy grava o certificado renovado em /etc/haproxy/certs/, sem interromper o tráfego.
  • Um segundo gancho (post hook) valida a configuração com haproxy -c e recarrega o HAProxy uma vez só, se algum certificado mudou. Se a configuração estiver inválida, o reload é abortado.

Os ganchos são instalados e mantidos atualizados pelo próprio painel. Não é preciso configurar nada.

Renovar manualmente

Botão O que faz
Renovar Todos (topo) Roda a renovação de todos os certificados e publica no HAProxy tudo o que mudou. Se um certificado falhar (por exemplo, domínio que não resolve mais), os demais são publicados mesmo assim e o painel avisa quais tiveram problema.
Renovar (na linha) Renova só aquele certificado. Se ele ainda não está perto de vencer, o certbot não renova e o painel avisa.
Botão de alerta (na linha) Forcar renovacao, mesmo sem estar vencendo.
Republicar do Let's Encrypt Não chama a Let's Encrypt: recombina os certificados já renovados no HAProxy. Corrige o drift na hora. Também aparece como botão amarelo na linha do certificado com drift.

Atenção: a Let's Encrypt limita a emissão de certificados idênticos (5 por semana). Use Forcar renovacao só quando necessário.

Lineages órfãs

O card Lineages orfas aparece quando o certbot tem certificados que nenhum domínio do HAProxy usa. Eles são candidatos à remoção, principalmente os que nao resolve(m) (NXDOMAIN) no DNS: esses fazem a renovação automática terminar com erro. Certificado em uso pelo HAProxy nunca aparece aqui.

Confira a coluna DNS e clique em Remover para apagar a lineage do certbot e o .pem. A remoção é irreversível.

Certificado manual (comprado)

O painel não tem formulário de envio de certificado. Para usar um certificado comprado ou emitido fora da Let's Encrypt:

  1. Junte em um único arquivo .pem o certificado, a cadeia intermediária e a chave privada.
  2. Copie o arquivo por SSH para /etc/haproxy/certs/, com um nome diferente das lineages da Let's Encrypt (por exemplo loja.exemplo.com.br-manual.pem), e deixe-o legível só pelo root.
  3. Recarregue o HAProxy (por exemplo, salvando qualquer ajuste no painel ou com systemctl reload haproxy após haproxy -c).

O certificado passa a aparecer na lista com validade e estado. Os botões Renovar e DNS não se aplicam a ele: a renovação é por sua conta, antes do vencimento.

Atenção: se existir uma lineage da Let's Encrypt com o mesmo nome do arquivo, Republicar do Let's Encrypt e a renovação automática sobrescrevem o .pem. Por isso use um nome próprio para o arquivo manual.

Remover um certificado

Clique na lixeira da linha e confirme. O arquivo sai de /etc/haproxy/certs/ e o HAProxy é recarregado. Os hosts que dependiam dele passam a receber outro certificado (ou o default.pem), o que gera erro de segurança no navegador.

Erros comuns

Falha no HTTP-01: domínio não aponta para este servidor

O DNS de todos os hosts (inclusive o www) precisa apontar para o IP público deste servidor, e a porta 80 precisa estar aberta. Confira o DNS e tente de novo. Se só um dos hosts não aponta, desmarque-o na emissão pela tela do domínio.

403 no HTTP-01 com a Cloudflare (nuvem laranja)

Com o proxy da Cloudflare ligado (nuvem laranja), a requisição de validação passa pela Cloudflare antes de chegar aqui. A Let's Encrypt também valida a partir de vários pontos da internet ao mesmo tempo (validação secundária), e essas checagens podem ser bloqueadas ou desafiadas pela Cloudflare (regras de firewall, Bot Fight Mode, modo "Under Attack"), resultando em 403 ou falha na emissão.

Duas saídas:

  1. Mudar o registro para DNS only (nuvem cinza) na Cloudflare, emitir o certificado e, se quiser, voltar para laranja depois. Lembre-se de que a renovação a cada ~60 dias também usará HTTP-01.
  2. Usar DNS-01 (recomendado): configure o token e emita (ou use o botão DNS no certificado existente). A validação deixa de depender do caminho HTTP, e as renovações seguintes também passam a usar DNS.

Certificado renovado mas o site mostra o antigo (drift)

A etiqueta drift indica que o certbot já renovou, mas o HAProxy continua servindo a versão anterior. Clique em Republicar do Let's Encrypt.

"ainda nao vencendo"

Ao clicar em Renovar num certificado com muitos dias de validade, o certbot não renova. Isso é normal. Se realmente precisar, use Forcar renovacao.

Veja também

Copiar para usar com IA

Este artigo foi útil?

Que bom! O que ajudou mais? O que faltou nesta página?

Opcional — seu voto já foi registrado.

Obrigado pelo seu feedback!