Skip to main content

此版本的 GitHub Enterprise 将停止服务 2022-06-03. 即使针对重大安全问题,也不会发布补丁。 要获得更好的性能、改进的安全性和新功能,请升级到 GitHub Enterprise 的最新版本。 如需升级方面的帮助,请联系 GitHub Enterprise 支持

将代理服务器与自托管运行器一起使用

您可以配置自托管运行器使用代理服务器与 GitHub Enterprise Server 通信。

注: GitHub 托管的运行器目前在 GitHub Enterprise Server 上不受支持。 您可以在 GitHub 公共路线图 上查看有关未来支持计划的更多信息。

使用环境变量配置代理服务器

如果需要一个自托管运行器来通过代理服务器通信,则自托管运行器应用程序使用在以下环境变量中设置的代理配置:

  • http:_proxy:HTTPS 流量的代理 URL。 如果需要,您也可以包括基本验证凭据。 例如:
    • http://proxy.local
    • http://192.168.1.1:8080
    • http://username:password@proxy.local
  • http_proxy:HTTP 流量的代理 URL。 如果需要,您也可以包括基本验证凭据。 例如:
    • http://proxy.local
    • http://192.168.1.1:8080
    • http://username:password@proxy.local
  • no_proxy:逗号分隔的主机列表不应使用代理。 no_proxy 中只允许使用主机名,不能使用 IP 地址。 例如:
    • example.com
    • example.com,myserver.local:443,example.org

当自托管运行器应用程序启动时,会读取代理环境变量,因此您必须在配置或启动自托管运行器应用程序之前设置环境变量。 如果您的代理配置更改,必须重新启动自托管运行器应用程序。

在 Windows 机器上,代理环境变量名称不区分大小写。 在 Linux 和 macOS 机器上,建议环境变量全部小写。 如果您在 Linux 或 macOS 上同时有小写和大写的环境变量, 例如,https://clus_proxyHTTPS_PROXY,自托管运行器应用程序将使用小写环境变量。

自托管运行器与 GitHub Enterprise Server 之间的连接通过HTTP(端口 80)或 HTTPS(端口 443)。 要确保通过 HTTPS 的连接,请为 您的 GitHub Enterprise Server 实例 配置 TLS。 更多信息请参阅“配置 TLS”。

使用 .env 文件设置代理配置

如果设置环境变量不可行,您可以在自托管运行器应用程序目录中名为 .env 的文件中设置代理配置变量。 例如,如果您想要将运行器应用程序配置为系统帐户下的服务,这可能是必需的。 当运行器应用程序启动时,它会读取代理 .env 中为代理配置设置的变量。

示例 .env 代理配置如下所示:

https_proxy=http://proxy.local:8080
no_proxy=example.com,myserver.local:443

设置 Docker 容器的代理配置

如果您在工作流程中使用 Docker 容器操作或服务容器,则除了设置上述环境变量外,可能还需要配置 Docker来使用代理服务器。

有关所需 Docker 配置的信息,请参阅 Docker 文档中的“配置 Docker 以使用代理服务器”。