Saltar para o conteúdo

Domínio próprio

Liga o teu próprio endereço (`o-meu-site.com`) à FortFox em vez de usar o endereço temporário que recebes ao criar o site. Envolve um passo de verificação por DNS para provar que o domínio é teu, e a emissão automática de certificado HTTPS.

6 min de leitura

Como funciona — visão geral

Os passos, do registar até estar online:

  1. Adicionas o domínio no painel (Sites → [site] → Domínio → Adicionar).
  2. A FortFox dá-te um token de verificação e instruções específicas.
  3. Mudas o DNS no teu provedor (GoDaddy, Cloudflare DNS, OVH, etc.):
    • Registo TXT com o token, para provar que controlas o domínio.
    • Registo A ou CNAME para apontar para a FortFox.
  4. A FortFox verifica automaticamente (re-tenta a cada 5 min).
  5. Verificado → emite certificado HTTPS via Let's Encrypt (gratuito, automático).
  6. Renovação automática a cada 60 dias.

Passo a passo

1. Adicionar no painel

Sites → site → Domínio → Adicionar domínio próprio.

Indica o domínio (o-meu-site.pt ou loja.o-meu-site.pt). Aceita-se domínios apex (exemplo.com) e subdomínios (www.exemplo.com, loja.exemplo.com).

A FortFox gera dois tipos de instruções consoante o tipo:

2a. Para um domínio apex (o-meu-site.pt)

Verificação (TXT):

  • Tipo: TXT
  • Nome: @ (ou deixa em branco — significa "o próprio domínio")
  • Valor: o token que a FortFox te dá (ex.: fortfox-verify=abc123def456)
  • TTL: 300 (ou o mais baixo que o teu provedor permita)

Apontar (A):

  • Tipo: A
  • Nome: @
  • Valor: o IP do edge FortFox que te aparece no painel (ex.: 91.99.20.50)
  • TTL: 300

Apex (o-meu-site.pt) tem de usar A (não CNAME) — limitação do standard DNS.

2b. Para um subdomínio (www.o-meu-site.pt ou loja.o-meu-site.pt)

Verificação (TXT):

  • Tipo: TXT
  • Nome: _fortfox-verify.www (atenção ao prefixo _fortfox-verify.)
  • Valor: o token
  • TTL: 300

Apontar (CNAME) — recomendado:

  • Tipo: CNAME
  • Nome: www (ou loja)
  • Valor: edge.fortfox.pt (o hostname dos edges, que resolve para todos os IPs)
  • TTL: 300

CNAME é melhor que A porque se um IP de edge mudar, não tens de atualizar nada.

3. Esperar pela propagação

DNS demora a propagar. Tipicamente 5-30 min, mas em casos extremos até 48 h (depende do TTL anterior do registo).

Para acelerar verificação:

  • Define TTL baixo (300 = 5 min) ao criar os registos novos.
  • Espera 5 min e atualiza a página da FortFox.

A FortFox vai verificar automaticamente a cada 5 minutos sem precisar de tu fazeres nada. Quando vir o registo, marca como verificado e arranca a emissão de certificado.

4. Certificado HTTPS automático

Verificado o domínio, a FortFox pede um certificado a Let's Encrypt (gratuito, válido em todos os browsers). O processo demora ~30-60 segundos.

Renovação: feita 30 dias antes de expirar, automaticamente. Nunca tens de pensar nisso.

Estado do domínio no painel

EstadoSignifica
🟡 A verificar DNSRegistos ainda não detectados. Aguarda ou verifica que os puseste corretos.
🟡 A emitir certificadoDNS OK; Let's Encrypt está a processar. Aguarda 1-2 minutos.
🟢 Verificado e seguroTudo OK. Site acessível em HTTPS no teu domínio.
🔴 FalhouProblema no DNS ou no Let's Encrypt. Vê detalhes e tenta de novo.

Vários domínios para um site

Podes ligar vários domínios ao mesmo site:

  • o-meu-site.pt + www.o-meu-site.pt (ambas as variantes do domínio principal)
  • o-meu-site.pt + meu-site.com (domínio antigo a redirecionar para o novo)

Para forçar uma versão "canónica" (www ou não-www), cria um redirecionamento permanente entre os dois.

Casos comuns

Migrei o site para a FortFox, como faço a transição sem downtime?

  1. Mantém o teu DNS atual a apontar para o servidor velho.
  2. Cria o site na FortFox. Adiciona o teu domínio (mas ainda não muda o DNS — usa o token TXT só para verificar).
  3. Testa que a FortFox responde via curl com Host: header:
    curl -H "Host: o-meu-site.pt" https://edge.fortfox.pt/
    
  4. Quando confiares, baixa o TTL do registo A/CNAME do servidor velho para 60 s.
  5. Espera o TTL passar (todos os clientes têm o valor velho cacheado por 60 s no máximo).
  6. Muda o registo A/CNAME para apontar à FortFox.
  7. Tráfego começa a fluir pela FortFox em menos de 1 min.
  8. Quando confirmares estabilidade, sobe o TTL para 3600 (cache normal).

Domain registrar não me deixa pôr TTL < 1 hora

Comum em registrars baratos (Namecheap, Web.com). Soluções:

  • Aceita 1 h de propagação (não há remédio).
  • Muda os nameservers para um provedor DNS dedicado (Cloudflare DNS gratuito, AWS Route53, etc.) que aceita TTL pequeno.

O DNS resolve mas a FortFox diz que não detecta

  • Dig manual: dig TXT _fortfox-verify.www.o-meu-site.pt — vê o que o resolver autoritativo está a dar.
  • TTL antigo cacheado: alguns resolvers globais (8.8.8.8 do Google, 1.1.1.1 da Cloudflare) podem ter o registo velho. Aguarda até a TTL do anterior expirar.
  • Erro de copy-paste: confirma que o token está exato (sem aspas, sem espaços), com fortfox-verify= no início.

Onde mexer

Sites → site → Domínio.

Em mais detalhe técnico

Métodos de verificação:

  • DNS TXT (default): mais robusto, funciona com domain transfer.
  • HTTP file: a FortFox pede um ficheiro em /.well-known/fortfox/verify.txt. Alternativa quando não controlas DNS mas controlas o servidor velho. Mais frágil.

ACME / Let's Encrypt: a FortFox usa o protocolo ACME v2 com DNS-01 challenge (não HTTP-01). Significa que a emissão funciona antes do site responder corretamente ao próprio domínio. Robustez na transição.

Wildcard certs: ainda não suportados via UI. Necessitam DNS-01 e domain ownership demonstrável — está no roadmap.

Renovação: cron interno verifica certs a expirar em ≤30 dias e renova. Falhas geram alerta no painel + email ao owner.

Multi-domain certs: a FortFox emite um cert por hostname. Não SAN-combine domínios diferentes num só cert (cada um tem o seu). Tradeoff: emit mais frequente, mas isolation maior.

OCSP stapling: ligado por defeito nos edges. Browsers verificam validez do cert sem chamar Let's Encrypt — performance e privacy.

CAA records: a FortFox respeita CAA records do teu domínio. Se tens CAA 0 issue "letsencrypt.org", a emissão funciona. Se tens CAA 0 issue "outracompanhia.com", falha. Adiciona Let's Encrypt à tua CAA se restringes.

Próximos passos

← Toda a documentação