verdaccio/website/translated_docs/vi/config.md

id	title
cấu hình	Tệp cấu hình

Tệp này là một phần quan trọng của Verdaccio, đây là nơi bạn có thể sửa đổi hành vi mặc định, bật plugin và mở rộng các tính năng.

Để cài tệp cấu hình mặc định đầu tiên, bạn chạy verdaccio.

Cấu hình mặc định

Cấu hình mặc định có hỗ trợ gói scoped và cho phép truy cập ẩn danh vào các gói không phải riêng tư, nhưng chỉ ** người dùng đã đăng nhập mới có thể xuất bản gói **.

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}

Các nội dung

Những nội dung sau sẽ giải thích ý nghĩa của từng thuộc tính và các tùy chọn khác nhau.

Kho lưu trữ

Là nơi lưu trữ mặc định. **Verdaccio sử dụng bộ nhớ chế độ tệp cục bộ tích hợp theo mặc định **.

storage: ./storage

Plugins

Là vị trí của thư mục của plugin. Rất hữu ích cho cấu hình chạy trên hệ thống Docker / Kubernetes.

plugins: ./plugins

Yêu cầu xác thực

Cài đặt yêu cầu xác thực được thực hiện ở đây, sự xác thực mặc đình này chạy trên tệp tinhtpasswd và được tích hợp sẵn. Bạn có thể sửa đổi chế độ này bằng plugins . Để biết thêm chi tiết về nội dung này, vui lòng đọc trang xác thực.

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

Web UI

Thuộc tính này cho phép bạn sửa đổi giao diện của web UI. Để biết thêm chi tiết về phần này, vui lòng đọc trang web ui .

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

Uplinks

Khi những gói không phải là cục bộ, uplinks cho phép hệ thống lấy các gói này từ một cơ quan đăng ký từ xa. Để biết thêm chi tiết về nội dung này, vui lòng đọc trang Uplink .

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

Các loại gói

Các gói này cho phép người dùng kiểm soát quyền truy cập vào gói. Để biết thêm chi tiết về mô-đun này, vui lòng đọc trang gói .

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

Cài đặt nâng cao

Phát hành ngoại tuyến

verdaccio theo mặc định không cho phép khách hàng phát hành khi họ ngoại tuyến. Bạn có thể thay đổi cài đặt này bằng cách cài thành * true*.

publish:
  allow_offline: false

Since: verdaccio@2.3.6 due #223

Tiền tố URL

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

Since: verdaccio@2.3.6 due #197

Thuộc tính Max Body Size

Thuộc tính Maximum body size của tệp JSON mặc định là 10mb và bạn có thể tăng giá trị này nếu bạn gặp lỗi như "đối tượng yêu cầu quá lớn".

max_body_size: 10mb

Cổng nghe

verdaccio được chạy mặc định trên cổng 4873 . Cổng có thể được thay đổi thông qua cli hoặc trong một tập tin cấu hình.

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

Để bật https trong verdaccio, chỉ cần sử dụng giao thức https:// để đặt cờ nghe . Để biết thêm chi tiết về phần này, vui lòng đọc trang ssl .

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

Proxy

Proxy là một máy chủ HTTP làm nhiệm vụ chuyển tiếp thông tin và kiểm soát tạo sự an toàn cho việc chuyển dữ liệu từ máy chủ từ xa đến máy khách.

http_proxy and https_proxy

Nếu bạn có một proxy trên mạng của mình, bạn có thể đặt tiêu đề X-Forwarded-For với các thuộc tính sau.

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

no_proxy

Biến này phải chứa danh sách các tiện ích mở rộng tên được phân cách bằng dấu phẩy không được proxy sử dụng.

no_proxy: localhost,127.0.0.1

Những thông báo

Thật dễ dàng để bật thông báo cho các công cụ của bên thứ ba thông qua các móc nối web. Để biết thêm chi tiết về phần này, vui lòng đọc trang thông báo .

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"}'

Để biết thêm thông tin về cài đặt cấu hình, vui lòng kiểm tra mã nguồn .

Đánh giá

Since: verdaccio@3.0.0

kiểm tra npm là một lệnh mới được phát hành trong phiên bản npm 6.x . Verdaccio bao gồm một plugin middleware tích hợp (plugin trung gian) để xử lý lệnh này.

Trong trường hợp bạn muốn cài đặt phiên bản mặc định mới, bạn cần thêm đoạn mã sau vào tệp cấu hình

middlewares:
  audit:
    enabled: true