A Mesma Fechadura, a Tua Própria Porta

A App do Home Assistant Pela Cloudflare, Trancada Com Um Certificado põe a fechadura na periferia da Cloudflare. O telemóvel tem um certificado, a Cloudflare verifica-o, e tudo o que não o tenha nunca chega a casa. Funciona, é gratuito, e significa que é a Cloudflare que guarda o portão e lê o tráfego à passagem.

Isto é a mesma fechadura com a porta na tua própria casa. O nginx ou o Caddy verifica o certificado. A tua própria autoridade de certificação emite-o. Mais ninguém está no caminho. A página de login continua invisível para tudo o que não tenha certificado, por isso o que muda não é se os estranhos entram. É quem faz o trabalho, e quem fica com o risco quando corre mal.

Tudo aqui foi montado e testado: nginx 1.30.5 e Caddy 2.11.7 em Podman, certificados do step-ca 0.30.2, cada proxy atacado sem certificado, com um certificado bom, com um revogado e com um upgrade para WebSocket, em IPv4 e IPv6. O backend do teste era um pequeno substituto que devolve os cabeçalhos que recebe, por isso os resultados mostram exatamente o que o Home Assistant receberia.

O Que Muda Quando a Cloudflare Sai

mTLS em casa com nginx ou CaddyTelemóveltem certificadoOutra pessoasem certificadoUma inundaçãonão precisa de cert.Rede de casaRouterporta 443sem escudoanti-DDoSnginx ou Caddyencadeia na tua CA?não revogado?IPv4 e IPv6step-caHome Assistantconfia no proxyRecusadono handshakepassafalha
Agora tudo chega ao teu router. O proxy recusa o que não tenha um certificado bom antes de o Home Assistant o ver. Uma inundação não precisa de certificado e, sem nada a montante para a absorver, cai na tua linha.
Versão com a Cloudflarenginx ou Caddy em casa
Quem verifica o certificadoA periferia da Cloudflare, com uma regra de WAFO teu proxy, durante o handshake TLS
Autoridade de certificaçãoGerida pela CloudflareA tua, step-ca para certificados de cliente
Quem vê o tráfego decifradoA Cloudflare, depois o Home AssistantO teu proxy e o Home Assistant, mais ninguém
Entrada a partir de foraUm túnel, só de saídaUm reencaminhamento de porta para o proxy
Um DDoS cai em cima deA CloudflareA tua linha de casa
A ligação de um estranho custaNada em casaUm handshake TLS no proxy, nunca um login no Home Assistant
IPv4 e IPv6Ambos, a Cloudflare responde a qualquer umAmbos, se a linha tiver os dois e o proxy escutar nos dois
RevogaçãoIncluída, verificada pela regraO nginx verifica uma CRL; o Caddy mantém uma lista de permitidos
Quando o fornecedor está em baixoSem acesso remotoNada muda
Custos de funcionamentoPlano gratuitoGratuito, mais o teu tempo com a CA

As duas linhas que mais importam puxam em sentidos opostos. Mais ninguém lê o teu tráfego nem te pode desligar, e isso é soberania, a razão de ser disto tudo. Mas o reencaminhamento de porta está de volta, por isso as varreduras e as inundações batem na tua linha em vez da da Cloudflare. A diferença em relação ao simples reencaminhamento de porta da comparação no artigo da Cloudflare é o que encontram quando chegam: um proxy que corta a ligação durante o handshake, e não a página de login do Home Assistant.

Sê claro sobre o que isso compra e o que não compra. O teu próprio proxy reverso não te dá proteção nenhuma contra DDoS. O mTLS impede um estranho de entrar. Não faz nada para impedir um estranho de encher a tua linha, e uma inundação não precisa de certificado para a encher. A Cloudflare absorve isso por ti em todos os planos, incluindo o gratuito1. Aqui não há ninguém a montante para o absorver, por isso uma inundação suficientemente grande tira a casa inteira da internet, e o proxy só consegue recusar ligações que chega a ver.

nginx Ou Caddy

Os dois fazem o trabalho. Diferem num sítio que importa. A revogação.

Revogação com nginx e com Caddynginx: uma CRL, trazida por um temporizadorstep-carevoga, CRL nova/1.0/crlHTTP simplesTemporizadorbusca, recarreganginxverifica a cadeiaCaddy: uma lista de permitidos, mantida à mãoTua cada reemissãoPermitidoscerts. exatosRecarregarapós cada ediçãoCaddyverificador leaf
O nginx recebe uma CRL de um temporizador e verifica-a em cada ligação. O Caddy não suporta CRL, por isso a revogação é uma lista de certificados exatos que manténs à mão.
nginx 1.30.5Caddy 2.11.7
Sem certificadoO handshake completa-se, 400 No required SSL certificate was sentHandshake recusado, curl sai com 55
Certificado revogadoRecusado, 400 The SSL certificate errorEntra diretamente só com a verificação da CA
Método de revogaçãoUma CRL, verificada ao longo de toda a cadeiaUma lista de certificados permitidos, o verificador leaf
WebSocket para a appPrecisa dos cabeçalhos Upgrade e Connection definidosFunciona sem configuração extra
IPv6Só com listen [::]:443 acrescentadoEscuta nos dois por omissão
ConfiguraçãoCerca de 30 linhasCerca de 15 linhas

