네트워크 & 요청 설정

Network settings#

httpsProxy#

  • 기본값: null
  • 유형: url

외부로 나가는 HTTPS 요청에 사용할 프록시입니다. If httpsProxy is unset, pnpm uses the legacy proxy setting, then the HTTPS_PROXY or https_proxy environment variable.

프록시 URL에 사용자 이름과 비밀번호가 포함된 경우 반드시 URL 인코딩하세요. 예를 들어:

pnpm-workspace.yaml
httpsProxy: "https://use%21r:pas%2As@my.proxy:1234/foo"

사용자 이름과 비밀번호 사이의 콜론(:)은 인코딩하지 마세요.

Since v11.20.0, an empty value reads as unset instead of failing the install with ERR_PNPM_INVALID_PROXY. If neither httpsProxy nor proxy is configured, a shell that exports HTTPS_PROXY= disables the proxy. A false or null value in pnpm-workspace.yaml or the .npmrc also reads as unset, so pnpm still falls back to proxy and the environment. To turn proxying off, set proxy to false. 명령줄에서는 플래그가 값을 그대로 전달하므로 false와 null은 일반 호스트 이름으로 취급됩니다.

httpProxy#

  • 기본값: null
  • 유형: url

발신 HTTP 요청에 사용할 프록시입니다. If httpProxy is unset, pnpm uses the proxy resolved for httpsProxy, then the HTTP_PROXY or http_proxy environment variable, then PROXY or 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

프록시를 사용하지 않을 도메인 확장자를 쉼표로 구분한 문자열입니다. If noProxy is unset, pnpm uses noproxy, then the NO_PROXY or no_proxy environment variable.

빈 값, false, null 값은 httpsProxy에 설명된 대로 동작합니다.

localAddress#

  • 기본값: undefined
  • 유형: IP Address

로컬 인터페이스의 IP 주소로, npm 레지스트리에 연결할 때 사용됩니다.

maxsockets#

  • Default: networkConcurrency x 3 if networkConcurrency is set, otherwise 50
  • 유형: Number

오리진(프로토콜/호스트/포트 조합)당 사용할 최대 연결 수입니다.

maxSockets is accepted as an alias. Both spellings are read from pnpm-workspace.yaml, the global configuration file, the environment, and the command line, in that increasing order of precedence, so a value passed on the command line wins even when the two sides spelled the setting differently.

strictSsl#

  • 기본값: true
  • 타입: Boolean

HTTPS를 통해 레지스트리에 요청할 때 SSL 키 유효성 검사를 수행할지 여부입니다.

Request settings#

gitShallowHosts#

  • 기본값: ['github.com', 'gist.github.com', 'gitlab.com', 'bitbucket.com', 'bitbucket.org']
  • 유형: string[]

Git 저장소인 종속성을 가져올 때 호스트가 이 설정에 나열되어 있으면, pnpm은 얕은 복제를 사용하여 전체 기록이 아닌 필요한 커밋만 가져옵니다.

networkConcurrency#

  • Default: auto (workers × 3 clamped to 64-96)
  • 유형: Number

동시에 처리할 HTTP(S) 요청의 최대 수를 제어합니다.

pnpm automatically selects a value between 64 and 96 based on the number of workers (networkConcurrency = clamp(workers × 3, 64, 96)). 자동 조정을 재정의하려면 이 값을 명시적으로 설정하세요.

If a request times out while other requests to the same host are still in flight, pnpm lowers the limit for that host to one request for the rest of the command. Requests that are already running finish first. Requests to other hosts keep the full limit. Requests sent through the same proxy count as one host.

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 단위) 아래로 떨어지면 경고 메시지가 표시됩니다.

maxTarballUnpackedSize#

Added in: v11.28.7

  • Default: 4294967296 (4 GiB)
  • 유형: Number

The most bytes the files of one package may unpack to. A package whose files total more fails to install with the error ERR_PNPM_TARBALL_TOO_LARGE.

Raise the setting if you need to install a legitimately large package.