Domínios

Um domínio é o endereço da web que os visitantes usam para acessar um projeto publicado. Todo projeto Atoms publicado recebe um endereço gratuito hospedado pela Atoms. O sufixo público exato pode depender da implantação. Se o seu plano incluir domínios personalizados, você também pode conectar um domínio que já possui ou comprar um novo domínio pelo fluxo de gerenciamento de domínios.

Comece com seu objetivo

Você não precisa entender DNS antes de escolher um caminho. Selecione a opção que corresponde ao que você deseja fazer e siga as etapas relevantes abaixo.

Escolha o caminho que corresponde ao seu objetivo

Objetivo	Onde ir
Usar o endereço gratuito da Atoms	Settings > Domains > encontrar a URL padrão .atoms.world > Edit
Conectar um domínio que você já possui	Settings > Domains > Connect Existing Domain > Connect domain
Comprar um novo domínio	Settings > Domains > Purchase New Domain > Buy new domain
Escolher o endereço público preferido	Settings > Domains > escolher o domínio > Set as Primary
Mover um domínio de outro projeto Atoms	Settings > Domains > Connect Existing Domain > Connect domain > Connected Domain > Switch > Continue
Remover um domínio conectado	Settings > Domains > escolher o domínio > Manage > Disconnect

Antes de começar

• Publique o projeto primeiro.
• Para um domínio personalizado, use um plano pago que inclua suporte a domínio personalizado.
• Certifique-se de que você pode editar os registros DNS para o hostname exato que deseja conectar.
• Identifique onde o DNS ativo do domínio é gerenciado. Isso pode ser um serviço diferente da empresa onde você registrou o domínio.
• Registre ou exporte a configuração DNS existente antes de fazer alterações.
• Verifique se o hostname já abre outro site ou serviço antes de substituir seu registro A ou CNAME.
• Mantenha os registros de e-mail e de serviços não relacionados. Não remova registros MX, SPF, DKIM, DMARC ou TXT não relacionados apenas para conectar um site.

Termos essenciais de domínio e DNS

Você só precisa de alguns conceitos de DNS para conectar um domínio com segurança.

Termo	O que significa
Domínio / hostname	O endereço que as pessoas digitam em um navegador para abrir seu site, como example.com ou app.example.com.
Domínio raiz / apex	A versão básica do seu domínio, sem nada adicionado antes dele. Por exemplo, example.com é o domínio raiz. Endereços como www.example.com e app.example.com são criados a partir dele
Subdomínio	Um endereço que adiciona uma palavra antes do seu domínio principal. Por exemplo, www.example.com , app.example.com e shop.example.com são todos subdomínios de example.com.
Provedor DNS / host DNS	O serviço onde você gerencia as configurações do seu domínio. Pode ser a mesma empresa onde você comprou seu domínio, ou pode ser um serviço diferente.
Registro DNS	Uma configuração que informa à internet como seu domínio deve funcionar, por exemplo, onde seu site deve abrir ou como a Atoms pode verificar seu domínio.
Registro A	Uma configuração DNS que aponta seu domínio para o servidor onde seu site está hospedado.
Registro AAAA	Uma configuração DNS que aponta um domínio para um endereço de servidor IPv6. A maioria dos iniciantes não precisa dessa definição durante o fluxo normal de configuração da Atoms.
TXT	Uma configuração DNS que pode conter informações de verificação. A Atoms pode pedir que você adicione uma para confirmar que você controla o domínio.
Propagação DNS	O tempo que uma alteração de DNS pode levar para ficar visível em toda a internet. Durante esse período, algumas pessoas ainda podem ver as configurações antigas.
HTTPS / TLS	A versão segura de uma conexão de site. Quando seu domínio usa HTTPS, as informações enviadas entre o visitante e seu site são criptografadas.
Primary Domain	O principal endereço da web que você deseja que os visitantes usem quando seu projeto tiver mais de um domínio conectado.

Útil quando você se deparar com eles

Termo	O que significa
CNAME	Uma configuração DNS que aponta um endereço de domínio para outro endereço de domínio.
Registrar	A empresa/entidade que registra e renova o nome de domínio para o registrante.

