Como instalar um certificado Let’s Encrypt (HTTPS grátis) num VPS?
Obter um certificado SSL gratuito com o Certbot para nginx ou Apache, em modo standalone ou wildcard por DNS com a Cloudflare, verificar a renovação
O Let’s Encrypt é uma autoridade de certificação gratuita e automatizada: emite certificados TLS reconhecidos por todos os navegadores, válidos durante 90 dias. O Certbot, o cliente mantido pela EFF, pede o certificado, configura o nginx ou o Apache e renova-o sozinho. Este guia abrange Debian 12 / 13 e Ubuntu 22.04 / 24.04: nginx, Apache, modo standalone sem servidor web, certificado wildcard por validação DNS com a Cloudflare, renovação por temporizador do systemd, a alternativa Caddy e os erros mais frequentes.
Procedimento passo a passo
-
Apontar o domínio para o VPS
Crie um registo A para o IPv4 do VPS, e um AAAA se o VPS tiver IPv6, e depois confirme com dig +short example.com A que a resposta é mesmo esse endereço. O Let’s Encrypt verifica o domínio a partir de vários pontos da Internet: enquanto o DNS não responder em todo o lado, o pedido falha.
-
Abrir as portas 80 e 443
A validação HTTP passa sempre pela porta 80, mesmo que o site depois sirva apenas HTTPS. Autorize a 80 e a 443 em TCP no UFW e na « Firewall » do painel ACLClouds, se estiver ativada.
-
Instalar o Certbot e o plugin do servidor web
Instale o certbot com o python3-certbot-nginx ou o python3-certbot-apache. O pacote ativa também o temporizador certbot.timer, que trata da renovação.
-
Pedir o certificado
certbot --nginx -d example.com -d www.example.com valida os dois nomes, instala o certificado na configuração do nginx e propõe redirecionar HTTP para HTTPS. Para o Apache, substitua --nginx por --apache. No primeiro pedido, o Certbot pede um endereço de e-mail e a aceitação dos termos do Let’s Encrypt.
-
Testar a renovação
Execute certbot renew --dry-run: o Certbot simula uma renovação completa no ambiente de testes do Let’s Encrypt, sem tocar nos certificados existentes. systemctl list-timers certbot.timer mostra a próxima execução do temporizador.
-
Verificar a partir do exterior
Abra https://example.com num navegador, ou execute curl -I https://example.com a partir de outra máquina. certbot certificates lista os certificados, os nomes abrangidos e a respetiva data de expiração.
Verificar o DNS e abrir as portas
dig +short example.com A
dig +short www.example.com A
ufw allow 80/tcp
ufw allow 443/tcp
ufw status
Certbot com nginx
apt update
apt install -y certbot python3-certbot-nginx
certbot --nginx -d example.com -d www.example.com
nginx -t && systemctl reload nginx
Certbot com Apache
apt update
apt install -y certbot python3-certbot-apache
certbot --apache -d example.com -d www.example.com
apachectl configtest && systemctl reload apache2
Modo standalone e modo webroot
# Aucun serveur web sur le port 80 : Certbot démarre le sien
certbot certonly --standalone -d api.example.com
# Le serveur web reste en marche et sert le dossier du site
certbot certonly --webroot -w /var/www/html -d example.com -d www.example.com
ls /etc/letsencrypt/live/example.com/
/root/.secrets/cloudflare.ini
dns_cloudflare_api_token = CLOUDFLARE_API_TOKEN
Certificado wildcard com o plugin Cloudflare
apt install -y python3-certbot-dns-cloudflare
mkdir -p /root/.secrets && chmod 700 /root/.secrets
nano /root/.secrets/cloudflare.ini
chmod 600 /root/.secrets/cloudflare.ini
certbot certonly --dns-cloudflare --dns-cloudflare-credentials /root/.secrets/cloudflare.ini --dns-cloudflare-propagation-seconds 30 -d example.com -d '*.example.com'
Renovação: temporizador, teste e hook
systemctl list-timers certbot.timer
certbot renew --dry-run
certbot certificates
cat > /etc/letsencrypt/renewal-hooks/deploy/reload-nginx.sh <<'EOF'
#!/bin/sh
systemctl reload nginx
EOF
chmod 755 /etc/letsencrypt/renewal-hooks/deploy/reload-nginx.sh
Instalar o Caddy a partir do repositório oficial
apt install -y debian-keyring debian-archive-keyring apt-transport-https curl
curl -1sLf 'https://dl.cloudsmith.io/public/caddy/stable/gpg.key' | gpg --dearmor -o /usr/share/keyrings/caddy-stable-archive-keyring.gpg
curl -1sLf 'https://dl.cloudsmith.io/public/caddy/stable/debian.deb.txt' | tee /etc/apt/sources.list.d/caddy-stable.list
chmod o+r /usr/share/keyrings/caddy-stable-archive-keyring.gpg /etc/apt/sources.list.d/caddy-stable.list
apt update
apt install -y caddy
/etc/caddy/Caddyfile
example.com, www.example.com {
reverse_proxy localhost:8080
}
Antes de começar
Precisa de um nome de domínio cuja zona DNS gere, de um VPS Linux com acesso root e de um site ou aplicação que já responda em HTTP. Os comandos são executados como root; com outra conta, acrescente sudo antes de cada um. Substitua example.com pelo seu domínio.
- Sem domínio próprio, um subdomínio gratuito em aclclouds.online também funciona: crie o registo A para o IPv4 do VPS e peça o certificado para esse nome.
- O Certbot também existe em snap, o método recomendado pela EFF para ter a versão mais recente: snap install --classic certbot. Mantenha uma só instalação: remova o pacote apt antes de passar para o snap.
- Um certificado abrange todos os nomes passados com -d: o domínio sem prefixo e o www não precisam de dois certificados.
Escolher o método de validação
O Let’s Encrypt verifica que controla o domínio antes de assinar o certificado. O Certbot responde a esta verificação de várias formas, consoante o que já corre no VPS.
- --nginx ou --apache: o plugin altera a configuração do site, obtém o certificado e instala-o. É o caso mais comum.
- --webroot: o Certbot coloca um ficheiro na pasta do site, servido pelo seu servidor web, que continua a funcionar. Depois, acrescenta o certificado à configuração por si.
- --standalone: o Certbot arranca o seu próprio servidor na porta 80. Prático para uma API, um servidor de correio ou um serviço sem servidor web, desde que a porta 80 esteja livre no momento do pedido e de cada renovação.
- Validação DNS (DNS-01): o Certbot cria um registo TXT _acme-challenge. É o único método que aceita certificados wildcard, e funciona mesmo com a porta 80 fechada.
Certificado wildcard com a Cloudflare
Um certificado wildcard *.example.com abrange todos os subdomínios de um nível, mas não o próprio example.com: peça os dois nomes. Passa obrigatoriamente pela validação DNS. Se a zona estiver na Cloudflare, o plugin certbot-dns-cloudflare cria e apaga o registo TXT sozinho, o que torna também a renovação automática.
No painel da Cloudflare, crie um token de API com a permissão Zone > DNS > Edit, limitada à zona em causa, e cole-o em cloudflare.ini. Este ficheiro dá controlo sobre o seu DNS: mantenha-o em modo 600, fora de qualquer repositório Git. Se a validação falhar porque o TXT ainda não está visível, aumente --dns-cloudflare-propagation-seconds (10 segundos por predefinição).
- O Certbot tem outros plugins DNS, por exemplo python3-certbot-dns-ovh para uma zona na OVHcloud ou python3-certbot-dns-route53 para a AWS.
- O modo --manual --preferred-challenges dns obriga a criar o TXT à mão: resolve uma vez, mas o certificado não se renova sozinho.
Como funciona a renovação automática
O pacote do Debian e do Ubuntu instala o certbot.timer, um temporizador do systemd que executa certbot renew duas vezes por dia a uma hora aleatória. O Certbot só renova os certificados perto do fim da validade: 30 dias antes da expiração com as versões incluídas no Debian 12 e no Ubuntu 24.04, ou quando resta um terço da validade a partir do Certbot 4.0. O snap instala o seu próprio temporizador, visível em systemctl list-timers.
Depois de uma renovação, o servidor web tem de recarregar o novo certificado. Os plugins --nginx e --apache tratam disso. Nos outros casos (webroot, standalone, Postfix, um contentor), coloque um script em /etc/letsencrypt/renewal-hooks/deploy/: só é executado quando um certificado mudou de facto.
- No modo standalone, se um servidor web ocupar a porta 80, acrescente --pre-hook "systemctl stop nginx" --post-hook "systemctl start nginx": o Certbot para-o durante alguns segundos em cada renovação.
- Desde junho de 2025, o Let’s Encrypt já não envia e-mails antes da expiração: vigie a data com certbot certificates ou com uma ferramenta como o Uptime Kuma.
- A validade vai diminuir: 64 dias em fevereiro de 2027 e depois 45 dias em fevereiro de 2028. Conte com o temporizador, não com uma renovação manual a cada 60 dias.
A alternativa Caddy
O Caddy é um servidor web que obtém e renova os seus certificados sozinho, sem Certbot: basta escrever o nome de domínio no Caddyfile. Usa o Let’s Encrypt, com o ZeroSSL como reserva, e redireciona HTTP para HTTPS por predefinição. É a opção mais simples para colocar uma aplicação Node.js, Python ou um contentor atrás de HTTPS com reverse_proxy.
O Caddy e o nginx não podem escutar ambos nas portas 80 e 443: escolha um ou outro. Os requisitos são os mesmos (DNS a apontar para o VPS, portas 80 e 443 abertas), e um wildcard exige um módulo DNS adicionado ao Caddy. Depois de uma alteração, systemctl reload caddy aplica o Caddyfile.
Erros comuns e soluções
O Certbot mostra a causa da falha na mensagem e em /var/log/letsencrypt/letsencrypt.log. Estes são os erros mais frequentes.
- Timeout during connect (likely firewall problem): o Let’s Encrypt não chega à porta 80. Abra 80/tcp no UFW e na firewall do painel e depois confirme que há um servidor à escuta com ss -ltnp | grep :80.
- DNS problem: NXDOMAIN looking up A: o nome ainda não existe no DNS, ou acabou de ser criado. Aguarde a propagação e verifique com dig +short example.com A @1.1.1.1.
- A validação chega a outro servidor: um registo AAAA esquecido para uma máquina antiga faz falhar o pedido, porque o Let’s Encrypt tenta primeiro o IPv6. Corrija ou apague esse AAAA.
- too many certificates already issued: limite de 50 certificados por domínio registado e por semana, ou de 5 certificados idênticos por semana. Faça os seus testes com --dry-run ou --test-cert, que usam o ambiente de testes.
- Could not bind TCP port 80 em modo standalone: o nginx ou o Apache já ocupa a porta. Use --nginx, --webroot, ou pare o servidor web durante o pedido.
- CAA record for example.com prevents issuance: um registo CAA da zona só autoriza outra autoridade. Acrescente um CAA 0 issue "letsencrypt.org".
Que VPS escolher para um site em HTTPS?
Um certificado Let’s Encrypt não custa nada e quase não consome recursos: a escolha do VPS depende do próprio site. Na ACLClouds, a 17 de novembro de 2026, o VPS Mini (2 vCPU, 8 GB de RAM, 40 GB de armazenamento) custa 4,99 € por mês sem compromisso, ou 3,99 € por mês com compromisso de um ano, e corre nginx, PHP e uma base de dados para vários sites. A imagem pré-configurada Servidor Web LEMP já instala nginx, PHP-FPM, MariaDB e Certbot.
Verificação rápida
- dig +short example.com A devolve o IPv4 do VPS.
- curl -I https://example.com responde sem erro de certificado.
- certbot certificates mostra uma data de expiração daqui a cerca de 90 dias.
- certbot renew --dry-run termina com Congratulations, all simulated renewals succeeded.
- systemctl list-timers certbot.timer indica uma próxima execução.
Perguntas frequentes
O Let’s Encrypt é mesmo gratuito?
Sim. O Let’s Encrypt é uma autoridade de certificação sem fins lucrativos, gerida pelo ISRG e financiada por donativos e patrocinadores. Os certificados são gratuitos, sem limite enquanto forem renovados, e os navegadores reconhecem-nos tal como um certificado pago com validação de domínio.
Qual a diferença entre um certificado SSL gratuito e um certificado pago?
A cifragem é a mesma. Um certificado pago pode acrescentar validação da organização (OV ou EV), uma validade mais longa ou um seguro, úteis para certas exigências contratuais. Para um site, uma API ou uma interface de administração, basta um certificado Let’s Encrypt com validação de domínio.
Como renovar manualmente um certificado Let’s Encrypt?
Execute certbot renew: só são renovados os certificados perto do fim da validade. Para forçar um certificado específico, use certbot renew --cert-name example.com --force-renewal, com moderação devido aos limites de emissão.
O certificado funciona atrás do proxy da Cloudflare?
Sim. Com o proxy ativado (nuvem laranja), defina o modo SSL/TLS da Cloudflare como Full (strict) para que a Cloudflare verifique o certificado do VPS. Se a validação HTTP falhar através do proxy, passe para o plugin DNS da Cloudflare, que não depende da porta 80.
É possível obter um certificado Let’s Encrypt para um endereço IP?
Sim, desde janeiro de 2026, mas apenas com o perfil de certificados de curta duração (cerca de 6 dias), opcional e com um cliente recente. Para um site, um nome de domínio ou um subdomínio gratuito continua a ser mais simples.
Como apagar um certificado de que já não preciso?
Remova primeiro as linhas ssl_certificate que o referem no nginx, ou as diretivas SSLCertificateFile do Apache, e depois execute certbot delete --cert-name example.com. Pela ordem inversa, o servidor web deixa de arrancar, porque o ficheiro desapareceu.