Passa al contenuto principale
Versione: Prossimo

Auth & Registry Settings (.npmrc)

The settings on this page must be configured via .npmrc files. pnpm uses the npm CLI under the hood for publishing, so these settings need to be in a format that npm can read.

For details on how .npmrc files are loaded, see the pnpm config command.

For settings that can be configured in pnpm-workspace.yaml, see Settings (pnpm-workspace.yaml).

Registry Settings​

registry​

L'URL di base del registro del pacchetto npm (barra finale inclusa).

@jsr:registry​

Added in: v10.9.0

The base URL of the JSR package registry.

<scope>:registry​

Il registro npm da utilizzare per i pacchetti dell'ambito specificato. Per esempio, impostando @babel:registry=https://esempio.com/packages/npm/ farà rispettare che quando usi pnpm add @babel/core, o qualsiasi pacchetto @babel con ambito, il pacchetto verrà recuperato da https://esempio.com/packages/npm invece del registro predefinito.

Authentication Settings​

<URL>:_authToken​

Definisci il token del portatore di autenticazione da utilizzare quando si accede al registro. Ad esempio:

//registry.npmjs.org/:_authToken=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

Puoi anche usare una variabile d'ambiente. Ad esempio:

//registry.npmjs.org/:_authToken=${NPM_TOKEN}

Oppure puoi semplicemente utilizzare direttamente una variabile di ambiente, senza modificare affatto il file .npmrc:

npm_config_//registry.npmjs.org/:_authToken=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

<URL>:tokenHelper​

Un token helper è un eseguibile che emette un token di autenticazione. Può essere usato in situazioni in cui authToken non è un valore costante ma è qualcosa che si aggiorna regolarmente, in cui uno script o un altro strumento può usare un token di aggiornamento esistente per ottenere un nuovo token di accesso.

La configurazione per il percorso dell'helper deve essere un percorso assoluto, senza argomenti. Per essere sicuro, è consentito impostare questo valore solo nell'utente .npmrc. In caso contrario, un progetto potrebbe inserire un valore in .npmrc locale di un progetto ed eseguire eseguibili arbitrari.

Impostazione di un token helper per il registro predefinito:

tokenHelper=/home/ivan/token-generator

Impostazione di un token helper per il registro specificato:

//registry.corp.com:tokenHelper=/home/ivan/token-generator

Proxy Settings​

https-proxy​

  • Default: null
  • Tipo: url

Un proxy da utilizzare per le richieste HTTPS in uscita. Se sono impostate le variabili di ambiente HTTPS_PROXY, https_proxy, HTTP_PROXY o http_proxy, verranno utilizzati i relativi valori.

Se l'URL del tuo proxy contiene un nome utente e una password, assicurati di codificarli con l'URL. Ad esempio:

https-proxy=https://use%21r:pas%2As@my.proxy:1234/foo

Non codificare i due punti (:) tra nome utente e password.

http-proxy​

proxy​

  • Default: null
  • Tipo: url

Un proxy da utilizzare per le richieste http in uscita. Se le variabili di ambiente HTTP_PROXY o http_proxy sono impostate, le impostazioni del proxy saranno onorate dalla libreria di richiesta sottostante.

local-address​

  • Predefinito: non definito
  • Tipo: Indirizzo IP

L'indirizzo IP dell'interfaccia locale da utilizzare quando si effettuano connessioni al registro npm.

maxsockets​

  • Default: networkConcurrency x 3
  • Tipo: Numero

Il numero massimo di connessioni da utilizzare per origine (combinazione protocollo/host/porta).

noproxy​

  • Predefinito: null
  • Tipo: Stringa

Una stringa di estensioni di dominio separate da virgole per le quali non dovrebbe essere utilizzato un proxy.

SSL Settings​

strict-ssl​

  • Predefinito: true
  • Tipo: Booleano

Se eseguire o meno la convalida della chiave SSL quando si effettuano richieste al registro tramite HTTPS.

Vedi anche l'opzione ca.

Certificate Settings​

ca​

  • Predefinito: Il certificato CA di npm
  • Tipo: Stringa, Array o null

Il certificato di firma dell'autorità di certificazione considerato attendibile per le connessioni SSL al registro. I valori devono essere in formato PEM (ovvero "X.509 codificato in base-64 (.CER)"). Ad esempio:

ca="-----BEGIN CERTIFICATE-----\nXXXX\nXXXX\n-----END CERTIFICATE-----"

Imposta a null per consentire solo ai registrar noti o un certificato CA specifico di considerare attendibile solo quella specifica autorità di firma.

È possibile considerare attendibili più CA specificando una serie di certificati:

ca[]="..."
ca[]="..."

Vedi anche la configurazione strict-ssl.

cafile​

  • Predefinito: null
  • Tipo: percorso

Un percorso a un file contenente una o più autorità di certificazione che firmano certificati. Simile all'impostazione ca, ma permette più CA, così come per le informazioni CA da memorizzare in un file invece di essere specificato tramite CLI.

<URL>:cafile​

Define the path to a Certificate Authority file to use when accessing the specified registry. Ad esempio:

//registry.npmjs.org/:cafile=ca-cert.pem

<URL>:ca​

Added in: v10.25.0

Define an inline Certificate Authority certificate for the specified registry. The value must be PEM-encoded, like the global ca setting, but it only applies to the matching registry URL.

//registry.example.com/:ca=-----BEGIN CERTIFICATE-----...-----END CERTIFICATE-----

cert​

  • Predefinito: null
  • Tipo: Stringa

Un certificato client da passare quando si accede al registro. I valori devono essere in formato PEM (ovvero "X.509 codificato in base-64 (.CER)"). Ad esempio:

cert="-----BEGIN CERTIFICATE-----\nXXXX\nXXXX\n-----END CERTIFICATE-----"

It is not the path to a certificate file.

<URL>:cert​

Added in: v10.25.0

Define an inline client certificate to use when accessing the specified registry. Esempio:

//registry.example.com/:cert=-----BEGIN CERTIFICATE-----...-----END CERTIFICATE-----

<URL>:certfile​

Define the path to a certificate file to use when accessing the specified registry. Ad esempio:

//registry.npmjs.org/:certfile=server-cert.pem

key​

  • Predefinito: null
  • Tipo: Stringa

Una chiave client da passare quando si accede al registro. I valori devono essere in formato PEM (ovvero "X.509 codificato in base-64 (.CER)"). Ad esempio:

key="-----BEGIN PRIVATE KEY-----\nXXXX\nXXXX\n-----END PRIVATE KEY-----"

It is not the path to a key file. Use <URL>&#58;keyfile if you need to reference the file system instead of inlining the key.

Questa impostazione contiene informazioni sensibili. Non scriverlo in un file .npmrc locale di cui hai effettuato il commit nel repository.

<URL>:key​

Added in: v10.25.0

Define an inline client key for the specified registry URL.

//registry.example.com/:key=-----BEGIN PRIVATE KEY-----...-----END PRIVATE KEY-----

<URL>:keyfile​

Define the path to a client key file to use when accessing the specified registry. Ad esempio:

//registry.npmjs.org/:keyfile=server-key.pem