Personalize seu endereço gratuito da Atoms

Quando você publica um projeto pela primeira vez, a Atoms atribui um subdomínio padrão estável dentro do domínio hospedado pela Atoms. Você pode substituir esse subdomínio por outro nome disponível na experiência de Publicar/Atualizar.

1. Abra Settings > Domains.
2. Encontre a URL padrão .atoms.world.
3. Selecione Edit.
4. Digite o novo nome e selecione Update. Se o nome não puder ser usado, siga a mensagem de validação exibida na Atoms.
5. Teste o novo endereço. Abra a nova URL .atoms.world e confirme que o projeto publicado pretendido carrega em HTTPS.

Conecte um domínio que você já possui

Use este caminho quando seu domínio estiver registrado em outro lugar e você quiser que um hostname específico - como example.com, www.example.com ou app.example.com - abra seu projeto Atoms.

Escolha o hostname exato

Decida qual hostname os visitantes devem usar antes de editar o DNS. Um domínio raiz e seus subdomínios são hostnames separados. Por exemplo, example.com e www.example.com devem ser conectados individualmente se você quiser que ambos os endereços funcionem.

Inicie a conexão

1. Abra Settings > Domains.
2. Em Connect Existing Domain, selecione Connect domain.
3. Digite o hostname exato e selecione Connect domain para continuar.
4. Use a configuração assistida quando disponível. A Atoms pode identificar seu provedor DNS e oferecer um fluxo de conexão automática.
5. Escolha Manual Setup quando necessário. Se a conexão automática não estiver disponível, continue com os registros DNS que a Atoms mostrar para seu hostname.

Configure o DNS quando Manual Setup for exibido

A Atoms mostra os registros DNS necessários para o hostname que você está conectando. Não presuma que toda configuração usa os mesmos tipos de registro. Dependendo do hostname e da conexão, o roteamento do site pode usar um registro A ou um CNAME, e a verificação pode incluir um registro TXT.

Use os valores mostrados no seu projeto

Adicione apenas os tipos de registro, hosts e valores que a Atoms exibe atualmente para seu hostname. Não copie um endereço IP, destino CNAME, host TXT, token de verificação ou outro valor DNS de outro projeto ou de um exemplo.

1. Abra o provedor DNS ativo. Entre no serviço que hospeda o DNS ativo do domínio.
2. Faça backup dos registros existentes. Registre ou exporte a configuração atual antes de fazer alterações.
3. Adicione cada registro necessário exatamente como mostrado na Atoms. Isso pode incluir A, CNAME, TXT ou outro tipo de registro mostrado na configuração.
4. Proteja serviços não relacionados. Não exclua registros de e-mail nem registros TXT não relacionados. Altere apenas os registros necessários para o hostname que você está conectando.
5. Salve as alterações de DNS.
6. Volte para a Atoms e conclua a etapa de confirmação ou verificação mostrada no fluxo de conexão.

Aguarde a verificação e o HTTPS

Depois de salvar o DNS, o domínio pode mostrar "Verifying", enquanto a Atoms verifica a conexão e as informações de verificação. Alterações de DNS podem levar até 48 horas para ficarem visíveis globalmente, embora muitas vezes sejam atualizadas antes. Durante a propagação, diferentes redes podem mostrar resultados diferentes temporariamente.

Abra os detalhes do status do domínio, mantenha os registros inalterados enquanto o DNS se propaga e então selecione Recheck. Se o status for Failed, use o erro exibido e a próxima ação antes de alterar o DNS novamente.

Quando o domínio atingir Live, abra o hostname exato em HTTPS e confirme que ele carrega o projeto publicado pretendido.

Verifique a conexão

• O hostname exato aparece em Settings > Domains.
• O status do domínio é Live.
• O hostname abre em HTTPS.
• O projeto publicado correto carrega.
• Uma rota aninhada ou deep link atualizado funciona se o projeto tiver várias rotas.
• Se o projeto usar mais de um endereço conectado, cada endereço se comporta como esperado.

