# Domínio Personalizado

## 🧭 Visão Geral

Você pode mapear seu próprio domínio (ex. `yourdomain.com`) ou um subdomínio (ex. `dash.yourdomain.com`) para uma aplicação hospedada na Discloud. A plataforma serve o tráfego através do [subdomínio Discloud](/faq/general-questions/how-to-create-a-subdomain.md) da sua aplicação usando dois registros A apontando para nossos endereços IPv4 e valida a propriedade via registros TXT.

<figure><img src="/files/xTWW8YgmCxOk3iK2ZWtG" alt="Diagrama de fluxo do domínio personalizado"><figcaption></figcaption></figure>

***

## 📋 Requisitos

{% hint style="success" %}
[Plano Diamante ou superior](https://discloud.com/plans) é necessário para hospedar websites ou APIs.
{% endhint %}

{% hint style="success" %}
[Aplicação já hospedada](/how-to-host/websites-and-apis.md) usando um subdomínio da Discloud (ex. `exemplo.discloud.app`)
{% endhint %}

{% hint style="success" %}
Um domínio registrado que você controla (Cloudflare, Hostinger, GoDaddy, Namecheap, etc.)
{% endhint %}

{% hint style="success" %}
Capacidade de adicionar / modificar registros A e TXT
{% endhint %}

***

## 🏗️ Adicione Seu Domínio (Painel)

{% stepper %}
{% step %}
Abra o [Painel da Discloud](https://discloud.com/dashboard) → seção Domínio Personalizado.
{% endstep %}

{% step %}
Digite seu domínio (ex. `seudominio.com`). Opcionalmente, especifique um subdomínio (ex. `dash`).
{% endstep %}

{% step %}
Clique em **Registrar** e depois no botão **DNS**. Ao clicar nele, você verá os registros que precisa configurar (A e, se necessário, tokens TXT).
{% endstep %}
{% endstepper %}

<div data-full-width="false"><figure><img src="/files/mWGEHZnS2QNYpk8zRdno" alt=""><figcaption></figcaption></figure> <figure><img src="/files/C3Gfne3tFMW2iQwoWBMO" alt="Lista de registros A mostrando 75.2.96.173 e 99.83.186.151"><figcaption></figcaption></figure></div>

***

## ✅ Verificar e Configurar DNS

Embora qualquer provedor de DNS funcione, abaixo estão cenários com abas para clareza.

{% tabs %}
{% tab title="Domínio Raiz" %}
**Registros**

| Tipo                | Nome                      | Valor                |
| ------------------- | ------------------------- | -------------------- |
| A                   | `@` (ou raiz do provedor) | `75.2.96.173`        |
| A                   | `@` (ou raiz do provedor) | `99.83.186.151`      |
| TXT *(se mostrado)* | `@` / fornecido           | Token de verificação |
| {% endtab %}        |                           |                      |

{% tab title="Subdomínio" %}
**Exemplo: `dash.seudominio.com`**

<table><thead><tr><th width="169">Tipo</th><th width="383">Nome</th><th>Valor</th></tr></thead><tbody><tr><td>A</td><td><code>dash</code></td><td><code>75.2.96.173</code></td></tr><tr><td>A</td><td><code>dash</code></td><td><code>99.83.186.151</code></td></tr><tr><td>TXT <em>(se mostrado)</em></td><td>Fornecido (<code>dash</code> / <code>_discloud-verification</code>)</td><td>Token de verificação</td></tr></tbody></table>

Múltiplos subdomínios (ex. `api`, `app`) repetem este padrão independentemente.
{% endtab %}
{% endtabs %}

{% hint style="warning" %}

#### **Proxy do Cloudflare**

Se você usar **Cloudflare**, é obrigatório desabilitar o **Proxy** (certifique-se de que está definido como **DNS Only** / **Nuvem Cinza**, não a Laranja). Isso garante a emissão correta do certificado SSL.
{% endhint %}

<figure><img src="/files/eJ9XeBoUHz2eRxtatw5e" alt=""><figcaption></figcaption></figure>

***

## 🔄 Reconstruir a Aplicação

Após o DNS resolver e os tokens validarem, abra a aplicação vinculada e acione a Reconstrução para que a vinculação se torne ativa.

<div data-full-width="false"><figure><img src="/files/STQRzoKDwgbtfAX1ty27" alt="Lista de aplicações mostrando domínio personalizado"><figcaption></figcaption></figure> <figure><img src="/files/LmNlkarrs6WphsNUMPpu" alt=""><figcaption></figcaption></figure></div>

***

### 📡 **Propagação DNS**

* Mudanças de DNS normalmente se propagam em alguns minutos.
* No entanto, **valores TTL** e **cache do resolvedor** podem causar alguns atrasos.
* Para verificar as mudanças em todo o mundo, confira [dnschecker.org](https://dnschecker.org/)
* Se alguns POPs ainda exibirem registros antigos, aguarde e verifique novamente mais tarde.

<figure><img src="/files/2cc3kHRnuLJuXAOUL5gJ" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.discloud.com/api-and-integrations/custom-domain.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.