verdaccio/website/translated_docs/pl/config.md

id	title
configuration	Plik konfiguracyjny

Plik ten jest podstawą verdaccio, ponieważ to w nim możesz modyfikować domyślne zachowanie aplikacji, rozszerzać jej funkcje oraz włączać wtyczki.

Domyślny plik konfiguracyjny jest tworzony, gdy po raz pierwszy uruchomisz verdaccio.

Podstawowa konfiguracja

The default configuration has support for scoped packages and allow any user to access all packages but only authenticated users to publish.

storage: ./storage
auth:
  htpasswd:
    file: ./htpasswd
uplinks:
  npmjs:
    url: https://registry.npmjs.org/
packages:
  '@*/*':
    access: $all
    publish: $authenticated
    proxy: npmjs
  '**':
    proxy: npmjs
logs:
  - {type: stdout, format: pretty, level: http}

Sekcje

The following sections explain what each property means and the different options.

Magazyn danych

Jest lokalizacją domyślnego magazynu danych. Verdaccio domyślnie jest oparte o lokalny system plików.

storage: ./storage

Wtyczki

Is the location of the plugin directory. Useful for Docker/Kubernetes based deployments.

plugins: ./plugins

Uwierzytelnianie

Uwierzytelnianie jest wykonywane tutaj, podstawowe uwierzytelnianie jest oparte o htpasswd i jest wbudowane w aplikację. Możesz modyfikować jego zachowanie poprzez wtyczki. Więcej informacji o tej sekcji znajdziesz na stronie dotyczącej uwierzytelniania.

auth:
  htpasswd:
    file: ./htpasswd
    max_users: 1000

Internetowy interfejs użytkownika

Te właściwości pozwalają Ci zmienić wygląd internetowego interfejsu użytkownika. Aby uzyskać więcej informacji na temat tej sekcji, przeczytaj stronę dotyczącą internetowego interfejsu użytkownika.

web:
  enable: true
  title: Verdaccio
  logo: logo.png
  scope:

Uplinks

Uplinks is the ability of the system to fetch packages from remote registries when those packages are not available locally. For more information about this section read the uplinks page.

uplinks:
  npmjs:
    url: https://registry.npmjs.org/

Packages

Packages allow the user to control how the packages are gonna be accessed. For more information about this section read the packages page.

packages:
  '@*/*':
    access: $all
    publish: $authenticated
    proxy: npmjs

Ustawienia zaawansowane

Publikowanie w trybie offline

Domyślnie verdaccio nie pozwala na publikowanie w trybie offline, można to zmienić poprzez ustawienie tej właściwości na true.

publish:
  allow_offline: false

Since: verdaccio@2.3.6 due #223

URL Prefix

url_prefix: https://dev.company.local/verdaccio/

Since: verdaccio@2.3.6 due #197

Max Body Size

Domyślnie maksymalny rozmiar ciała dokumentu JSON to 10mb, jeśli napotykasz błędy takie jak "zbyt duży rozmiar żądania" możesz zwiększyć tę wartość.

max_body_size: 10mb

Port nasłuchu

verdaccio domyślnie nadaje poprzez port 4873. Zmiana tego portu może być dokonana przez cli lub przez plik konfiguracyjny, wszystkie następujące opcje są prawidłowe.

listen:
# - localhost:4873            # default value
# - http://localhost:4873     # same thing
# - 0.0.0.0:4873              # listen on all addresses (INADDR_ANY)
# - https://example.org:4873  # if you want to use https
# - "[::1]:4873"                # ipv6
# - unix:/tmp/verdaccio.sock    # unix socket

HTTPS

Aby aktywować https w verdaccio wystarczy ustawić flagę listen na protokół https://. Więcej informacji o tej sekcji znajdziesz na stronie dotyczącej ssl.

https:
    key: ./path/verdaccio-key.pem
    cert: ./path/verdaccio-cert.pem
    ca: ./path/verdaccio-csr.pem

Proxy

Proxy to specjalne serwery HTTP stworzone do transferu danych z serwerów zdalnych do klientów lokalnych.

http_proxy and https_proxy

Jeśli posiadasz serwer proxy w swojej sieci możesz ustawić nagłówek X-Forwarded-For używając następujących właściwości.

http_proxy: http://something.local/
https_proxy: https://something.local/

no_proxy

Ta zmienna powinna posiadać listę domen oddzieloną przecinkami, dla których proxy nie powinno być używane.

no_proxy: localhost,127.0.0.1

Powiadomienia

Dostarczanie powiadomień do aplikacji zewnętrznych jest całkiem łatwe poprzez web hooks. Aby uzyskać więcej informacji o tej sekcji przeczytaj stronę dotyczącą powiadomień.

notify:
  method: POST
  headers: [{'Content-Type': 'application/json'}]
  endpoint: https://usagge.hipchat.com/v2/room/3729485/notification?auth_token=mySecretToken
  content: '{"color":"green","message":"New package published: * {{ name }}*","notify":true,"message_format":"text"}'

Bardziej szczegółowe ustawienia konfiguracji znajdziesz w kodzie źródłowym.

Audit

Since: verdaccio@3.0.0

npm audit to nowa komenda wydana razem z npm 6.x. Verdaccio zawiera wbudowany plugin oprogramowania pośredniego do obsługi tej komendy.

Jeśli instalujesz aplikację od nowa, to posiada to ona domyślnie, w przeciwnym razie musisz dodać następujące właściwości do Twojego pliku konfiguracyjnego

middlewares:
  audit:
    enabled: true