Orbit
Adicionar um Domínio Personalizado ao Seu Projeto
Every Orbit project serves on a free kaps.run address, and you can attach your own domains alongside it with an SSL certificate provisioned automatically. This guide covers adding a domain, the DNS…
Cada projeto Orbit é servido num endereço kaps.run gratuito, e pode anexar os seus próprios domínios ao lado dele com um certificado SSL aprovisionado automaticamente. Este guia cobre como adicionar um domínio, o registo DNS de que necessita, como ler os estados de verificação, escolher um domínio principal e o que verificar quando um domínio fica preso.
Antes de Começar
Precisa de um projeto Orbit com pelo menos uma implementação bem-sucedida, um domínio cuja DNS controla e um plano que inclua domínios personalizados. Os domínios personalizados estão incluídos em Liftoff e Apex; o plano Launch gratuito não os inclui. Consulte Orbit Plan Limits.
Passo 1: Adicionar o Domínio em Orbit
- Abra o seu projeto em Orbit.
- Abra o separador Domain ou clique em Manage domains no cartão Custom domains em Settings.
- Em Add a domain, escreva o nome do anfitrião, por exemplo
app.example.com. - Clique em Add.
Introduza um nome de anfitrião simples. Não inclua https://, uma barra final ou um caminho: o formulário rejeita tudo aquilo que não seja um nome de anfitrião simples com "Enter a valid hostname like app.example.com".

Pode adicionar até 25 domínios a um projeto. O primeiro que adiciona torna-se o domínio principal.
Se o domínio já está anexado a um projeto Orbit diferente, Orbit recusa-o. Remova-o do outro projeto primeiro.
Passo 2: Adicionar o Registo DNS
Orbit mostra um painel DNS setup com o registo exato a criar: um CNAME, com o Name e Value a utilizar. O destino é o mesmo independentemente de quem aloja a sua DNS.
Se o Seu Domínio Usa Kapsule DNS
- Clique em Domains na barra lateral do KPanel.
- Clique no seu domínio.
- No editor DNS, adicione um registo CNAME utilizando o Name e Value mostrados no separador Orbit Domain.
Se o Seu Domínio Usa Outro Fornecedor DNS
Inicie sessão nesse fornecedor e adicione o mesmo registo CNAME. A interface é diferente, mas o tipo de registo, nome e valor não.
Os domínios apex (example.com sem subdomínio) não podem ter um CNAME simples de acordo com o padrão DNS. Muitos fornecedores oferecem nivelamento CNAME ou um registo ALIAS ou ANAME que consegue o mesmo; utilize isso se o seu tiver. Se não tiver, publique num subdomínio como www.example.com e redirecione o apex para ele no seu fornecedor DNS ou registador.
Passo 3: Aguardar Verificação e SSL
Orbit verifica DNS por sua conta e o separador Domain relata onde chegou:
| O que vê | O que significa |
|---|---|
| Checking DNS… | Uma verificação está a ser executada agora |
| CNAME not detected yet | O registo não se propagou ou não está correto |
| CNAME verified: SSL provisioning… | O registo resolve-se, o certificado está a ser emitido |
| SSL active: CNAME verified | O domínio está ativo e a ser servido por HTTPS |
Clique em Re-check DNS para forçar uma verificação em vez de aguardar a próxima automática.
A propagação DNS demora desde alguns minutos a várias horas, dependendo do TTL nos seus registos antigos. O certificado emite dentro de um ou dois minutos de o CNAME ser detectado e renova-se automaticamente enquanto o domínio permanecer anexado.
Antes de adicionar o registo, baixe o TTL no registo existente para esse nome de anfitrião e aguarde a expiração do TTL antigo. A mudança demora então minutos em vez de horas. Isto é mais importante quando está a mover um nome de anfitrião ativo em vez de adicionar um novo.
Escolher o Domínio Principal
Com mais de um domínio anexado, um é marcado como Primary. Clique em Set as primary domain em qualquer domínio verificado para alterá-lo. O principal é o endereço canónico do projeto; os outros continuam a servir.
Remover um Domínio
Clique em Remove domain na linha.
Remover um domínio tira-o do serviço imediatamente. Os visitantes deixam de chegar ao seu projeto nesse nome de anfitrião imediatamente e o certificado deixa de ser mantido. O registo DNS no seu fornecedor não é removido: elimine-o você mesmo quando já não precisar dele, ou continuará a apontar para um nome de anfitrião que já não responde por você.
O seu projeto continua a ser servido no seu endereço kaps.run independentemente.
SSL É Automático e Gratuito
Nunca compra, carrega ou renova um certificado para um domínio Orbit. Uma vez que o CNAME resolve, um certificado é emitido e depois renovado automaticamente. Não existe um ecrã de gestão de certificados porque não há nada a gerir.
Resolução de Problemas
Preso em "CNAME not detected yet".
- Verifique o tipo de registo. Um registo A que aponta para um endereço IP não verifica; deve ser um CNAME para o valor que Orbit lhe forneceu.
- Verifique o nome do registo. Muitos editores DNS acrescentam a zona para você, portanto introduzir
app.example.compode produzirapp.example.com.example.com. Introduza apenasappse o editor mostrar a zona como sufixo. - Verifique se há um registo em conflito. Um A, AAAA ou CNAME existente no mesmo nome vencerá ou tornará a zona inválida. Remova-o.
- Verifique que editou a zona que é realmente autoritativa. Se moveu servidores de nomes recentemente, pode estar a editar a cópia do fornecedor antigo.
- Aguarde o TTL do registo que substituiu.
Verificado, mas o certificado não se ativa. Um registo CAA no domínio pode impedir a emissão. Remova-o ou adicione uma entrada que permita a autoridade de certificação que Kapsule utiliza. Se não tem a certeza, contacte o suporte com o nome do domínio.
"This domain is already attached to another project." Exatamente o que diz. Encontre o outro projeto Orbit e remova o domínio lá primeiro.
"Domain limit reached." Atingiu 25 domínios neste projeto. Remova um que já não necessite.
O domínio resolve mas mostra o site errado. Verifique o carácter CNAME target carácter por carácter. É fácil anexar o domínio a um projeto e apontar DNS para outro.
Leitura Relacionada
- What Is Orbit? para entender como funciona o endereço
kaps.run - Configuring Redirects and Rewrites para enviar caminhos antigos para novos assim que o domínio estiver ativo
- Orbit Plan Limits para saber quais os planos que incluem domínios personalizados