Pular para o conteúdo principal

Subdomínio padrão

Todo projeto do tipo site ganha um endereço https://nome.cubehost.dev, com HTTPS automático e sem configurar nada. Bots não têm endereço: eles se conectam ao Discord por conta própria.

Como escolher

Defina o subdomain no cube.json, no campo do painel ao enviar, ou deixe em branco para a Cube gerar um a partir do nome do projeto (por exemplo, loja-do-ze-k3x9qa). Alguns nomes são reservados (como www, api, app, admin, docs) e nomes que lembram bancos, marcas e órgãos públicos são bloqueados para evitar golpes. A lista cresce quando a equipe da Cube vê um golpe novo; um site que já usa um nome continua com ele. Nos dois casos, o erro é reserved_subdomain: escolha outro.

Como trocar

Em Configurações › Rede, escreva o novo subdomínio e salve. A troca vale na hora: o endereço novo passa a funcionar e o antigo deixa de responder (mostra Este endereço não existe).
Atualize os links, webhooks e integrações que apontam para o endereço antigo antes de trocar.

Domínio próprio

Use domínios seus, como loja.com.br, nos seus sites. O HTTPS sai sozinho, sem você cuidar de certificado. São três passos, que a página Domínios mostra no topo: informe o domínio, crie os registros no seu provedor e espere o Ativo. Todo plano pago tem um pacote de domínios próprios na conta, dividido entre os sites como você quiser: vários no mesmo site (como cloud.meusite.com.br e docs.meusite.com.br), um em cada ou todos num site só. O www do mesmo nome no mesmo site vai junto e não conta como outro: loja.com.br e www.loja.com.br no site são 1. Os domínios que ainda estão em Verificando também contam. Com todos em uso, um domínio novo é recusado (plan_limit_reached) com o plano que tem mais: remova um ou mude de plano. As páginas Domínios e Configurações › Rede mostram quantos estão em uso. Só sites e APIs recebem domínio: bots não recebem visitas pela internet.

Como adicionar

1

Adicione o domínio

Em Configurações › Rede do site (ou na página Domínios), clique em Adicionar domínio e digite só o nome, como loja.com.br. Marque Incluir também www.loja.com.br para o www ir junto, e escolha o endereço principal: Sem www ou Com www. O outro redireciona para ele. Se não marcou, dá para incluir o www depois no menu … do domínio: Incluir www.loja.com.br.
2

Crie os dois registros no DNS

No lugar onde você gerencia o domínio (onde comprou ou no seu provedor de DNS), crie os registros que o painel mostra:O www e a raiz usam o mesmo TXT; o www precisa do próprio CNAME (www.loja.com.br → domains.cubehost.dev). Para a raiz (loja.com.br, sem nada antes), veja antes Domínio na raiz.
3

Espere o Ativo

A Cube confere sozinha a cada minuto, e o status muda de Verificando para Ativo. A mudança no DNS pode levar alguns minutos. O HTTPS sai sozinho. Verificar confere na hora.

Domínio na raiz

Na raiz (loja.com.br, sem nada antes), o certificado HTTPS só sai quando o DNS mostra o CNAME para domains.cubehost.dev de verdade. A raiz quase nunca aceita CNAME, e o ALIAS, o ANAME e o CNAME achatado (CNAME flattening) da maioria dos provedores, como Hostinger, Namecheap e Porkbun, respondem só com os endereços, sem o CNAME. Com eles, a raiz não ativa: o painel mostra o domínio em Erro, com a explicação, e a API devolve error.code: "root_alias_unsupported". Não existe TXT a mais que resolva. O caminho que funciona em qualquer provedor:
  1. Use o www como endereço principal. Adicione www.loja.com.br, com o CNAME para domains.cubehost.dev. Como o www é um subdomínio, o CNAME funciona em todo provedor.
  2. Redirecione a raiz para o www no seu provedor, se ele tiver redirecionamento (ou encaminhamento) de domínio: mande loja.com.br para https://www.loja.com.br. Na Cube, não adicione a raiz. Se ela já estiver lá, remova.
Se você faz questão da raiz, fale com o suporte: a equipe orienta a levar o DNS do domínio para um provedor em que o CNAME da raiz funciona. O domínio continua registrado onde está; só os servidores DNS mudam.
Não copie os endereços IP do alvo para registros A ou AAAA. Eles podem mudar sem aviso, e o site deixa de abrir. Na raiz, o resultado é o mesmo do ALIAS: o certificado não sai.

Como funciona

  • Só o domínio verificado abre o site. Sem o TXT, o domínio não abre nada, mesmo com o CNAME apontado.
  • Um domínio é de uma conta só. Cadastrar um domínio que outra conta já verificou dá domain_taken. Quem cadastrou antes sem o TXT não toma o domínio de ninguém: vale quem provar a posse. Se o domínio é seu e está em outra conta, fale com o suporte.
  • Vários domínios no mesmo site: cada um tem o próprio TXT, o próprio HTTPS e o próprio status, e remover um não mexe nos outros. Cada um abre o site direto ou redireciona para outro domínio do mesmo site (308, mantendo o caminho), como o www levando à raiz. Dá para inverter o principal depois, no menu do domínio: Tornar o endereço principal.
  • Enquanto o endereço principal não está Ativo, o domínio que redireciona para ele abre o site direto, para ninguém cair num endereço que ainda não abre. Quando o principal fica Ativo, o redirecionamento liga sozinho, em até um minuto.
  • Sem o TXT em 7 dias, a Cube para de conferir sozinha e o status vira Erro; Verificar volta a procurar.
  • Site parado ou sem responder: quem abrir o domínio vê a página da Cube dizendo isso, nunca um erro cru. Veja Site não abre.
  • Erro no certificado HTTPS: confira se o CNAME aponta para domains.cubehost.dev e clique em Verificar, que pede o certificado de novo. Na raiz, veja Domínio na raiz.
  • Remover faz o domínio parar de abrir o site na hora. Para usar de novo, é só adicionar outra vez: o TXT continua o mesmo.
  • Sem nenhum site, não dá para adicionar domínio: o domínio próprio aponta para um site. A página Domínios diz isso e tem Publicar um site, que abre o Novo projeto com a Publicação na web já ligada; o site ganha o endereço em cubehost.dev com HTTPS, e o domínio entra depois.
  • Página Domínios: cada site é um grupo com o nome, o ID, quantos domínios tem e o status. Clique no grupo para ver os domínios dele. A busca no topo acha pelo domínio, pelo nome do projeto ou pelo ID, e abre os grupos com resultado. No grupo de um site, Adicionar outro domínio (ou Adicionar domínio, no site ainda sem nenhum) já vem com o site escolhido. O topo da página diz quantos domínios do plano estão em uso.
  • Trocar de plano pago não mexe nos domínios: quem muda para um plano com menos domínios do que já usa fica com todos no ar e só não adiciona outro até ficar abaixo do pacote novo. No fim do beta (a conta volta ao Free, sem site), eles param de abrir os sites, sem ser apagados.
Pela API: Domínios (listar, adicionar, redirecionar, verificar e remover).