将Docker部署的Nexus 3.15迁移至3.68.1版本的方法咨询

核心问题原因 #

你遇到的问题本质是跨大版本的元数据不兼容：仅复制Blob文件夹会缺失仓库的元数据（比如镜像索引、标签关联信息），导致控制台看不到内容；直接复制完整/nexus-data则因为3.15到3.68.1版本跨度太大，内置数据库无法完成直接迁移，导致实例启动失败。

方案一：通过中间版本升级完整数据（推荐） #

Nexus跨大版本升级必须遵循官方过渡路径，先将旧版数据升级到中间兼容版本，再迁移到目标版本：

1. 备份旧数据：停止3.15版本的Docker容器，将旧实例的/nexus-data目录完整备份到安全位置。
2. 启动中间版本容器：拉取Nexus 3.29.x（官方推荐的过渡版本）镜像，挂载备份的旧数据目录启动：

   docker run -d -p 8081:8081 -v /path/to/your/old/nexus-data:/nexus-data sonatype/nexus3:3.29.2
   

3. 等待元数据迁移：查看容器日志，确认输出类似Database migration completed的信息，说明中间版本完成了元数据升级。
4. 升级到目标版本：停止3.29.x容器，拉取3.68.1镜像，挂载经过中间版本升级的/nexus-data目录启动：

   docker run -d -p 8081:8081 -v /path/to/upgraded/nexus-data:/nexus-data sonatype/nexus3:3.68.1
   

5. 验证结果：启动完成后，登录控制台即可看到所有仓库和对应的镜像内容。

方案二：仅用Blob文件的应急恢复（无完整数据备份时） #

如果只有单独的Blob文件夹备份，可以通过重建元数据恢复：

1. 匹配仓库配置：在3.68.1实例中，创建与旧版完全同名、同类型、同Blob存储配置的仓库（比如旧版是名为docker-local的Docker宿主仓库，新版必须创建相同名称和类型的仓库，并关联你复制的Blob存储）。
2. 重建元数据任务：进入Nexus控制台的「任务」菜单，创建Repair - Rebuild repository metadata任务，选择目标仓库后执行。
3. 验证内容：任务执行完成后刷新仓库页面，即可看到Blob中的镜像。注意：此方法可能丢失部分元数据（如镜像上传时间、标签历史）。

关键注意事项 #

• 所有操作前必须备份数据，避免不可逆损失。
• Blob存储的名称、路径配置必须与旧版完全一致，否则Nexus无法关联到Blob文件。
• 跨版本升级必须遵循官方路径，跳过中间版本会导致数据库迁移失败。

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