Skip to main content

Configuración del nombre de host para la instancia

Puede proporcionar acceso confiable a tu instancia de GitHub Enterprise Server mediante la asignación de un nombre de host accesible a través de la red.

Acerca del nombre de host de GitHub Enterprise Server

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

La configuración del nombre de host en Consola de administración debe establecerse con un nombre de dominio totalmente cualificado (FQDN) adecuado que se pueda resolver en Internet o dentro de su red interna. Por ejemplo, la configuración de nombre de host podría ser github.companyname.com. Web y las solicitudes de API se redirigirán automáticamente al nombre de host configurado en .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 Especificación de Nombres de Dominio RFC.

Después de configurar un nombre de host, puede habilitar el aislamiento de subdominio para aumentar aún más la seguridad de tu instancia de GitHub Enterprise Server. Para más información, consulta Habilitar el aislamiento de subdominio.

GitHub recomienda encarecidamente no cambiar el nombre de host de una instancia existente GitHub Enterprise Server . 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, haz 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 " Site admin", haz clic en Consola de administración.

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

  5. En "Hostname", escriba el nombre de host que desea establecer para 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 más información, consulta Configurar servidores de nombres DNS.

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

    Nota:

    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 ayudar a mitigar varias vulnerabilidades de scripting entre sitios, se recomienda habilitar el aislamiento de subdominios para tu instancia de GitHub Enterprise Server después de configurar un nombre de host. Para más información, consulta Habilitar el aislamiento de subdominio.

Cambiar el nombre de host

Si necesita cambiar el nombre de host de tu instancia de GitHub Enterprise Server, debe restaurar una copia de seguridad de la instancia existente en una nueva instancia con el nombre de host deseado. Para más información, consulta Cambiar el nombre de host de la instancia.

Advertencia

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.