verdaccio/plugins-bundle

verdaccio-docker-plugins-bundle

镜像概述

verdaccio-docker-plugins-bundle是一个预集成常用插件的Verdaccio Docker镜像。Verdaccio是一款轻量级npm代理仓库工具，该镜像通过打包认证、存储、UI增强等核心插件，减少手动配置步骤，帮助用户快速部署功能完善的npm私有仓库。

核心功能与特性

• 预集成核心插件：包含verdaccio-auth-memory（内存认证）、verdaccio-htpasswd（文件认证）、verdaccio-s3-storage（S3云存储）、verdaccio-ui（现代化界面）等，覆盖基础到高级使用场景
• 简化部署流程：无需手动安装插件，拉取镜像即可启动具备扩展功能的npm仓库，降低部署门槛
• 支持自定义配置：可通过挂载本地配置文件（config.yaml）调整插件参数、仓库权限、存储策略等，满足个性化需求
• 轻量高效：基于官方Verdaccio镜像构建，保持轻量级特性，同时提供丰富功能扩展

使用场景

• 企业内部npm包管理：搭建私有npm仓库，统一管理内部开发的npm包，控制访问权限，保障代码安全
• 团队协作开发：支持团队共享私有依赖包，加速本地依赖安装，减少对公共npm仓库的依赖
• 功能扩展需求：需快速集成认证（如LDAP）、云存储（如S3）、自定义UI等功能时，无需从零配置插件

使用方法

快速启动

通过以下命令快速启动容器：

bash
docker run -d -p 4873:4873 -v ./verdaccio-data:/verdaccio/storage --name verdaccio-plugins verdaccio/verdaccio-docker-plugins-bundle

• -p 4873:4873：映射容器端口到主机，默认npm仓库端口为4873
• -v ./verdaccio-data:/verdaccio/storage：挂载本地目录存储npm包数据，避免容器重启后数据丢失

环境变量配置

支持通过环境变量调整基础配置：

自定义配置文件

如需调整插件参数或仓库设置，可挂载本地config.yaml文件：

bash
docker run -d -p 4873:4873 \
  -v ./verdaccio-data:/verdaccio/storage \
  -v ./config.yaml:/verdaccio/conf/config.yaml \
  --name verdaccio-plugins verdaccio/verdaccio-docker-plugins-bundle

配置文件示例（config.yaml）：

yaml
storage: /verdaccio/storage
plugins: ./plugins
web:
  title: "企业私有npm仓库"
auth:
  htpasswd:
    file: ./htpasswd
    max_users: 1000
uplinks:
  npmjs:
    url: https://registry.npmjs.org/
packages:
  '@*/*':
    access: $all
    publish: $authenticated
    unpublish: $authenticated
    proxy: npmjs

docker-compose配置示例

创建docker-compose.yml文件简化部署：

yaml
version: '3'
services:
  verdaccio:
    image: verdaccio/verdaccio-docker-plugins-bundle
    ports:
      - "4873:4873"
    volumes:
      - ./verdaccio-data:/verdaccio/storage
      - ./config.yaml:/verdaccio/conf/config.yaml
    environment:
      - VERDACCIO_PORT=4873
    restart: always

启动命令：docker-compose up -d