Saltar al contenido principal
Version: Próxima versión

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​

La URL base del registro del paquete npm (barra inclinada final incluida).

@jsr:registry​

Added in: v10.9.0

The base URL of the JSR package registry.

<scope>:registry​

El registro npm que se debe usar para los paquetes del ámbito especificado. Para ejemplo, configuración @babel:registry=https://example.com/packages/npm/ hará cumplir eso cuando use Pnpm Agregar @babel/núcleo, o cualquier @babel Ámbito paquete, el paquete se recuperará de https://example.com/packages/npm en lugar del registro predeterminado.

Authentication Settings​

<URL>:_authToken​

Defina la señal de portadora de autenticación que se debe utilizar al acceder al registro especificado. Por ejemplo:

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

También puede utilizar una variable de entorno. Por ejemplo:

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

O simplemente puede usar una variable de entorno directamente, sin cambiar .npmrc en absoluto:

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

<URL>:tokenHelper​

Un token de ayuda es un ejecutable que genera un token de autenticación. Esto se puede usar en situaciones en las que authToken no es un valor constante sino algo que se actualiza regularmente, donde un script u otra herramienta puede usar un token de actualización existente para obtener un nuevo token de acceso.

La configuración de la ruta al asistente debe ser una ruta absoluta, sin argumentos. Para mayor seguridad, solo se permite establecer este valor en el usuario .npmrc. De lo contrario, un proyecto podría colocar un valor en el .npmrc local de un proyecto y ejecutar ejecutables arbitrarios.

Configuración de un token de ayuda para el registro predeterminado:

tokenHelper=/home/ivan/token-generator

Configuración de un token de ayuda para el registro predeterminado:

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

Proxy Settings​

https-proxy​

  • Default: null
  • Tipo: url

Un proxy para usar con solicitudes HTTPS salientes. Si se establecen las variables de entorno HTTPS_PROXY, https_proxy, HTTP_PROXY o http_proxy, utilizarán sus valores en su lugar.

Si su URL de proxy contiene un nombre de usuario y una contraseña, asegúrese de codificarlos como URL. Por ejemplo:

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

No codifique los dos puntos (:) entre el nombre de usuario y la contraseña.

http-proxy​

proxy​

  • Default: null
  • Tipo: url

Un proxy para usar con solicitudes http salientes. Si se establecen las variables de entorno HTTP_PROXY o http_proxy, la biblioteca de solicitud subyacente respetará la configuración del proxy.

local-address​

  • Predeterminado: indefinido
  • Tipo: Dirección IP

La dirección IP de la interfaz local que se usará al realizar conexiones con el registro npm.

maxsockets​

  • Default: networkConcurrency x 3
  • Selecciona Número

El número máximo de conexiones a usar por origen (combinación de protocolo/host/puerto).

noproxy​

  • Por defecto: null
  • Tipo: String

Una cadena de extensiones de dominio separadas por comas para las que no se debe usar un proxy.

SSL Settings​

strict-ssl​

  • Por defecto: true
  • Tipo: Boolean

Si realizar o no la validación de la clave SSL al realizar solicitudes al registro a través de HTTPS.

Ver también la opción ca.

Certificate Settings​

ca​

  • Valor predeterminado: El certificado CA de npm
  • Tipo: Cadena, Arreglo o nulo

El certificado de firma de la autoridad de certificación en el que se confía para las conexiones SSL con el registro. Los valores deben estar en formato PEM (también conocido como "X.509 codificado en Base-64 (.CER)"). Por ejemplo:

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

Se establece en nulo para permitir sólo a los registradores conocidos, o a un certificado de CA específico para confiar en sólo la autorización de firma específica.

Se puede confiar en varias CA especificando una arreglo de certificados:

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

Consulte también la configuración strict-ssl.

cafile​

  • Por defecto: null
  • Tipo: path

Una ruta a un archivo que contiene uno o varios certificados de firma de autoridad de certificación. Similar a la configuración ca, pero permite múltiples CA, así como que la información de CA se almacene en un archivo en lugar de especificarse a través de CLI.

<URL>:cafile​

Define the path to a Certificate Authority file to use when accessing the specified registry. Por ejemplo:

//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​

  • Default: null
  • Tipo: String

Un certificado de cliente para pasar al acceder al registro. Los valores deben estar en formato PEM (también conocido como "X.509 codificado en Base-64 (.CER)"). Por ejemplo:

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. Ejemplo:

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

<URL>:certfile​

Define the path to a certificate file to use when accessing the specified registry. Por ejemplo:

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

key​

  • Por defecto: null
  • Tipo: String

Una clave de cliente para pasar al acceder al registro. Los valores deben estar en formato PEM (también conocido como "X.509 codificado en Base-64 (.CER)"). Por ejemplo:

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.

Esta configuración contiene información confidencial. No lo escriba en un archivo local .npmrc asignado al repositorio.

<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. Por ejemplo:

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