Verdaccio从v3迁移至v4：未加载存储目录的未文档化破坏性变更问题

问题分析 #

Verdaccio v4 的 Docker 镜像相比 v3 有两个关键破坏性变更：

1. 默认使用**非 root 用户（uid=10001）**运行，原有 v3 卷的 root 权限会导致容器无法读取存储内容；
2. 分卷挂载时需确保数据从原有卷正确迁移，否则会出现配置文件缺失的启动报错。

解决方案1：单卷挂载兼容（快速修复） #

如果不想拆分卷，直接修复权限后沿用单卷挂载模式：

1. 修复原有卷的权限，给 verdaccio 用户读写权限：

   docker run --rm -v verdaccio_data:/verdaccio alpine chown -R 10001:10001 /verdaccio
   

2. 修改 docker-compose.yml，显式指定运行用户：

   version: "3"
   services:
     verdaccio:
       image: verdaccio/verdaccio:4.13
       container_name: verdaccio
       ports:
         - "4873:4873"
       volumes:
         - verdaccio_data:/verdaccio
       user: "10001:10001"
   volumes:
     verdaccio_data:
       external: true
   

启动后即可正常加载原有存储内容，不会出现库列表为空的问题。

解决方案2：分卷挂载（规范配置） #

如果需要拆分 conf 和 storage 卷，需先迁移数据并修复权限：

1. 从原有 v3 卷迁移 conf 和 storage 数据到新外部卷：

   # 迁移配置目录
   docker run --rm -v verdaccio_data:/source -v verdaccio_data_conf:/dest alpine cp -a /source/conf/. /dest/
   # 迁移存储目录
   docker run --rm -v verdaccio_data:/source -v verdaccio_data_storage:/dest alpine cp -a /source/storage/. /dest/
   

2. 修复新卷的权限：

   docker run --rm -v verdaccio_data_conf:/conf alpine chown -R 10001:10001 /conf
   docker run --rm -v verdaccio_data_storage:/storage alpine chown -R 10001:10001 /storage
   

3. 使用分卷挂载的 docker-compose.yml：

   version: "3"
   services:
     verdaccio:
       image: verdaccio/verdaccio:4.13
       container_name: verdaccio
       ports:
         - "4873:4873"
       volumes:
         - verdaccio_data_conf:/verdaccio/conf
         - verdaccio_data_storage:/verdaccio/storage
       user: "10001:10001"
   volumes:
     verdaccio_data_conf:
       external: true
     verdaccio_data_storage:
       external: true
   

启动后即可正常加载配置和存储内容。

关键注意点 #

• 不要直接使用空的外部卷进行分卷挂载，必须从原有 v3 卷迁移对应目录的数据；
• v4 容器必须使用 uid=10001 的用户运行，否则会出现权限不足导致的读取失败或启动报错。

内容的提问来源于stack exchange，提问作者jmuhire