Skip to main content

Acerca de los dominios personalizados y las Páginas de GitHub

GitHub Pages respalda el uso de dominios personalizados o el cambio la raíz de la URL del sitio desde el valor predeterminado, como octocat.github.io, para cualquier dominio que poseas.

¿Quién puede utilizar esta característica?

GitHub Pages is available in public repositories with GitHub Free and GitHub Free for organizations, and in public and private repositories with GitHub Pro, GitHub Team, GitHub Enterprise Cloud, and GitHub Enterprise Server. For more information, see "GitHub’s plans."

GitHub Pages now uses GitHub Actions to execute the Jekyll build. When using a branch as the source of your build, GitHub Actions must be enabled in your repository if you want to use the built-in Jekyll workflow. Alternatively, if GitHub Actions is unavailable or disabled, adding a .nojekyll file to the root of your source branch will bypass the Jekyll build process and deploy the content directly. For more information on enabling GitHub Actions, see "Managing GitHub Actions settings for a repository."

Dominios personalizados compatibles

Sugerencia: Se recomienda comprobar el dominio personalizado antes de agregarlo al repositorio para mejorar la seguridad y evitar ataques de toma de control. Para obtener más información, vea «Verificar tu dominio personalizado para GitHub Pages».

GitHub Pages trabaja con dos tipos de dominios: subdominios y dominios apex. Para una lista de dominios personalizados no admitidos, consulta "Solucionar problemas de dominios personalizados y Páginas de GitHub".

Tipo de dominio personalizado compatibleEjemplo
Subdominio wwwwww.example.com
Subdominio personalizadoblog.example.com
Dominio de Apexexample.com

Puede establecer una de las configuraciones de subdominio de vértice y www, o las dos, para el sitio. Para más información sobre los dominios de vértice, vea "Uso de un dominio de vértice para el sitio de GitHub Pages".

Se recomienda usar siempre un subdominio www, incluso si también se utiliza un dominio de vértice. Al crear un sitio con un dominio de vértice, intentaremos asegurar el subdominio www de forma automática para que lo use al entregar el contenido del sitio, pero tendrá que realizar los cambios de DNS para usar el subdominio www. Si configura un subdominio de www, intentamos proteger de forma automática el dominio de vértice asociado. Para obtener más información, vea «Configurar un dominio personalizado para tu sitio de Páginas de GitHub».

Uso de un dominio personalizado en varios repositorios

Si establece un dominio personalizado para un sitio de usuario u organización, de forma predeterminada, se usará el mismo dominio personalizado para todos los sitios de proyecto propiedad de la misma cuenta. Para obtener más información sobre los tipos de sitios, consulte "Acerca de GitHub Pages".

Por ejemplo, si el dominio personalizado para el sitio de usuario es www.octocat.com y tiene un sitio de proyecto sin ningún dominio personalizado configurado que se publique desde un repositorio denominado octo-project, el sitio de GitHub Pages para ese repositorio estará disponible en www.octocat.com/octo-project.

Puede invalidar el dominio personalizado predeterminado agregando un dominio personalizado al repositorio individual.

Nota: Las direcciones URL de los sitios de proyecto que se publican de manera privada no se ven afectadas por el dominio personalizado del sitio de usuario u organización. Para más información sobre los sitios publicados de manera privada, consulta "Cambiar la visibilidad de tu sitio de GitHub Pages" en la documentación de GitHub Enterprise Cloud.

Para quitar el dominio personalizado predeterminado, debe quitar el dominio personalizado del sitio de usuario u organización.

Uso de un subdominio para tu sitio GitHub Pages

Un subdominio es la parte de una URL antes del dominio raíz. Puede configurar el subdominio como www o como una sección distintiva del sitio, como blog.example.com.

Los subdominios se configuran con un registro CNAME por medio del proveedor DNS. Para obtener más información, vea «Configurar un dominio personalizado para tu sitio de Páginas de GitHub».

Subdominios www

www es el tipo de subdominio más usado. Por ejemplo, www.example.com incluye un subdominio www.

Los subdominios www son el tipo de dominio personalizado más estable porque los subdominios www no se ven afectados por los cambios en las direcciones IP de los servidores de GitHub.

Subdominios personalizados

Un subdominio personalizado es un tipo de subdominio que no usa la variante www estándar. Los subdominios personalizados se utilizan principalmente cuando se necesitan dos secciones distintas de su sitio. Por ejemplo, puede crear un sitio denominado blog.example.com y personalizar esa sección de manera independiente a www.example.com.

Uso de un dominio apex para tu sitio GitHub Pages

Un dominio de vértice es un dominio personalizado que no contiene un subdominio, como example.com. Los dominios apex también son conocidos como dominios apex base, vacíos, desnudos, o de zona.

Un dominio de vértice se configura con un registro A, ALIASo ANAME desde el proveedor DNS. Para obtener más información, vea «Configurar un dominio personalizado para tu sitio de Páginas de GitHub».

Si usa un dominio de vértice como el dominio personalizado, también se recomienda configurar un subdominio www. Si configuras los registros correctos para cada dominio, teclea a tu proveedor de DNS, GitHub Pages creará automáticamente redireccionamientos entre los dominios. Por ejemplo, si configura www.example.com como dominio personalizado para el sitio y tiene registros DNS de GitHub Pages configurados para los dominios de vértice y www, example.com se redirigirá a www.example.com. Tenga en cuenta que las redirecciones automáticas solo se aplican al subdominio www. Las redirecciones automáticas no se aplican a ningún otro subdominio, como blog. Para más información, consulta "Configurar un dominio personalizado para tu sitio de Páginas de GitHub".

Asegurar el dominio personalizado para tu sitio de GitHub Pages

Si se inhabilita tu sitio de GitHub Pages pero este tiene configurado un dominio personalizado, está en riesgo de que lo tomen. La configuración de tu dominio personalizado con tu proveedor DNS mientras tu sitio está inhabilitado, podría hacer que alguien más aloje un sitio en un o de tus subdominios.

El verificar tu dominio personalizado previene que otros usuarios de GitHub lo utilicen con sus repositorios. Si tu dominio no está verificado y tu sitio de GitHub Pages está inhabilitado, deberías actualizar o eliminar tus registros de DNS inmediatamente con tu proveedor de DNS. Para más información, consulta "Verificar tu dominio personalizado para GitHub Pages" y "Configurar un dominio personalizado para tu sitio de Páginas de GitHub".

Existen algunos motivos por los que tu sitio pueda estar inhabilitado automáticamente.

  • Si bajaste de categoría de GitHub Pro a GitHub Free, todos los sitios de GitHub Pages que se publicaron actualmente desde repositorios privados en tu cuenta quedarán sin publicar. Para obtener más información, vea «Bajada de la categoría de un plan de una cuenta».
  • Si transfieres a un repositorio privado a una cuenta personal que está usando GitHub Free, el repositorio perderá acceso a la función de GitHub Pages, y el sitio de GitHub Pages actualmente publicado, quedará sin publicar. Para obtener más información, vea «Transferir un repositorio».

Información adicional