A revogação é o ponto a decidir. A documentação do Caddy lista exatamente um verificador incluído no Caddy padrão, o leaf, e verifica se o certificado «is one of a defined set of permitted certificates»2. Não há CRL nem OCSP para certificados de cliente. Aponta o Caddy só para a CA e um telemóvel revogado entra à vontade. O teste mostrou exatamente isso: o phone2, revogado uma hora antes, recebeu um 200. A lista de permitidos fecha a brecha. É também uma lista que manténs à mão, durante todo o tempo em que o tiveres a correr.

A Configuração do nginx

map $http_upgrade $connection_upgrade {
    default upgrade;
    ''      close;
}

server {
    listen 443 ssl;
    listen [::]:443 ssl;
    server_name ha.example.com;

    ssl_certificate         /etc/nginx/pki/server-chain.pem;
    ssl_certificate_key     /etc/nginx/pki/server.key;
    ssl_protocols           TLSv1.2 TLSv1.3;

    # The mTLS half: only certificates from our CA, and not revoked.
    ssl_client_certificate  /etc/nginx/pki/client-ca.pem;
    ssl_verify_client       on;
    ssl_verify_depth        2;
    ssl_crl                 /etc/nginx/pki/crl-chain.pem;

    location / {
        proxy_pass http://192.0.2.10:8123;
        proxy_http_version 1.1;
        proxy_set_header Host $host;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection $connection_upgrade;
    }
}
LinhaPorque está lá
listen [::]:443 sslSem ela o nginx é só IPv4, e um telemóvel numa rede IPv6 não tem onde aterrar
ssl_verify_client onSem certificado, não entra. optional deixaria o pedido passar para ser julgado mais tarde
ssl_verify_depth 2O step-ca assina a partir de uma intermédia, por isso a cadeia é telemóvel, intermédia, raiz. O valor por omissão de 1 fica aquém3
ssl_client_certificateA intermédia e a raiz num só ficheiro
ssl_crlA CRL do step-ca e uma CRL da raiz num só ficheiro. O nginx verifica cada elo da cadeia, por isso precisa das duas
Upgrade e ConnectionA app fala com o Home Assistant por WebSocket. Sem isto a app carrega e depois fica ali parada

O ficheiro da CRL é a parte que pede cuidado, e está tudo em Certificados de Cliente a Partir do step-ca: porque é que a CRL do step-ca é rejeitada até um modelo lhe corrigir o âmbito, porque é que o nginx também quer uma CRL da raiz, e o temporizador que a renova antes de expirar. Salta isso e o nginx tranca todos os telemóveis cá fora, incluindo os bons.

O que o teste devolveu:

ClienteIPv4IPv6
Sem certificado400 No required SSL certificate was sent400
phone1200, X-Forwarded-For: 127.0.0.1200, X-Forwarded-For: ::1
phone2, revogado400 The SSL certificate error400
phone1, upgrade para WebSocket200, Upgrade: websocket passado adiante200, Upgrade: websocket passado adiante

Antes de entrar a linha listen de IPv6, o pedido em IPv6 nem sequer ligava. curl saiu com 7.

A Configuração do Caddy

ha.example.com {
	tls /etc/caddy/pki/server-chain.pem /etc/caddy/pki/server.key {
		client_auth {
			mode require_and_verify
			trust_pool file /etc/caddy/pki/client-ca.pem
			verifier leaf {
				file /etc/caddy/pki/allowed-phones.pem
			}
		}
	}
	reverse_proxy 192.0.2.10:8123
}

require_and_verify significa que o certificado tem de lá estar e tem de encadear até à CA2. verifier leaf é a revogação. Só os certificados que estão em allowed-phones.pem entram, por isso revogar um telemóvel significa tirar o seu certificado desse ficheiro e recarregar.

ClienteIPv4IPv6
Sem certificadoHandshake recusadoHandshake recusado
phone1, na lista200, X-Forwarded-For: 127.0.0.1200, X-Forwarded-For: ::1
phone2, revogado, só verificação da CA200
phone2, fora da listaHandshake recusadoHandshake recusado
phone1, upgrade para WebSocket em HTTP/1.1200, Upgrade: websocket passado adiante

A lista de permitidos tem uma armadilha própria, e o teste caiu direitinho nela. A lista guarda certificados exatos, não nomes. Volta a emitir o certificado de um telemóvel e o novo não está na lista. O phone1 foi reemitido a meio dos testes e o Caddy recusou-o com tls alert bad certificate até a lista ser refeita. Cada renovação passa a ser dois trabalhos. Emitir o certificado, e depois atualizar a lista. Esquece o segundo e o telemóvel fica trancado cá fora por nada.

O Caddy também regista enabling strict SNI-Host enforcement because TLS client auth is configured ao arrancar. É ele a fazer a coisa certa: um pedido tem de pedir no handshake o mesmo nome de anfitrião que no pedido HTTP, para que ninguém passe a verificação do certificado para um site e depois peça outro.

