Configuração de Domínio Personalizado para Seu Site

A capacidade de usar um domínio personalizado é crucial para o branding e para criar uma presença online profissional para o seu site. Cada plataforma de hospedagem de sites estáticos tem seu método de configuração específico. Este documento usará o GitHub Pages como exemplo para fornecer uma visão geral básica de como configurar seu domínio personalizado. Para informações mais detalhadas, consulte a documentação oficial do GitHub Pages: https://docs.github.com/en/pages/configuring-a-custom-domain-for-your-github-pages-site.

Visão Geral

Este guia explica como:

• Configurar um Domínio Personalizado usando o GitHub Pages
• Configurar registros DNS em seu registrador de domínio

Etapas de Configuração (Exemplo do GitHub Pages)

Etapa 1: Configurar Registros DNS em Seu Provedor de Domínio

Você precisa configurar os seguintes registros DNS em seu provedor de domínio para apontar seu domínio personalizado para o GitHub Pages:

1. Registros A: Aponte seu domínio raiz (por exemplo, seusite.org) para os endereços IP dos servidores do GitHub Pages, que são:
   • 185.199.108.153
   • 185.199.109.153
   • 185.199.110.153
   • 185.199.111.153
2. Registro CNAME: Aponte seu subdomínio www (por exemplo, www.seusite.org) para seu domínio do GitHub Pages (por exemplo, seunome.github.io).

Etapa 2: Definir Domínio Personalizado no GitHub Pages

1. Navegue até as configurações do seu repositório: Vá para o seu repositório do GitHub onde o código do seu site está hospedado.
2. Abra as configurações do GitHub Pages: Clique em "Settings" e depois navegue até a seção "Pages" na barra lateral.
3. Insira seu domínio personalizado: Na seção "Custom domain", insira o nome de domínio personalizado desejado (por exemplo, www.seusite.org).
4. Salvar e Verificar: Clique em "Save". O GitHub Pages tentará verificar suas configurações de domínio personalizado.

Etapa 3: Habilitar HTTPS (Recomendado)

Nas configurações do GitHub Pages, marque a opção "Enforce HTTPS" para habilitar a criptografia em seu site. Isso é essencial para a segurança e para o bom funcionamento de alguns recursos.

Etapa 4: Alterar a URL BASE

• Configuração do Tema: Dependendo do seu tema, você pode precisar configurar a URL BASE ou configurações similares para garantir que seu site funcione corretamente com seu domínio personalizado, especialmente se os recursos da página forem carregados incorretamente.
• Encontrando a Configuração: A localização exata dessa configuração varia dependendo do tema ou do framework SSG.
  • Se estiver usando temas vitepress, a configuração geralmente está no arquivo config.mts, procure por configurações como base: '/'
  • Se estiver usando temas hugo, a configuração geralmente está no arquivo config.toml, procure por configurações como baseURL = "your-domain.org"
  • Se estiver usando temas jekyll, a configuração geralmente está no arquivo _config.yml, procure por configurações como baseurl: ""
• Definindo uma URL Base Padrão: Se o seu tema não tiver uma configuração dedicada para a URL BASE ou uma configuração semelhante, você deverá alterá-la para um formato como BASE_URL = '/', baseurl: "" ou base: '/' para evitar quaisquer conflitos.
• Exemplo para VitePress

  import { defineConfig } from 'vitepress';
  
  export default defineConfig({
    base: '/'
  })

Considerações Importantes

• Tempo de Propagação: As alterações de DNS podem levar algum tempo para se propagarem pela internet. Pode levar alguns minutos ou horas para que suas alterações entrem em vigor.
• Requisitos Específicos: Plataformas diferentes terão requisitos e layouts de interface do usuário diferentes, sempre verifique suas documentações específicas.
• Provedor de Domínio: Você precisará de acesso às configurações de DNS do seu provedor de domínio para criar ou alterar esses registros.
• Configurações VpAdmin: Depois de configurar as configurações de DNS com seu registrador de domínio, você também precisa definir o mesmo domínio na "Configuração de Sites" no VpAdmin.

Conclusão

Seguindo estas etapas, você pode configurar com sucesso um domínio personalizado para seu site hospedado no GitHub Pages. Lembre-se de consultar a documentação oficial da sua plataforma de hospedagem para obter instruções mais detalhadas, especialmente se você estiver usando uma plataforma diferente.