uv에서 프록시 사용하기

uv의 프록시 환경 변수를 설정하고, 승인된 프록시 CA가 운영체제 신뢰 저장소에 이미 있다면 현재의 system-certs 옵션을 사용하세요.

POSIX 셸에서 uv 명령 한 번에만 프록시를 적용하려면 해당 호출에 변수를 지정하세요.

HTTP_PROXY=http://203.0.113.10:8080 \
HTTPS_PROXY=http://203.0.113.10:8080 \
uv add requests

예제 엔드포인트를 서비스 주소나 HTTP 프록시 목록의 후보로 바꾸세요. 이 할당은 셸 시작 파일을 수정하는 대신 해당 명령과 자식 프로세스에 적용됩니다. PowerShell은 문법이 다릅니다. HTTPS 목적지도 http:// 프록시 리스너를 사용할 수 있습니다. ALL_PROXY는 일반 프록시 설정을 제공하고 NO_PROXY는 우회 대상을 지정합니다.

경로는 작동하지만 승인된 조직 CA가 uv에 포함된 Mozilla 루트 인증서에 없다면, 그 CA가 시스템에 이미 설치되어 있을 때 시스템 신뢰를 사용하세요.

HTTPS_PROXY=http://203.0.113.10:8080 \
uv --system-certs add requests

옵션은 --system-certs입니다. 대응하는 UV_SYSTEM_CERTS=true 변수는 uv 0.11.0에서 추가되었습니다. 이전 버전은 설치된 도움말을 확인하세요. 별도로 제공된 PEM 번들은 문서화된 SSL_CERT_FILE 또는 SSL_CERT_DIR 신뢰 인터페이스를 사용합니다. 이 신뢰 설정들은 어느 것도 프록시 주소를 고르지 않습니다.

경로 테스트가 성공했다고 판단하기 전에 명령 출력을 읽으세요. uv는 다운로드 없이 캐시된 패키지를 재사용할 수 있습니다. 실제 작업은 인덱스 외에도 파일, 리디렉션, 관리형 Python 다운로드, Git 의존성에 접근할 수 있습니다. 실패 단계와 오류를 함께 기록하세요. 잘못된 경로가 계속되면 상속한 프록시·우회 값을 살펴보세요. 패키지 인덱스를 바꾸는 것은 소스를 고르는 것이며 포워드 프록시를 고르는 것이 아닙니다.

관련 글