네트워크 & 요청 설정
네트워크 설정#
httpsProxy#
- 기본값: null
- 유형: url
발신 HTTPS 요청에 사용할 프록시입니다. HTTPS_PROXY, https_proxy, HTTP_PROXY 또는 http_proxy 환경 변수가 설정되어 있으면 해당 값이 대신 사용됩니다.
프록시 URL에 사용자 이름과 비밀번호가 포함되어 있다면 반드시 URL 인코딩하세요. 예를 들어:
httpsProxy: "https://use%21r:pas%2As@my.proxy:1234/foo"
사용자 이름과 비밀번호 사이의 콜론(:)은 인코딩하지 마세요.
버전 v11.20.0부터 빈 값은 ERR_PNPM_INVALID_PROXY로 설치가 실패하는 대신 설정되지 않은 것으로 처리되므로, HTTPS_PROXY=을 내보내는 셸에서도 프록시가 단순히 비활성화됩니다. false 또는 null 값을 pnpm-workspace.yaml 또는 .npmrc에 설정해도 프록시가 꺼집니다. 명령줄에서는 플래그가 값을 그대로 전달하므로 false와 null은 일반 호스트 이름으로 취급됩니다.
httpProxy#
- 기본값: null
- 유형: url
발신 HTTP 요청에 사용할 프록시입니다. HTTP_PROXY 또는 http_proxy 환경 변수가 설정되어 있으면 기본 요청 라이브러리가 프록시 설정을 따릅니다.
빈 값, false, null 값은 httpsProxy에 설명된 대로 동작합니다.
.npmrc는 npm의 레거시 proxy 설정도 지원하며, 이 설정은 https-proxy와 http-proxy 모두의 대체값으로 사용됩니다. 버전 v11.20.0부터 빈 proxy=은 설정되지 않은 것으로 처리되므로 더 이상 HTTPS_PROXY 환경 변수를 무시하지 않으며, proxy=false(또는 pnpm-workspace.yaml의 proxy: false)는 false라는 이름의 프록시 호스트로 해석되는 대신 프록시를 끕니다 (#13533).
noProxy#
- 기본값: null
- 유형: String
프록시를 사용하지 않을 도메인 확장자를 쉼표로 구분한 문자열입니다.
빈 값, false, null 값은 httpsProxy에 설명된 대로 동작합니다.
localAddress#
- 기본값: undefined
- 유형: IP Address
로컬 인터페이스의 IP 주소이며, npm 레지스트리에 연결할 때 사용됩니다.
maxsockets#
- 기본값: networkConcurrency x 3
- 유형: Number
출처(프로토콜/호스트/포트 조합)당 사용할 최대 연결 수입니다.
strictSsl#
- 기본값: true
- 타입: Boolean
레지스트리에 HTTPS로 요청할 때 SSL 키 검증을 수행할지 여부입니다.
요청 설정#
gitShallowHosts#
- 기본값: ['github.com', 'gist.github.com', 'gitlab.com', 'bitbucket.com', 'bitbucket.org']
- 유형: string[]
Git 리포지터리인 종속성을 가져올 때, 호스트가 이 설정에 나열되어 있으면, pnpm은 필요한 커밋만 가져오기 위해 얕은 복제를 사용하며, 전체 기록은 가져오지 않습니다.
networkConcurrency#
- 기본값: auto (workers × 3 clamped to 16-64)
- 유형: Number
동시에 처리할 HTTP(S) 요청의 최대 수를 제어합니다.
버전 v10.24.0부터 pnpm은 워커 수에 따라 16에서 64 사이의 값을 자동으로 선택합니다 (networkConcurrency = clamp(workers × 3, 16, 64)). 자동 조정을 재정의하려면 이 값을 명시적으로 설정하세요.
fetchRetries#
- 기본값: 2
- 유형: Number
레지스트리에서 가져오지 못할 경우 pnpm이 재시도할 횟수입니다.
fetchRetryFactor#
- 기본값: 10
- 유형: Number
재시도 백오프의 지수 계수입니다.
fetchRetryMintimeout#
- 기본값: 10000 (10초)
- 유형: Number
재시도 지수 백오프의 하한값(밀리초)입니다.
fetchRetryMaxtimeout#
- 기본값: 60000 (1분)
- 유형: Number
재시도 지수 백오프의 상한값(밀리초)입니다.
fetchTimeout#
- 기본값: 60000 (1분)
- 유형: Number
HTTP 요청이 연결되고 완료될 때까지 기다리는 최대 시간입니다. 이 시간은 적절한 연결 환경에서 가장 큰 패키지를 다운로드하기에 충분해야 합니다.
fetchWarnTimeoutMs#
버전 10.18.0에서 추가됨
- 기본값: 10000 ms (10초)
- 유형: Number
레지스트리에 대한 메타데이터 요청이 지정된 임계값(밀리초)보다 오래 걸리면 경고 메시지가 표시됩니다.
fetchMinSpeedKiBps#
버전 10.18.0에서 추가됨
- 기본값: 50 KiB/s
- 유형: Number
레지스트리에서 tarball을 다운로드하는 속도가 지정된 임계값(KiB/s) 아래로 떨어지면 경고 메시지가 표시됩니다.