O Lado do Home Assistant

As mesmas definições da versão com a Cloudflare, apontadas a um proxy diferente. Em Settings → System → Network → HTTP server4:

DefiniçãoValorPorquê
Trust X-Forwarded-ForLigadoSem isto o Home Assistant recusa os pedidos que passam por proxy
Trusted proxiesSó o endereço do proxy, IPv4 e IPv6, por exemplo 192.0.2.20 e 2001:db8::20Só essa máquina pode afirmar que está a reencaminhar por alguém
Enable IP banningLigadoOs banimentos caem no endereço real do cliente que o proxy passa adiante
Home Assistant URL, Internethttps://ha.example.comA app usa isto como o seu URL externo

Põe na lista o endereço IPv6 do proxy, além do IPv4. O teste mostra o nginx a reencaminhar ::1 como endereço do cliente em IPv6, e em uso real reencaminha seja qual for o endereço de onde o telemóvel veio. Se o Home Assistant só confiar no endereço IPv4 do proxy, todos os pedidos que lhe cheguem do proxy por IPv6 são recusados.

O Telemóvel

Do step-ca, o telemóvel precisa de três ficheiros. Está tudo coberto no artigo sobre certificados de cliente do step-ca, e a montagem da própria CA em A Tua Própria Autoridade de Certificação.

FicheiroInstalar como
Certificado raizCertificado de CA
Certificado intermédioCertificado de CA
O ficheiro PKCS12 do telemóvelCertificado de utilizador de VPN e apps5

O certificado de servidor no proxy também vem do step-ca. A app Android do Home Assistant confia nos certificados de CA que o utilizador instala6, por isso aceita-o, e isso é uma segunda fechadura, não um incómodo. Um dispositivo que não tenha a tua raiz não confia no servidor, antes sequer de se pôr a questão do seu próprio certificado.

Depois define o nível de segurança da ligação da app para Most secure, tal como na versão com a Cloudflare7.

Onde Isto Falha

CasoO que aconteceO que fazer
A CRL expiraO nginx recusa todos os telemóveisRenová-la com um temporizador, como no artigo do step-ca
A CRL da raiz expiraO mesmo, um ano depoisUma data na agenda
Caddy, telemóvel revogadoEntra, a não ser que tenha saído da lista de permitidosManter a lista, ou usar o nginx
Caddy, telemóvel reemitidoTrancado cá fora até a lista ser atualizadaAtualizar a lista a cada certificado
Linha de casa atrás de NAT de operador, sem IPv6Nada consegue chegar ao reencaminhamento de portaIPv6, ou a versão com a Cloudflare
Uma inundação apontada à linha de casaTira a casa toda do ar, não só o Home AssistantA versão com a Cloudflare, se isso te preocupar mais do que um terceiro
iPhone, Wear OSO mesmo que na versão com a Cloudflare: o Android é a app documentada, o Wear OS quer o PKCS12 na configuração inicial5Testar antes de confiar nisso

Nada disto está escondido. Cada um é um trabalho. Escreve-o com uma data ou um comando ao lado e continua a ser um trabalho, não uma surpresa.

Ser Dono da Coisa Toda

A versão com a Cloudflare e esta mantêm o mesmo estranho cá fora. A diferença é em quem tens de confiar enquanto o fazem.

Com a Cloudflare confias numa empresa para guardar o portão, decifrar o tráfego e continuar a oferecê-lo de graça. Com isto confias em ti próprio para renovar uma CRL, manter uma lista em ordem e reparar quando chega uma data. Nenhuma das duas dispensa confiança. Uma espalha-a por alguém a quem não pagas nada e para quem não podes telefonar. A outra mantém-na em casa, onde a podes ver falhar e consertar.

Para a porta da frente de uma casa, sei qual prefiro. O trabalho são uns quantos ficheiros e um temporizador. Como tal, a única coisa que realmente pede é que tomes conta dela, que é o que ser dono de alguma coisa sempre quis dizer.


  1. Cloudflare — DDoS Protection — deteção e mitigação automática de DDoS, «Available on all plans». ↩︎

  2. Caddy — tls directive, client_auth — require_and_verify «Require clients to present a valid certificate that is verified»; «The one verifier, currently, shipped in standard Caddy is leaf», que verifica se o certificado «is one of a defined set of permitted certificates». ↩︎ ↩︎

  3. nginx — ngx_http_ssl_module — ssl_verify_depth tem 1 por omissão; ssl_crl: «When using intermediate certificates, their CRLs should be specified in the same file.» ↩︎

  4. Home Assistant — HTTP integration — proxies reversos, proxies de confiança e banimento de IP; definições na interface desde a 2026.8. ↩︎

  5. Home Assistant Companion — Getting Started, TLS client authentication — instalar como «VPN & app user certificate»; o Wear OS precisa do certificado fornecido como PKCS12 durante a configuração inicial. ↩︎ ↩︎

  6. home-assistant/android — network_security_config.xml — as âncoras de confiança são system mais user: «Additionally trust user added CAs». ↩︎

  7. Home Assistant Companion — Connection security level — Most secure só usa um URL não cifrado na rede de casa. ↩︎