Domínios raiz, www e subdomínios

Pergunta	Como lidar com isso
example.com e www.example.com contam como o mesmo hostname?	Não. São hostnames separados. Conecte e teste cada um que você deseja que os visitantes usem.
O domínio raiz e o www podem ser conectados?	Sim. Conecte cada hostname separadamente e depois escolha o endereço preferido como Primary Domain.
Vários subdomínios podem ser usados?	Sim. Hostnames como app.example.com e shop.example.com podem ser configurados separadamente.
Subdomínios diferentes podem apontar para projetos diferentes?	Cada hostname pode ser configurado de forma independente, então subdomínios diferentes podem ser conectados a projetos diferentes.
O mesmo hostname pode ser conectado a dois projetos ao mesmo tempo?	Um hostname deve ser conectado a apenas um projeto por vez. Desconecte o vínculo existente antes de movê-lo para outro projeto.
Como conectar um domínio que ainda está associado a outro projeto ou a um projeto excluído?	No projeto de destino, vá para Settings > Domains > Connect Existing Domain > Connected Domain > Switch > Continue. Se o domínio não estiver disponível nesse fluxo, entre em contato com o Suporte da Atoms.

Compre um novo domínio

Use Purchase New Domain quando quiser pesquisar e registrar um novo domínio em vez de conectar um que você já possui. O checkout é concluído por meio da IONOS.

1. Abra Settings > Domains.
2. Selecione Purchase New Domain.
3. Pesquise um nome de domínio. Use os resultados da pesquisa para verificar disponibilidade e preço.
4. Adicione o domínio ao carrinho.
5. Conclua o checkout pela IONOS. Forneça as informações de registro e pagamento solicitadas durante o checkout.
6. Conclua qualquer verificação do registrante. Siga as instruções de verificação enviadas pelo registrador para que o registro permaneça ativo.
7. Volte para Settings > Domains. Siga as instruções exibidas na Atoms para concluir a configuração do domínio para seu projeto.

Escolha um Primary Domain

Um projeto pode ter mais de um endereço conectado, como um endereço gratuito .atoms.world e um ou mais domínios personalizados. O Primary Domain é o endereço que você deseja que os visitantes usem como URL pública preferida. Defini-lo seleciona o endereço preferido; isso não redireciona por si só todos os hostnames conectados.

1. Abra Settings > Domains.
2. Encontre o domínio conectado que você deseja usar. Certifique-se de que ele esteja funcionando antes de torná-lo primário.
3. Selecione Set as Primary.
4. Teste o resultado. Abra o endereço primário e confirme que ele carrega o projeto pretendido. Teste redirecionamentos separadamente apenas para links históricos depois de ativar Redirect; a Atoms oferece suporte ao redirecionamento de até dois links.

Os cartões de domínio mostram o estado de cada domínio conectado. Use o status como ponto de partida e depois teste o próprio hostname.

Status	O que significa	O que fazer
Live	O domínio concluiu o fluxo de conexão e verificação.	Abra o hostname em HTTPS e confirme que o projeto publicado correto carrega.
Verifying	A Atoms está verificando a conexão do domínio e as informações de verificação.	Aguarde o tempo de propagação do DNS e certifique-se de que os valores A/TXT correspondem aos mostrados na Atoms. Se não avançar, use o guia Solução de problemas de domínio e SSL.
Disconnected	O domínio não está conectado ao projeto no momento.	Reconecte-o se necessário ou use o fluxo Switch se estiver movendo-o de outro projeto Atoms.
Failed	O processo de conexão ou verificação não foi concluído com sucesso.	Revise o erro mostrado na Atoms, confirme o hostname e os valores DNS e tente novamente após corrigir o problema identificado.

Desconecte, troque ou substitua um domínio com segurança

Se um domínio já recebe tráfego, verifique o destino ou a substituição antes de remover uma conexão em funcionamento. Isso evita deixar os visitantes sem um endereço utilizável.

Mova um domínio de outro projeto Atoms

1. Abra o projeto de destino e vá para Settings > Domains.

