Variabili Ambientali
Verdaccio fornisce una serie di variabili ambientali per modificare le autorizzazioni, la porta o il protocollo http. Ecco l'elenco completo:
Docker
Per modificare il comportamento all'esecuzione dell'immagine, ecco un elenco delle variabili disponibili.
| Variabile | Default | Descrizione |
|---|---|---|
| VERDACCIO_APPDIR | /opt/verdaccio | la cartella operativa del docker |
| VERDACCIO_USER_NAME | verdaccio | l'utente del sistema |
| VERDACCIO_USER_UID | 10001 | l'id utente usato per applicare le autorizzazioni della cartella |
| VERDACCIO_PORT | 4873 | la porta di Verdaccio |
| VERDACCIO_PROTOCOL | http | il protocollo http predefinito |
| VERDACCIO_ADDRESS | [::] | the default address to listen on (IPv6 [::], all interfaces) |
next)The default value of VERDACCIO_ADDRESS changed from 0.0.0.0 (IPv4, in 6.x) to [::] (IPv6, in the next major (next) and later). On dual-stack hosts [::] also accepts IPv4 connections, but in environments where IPv6 is not available you may need to set VERDACCIO_ADDRESS=0.0.0.0 explicitly.
VERDACCIO_HANDLE_KILL_SIGNALS
This variable only applies to Verdaccio 6.x, where graceful shutdown is opt-in by setting VERDACCIO_HANDLE_KILL_SIGNALS=true. Starting with the next major (next) it has been removed and graceful shutdown is always enabled, so the variable has no effect.
Enables gracefully shutdown, more info at the pull request #2121.
VERDACCIO_PUBLIC_URL
Define a specific public url for your server, it overrules the Host and X-Forwarded-Proto header if a reverse proxy is being used, it takes in account the url_prefix if is defined.
Ciò è utile in quelle situazioni in cui è necessario un URL dinamico.
es.:
VERDACCIO_PUBLIC_URL='https://somedomain.org';
url_prefix: '/my_prefix'
// url -> https://somedomain.org/my_prefix/
VERDACCIO_PUBLIC_URL='https://somedomain.org';
url_prefix: '/'
// url -> https://somedomain.org/
VERDACCIO_PUBLIC_URL='https://somedomain.org/first_prefix';
url_prefix: '/second_prefix'
// url -> https://somedomain.org/second_prefix/'
VERDACCIO_FORWARDED_PROTO
The default header to identify the protocol is X-Forwarded-Proto, but there are some environments which uses something different, to change it use the variable VERDACCIO_FORWARDED_PROTO
$ VERDACCIO_FORWARDED_PROTO=CloudFront-Forwarded-Proto verdaccio --listen 5000
VERDACCIO_STORAGE_PATH
Di default, l'archiviazione è definita dal file di configurazione, ma utilizzare questa variabile consente di impostarla dalla variabile ambientale.
VERDACCIO_STORAGE_NAME
The database name for @verdaccio/local-storage is by default .verdaccio-db.json, but this can be update by using this variable.
VERDACCIO_LEGACY_ALGORITHM
The cipher algorithm used to encrypt/decrypt legacy authentication tokens (the pre-JWT npm bearer tokens handled by @verdaccio/signature). Defaults to aes-256-ctr. This is unrelated to storage; it only affects token encryption, and the key is always 256 bits (32 characters).
The accepted values are the cipher names supported by your Node.js / OpenSSL build — see the Node.js crypto documentation (crypto.getCiphers()). Only change it if you need to match tokens produced with a different algorithm.
VERDACCIO_LEGACY_ENCRYPTION_KEY
Overrides the key used to encrypt/decrypt legacy authentication tokens, not storage data.
By default these legacy AES tokens are encrypted with the server secret — the 32-character key that Verdaccio auto-generates and persists in the storage database (.verdaccio-db.json, the secret field). When this variable is set it takes precedence over that secret for the legacy token path only — useful, for example, to keep decrypting tokens issued with a previous secret after the one in .verdaccio-db.json has been rotated.
The value must be exactly 32 characters (256 bits), otherwise encryption fails with an Invalid secret key length error. If unset, the server secret is used.