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 acessahttp://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
.pemfinal (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
- Clique em Gerar Certificado.
- 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). |
- 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:
- Abra o domínio em Dominios.
- Abra Emitir / expandir certificado Let's Encrypt.
- 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):
- Se Plugin aparecer como nao instalado, clique em Instalar plugin e confirme.
- Crie na Cloudflare um API token com permissão
Zone → DNS → Editnas zonas dos seus domínios. - 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.brna 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.timerdo 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 -ce 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:
- Junte em um único arquivo
.pemo certificado, a cadeia intermediária e a chave privada. - Copie o arquivo por SSH para
/etc/haproxy/certs/, com um nome diferente das lineages da Let's Encrypt (por exemploloja.exemplo.com.br-manual.pem), e deixe-o legível só pelo root. - Recarregue o HAProxy (por exemplo, salvando qualquer ajuste no painel ou com
systemctl reload haproxyapóshaproxy -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:
- 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.
- 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.