Configurazione Web

Verdaccio ha un'interfaccia utente web per mostrare solo i pacchetti privati ed è personalizzabile a tuo piacimento.

web:
  enable: true
  title: Verdaccio
  logo: http://somedomain/somelogo.png
  primary_color: '#4b5e40'
  gravatar: true | false
  scope: '@scope'
  sort_packages: asc | desc
  darkMode: false
  favicon: http://somedomain/favicon.ico | /path/favicon.ico
  rateLimit:
    windowMs: 50000
    max: 1000
  pkgManagers:
    - npm
    - yarn
    - pnpm
  login: true
  scriptsBodyAfter:
    - '<script type="text/javascript" src="https://my.company.com/customJS.min.js"></script>'
  metaScripts:
    - '<script type="text/javascript" src="https://code.jquery.com/jquery-3.5.1.slim.min.js"></script>'
    - '<script type="text/javascript" src="https://browser.sentry-cdn.com/5.15.5/bundle.min.js"></script>'
    - '<meta name="robots" content="noindex" />'
  scriptsbodyBefore:
    - '<div id="myId">html before webpack scripts</div>'
  html_cache: true
  showInfo: true
  showSettings: true
  # In combination with darkMode you can force specific theme
  showThemeSwitch: true
  showFooter: true
  showSearch: true
  showDownloadTarball: true
  showRaw: true

Tutte le restrizioni d'accesso definite per proteggere i tuoi pacchetti si applicheranno anche all'Interfaccia Web.

Il primary_color e ambito devono esser avvolti da virgolette: es: ('#000000' o "#000000")

Il primary_color dev'essere una rappresentazione hex valida.

Internazionalizzazione

Dalla v4.5.0, sono disponibili le traduzioni.

i18n:
  web: en-US

⚠️ Solo le lingue abilitate su questo file sono disponibili, puoi contribuere aggiungendo altre lingue. Quella predefinita è en-US

Configurazione

Proprietà	Tipo	Richiesto	Esempio	Supporto	Descrizione
enable	booleano	No	true/false	tutti	consente di mostrare l'interfaccia web
title	stringa	No	Verdaccio	tutti	Descrizione del titolo di testa HTML (se non definito, imposta "Verdaccio" di default).
gravatar	booleano	No	true	>v4	I gravatar saranno generati sotto al cappuccio se questa proprietà è abilitata
sort_packages	[asc,desc]	No	asc	>v4	Di default i pacchetti privati sono ordinati in modo crescente
logo	stringa	No	/local/path/to/my/logo.png http://my.logo.domain/logo.png	tutti	un URI in cui si trova il logo (logo dell'intestazione)
primary_color	stringa	No	"#4b5e40"	>4	Il colore principale da usare nell'UI (intestazione, etc.)
scope	stringa	No	@myscope	>v3.x	Se stai usando questo registro per un ambito del modulo specifico, specifica quell'ambito per impostarlo nell'intestazione delle istruzioni della webui
darkMode	booleano	No	false	>=v4.6.0	Questa modalità è un tema speciale per coloro che vogliono vivere dal lato oscuro
favicon	stringa	No	false	>=v5.0.1	Mostra un favicon personalizzato, può essere una risorsa locale o un url valido
rateLimit	oggetto	No	usa la configurazione userRateLimit	>=v5.4.0	Aumenta o riduce il limite di frequenza, di default è di 5000 richieste ogni 2 minuti, limita soltanto gli endpoint dell'API web; CSS, JS, etc. sono ignorati
pkgManagers	npm, pnpm or yarn	No	npm	>=v5.5.0	Permette di personalizzare quali gestori di pacchetti nella barra laterale e quali finestre dialogo informative dei registri sono visibili
login	booleano	No	true or false	>=v5.5.0	Consente di disabilitare l'accesso dall'interfaccia utente (include anche gli endpoint web).
scriptsBodyAfter	string[]	No	qualsiasi elenco di stringhe	>=5.0.0	inietta gli script dopo il tag
metaScripts	string[]	No	qualsiasi elenco di stringhe	>=5.0.0	inietta gli script in

| | scriptsbodyBefore | string[] | No | qualsiasi elenco di stringhe | `>=5.0.0` | inietta gli script prima di | | html_cache | booleano | No | true | `>=v5.9.0` | se la cache html è abilitata, default a true | | showInfo | booleano | No | true | `>=v5.10.0` | mostra il pulsante di info sull'intestazione | | showSettings | booleano | No | true | `>=v5.10.0` | mostra il pulsante delle impostazioni sull'intestazione | | showThemeSwitch | booleano | No | true | `>=v5.10.0` | mostra il pulsante di modifica del tema sull'intestazione | | showFooter | booleano | No | true | `>=v5.10.0` | consenti nascondi piè di pagina | | showSearch | booleano | No | true | `>=v5.10.0` | consenti di nascondere il componente di ricerca | | showDownloadTarball | booleano | No | true | `>=v5.10.0` | consenti di nascondere il pulsante di download sulla barra laterale | | showRaw | booleano | No | true | `>=v5.10.0` | consenti di nascondere il pulsante del manifesto sulla barra laterale (funzionalità sperimentale) |

Le dimensioni consigliate del logo sono 40x40 pixel.

La darkMode è abilitabile tramite l'UI ed è persistita nell'archiviazione locale del browser. Se combini showThemeSwitch: false con darkMode, gli utenti saranno forzati a utilizzare un tema specifico. Inoltre, anche primary_color nullo e scuro non sono personalizzabili.