mirror of
https://github.com/verdaccio/verdaccio.git
synced 2025-01-27 22:59:51 -05:00
69c831e3f8
* New translations what-is-verdaccio.md (Polish) docs(website): new translations * New translations what-is-verdaccio.md (Polish) docs(website): new translations * New translations windows.md (Polish) docs(website): new translations * New translations en.json (Polish) docs(website): new translations * New translations en.json (Polish) docs(website): new translations * New translations notifications.md (Polish) docs(website): new translations * New translations plugins.md (Polish) docs(website): new translations * New translations plugins.md (Polish) docs(website): new translations * New translations server.md (Polish) docs(website): new translations * New translations install.md (Polish) docs(website): new translations * New translations ansible.md (Polish) docs(website): new translations * New translations build.md (Polish) docs(website): new translations * New translations cli.md (Polish) docs(website): new translations * New translations install.md (Polish) docs(website): new translations * New translations repositories.md (Polish) docs(website): new translations * New translations cli.md (Polish) docs(website): new translations * New translations config.md (Polish) docs(website): new translations * New translations config.md (Polish) docs(website): new translations * New translations config.md (Polish) docs(website): new translations * New translations config.md (Polish) docs(website): new translations * New translations contributing.md (Polish) docs(website): new translations * New translations contributing.md (Polish) docs(website): new translations * New translations contributing.md (Polish) docs(website): new translations * New translations contributing.md (Polish) docs(website): new translations * New translations contributing.md (Polish) docs(website): new translations * New translations windows.md (Polish) docs(website): new translations * New translations cli.md (Polish) docs(website): new translations * New translations ansible.md (Vietnamese) docs(website): new translations * New translations repositories.md (Vietnamese) docs(website): new translations * New translations chef.md (Vietnamese) docs(website): new translations * New translations puppet.md (Vietnamese) docs(website): new translations * New translations ci.md (Vietnamese) docs(website): new translations * New translations what-is-verdaccio.md (Vietnamese) docs(website): new translations * New translations node-api.md (Vietnamese) docs(website): new translations * New translations windows.md (Vietnamese) docs(website): new translations * New translations web.md (Vietnamese) docs(website): new translations * New translations use-cases.md (Vietnamese) docs(website): new translations * New translations uplinks.md (Vietnamese) docs(website): new translations * New translations test.md (Vietnamese) docs(website): new translations * New translations ssl.md (Vietnamese) docs(website): new translations * New translations server.md (Vietnamese) docs(website): new translations * New translations reverse-proxy.md (Vietnamese) docs(website): new translations * New translations protect-your-dependencies.md (Vietnamese) docs(website): new translations * New translations auth.md (Vietnamese) docs(website): new translations * New translations plugins.md (Vietnamese) docs(website): new translations * New translations packages.md (Vietnamese) docs(website): new translations * New translations notifications.md (Vietnamese) docs(website): new translations * New translations logger.md (Vietnamese) docs(website): new translations * New translations kubernetes.md (Vietnamese) docs(website): new translations * New translations install.md (Vietnamese) docs(website): new translations * New translations iis-server.md (Vietnamese) docs(website): new translations * New translations docker.md (Vietnamese) docs(website): new translations * New translations dev-plugins.md (Vietnamese) docs(website): new translations * New translations contributing.md (Vietnamese) docs(website): new translations * New translations config.md (Vietnamese) docs(website): new translations * New translations cli.md (Vietnamese) docs(website): new translations * New translations build.md (Vietnamese) docs(website): new translations * New translations en.json (Vietnamese) docs(website): new translations * New translations ansible.md (Vietnamese) docs(website): new translations * New translations ansible.md (Vietnamese) docs(website): new translations * New translations ansible.md (Vietnamese) docs(website): new translations * New translations contributing.md (Polish) docs(website): new translations * New translations install.md (Polish) docs(website): new translations * New translations auth.md (Vietnamese) docs(website): new translations * New translations auth.md (Vietnamese) docs(website): new translations * New translations auth.md (Vietnamese) docs(website): new translations * New translations uplinks.md (Spanish) docs(website): new translations * New translations plugins.md (Korean) docs(website): new translations * New translations build.md (Korean) docs(website): new translations * New translations cli.md (Korean) docs(website): new translations * New translations config.md (Korean) docs(website): new translations * New translations contributing.md (Korean) docs(website): new translations * New translations dev-plugins.md (Korean) docs(website): new translations * New translations docker.md (Korean) docs(website): new translations * New translations iis-server.md (Korean) docs(website): new translations * New translations install.md (Korean) docs(website): new translations * New translations kubernetes.md (Korean) docs(website): new translations * New translations logger.md (Korean) docs(website): new translations * New translations notifications.md (Korean) docs(website): new translations * New translations packages.md (Korean) docs(website): new translations * New translations protect-your-dependencies.md (Korean) docs(website): new translations * New translations ansible.md (Korean) docs(website): new translations * New translations repositories.md (Korean) docs(website): new translations * New translations reverse-proxy.md (Korean) docs(website): new translations * New translations server.md (Korean) docs(website): new translations * New translations ssl.md (Korean) docs(website): new translations * New translations test.md (Korean) docs(website): new translations * New translations uplinks.md (Korean) docs(website): new translations * New translations use-cases.md (Korean) docs(website): new translations * New translations web.md (Korean) docs(website): new translations * New translations windows.md (Korean) docs(website): new translations * New translations node-api.md (Korean) docs(website): new translations * New translations what-is-verdaccio.md (Korean) docs(website): new translations * New translations ci.md (Korean) docs(website): new translations * New translations puppet.md (Korean) docs(website): new translations * New translations auth.md (Korean) docs(website): new translations * New translations en.json (Italian) docs(website): new translations * New translations en.json (Korean) docs(website): new translations * New translations plugins.md (Italian) docs(website): new translations * New translations auth.md (Italian) docs(website): new translations * New translations build.md (Italian) docs(website): new translations * New translations cli.md (Italian) docs(website): new translations * New translations config.md (Italian) docs(website): new translations * New translations contributing.md (Italian) docs(website): new translations * New translations dev-plugins.md (Italian) docs(website): new translations * New translations docker.md (Italian) docs(website): new translations * New translations iis-server.md (Italian) docs(website): new translations * New translations install.md (Italian) docs(website): new translations * New translations kubernetes.md (Italian) docs(website): new translations * New translations logger.md (Italian) docs(website): new translations * New translations notifications.md (Italian) docs(website): new translations * New translations packages.md (Italian) docs(website): new translations * New translations protect-your-dependencies.md (Italian) docs(website): new translations * New translations chef.md (Italian) docs(website): new translations * New translations repositories.md (Italian) docs(website): new translations * New translations reverse-proxy.md (Italian) docs(website): new translations * New translations server.md (Italian) docs(website): new translations * New translations ssl.md (Italian) docs(website): new translations * New translations test.md (Italian) docs(website): new translations * New translations uplinks.md (Italian) docs(website): new translations * New translations use-cases.md (Italian) docs(website): new translations * New translations web.md (Italian) docs(website): new translations * New translations windows.md (Italian) docs(website): new translations * New translations node-api.md (Italian) docs(website): new translations * New translations what-is-verdaccio.md (Italian) docs(website): new translations * New translations ci.md (Italian) docs(website): new translations * New translations puppet.md (Italian) docs(website): new translations * New translations chef.md (Korean) docs(website): new translations * New translations ansible.md (Portuguese) docs(website): new translations * New translations protect-your-dependencies.md (Russian) docs(website): new translations * New translations cli.md (Russian) docs(website): new translations * New translations config.md (Russian) docs(website): new translations * New translations contributing.md (Russian) docs(website): new translations * New translations dev-plugins.md (Russian) docs(website): new translations * New translations docker.md (Russian) docs(website): new translations * New translations iis-server.md (Russian) docs(website): new translations * New translations install.md (Russian) docs(website): new translations * New translations kubernetes.md (Russian) docs(website): new translations * New translations logger.md (Russian) docs(website): new translations * New translations notifications.md (Russian) docs(website): new translations * New translations packages.md (Russian) docs(website): new translations * New translations plugins.md (Russian) docs(website): new translations * New translations repositories.md (Russian) docs(website): new translations * New translations auth.md (Russian) docs(website): new translations * New translations reverse-proxy.md (Russian) docs(website): new translations * New translations server.md (Russian) docs(website): new translations * New translations ssl.md (Russian) docs(website): new translations * New translations test.md (Russian) docs(website): new translations * New translations uplinks.md (Russian) docs(website): new translations * New translations use-cases.md (Russian) docs(website): new translations * New translations web.md (Russian) docs(website): new translations * New translations windows.md (Russian) docs(website): new translations * New translations node-api.md (Russian) docs(website): new translations * New translations what-is-verdaccio.md (Russian) docs(website): new translations * New translations ci.md (Russian) docs(website): new translations * New translations puppet.md (Russian) docs(website): new translations * New translations chef.md (Russian) docs(website): new translations * New translations build.md (Russian) docs(website): new translations * New translations ansible.md (Russian) docs(website): new translations * New translations auth.md (Portuguese) docs(website): new translations * New translations protect-your-dependencies.md (Portuguese) docs(website): new translations * New translations build.md (Portuguese) docs(website): new translations * New translations cli.md (Portuguese) docs(website): new translations * New translations config.md (Portuguese) docs(website): new translations * New translations contributing.md (Portuguese) docs(website): new translations * New translations dev-plugins.md (Portuguese) docs(website): new translations * New translations docker.md (Portuguese) docs(website): new translations * New translations iis-server.md (Portuguese) docs(website): new translations * New translations install.md (Portuguese) docs(website): new translations * New translations kubernetes.md (Portuguese) docs(website): new translations * New translations logger.md (Portuguese) docs(website): new translations * New translations notifications.md (Portuguese) docs(website): new translations * New translations packages.md (Portuguese) docs(website): new translations * New translations plugins.md (Portuguese) docs(website): new translations * New translations repositories.md (Portuguese) docs(website): new translations * New translations en.json (Portuguese) docs(website): new translations * New translations reverse-proxy.md (Portuguese) docs(website): new translations * New translations server.md (Portuguese) docs(website): new translations * New translations ssl.md (Portuguese) docs(website): new translations * New translations test.md (Portuguese) docs(website): new translations * New translations uplinks.md (Portuguese) docs(website): new translations * New translations use-cases.md (Portuguese) docs(website): new translations * New translations web.md (Portuguese) docs(website): new translations * New translations windows.md (Portuguese) docs(website): new translations * New translations node-api.md (Portuguese) docs(website): new translations * New translations what-is-verdaccio.md (Portuguese) docs(website): new translations * New translations ci.md (Portuguese) docs(website): new translations * New translations puppet.md (Portuguese) docs(website): new translations * New translations chef.md (Portuguese) docs(website): new translations * New translations ansible.md (Italian) docs(website): new translations * New translations cli.md (French) docs(website): new translations * New translations config.md (French) docs(website): new translations * New translations contributing.md (French) docs(website): new translations * New translations dev-plugins.md (French) docs(website): new translations * New translations docker.md (French) docs(website): new translations * New translations install.md (French) docs(website): new translations * New translations kubernetes.md (French) docs(website): new translations * New translations notifications.md (French) docs(website): new translations * New translations packages.md (French) docs(website): new translations * New translations plugins.md (French) docs(website): new translations * New translations web.md (French) docs(website): new translations * New translations windows.md (French) docs(website): new translations * New translations en.json (French) docs(website): new translations * New translations cli.md (German) docs(website): new translations * New translations notifications.md (Arabic) docs(website): new translations * New translations cli.md (Arabic) docs(website): new translations * New translations config.md (Arabic) docs(website): new translations * New translations contributing.md (Arabic) docs(website): new translations * New translations dev-plugins.md (Arabic) docs(website): new translations * New translations docker.md (Arabic) docs(website): new translations * New translations install.md (Arabic) docs(website): new translations * New translations kubernetes.md (Arabic) docs(website): new translations * New translations packages.md (Arabic) docs(website): new translations * New translations en.json (Arabic) docs(website): new translations * New translations plugins.md (Arabic) docs(website): new translations * New translations web.md (Arabic) docs(website): new translations * New translations windows.md (Arabic) docs(website): new translations * New translations config.md (German) docs(website): new translations * New translations kubernetes.md (Japanese) docs(website): new translations * New translations notifications.md (Japanese) docs(website): new translations * New translations packages.md (Japanese) docs(website): new translations * New translations plugins.md (Japanese) docs(website): new translations * New translations web.md (Japanese) docs(website): new translations * New translations windows.md (Japanese) docs(website): new translations * New translations en.json (Japanese) docs(website): new translations * New translations install.md (Japanese) docs(website): new translations * New translations docker.md (Japanese) docs(website): new translations * New translations contributing.md (German) docs(website): new translations * New translations dev-plugins.md (German) docs(website): new translations * New translations docker.md (German) docs(website): new translations * New translations install.md (German) docs(website): new translations * New translations kubernetes.md (German) docs(website): new translations * New translations notifications.md (German) docs(website): new translations * New translations packages.md (German) docs(website): new translations * New translations plugins.md (German) docs(website): new translations * New translations dev-plugins.md (Japanese) docs(website): new translations * New translations web.md (German) docs(website): new translations * New translations windows.md (German) docs(website): new translations * New translations en.json (German) docs(website): new translations * New translations cli.md (Japanese) docs(website): new translations * New translations config.md (Japanese) docs(website): new translations * New translations contributing.md (Japanese) docs(website): new translations * New translations en.json (Russian) docs(website): new translations * New translations auth.md (Vietnamese) docs(website): new translations
198 lines
No EOL
5.5 KiB
Markdown
198 lines
No EOL
5.5 KiB
Markdown
---
|
|
id: configuration
|
|
title: "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**.
|
|
|
|
```yaml
|
|
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.
|
|
|
|
### Storage
|
|
|
|
Is the location of the default storage. **Verdaccio is by default based on local file system**.
|
|
|
|
```yaml
|
|
storage: ./storage
|
|
```
|
|
|
|
### Wtyczki
|
|
|
|
Is the location of the plugin directory. Useful for Docker/Kubernetes based deployments.
|
|
|
|
```yaml
|
|
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](plugins.md). Więcej informacji o tej sekcji znajdziesz na [stronie dotyczącej uwierzytelniania](auth.md).
|
|
|
|
```yaml
|
|
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.md).
|
|
|
|
```yaml
|
|
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.md).
|
|
|
|
```yaml
|
|
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.md).
|
|
|
|
```yaml
|
|
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*.
|
|
|
|
```yaml
|
|
publish:
|
|
allow_offline: false
|
|
```
|
|
|
|
<small>Since: <code>verdaccio@2.3.6</code> due <a href="https://github.com/verdaccio/verdaccio/pull/223">#223</a></small>
|
|
|
|
### URL Prefix
|
|
|
|
```yaml
|
|
url_prefix: https://dev.company.local/verdaccio/
|
|
```
|
|
|
|
Since: `verdaccio@2.3.6` due [#197](https://github.com/verdaccio/verdaccio/pull/197)
|
|
|
|
### Max Body Size
|
|
|
|
By default the maximum body size for a JSON document is `10mb`, if you run in errors as `"request entity too large"` you may increase this value.
|
|
|
|
```yaml
|
|
max_body_size: 10mb
|
|
```
|
|
|
|
### Listen Port
|
|
|
|
`verdaccio` runs by default in the port `4873`. Changing the port can be done via [cli](cli.md) or in the configuration file, the following options are valid.
|
|
|
|
```yaml
|
|
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](ssl.md).
|
|
|
|
```yaml
|
|
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.
|
|
|
|
```yaml
|
|
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.
|
|
|
|
```yaml
|
|
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ń](notifications.md).
|
|
|
|
```yaml
|
|
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](https://github.com/verdaccio/verdaccio/tree/master/conf).
|
|
|
|
### Audit
|
|
|
|
<small>Since: <code>verdaccio@3.0.0</code></small>
|
|
|
|
`npm audit` to nowa komenda wydana razem z [npm 6.x](https://github.com/npm/npm/releases/tag/v6.1.0). Verdaccio zawiera wbudowany plugin oprogramowania pośredniego do obsługi tej komendy.
|
|
|
|
> If you have a new installation it comes by default, otherwise you need to add the following props to your config file
|
|
|
|
```yaml
|
|
middlewares:
|
|
audit:
|
|
enabled: true
|
|
``` |