Skip to main content

자체 호스트형 실행기를 사용하는 프록시 서버 사용

프록시 서버를 사용하여 GitHub와 통신하도록 자체 호스트형 실행기를 구성할 수 있습니다.

환경 변수를 사용하여 프록시 서버 구성

프록시 서버를 통해 통신하기 위해 자체 호스트형 실행기가 필요한 경우 자체 호스트형 실행기 애플리케이션은 다음 환경 변수에 설정된 프록시 구성을 사용합니다.

  • https_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_proxy, HTTPS_PROXY), 자체 호스트형 실행기 애플리케이션은 소문자 환경 변수를 사용합니다.

.env 파일을 사용하여 프록시 구성 설정

환경 변수를 설정하는 것이 실용적이지 않은 경우 자체 호스트형 실행기 애플리케이션 디렉터리(즉, 실행기 소프트웨어를 다운로드하고 압축을 푼 디렉터리) 내의 .env 파일에 프록시 구성 변수를 설정할 수 있습니다. 예를 들어 시스템 계정으로 실행기 애플리케이션을 서비스로 구성하려는 경우 이 작업이 필요할 수 있습니다. 실행기 애플리케이션은 시작 시 .env에서 프록시 구성을 위해 설정된 변수를 읽습니다.

.env 프록시 구성 예제

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

Docker 컨테이너에 대한 프록시 구성 설정

워크플로에서 Docker 컨테이너 작업 또는 서비스 컨테이너를 사용하는 경우 위 환경 변수를 설정하는 것 외에도 프록시 서버를 사용하도록 Docker를 구성해야 할 수 있습니다.

필요한 Docker 구성에 대한 자세한 내용은 Docker 설명서에서 "프록시 서버를 사용하도록 Docker 구성"을 참조하세요.