关于 的主机名
若要通过网络上的已知名称提供对 你的 GitHub Enterprise Server 实例 的可靠访问,可以配置主机名。 如果配置主机名,而不是使用硬编码 IP 地址,你将能够更改运行 你的 GitHub Enterprise Server 实例 的物理硬件,而不会影响用户或客户端软件。
管理控制台 中的主机名设置应设置为合适的完全限定域名 (FQDN),此域名可在互联网上或您的内部网络内解析。 例如,你的主机名设置可能是 github.companyname.com.
Web 和 API 请求将自动重定向到 管理控制台 中配置的主机名。 请注意,localhost
不是有效的主机名设置。
按照域名规范 RFC 的第 2.3.4 节,主机名长度必须小于 63 个字符。
配置主机名后,可以启用子域隔离以进一步提高 你的 GitHub Enterprise Server 实例 的安全性。 有关详细信息,请参阅“启用子域隔离”。
GitHub 强烈建议不要更改现有 实例的主机名。 更改主机名将会导致意外的行为,甚至包括实例中断。 请改用所需的主机名配置新实例,然后将原始实例中的设置和数据还原到新实例。
有关支持的主机名类型的详细信息,请参阅 HTTP RFC 第 2.1 节。
配置主机名
-
在 上的管理帐户中,在任一页面的右上角,单击 。
-
如果你尚未在“站点管理员”页上,请在左上角单击“站点管理员”。
-
在“ 站点管理”边栏中,单击“管理控制台”。
-
在“设置”边栏中,单击“主机名”。
-
在“主机名”下,键入要为 你的 GitHub Enterprise Server 实例 设置的主机名。
-
要测试新主机名的 DNS 和 SSL 设置,请单击“测试域设置”。
-
如果在所有条目旁边没有看到绿色的复选标记,请检查配置,查找失效的设置。 有关详细信息,请参阅“配置 DNS 域名服务器”。
-
在“设置”边栏下,单击“保存设置”。
Note
保存 管理控制台 中的设置会重启系统服务,这可能会导致用户可察觉的停机时间。
-
等待配置运行完毕。
为了帮助缓解各种跨站脚本漏洞,建议在配置主机名后为 你的 GitHub Enterprise Server 实例 启用子域隔离。 有关详细信息,请参阅“启用子域隔离”。
更改主机名
如果需要更改 你的 GitHub Enterprise Server 实例 的主机名,则必须将现有实例的备份还原到具有所需主机名的新实例。 有关详细信息,请参阅“更改实例的主机名”。
Warning
初始设置后不要更改 GitHub Enterprise Server 的主机名。 更改主机名将会导致意外的行为,甚至包括实例中断和用户安全密钥失效。 如果更改了实例的主机名并遇到问题,请联系GitHub Enterprise 支持或GitHub 高级支持。