为实例配置主机名

关于 GitHub Enterprise Server 的主机名

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

管理控制台 中的主机名设置应设置为合适的完全限定域名 (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 实例 的主机名，则必须将现有实例的备份还原到具有所需主机名的新实例。 有关详细信息，请参阅“更改实例的主机名”。