Skip to main content

Configuración del nombre de host para la instancia

Puedes proporcionar acceso fiable a tu instancia de GitHub Enterprise Server si asignas un nombre de host accesible a través de la red.

Acerca del nombre de host para GitHub Enterprise Server

Para proporcionar acceso fiable a tu instancia de GitHub Enterprise Server a través de un nombre conocido en la red, puedes configurar un nombre de host. Si configuras un nombre de host en lugar de utilizar una dirección IP codificada de forma rígida, podrás cambiar el hardware físico que ejecuta la tu instancia de GitHub Enterprise Server sin que los usuarios ni el software cliente se vean afectados.

La configuración del nombre de host en la Consola de administración debe ajustarse a un nombre de dominio adecuado y que cumpla con todos los requisitos (FQDN) el cual se pueda resolver en la internet o dentro de tu red interna. Por ejemplo, el valor de nombre de host podría ser github.companyname.com.. Las solicitudes web y de API se redirigirán automáticamente al nombre de host configurado en la Consola de administración. Ten en cuenta que localhost no es una configuración válida de nombre de host.

Los nombres de host deben tener menos de 63 caracteres según la Sección 2.3.4 de la RFC de especificación de nombres de dominio.

Después de configurar un nombre de host, puedes habilitar el aislamiento de subdominios para incrementar aún más la seguridad de la tu instancia de GitHub Enterprise Server. Para obtener más información, vea «Habilitar el aislamiento de subdominio».

GitHub recomienda encarecidamente no cambiar el nombre de host de una instancia de GitHub Enterprise Server existente. Cambiar el nombre del host ocasionará un comportamiento inesperado que puede incluir y llegar hasta la interrupción del servicio. En su lugar, configura una nueva instancia con el nombre de host deseado y, a continuación, restaura la configuración y los datos de la instancia original a la nueva instancia.

Para más información sobre los tipos de nombre de host admitidos, vea la Sección 2.1 de HTTP RFC.

Configurar el nombre de host

  1. Desde una cuenta administrativa de GitHub Enterprise Server, en la esquina superior derecha de cualquier página, haga clic en .

  2. Si todavía no está en la página "Administrador del sitio", en la esquina superior izquierda, haga clic en Administrador del sitio.

  3. En la barra lateral " Administrador del sitio", haz clic en Consola de administración .

  4. En la barra lateral Settings, haga clic en Hostname.

  5. En "Nombre de host", escriba el nombre de host que quiera establecer para la tu instancia de GitHub Enterprise Server.

  6. A fin de probar las configuraciones de DNS y SSL para el nuevo nombre de host, haga clic en Probar configuraciones del dominio.

  7. Si no ves una tilde verde al costado de todas las entradas, revisa tu configuración para los elementos de configuración que hayan fallado. Para obtener más información, vea «Configurar servidores de nombres DNS».

  8. En la barra lateral "Configuración" , haga clic en Guardar configuración.

    Note

    Al guardar la configuración en Consola de administración se restablecen los servicios del sistema, lo que podría generar un tiempo de inactividad visible para el usuario.

  9. Espera que se complete la fase de configuración.

Para ayudarte a mitigar diversas vulnerabilidades de scripting entre sitios, te recomendamos que habilites el aislamiento de subdominios para la tu instancia de GitHub Enterprise Server después de configurar un nombre de host. Para obtener más información, vea «Habilitar el aislamiento de subdominio».

Cambiar el nombre de host

Si necesitas cambiar el nombre de host de tu instancia de GitHub Enterprise Server, debes restaurar una copia de seguridad de la instancia existente en una nueva instancia con el nombre de host deseado. Para obtener más información, vea «Cambiar el nombre de host de la instancia».

Warning

No cambies el nombre de host de GitHub Enterprise Server después de la configuración inicial. Cambiar el nombre del host ocasionará un comportamiento inesperado que puede incluir, llegar hasta la interrupción del servicio y a la invalidación de las claves de seguridad de los usuarios. Si ha cambiado el nombre de host de la instancia y tiene problemas, póngase en contacto con Soporte técnico para GitHub Enterprise o Soporte prémium de GitHub.