# Domínio próprio

No plano Ultra, entregue os arquivos da CDN por um subdomínio da cidade, como midia.suacidade.com.br, com HTTPS.

Source: https://fivedash.fivex.gg/docs/pt/cdn/custom-domain

Com um domínio próprio, a CDN entrega os arquivos com o endereço da cidade, como `https://midia.suacidade.com.br/itens/agua.png`, em vez de `https://cdn.fivex.sh/cidade-exemplo/itens/agua.png`. É a placa da cidade no portão do depósito. Esta página mostra os passos exatos que aparecem no painel. É para quem cuida da CDN e tem acesso ao DNS do domínio da cidade.

## Antes de começar

* **Plano Ultra:** o domínio próprio da CDN faz parte do Ultra (1 domínio). Nos outros planos, o campo mostra "Disponível no plano Ultra." e fica bloqueado.
* **Um subdomínio:** use um subdomínio só para a CDN, como `midia.suacidade.com.br`.
* **Acesso ao DNS:** você precisa criar registros no provedor de DNS do domínio (onde o domínio foi comprado ou onde o DNS é gerenciado).
* **Nível de acesso:** **Configurações** (CDN) em **Configurar**.

## Configurar o domínio

### Abra a seção

Vá em **CDN → Configurações** e desça até **Domínio próprio**.

### Informe o subdomínio

Em **Subdomínio** ("Informe o endereço que você quer usar. Depois, vamos mostrar os registros DNS necessários."), digite o endereço, por exemplo `midia.suacidade.com.br`, e clique em **Configurar domínio**. Aparece **Domínio configurado** e o selo **Pendente**.

### Crie o registro CNAME

O painel mostra: "No provedor de DNS do seu domínio, adicione o registro abaixo para apontar este subdomínio para a CDN." No provedor de DNS, crie o registro com os valores da tabela (use os botões de copiar ao lado de cada valor).

### Crie os registros de validação

Em **Registros de validação**, o painel lista registros TXT. Crie todos eles. "Todos os valores abaixo precisam estar no DNS. Quando o nome se repetir, mantenha um TXT separado para cada valor."

### Verifique o DNS

Depois de salvar os registros no provedor, clique em **Verificar DNS**. Aparece **Status consultado** e as etapas são atualizadas.

### Espere ficar Ativo

Quando o **Domínio** e o **Certificado HTTPS** estiverem confirmados, o selo muda para **Ativo** e aparece "DNS e certificado confirmados."

### O registro CNAME

| **Tipo** | **Nome / Host**                                        | **Valor / Destino**                           |
| -------- | ------------------------------------------------------ | --------------------------------------------- |
| `CNAME`  | O seu subdomínio, por exemplo `midia.suacidade.com.br` | O destino mostrado no painel (`cdn.fivex.sh`) |

### Os registros de validação

| **Tipo** | **Nome / Host**           | **Valor / Destino**        |
| -------- | ------------------------- | -------------------------- |
| `TXT`    | O nome mostrado no painel | O valor mostrado no painel |

Copie nome e valor exatamente como o painel mostra. Pode haver mais de um TXT com o mesmo nome e valores diferentes: crie um registro para cada valor.

> No provedor, **Nome** também pode aparecer como **Host**, e **Valor** como **Destino**. Se o provedor completar o domínio automaticamente, evite repeti-lo no campo **Nome**. Por exemplo, para `midia.suacidade.com.br` num provedor que completa `suacidade.com.br`, escreva só `midia`.

## Etapas de ativação

O painel mostra duas etapas, cada uma com a sua situação.

| Etapa                 | Situações possíveis                                          |
| --------------------- | ------------------------------------------------------------ |
| **Domínio**           | **Em validação**, **Confirmado**                             |
| **Certificado HTTPS** | **Em validação**, **Em emissão**, **Em ativação**, **Ativo** |

| Mensagem                                                                     | O que significa                              |
| ---------------------------------------------------------------------------- | -------------------------------------------- |
| "Aguardando a validação do domínio e do certificado HTTPS."                  | Nada confirmado ainda. Confira os registros. |
| "O domínio foi confirmado. Falta concluir a validação do certificado HTTPS." | O CNAME está certo; falta o certificado.     |
| "O certificado foi confirmado. Falta concluir a validação do domínio."       | O certificado está certo; falta o domínio.   |
| "Aguardando a emissão do certificado HTTPS."                                 | O certificado está sendo emitido.            |
| "O certificado foi emitido. Aguardando sua ativação."                        | Falta pouco.                                 |
| "Domínio e certificado HTTPS confirmados."                                   | Tudo pronto: o selo fica **Ativo**.          |

## Depois de ativo

* Os links copiados no painel passam a usar o domínio: `https://midia.suacidade.com.br/<pasta>/<arquivo>` (sem o endereço da CDN no caminho).
* "Mantenha os registros abaixo no provedor de DNS do seu domínio." Se você apagar os registros, o domínio para de funcionar.
* Os scripts que já usam links `https://cdn.fivex.sh/<endereco>/…` continuam com o endereço padrão. Troque nos scripts se quiser usar o domínio.

## Remover o domínio

### Remova

Em **Domínio próprio**, clique em **Remover domínio**.

### Confira o resultado

Aparece **Domínio removido**. Se a remoção ainda depender do provedor, aparece "Domínio desativado. A remoção no provedor será tentada automaticamente." e o selo fica **Remoção pendente** ("A remoção será tentada automaticamente. Você também pode tentar agora."). Use **Tentar concluir remoção** para tentar de novo.

Com o domínio desativado, os arquivos continuam disponíveis pelo endereço padrão da CDN. Os registros no seu DNS podem ser apagados depois.

## Perguntas frequentes

**Apareceu "Domínio próprio da CDN faz parte do plano Ultra."**
A organização não está no Ultra. Mude o plano em **Configurações → Plano**.

**Já criei os registros e continua Pendente.**
Mudanças de DNS podem levar um tempo para valer. Confira se o nome não ficou repetido (por exemplo, `midia.suacidade.com.br.suacidade.com.br`) e se todos os TXT de validação estão lá. Depois clique em **Verificar DNS** de novo.

**Posso usar o mesmo domínio da loja ou do site de regras?**
Use um subdomínio diferente para a CDN, como `midia.suacidade.com.br`, separado de `loja.` e `regras.`.

## Próximos passos

[CDN](https://fivedash.fivex.gg/docs/pt/cdn/overview)Como a CDN funciona.
[Uso e limites](https://fivedash.fivex.gg/docs/pt/cdn/usage-and-limits)O que cada plano inclui.
[Enviar arquivos](https://fivedash.fivex.gg/docs/pt/cdn/upload-files)Copie os links novos.
[Planos e cobrança](https://fivedash.fivex.gg/docs/pt/getting-started/plans-and-billing)Mude para o Ultra.
