다음을 통해 공유


HttpClient.DefaultProxy 속성

정의

글로벌 HTTP 프록시를 가져오거나 설정합니다.

public:
 static property System::Net::IWebProxy ^ DefaultProxy { System::Net::IWebProxy ^ get(); void set(System::Net::IWebProxy ^ value); };
public static System.Net.IWebProxy DefaultProxy { get; set; }
static member DefaultProxy : System.Net.IWebProxy with get, set
Public Shared Property DefaultProxy As IWebProxy

속성 값

모든 HTTP 요청에 사용되는 프록시입니다.

예외

전달된 값은 null일 수 없습니다.

설명

이 정적 속성은 전달된 생성자에 명시적으로 설정된 프록시가 없는 경우 모든 HttpClient 인스턴스에서 HttpMessageHandler 사용하는 기본 프록시를 결정합니다.

이 속성에서 반환되는 기본 인스턴스는 플랫폼에 따라 다른 규칙 집합을 기준으로 초기화됩니다.

  • Windows: 환경 변수에서 프록시 구성을 읽거나, 정의되지 않은 경우 사용자의 프록시 설정에서 프록시 구성을 읽습니다.

  • macOS: 환경 변수에서 프록시 구성을 읽거나, 정의되지 않은 경우 시스템의 프록시 설정에서 프록시 구성을 읽습니다.

  • Linux: 환경 변수에서 프록시 구성을 읽거나 정의되지 않은 경우 이 속성은 모든 주소를 우회하는 구성되지 않은 인스턴스를 초기화합니다.

Windows 및 Unix 기반 플랫폼에서 DefaultProxy 초기화에 사용되는 환경 변수는 다음과 같습니다.

  • HTTP_PROXY: HTTP 요청에 사용되는 프록시 서버입니다.
  • HTTPS_PROXY: HTTPS 요청에 사용되는 프록시 서버입니다.
  • ALL_PROXY: HTTP_PROXY 및/또는 HTTPS_PROXY 정의되지 않은 경우 HTTP 및/또는 HTTPS 요청에 사용되는 프록시 서버입니다.
  • NO_PROXY: 쉼표로 구분된 호스트 이름 목록으로, 프록시에서 제외해야 합니다. 와일드카드에는 별표가 지원되지 않습니다. 하위 도메인과 일치시키려면 선행 점을 사용합니다. 예: NO_PROXY=.example.com(선행 점 포함)은 www.example.com과 일치하지만 example.com과는 일치하지 않습니다. NO_PROXY=example.com(선행 점 제외)은 www.example.com과 일치하지 않습니다. 이 동작은 나중에 다른 에코시스템과 더 잘 일치하도록 다시 검토될 수 있습니다.

환경 변수가 대소문자를 구분하는 시스템에서 변수 이름은 모두 소문자이거나 모두 대문자일 수 있습니다. 소문자 이름이 먼저 확인됩니다.

프록시 서버는 호스트 이름 또는 IP 주소일 수 있으며, 필요에 따라 콜론 및 포트 번호가 뒤에 오거나, 필요에 따라 프록시 인증을 위한 사용자 이름 및 암호를 포함하여 http URL일 수 있습니다. URL은 https가 아닌 http로 시작해야 하며, 호스트 이름, IP 또는 포트 뒤에 텍스트를 포함할 수 없습니다.

적용 대상