为实例配置主机名

关于 GitHub Enterprise Server 的主机名

若要通过网络上的已知名称可靠地访问 你的 GitHub Enterprise Server 实例，可以配置主机名。 如果配置主机名而不是使用硬编码 IP 地址，则可以更改运行的物理硬件 你的 GitHub Enterprise Server 实例 ，而不会影响用户或客户端软件。

中的 管理控制台 主机名设置应设置为可在 Internet 或内部网络中解析的相应完全限定域名（FQDN）。 例如，您的主机名可设置为 github.companyname.com.。Web 和 API 请求将自动重定向到 管理控制台 中配置的主机名。 请注意，localhost 不是有效的主机名设置。

按照域名规范 RFC 的第 2.3.4 节，主机名长度必须小于 63 个字符。

配置主机名后，可以启用子域隔离以进一步提高其安全性 你的 GitHub Enterprise Server 实例。 有关详细信息，请参阅“启用子域隔离”。

GitHub 强烈建议不要更改现有 GitHub Enterprise Server 实例的主机名。 更改主机名将会导致意外的行为，甚至包括实例中断。 请改用所需的主机名配置新实例，然后将原始实例中的设置和数据还原到新实例。

有关支持的主机名类型的详细信息，请参阅 HTTP RFC 第 2.1 节。

配置主机名

1. 在 GitHub Enterprise Server 上的管理帐户中，在任一页面的右上角，单击“”。

2. 如果你尚未在“站点管理员”页上，请在左上角单击“站点管理员”。

3. 在“ 站点管理”边栏中，单击“管理控制台”****。

4. 在“设置”边栏中，单击“主机名”。

5. 在“主机名”下方，键入要为 你的 GitHub Enterprise Server 实例 设置的主机名。

6. 要测试新主机名的 DNS 和 SSL 设置，请单击“测试域设置”。

7. 如果在所有条目旁边没有看到绿色的复选标记，请检查配置，查找失效的设置。 有关详细信息，请参阅“配置 DNS 域名服务器”。

8. 在“设置”边栏下，单击“保存设置”。

   注意

   保存 管理控制台 中的设置会重启系统服务，这可能会导致用户可察觉的停机时间。

9. 等待配置运行完毕。

为了帮助缓解各种跨站点脚本漏洞，建议在配置主机名后启用 你的 GitHub Enterprise Server 实例 子域隔离。 有关详细信息，请参阅“启用子域隔离”。

更改主机名

如果需要更改主机名 你的 GitHub Enterprise Server 实例，必须将现有实例的备份还原到具有所需主机名的新实例。 有关详细信息，请参阅“更改实例的主机名”。