khan/verdaccio

镜像概述

verdaccio是sinopia的分支，旨在保持与sinopia的向后兼容性，同时跟进npm的更新。它是一个私有/缓存npm仓库服务器，无需配置完整的CouchDB数据库，使用自有小型数据库；若所需包不存在于本地仓库，则从npmjs.org获取并仅缓存实际使用的包。

核心功能

• 基础功能：支持包安装（npm install/upgrade）、包发布（npm publish）、用户注册（npm adduser）
• 仓库管理：私有包管理、npmjs.org包缓存、公共包覆盖
• 限制：暂不支持标签（npm tag）、包弃用（npm deprecate）、所有权转移（npm owner）、命令行搜索（npm search）、星标（npm star/unstar）等功能

使用场景

1. 私有包使用：企业内部使用npm包系统，无需公开代码，私有包使用方式与公共包一致，建议为私有包定义统一前缀（如local-）区分。
2. npmjs缓存：多服务器环境减少延迟，首次从npmjs.org获取包后缓存，后续直接提供；npmjs故障时可使用缓存包。
3. 公共包覆盖：使用修改后的第三方包版本，可选择永久叉（修改配置停止同步）或临时覆盖（自定义预发布版本号）。

配置说明

非Docker安装启动

bash
# 全局安装并启动（自动生成默认配置config.yaml）
npm install -g verdaccio
verdaccio

# 配置npm registry
npm set registry http://localhost:4873/

# HTTPS场景设置CA（"null"表示从系统获取CA列表）
npm set ca null

访问http://localhost:4873/%E6%9F%A5%E7%9C%8B%E6%9C%AC%E5%9C%B0%E5%8C%85%E5%88%97%E8%A1%A8%E5%8F%8A%E6%90%9C%E7%B4%A2%E3%80%82

Docker部署

bash
# 构建镜像
docker build -t verdaccio .

# 运行容器（替换<本地目录路径>为实际路径）
docker run -it --rm --name verdaccio -p 4873:4873 \
  -v /<本地目录路径>/conf:/verdaccio/conf \
  -v /<本地目录路径>/storage:/verdaccio/storage \
  -v /<本地目录路径>/local_storage:/verdaccio/local_storage \
  verdaccio

添加用户

bash
npm adduser --registry http://localhost:4873/

按提示输入凭据，保存到verdaccio服务器。