2. Em Connect Existing Domain, selecione Connect domain.

3. Escolha Connected Domain.

4. Selecione Switch e depois Continue.

5. Verifique o resultado. Confirme que o projeto pretendido carrega em HTTPS e que o domínio atinge Live. Se o domínio não estiver disponível nesse fluxo, entre em contato com o Suporte da Atoms.

Desconecte um domínio

1. Abra Settings > Domains.

2. Escolha o domínio conectado e selecione Manage > Disconnect.

3. Verifique os endereços restantes. Certifique-se de que o projeto ainda tenha o endereço funcional que você pretende manter.

Desconectar ou excluir um domínio. Escolha Disconnect quando quiser apenas desvincular o domínio do projeto atual. Escolha Delete Domain quando quiser removê-lo da sua conta ou do seu conjunto de domínios.

A exclusão pode desvincular o domínio de outros projetos conectados, que então voltam para seus endereços padrão da Atoms. Isso exige confirmação explícita, e reconectar depois exige adicionar os registros DNS novamente.

Substitua um domínio público por outro domínio

1. Conecte primeiro o substituto.

2. Aguarde o substituto atingir Live.

3. Selecione Set as Primary para o substituto.

4. Verifique o substituto e o endereço alternativo .atoms.world.

5. Desconecte o domínio antigo com Manage > Disconnect.

6. Limpe o DNS antigo somente depois que o substituto for confirmado. Se o hostname antigo não deve mais apontar para a Atoms, remova ou substitua apenas os registros antigos específicos da Atoms no provedor DNS.

Não use Unpublish apenas para alterar um domínio

Unpublish tira o site publicado do ar. Trocar ou remover um domínio é uma ação separada de gerenciamento de domínio.

Checklist de lançamento pós-conexão

Um status Live confirma a conexão, mas finalize com algumas verificações específicas de domínio antes de considerar a alteração concluída.

• Abra o hostname de produção exato em HTTPS em uma janela privada/anônima.

• Confirme que o projeto Atoms pretendido carrega.

• Se tanto o domínio raiz quanto o www/subdomínio devem funcionar, teste cada hostname separadamente.

• Se Redirect estiver ativado, teste cada link histórico selecionado e confirme que ele redireciona para o endereço preferido. A Atoms oferece suporte a até dois links redirecionados.

• Abra diretamente pelo menos uma rota aninhada e atualize-a para confirmar que o hostname roteia corretamente.

• Após uma troca ou desconexão, confirme que o hostname antigo agora se comporta como esperado.

Solução de problemas e suporte

Se um domínio conectado não atingir Live ou parar de funcionar, evite alterar várias configurações ao mesmo tempo.

1. Compare os registros DNS. Verifique cada registro atualmente mostrado na Atoms em relação aos registros publicados pelo seu provedor DNS. Dependendo da configuração, isso pode incluir A, CNAME, TXT ou outro tipo de registro exibido no fluxo de conexão.

2. Confirme o hostname exato. Certifique-se de ter editado o DNS para o mesmo hostname que você inseriu na Atoms.

3. Aguarde o tempo de propagação do DNS. Alterações de DNS podem levar até 48 horas para ficarem visíveis globalmente.

4. Teste o hostname exato em HTTPS. Verifique se o site carrega o projeto correto e se a conexão segura está disponível.

5. Use Solução de problemas de domínio e SSL. Se os registros DNS estiverem corretos, mas a verificação, o HTTPS, o roteamento, os redirecionamentos ou o gerenciamento de domínio ainda falharem, siga o guia de solução de problemas específico.

6. Obter suporte se o problema continuar. Inclua o Link do Chat do projeto e uma captura de tela que mostre claramente o problema. Você pode usar a opção Feedback em uma mensagem de agente ou a entrada de suporte por chat.

Mantenha um endereço conhecido disponível

Não remova registros DNS em funcionamento nem desconecte e reconecte repetidamente um domínio apenas para testar configurações diferentes. Mantenha o endereço .atoms.world ou outro hostname funcional disponível até que a substituição seja confirmada.