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

  1. Abra o seu projeto em Orbit.
  2. Abra o separador Domain ou clique em Manage domains no cartão Custom domains em Settings.
  3. Em Add a domain, escreva o nome do anfitrião, por exemplo app.example.com.
  4. 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".

Domain tab of an Orbit project

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

  1. Clique em Domains na barra lateral do KPanel.
  2. Clique no seu domínio.
  3. 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 yetO 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 verifiedO 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.com pode produzir app.example.com.example.com. Introduza apenas app se 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

Ainda precisa de ajuda?

Envie-nos um email para support@kapsulehost.com ou abra um chat no KPanel.

Abrir KPanel
Adicionar um Domínio Personalizado ao Seu Projeto