npm 私有包怎么搭建？Verdaccio 怎么部署和使用？

Question

仓乃文 · Accepted Answer

企业内部共享组件库和工具包需要私有 npm 仓库。Verdaccio 是最轻量的私有 npm 方案，5 分钟即可部署，支持代理上游 npm、权限控制和包缓存。比 Git submodule 和文件引用优雅得多。

部署 Verdaccio：
```bash
# 方式 1：Docker 部署（推荐）
docker run -d \
  --name verdaccio \
  -p 4873:4873 \
  -v /data/verdaccio:/verdaccio/storage \
  verdaccio/verdaccio

# 方式 2：全局安装
npm install -g verdaccio
verdaccio
# 默认运行在 http://localhost:4873
```

配置文件：
```yaml
# ~/.config/verdaccio/config.yaml
storage: /verdaccio/storage

auth:
  htpasswd:
    file: /verdaccio/htpasswd
    max_users: 100

uplinks:
  npmjs:
    url: https://registry.npmjs.org/
    cache: true              # 缓存上游包，加速安装

packages:
  "@myorg/*":              # 组织包，需要登录
    access: $authenticated
    publish: $authenticated
    unpublish: $authenticated

"**":                     # 其他包代理上游
    access: $all
    proxy: npmjs

listen: 0.0.0.0:4873
```

使用私有仓库：
```bash
# 1. 添加用户
npm adduser --registry http://your-server:4873

# 2. 发布包
npm publish --registry http://your-server:4873

# 3. 项目中使用
# .npmrc
@myorg:registry=http://your-server:4873

# 然后正常安装
pnpm add @myorg/shared-utils
```

CI 环境配置：
```yaml
# .npmrc（项目根目录，提交到 Git）
@myorg:registry=http://your-server:4873
//your-server:4873/:_authToken=${NPM_TOKEN}

# GitHub Actions 中设置 NPM_TOKEN 环境变量
- run: pnpm install
  env:
    NPM_TOKEN: ${{ secrets.NPM_TOKEN }}
```

补充说明：
- Verdaccio 的 uplinks 缓存可以显著加速 CI 环境的 npm install
- 生产部署建议加 Nginx 反向代理，配置 HTTPS 和访问控制
- 大型企业可以考虑 Nexus 或 Artifactory，功能更全面
- 包名建议用 @myorg/ 前缀，和公共包区分开