Linux服务器上的Nexus制品库,如何备份并验证恢复完整性?
要让 Linux 服务器上的 Nexus 制品库具备可恢复性,备份不能只复制某个 blobs 目录,也不能在服务持续写入时直接拷贝整个数据目录。一个可用的恢复点至少要同时包含 Nexus 数据库、全部实际使用的 Blob Store、配置与密钥材料,并且这些内容必须来自同一一致性时间点。
实际执行时建议采用“冻结写入、停止服务、复制数据、生成校验清单、隔离环境恢复演练、通过应用层验证后再上线”的顺序。文件能够复制完成,只能证明备份介质上存在这些文件;只有 Nexus 能正常启动、仓库配置完整、制品能够按原路径下载并通过摘要校验,才能说明恢复结果具备可用性。

准备条件
以下内容按 Linux 上以 systemd 运行的 Nexus Repository 3 为例。默认路径只能作为参考,正式操作前必须从服务单元、启动参数和 Nexus 管理界面核实实际路径。不同版本可能使用不同的内置数据库,不能按照旧教程手工判断数据库目录名称。
明确恢复目标和一致性要求
先确定本次备份要满足的 RPO 和 RTO:
- RPO:发生故障时允许丢失多长时间内的新数据。例如 RPO 为 24 小时,可以接受最近一次日备份之后的变化丢失。
- RTO:从故障确认到 Nexus 恢复提供服务所允许的最长时间。
- 恢复版本:首次恢复应使用与备份时完全一致的 Nexus 版本和兼容的 Java 版本,不要在恢复过程中同时升级。
- 恢复范围:确认是恢复整套 Nexus,还是只恢复某个 Blob Store、某个仓库或一台备用服务器。
- 验证对象:提前记录若干已知制品的仓库名、路径、文件大小和 SHA-256 摘要,恢复后用这些制品做功能性验证。
数据库和 Blob Store 必须配套。数据库中保存仓库、组件、资产、权限和索引等信息,Blob Store 中保存制品内容。只恢复数据库,通常会出现仓库记录存在但制品下载失败;只恢复 Blob Store,则无法保证 Nexus 能够按照原来的仓库结构识别这些内容。

划定备份边界
建议先建立一份备份清单,不要直接把“默认目录存在”当成“备份范围完整”。
| 对象 | 应备份内容 | 注意事项 |
|---|---|---|
| Nexus 数据库 | 数据目录中的 db,或者当前部署模式使用的外部数据库一致性备份 | 不同版本可能使用不同内置数据库;外部数据库应使用对应数据库的原生备份方法 |
| 全部 Blob Store | 文件型 Blob Store 的完整目录,包括 content、metadata 等内容;外部对象存储中的对象和版本信息 | 不要只备份 blobs/default,要核对所有仓库实际绑定的 Blob Store |
| Nexus 配置 | 数据目录中的 etc,尤其是 nexus.properties 及版本相关配置 | 如果配置引用了外部路径、证书或密钥,需一并记录 |
| 密钥和证书 | 数据目录内的 keystore、密钥文件,以及服务单元或外部密钥系统中的相关材料 | 备份包含敏感信息,必须限制访问权限并加密保存 |
| 运行环境 | Nexus 版本、Java 版本、安装目录、nexus.vmoptions、systemd 服务单元、挂载点和环境变量 | 二进制文件可以单独保存安装包或校验信息,不建议把运行目录和数据目录混为一套恢复文件 |
| 日志和审计记录 | log、审计日志或外部日志系统中的相关记录 | 通常不是启动恢复必需项,但故障调查、合规审计可能需要 |
| 缓存和临时文件 | cache、tmp 等可重建目录 | 不应把它们当作核心恢复数据;是否保留取决于排障和审计需要 |
如果 Blob Store 使用的是 S3 兼容对象存储或其他外部存储,Linux 服务器上的 blobs 目录可能只是配置或索引信息,真正的制品对象并不在本机。此时需要同时完成对象存储侧的快照、版本保护或对象复制,并记录数据库与对象存储快照之间的对应时间点。
规划频率和保留周期
备份频率应根据制品发布频率、误删发现时间和可接受的数据损失制定。下面是一个可以作为起点的示例:
| 恢复目标 | 参考方式 | 示例保留策略 |
|---|---|---|
| 允许丢失一天以内的数据 | 每天维护窗口内做一次一致性备份 | 保留近 7 份日备份、4 份周备份 |
| 希望缩短到数小时 | 使用存储快照或受支持的数据库备份,并协调 Blob Store 快照时间 | 保留近 24 至 72 个小时点,同时保留日备份 |
| 需要更短恢复点 | 采用受支持的数据库时间点恢复、对象存储版本保护或复制方案 | 先验证数据库、Blob Store 和对象存储能否在同一恢复点对齐,再确定频率 |
保留周期应覆盖误删或错误清理任务被发现的时间。例如,仓库清理任务执行后不是立即发现问题,就不能只保留最近一份备份。建议至少保留一份与生产服务器不同故障域的副本,并对关键备份使用只读、不可变或受访问控制保护的存储。
容量估算时,Blob Store 通常是主要占用。若需要传输 800 GB 的十进制数据,链路有效速率为 200 Mbps,则理论传输时间约为:
800 × 8 × 1000 ÷ 200 = 32000 秒 ≈ 8.9 小时
这里的 800 GB 按十进制计算,200 Mbps 也按十进制比特速率计算。实际时间还会受到小文件数量、校验、压缩、加密和存储端 I/O 的影响。若使用的是存储快照,保留容量取决于快照之间的变化量,不能简单按完整数据量相加。
核实服务、数据目录和存储位置
先确认 systemd 服务名、服务用户、启动参数以及数据目录。下面的路径是示例,只有确认后才能用于后续操作。
SERVICE=nexus
NEXUS_HOME=/opt/nexus
DATA_DIR=/opt/sonatype/sonatype-work/nexus3
sudo systemctl cat "$SERVICE"
sudo systemctl show "$SERVICE" -p User -p Group -p Environment -p ExecStart
sudo systemctl status "$SERVICE" --no-pager
如果服务名不是 nexus,应替换为实际服务名。重点检查启动参数中是否存在 nexus-data、karaf.data、NEXUS_DATA 或类似数据目录设置。确认路径后,再检查目录和空间:
sudo test -d "$DATA_DIR" && echo "data directory exists"
sudo du -xsh "$DATA_DIR"/etc "$DATA_DIR"/db "$DATA_DIR"/blobs
sudo df -hT "$DATA_DIR"
sudo df -ih "$DATA_DIR"
sudo find "$DATA_DIR/blobs" -mindepth 1 -maxdepth 2 -type d -print
在 Nexus 管理界面的 Blob Store 配置中逐一记录以下内容:
- Blob Store 名称;
- 存储类型;
- 文件型 Blob Store 的实际目录;
- 是否存在数据目录之外的自定义路径;
- 是否有仓库绑定到不同的 Blob Store;
- 外部对象存储的桶、前缀、区域和访问配置。
如果某个文件型 Blob Store 是通过软链接指向其他磁盘,备份时必须复制软链接实际指向的目录,而不是只保存一个软链接。若目录本身是独立挂载点,恢复演练时也要先挂载对应目标卷,否则复制操作可能落到普通目录中,导致服务启动后看似正常但无法读取制品。
备份目标应位于独立磁盘、独立挂载点或其他主机上:
BACKUP_ROOT=/mnt/backup/nexus
sudo install -d -m 700 "$BACKUP_ROOT"
findmnt -T "$DATA_DIR"
findmnt -T "$BACKUP_ROOT"
df -hT "$BACKUP_ROOT"
df -ih "$BACKUP_ROOT"
备份目录不能与 Nexus 数据目录共用同一个容易同时损坏的文件系统。备份内容包含用户、权限、仓库凭据和私钥等敏感信息,目录权限、传输链路和对象存储访问策略都应单独控制。
分步操作
1. 暂停写入并停止 Nexus
在维护窗口内先暂停 CI/CD 发布、制品上传、自动同步和人工管理操作。仅停止部分客户端不够时,应在变更系统中明确维护开始时间,并通知可能调用 Nexus 的任务。
主机文件备份采用离线复制时,应先停止 Nexus,让数据库和 Blob Store 不再发生变化:
sudo systemctl stop "$SERVICE"
for i in {1..30}; do
if ! sudo systemctl is-active --quiet "$SERVICE"; then
break
fi
sleep 1
done
sudo systemctl is-active "$SERVICE" || true
sudo ps -eo user,pid,args | grep -E '[n]exus|[k]araf' || true
sudo ss -ltnp | grep ':8081' || true
8081 只是常见示例端口,应替换为实际端口。停止后如果仍有 Nexus Java 进程、监听端口或打开数据文件,不要立即复制,也不要把强制终止进程作为常规步骤。先查看服务状态和日志:
sudo systemctl status "$SERVICE" --no-pager
sudo journalctl -u "$SERVICE" --no-pager -n 200
如果服务无法正常停止,应将本次备份标记为未开始,查明停止失败原因后重新进入维护窗口。强制终止正在写数据库的进程,可能产生数据库恢复、锁文件或未完成事务问题。
如果 Nexus 使用外部数据库,不能通过复制 $DATA_DIR/db 代替数据库备份。应先暂停写入,再使用当前版本和数据库类型支持的原生一致性备份方法,并确保数据库备份时间点与 Blob Store 快照相互对应。
2. 复制数据库、配置和全部 Blob Store
下面示例采用新的时间目录保存每次备份,避免把本次失败结果误认为旧备份的增量。rsync 选项用于保留权限、时间、硬链接、ACL、扩展属性和稀疏文件。
STAMP=$(date -u +%Y%m%dT%H%M%SZ)
DEST="$BACKUP_ROOT/$STAMP"
sudo install -d -m 700 "$DEST/data"
sudo rsync -aHAXS --numeric-ids --info=progress2 \
"$DATA_DIR/etc/" "$DEST/data/etc/"
sudo rsync -aHAXS --numeric-ids --info=progress2 \
"$DATA_DIR/db/" "$DEST/data/db/"
sudo rsync -aHAXS --numeric-ids --info=progress2 \
"$DATA_DIR/blobs/" "$DEST/data/blobs/"
如果备份目标文件系统不支持 ACL 或扩展属性,rsync 报错时不能直接去掉 -A 或 -X 后继续而不作记录。应改用支持这些属性的备份存储,或采用保留这些属性的归档方式,并在恢复验收中确认权限和安全属性没有丢失。
如果核实到其他文件型 Blob Store 位于数据目录之外,应针对每个路径单独复制,并在备份目录中保留名称映射。例如:
BLOBSTORE_PATH=/srv/nexus-blobstore/releases
BLOBSTORE_BACKUP="$DEST/blobstores/releases"
sudo install -d -m 700 "$BLOBSTORE_BACKUP"
sudo rsync -aHAXS --numeric-ids --info=progress2 \
"$BLOBSTORE_PATH/" "$BLOBSTORE_BACKUP/"
实际执行时,BLOBSTORE_PATH 和 Blob Store 名称必须替换为已经核实的值。外部对象存储不能用上述 rsync 命令代替,应在对象存储侧创建与数据库一致的恢复点。
同时保存服务单元、Java 信息和运行参数,便于在备用主机上重建环境:
sudo systemctl cat "$SERVICE" | sudo tee "$DEST/service-unit.txt" >/dev/null
if sudo test -f "$NEXUS_HOME/bin/nexus.vmoptions"; then
sudo cp -a "$NEXUS_HOME/bin/nexus.vmoptions" "$DEST/"
fi
java -version 2>&1 | sudo tee "$DEST/java-version.txt" >/dev/null
Nexus 安装包、插件或自定义证书如果位于数据目录之外,也应保存其版本信息和校验值。不要只恢复 etc 和 db,却忘记服务单元中引用的安装路径、Java 参数、证书路径或外部密钥服务。
3. 选择正确的数据库备份方式
离线复制数据目录时,db 应与 Blob Store 一起复制。某些版本或部署模式在 Nexus 管理界面的系统任务中提供与数据库类型匹配的数据库备份任务,名称可能包含数据库备份或具体数据库名称。
如果使用产品支持的数据库备份任务,应注意以下边界:
- 先确认任务输出位置、完成状态和恢复方法。
- 不能只备份数据库而忽略 Blob Store。
- 如果任务运行期间仍允许上传、删除或清理,应使用维护窗口,或使用能够保证数据库与 Blob Store 对齐的存储快照方案。
- 不要把数据库任务生成的备份文件手工拆分后放回
db目录,恢复方式应按同一版本的支持文档执行。 - 对外部数据库使用原生一致性备份,不要同时再复制一个并未被 Nexus 使用的本地
db目录,以免恢复时误选数据源。
对于大型实例,可以使用应用支持的数据库备份加存储快照减少停机时间,但必须通过恢复演练证明数据库记录与制品对象能够对应。无法证明时间点一致时,离线停止服务复制虽然停机时间更长,但恢复关系更容易判断。
4. 生成校验清单并标记完成
备份复制完成后,在备份副本上生成 SHA-256 清单。清单中的路径应相对于 data 目录,便于未来在恢复主机上复核:
sudo sh -c "
cd '$DEST/data' &&
find etc db blobs -type f -print0 |
sort -z |
xargs -0 -r sha256sum > '$DEST/SHA256SUMS'
"
sudo sh -c "
cd '$DEST/data' &&
sha256sum -c '$DEST/SHA256SUMS'
"
仅对备份副本执行自校验,能够发现备份副本随后发生的损坏,但不能完全证明复制过程中源和目标一一相同。服务仍处于停止状态时,可以使用 rsync 的校验模式进行干运行比较:
for part in etc db blobs; do
sudo rsync -aHAXSnic --delete --numeric-ids \
"$DATA_DIR/$part/" "$DEST/data/$part/"
done
这里的 -n 表示只模拟,不执行复制或删除;--delete 只用于在干运行中发现目标多余文件。正常情况下不应出现文件变更或删除提示。如果输出了差异,应先判断是权限、时间、扩展属性、复制中断还是源目录仍在变化,确认后重新校验。自定义 Blob Store 也应采用相同方式核对。
只有完成复制、校验和差异检查后,才创建完成标记:
sudo touch "$DEST/BACKUP.COMPLETE"
sudo chmod 600 "$DEST/BACKUP.COMPLETE"
没有 BACKUP.COMPLETE 的目录应视为未完成备份。完成标记、SHA256SUMS、备份说明和实际数据应一并复制到独立存储位置。
最后再启动原 Nexus。启动失败时不要立即让客户端恢复发布:
sudo systemctl start "$SERVICE"
sudo systemctl status "$SERVICE" --no-pager
5. 在隔离主机上执行恢复演练
恢复演练应优先使用与生产隔离的主机或独立虚拟机,避免恢复数据与生产实例同时写入同一 Blob Store。恢复主机应准备:
- 与备份时相同的 Nexus 版本;
- 兼容的 Java 版本;
- 与服务单元匹配的安装目录;
- 相同或等效的数据目录路径;
- 相同的文件型 Blob Store 挂载点;
- 外部对象存储、证书和密钥服务的测试访问能力;
- 足够的磁盘空间、文件数和内存。
如果 Nexus 数据目录是独立挂载点,不能直接对挂载点执行普通 mv。应为恢复准备新的卷或快照。下面命令适用于普通目录型数据目录,并且假设当前恢复主机上的旧数据需要保留:
RECOVERED=/mnt/backup/nexus/20250101T020000Z
DATA_DIR=/opt/sonatype/sonatype-work/nexus3
sudo test -f "$RECOVERED/BACKUP.COMPLETE"
sudo sh -c "
cd '$RECOVERED/data' &&
sha256sum -c '$RECOVERED/SHA256SUMS'
"
sudo systemctl stop "$SERVICE"
OLD_DATA_DIR="${DATA_DIR}.before-restore.$(date -u +%Y%m%dT%H%M%SZ)"
sudo mv "$DATA_DIR" "$OLD_DATA_DIR"
sudo install -d "$DATA_DIR"
sudo rsync -aHAXS --numeric-ids \
"$RECOVERED/data/etc/" "$DATA_DIR/etc/"
sudo rsync -aHAXS --numeric-ids \
"$RECOVERED/data/db/" "$DATA_DIR/db/"
sudo rsync -aHAXS --numeric-ids \
"$RECOVERED/data/blobs/" "$DATA_DIR/blobs/"
恢复前应从 systemd 单元确认实际服务用户和用户组:
sudo systemctl show "$SERVICE" -p User -p Group
如果服务用户的 UID 在恢复主机上不同,恢复文件后只对恢复目标目录调整所有权,不要修改备份源:
NEXUS_USER=nexus
NEXUS_GROUP=nexus
sudo chown -R "$NEXUS_USER:$NEXUS_GROUP" "$DATA_DIR"
NEXUS_USER 和 NEXUS_GROUP 必须替换为服务单元中实际使用的账号。chown -R 会影响恢复目标目录下的大量文件,执行前应确认目标路径不是生产数据目录,也不是备份源路径。对于外部对象存储,不要对本地空目录执行无意义的 chown,应恢复对象存储访问权限和服务端凭据。
首次恢复时不要修改数据库文件,也不要把新旧版本的 db、blobs、etc 交叉拼接。启动相同版本的 Nexus:
sudo systemctl start "$SERVICE"
sudo systemctl status "$SERVICE" --no-pager
如果恢复过程中需要升级 Nexus,应先完成同版本恢复和验收,再以新的备份为起点单独执行升级演练。把恢复和升级合并在一次操作中,会使数据库迁移、制品缺失和版本兼容问题难以区分。
Nexus制品库的恢复演练涉及数据库与Blob Store的计算和存储资源。A5数据提供香港、美国、日本等地的物理服务器,涵盖常规与AMD计算配置,部分方案配备NVMe;香港存储系列提供多块企业级硬盘配置,可为仓库服务及隔离恢复环境提供硬件资源基础。多地区产品也能匹配不同业务部署区域的资源需求。
结果验证
恢复完整性需要同时通过文件层、应用层和制品层验证。只看到进程处于运行状态,或者登录页面能够打开,都不足以证明恢复成功。

文件层验证
在恢复主机上再次执行校验:
sudo sh -c "
cd '$RECOVERED/data' &&
sha256sum -c '$RECOVERED/SHA256SUMS'
"
应确认以下条件:
SHA256SUMS中没有FAILED、MISSING或无法读取的文件;- 所有实际使用的 Blob Store 都有对应备份;
- 数据库目录、配置目录和外部 Blob Store 的备份时间点能够对应;
- 备份目录具有完成标记;
- 文件数量和总容量与备份前记录基本一致;
- 备份副本位于独立存储,而不是与生产目录同一个故障点。
文件数量和容量可以作为辅助检查:
sudo find "$RECOVERED/data/etc" "$RECOVERED/data/db" \
"$RECOVERED/data/blobs" -type f | wc -l
sudo du -sh "$RECOVERED/data/etc" \
"$RECOVERED/data/db" "$RECOVERED/data/blobs"
容量差异不一定直接表示损坏。稀疏文件、硬链接、文件系统块大小和显示单位都可能造成 du 结果不同,因此最终以校验清单和应用层读取结果为准。
服务层验证
检查服务状态、Nexus 状态接口和日志:
sudo systemctl is-active "$SERVICE"
curl -fsS "http://127.0.0.1:8081/service/rest/v1/status"
sudo journalctl -u "$SERVICE" --no-pager -n 200
端口和状态接口按实际配置替换。不同版本或安全配置可能要求认证,应使用安全的认证方式,不要把真实密码直接写进命令、脚本或日志。
服务层至少应满足:
- systemd 服务处于 active;
- Nexus 状态接口返回成功状态;
- 管理界面能够登录;
- 日志中没有数据库锁、数据库迁移失败、Blob Store 不可访问或大量制品缺失错误;
- Nexus 数据目录、日志目录和临时目录具有正确权限;
- 服务使用的是预期的
NEXUS_DATA,而不是安装目录下的其他空目录。
需要区分普通启动提示和真正的恢复错误。首次启动可能进行索引加载或缓存重建,但数据库无法打开、Blob Store 路径不存在、密钥无法解密配置等问题不能以“服务最终启动了”为理由忽略。
仓库和权限验证
登录管理界面或使用本版本支持的 REST API,对照备份前记录核对:
- 仓库名称、类型和在线状态;
- 每个仓库绑定的 Blob Store;
- 代理仓库的远程地址、认证和路由配置;
- hosted、proxy、group 仓库的成员关系;
- 用户、角色、权限和匿名访问设置;
- SSL 证书、信任配置和外部密钥引用;
- 清理策略、定时任务和关键仓库属性。
可以使用常见的仓库接口获取列表,认证方式应按实际环境补充:
curl -fsS \
"http://127.0.0.1:8081/service/rest/v1/repositories" \
-o /tmp/nexus-repositories.json
cat /tmp/nexus-repositories.json
如果接口返回未授权,应通过管理界面或受保护的临时凭据完成检查,不要为了验证而降低认证策略。
制品层验证
制品层验证是判断数据库与 Blob Store 是否真正匹配的关键。恢复前应选择有代表性的制品,至少覆盖:
- 一个 hosted 仓库中的旧制品;
- 一个近期发布的制品;
- 一个体积较大的制品;
- 每种重要格式中的一个制品,例如 Maven、npm、PyPI、Docker 或 Raw;
- 每个关键 Blob Store 至少一个制品;
- 一个代理仓库中已经缓存的制品。
以 Raw 仓库为例,验证命令可以是:
REPO_URL='http://127.0.0.1:8081/repository/example-raw'
curl -fL \
-o /tmp/nexus-restore-probe \
"$REPO_URL/已记录的制品路径"
sha256sum /tmp/nexus-restore-probe
将恢复后的摘要与备份前记录的摘要比较,同时检查 HTTP 状态码和文件大小。私有仓库需要使用实际认证方式,但不要把长期密码写在 shell 历史中。
不同格式的验证重点有所不同:
- Maven:验证 POM、主构件和校验文件能够下载;
- npm:验证包元数据和 tarball 能够下载;
- PyPI:验证包文件和元数据能够读取;
- Docker:验证镜像清单以及至少一个层能够拉取;
- Raw:验证已知路径、文件长度和 SHA-256;
- group 仓库:验证成员仓库顺序和实际聚合结果;
- proxy 仓库:分别测试已缓存制品和需要访问远端的制品。
代理仓库中未缓存的制品依赖远程服务。如果恢复主机不能访问远端,下载失败不一定表示本地备份损坏,应先用 hosted 仓库和已缓存制品完成本地恢复验证,再单独检查远程连接。
如果当前版本提供 Blob Store 完整性检查或只读校验任务,可以在隔离恢复环境中执行。带有“修复、重建、回收、压缩、删除”含义的任务不应作为第一步,也不应直接在生产数据上尝试。先保留快照,再了解任务是否会修改数据库或删除对象,最后按变更流程执行。
验收标准
可以用以下层级判断恢复是否通过:
| 验证层 | 验证方法 | 通过条件 |
|---|---|---|
| 备份介质 | 完成标记、SHA-256 清单、文件数量和容量 | 无缺失文件,校验全部通过 |
| 服务启动 | systemd 状态、状态接口、日志 | 服务正常运行,未出现数据库或 Blob Store 致命错误 |
| 配置数据 | 仓库、Blob Store、用户、角色和任务对照 | 关键配置与备份前记录一致 |
| 制品读取 | 各类仓库和各个 Blob Store 抽样下载 | HTTP 状态、大小和摘要符合预期 |
| 权限控制 | 管理员、只读用户、发布账号分别测试 | 权限边界与恢复前一致 |
| 恢复指标 | 记录从开始恢复到可用的时间 | RTO 满足目标,数据损失不超过 RPO |
| 切换准备 | 域名、证书、客户端配置和回滚目录 | 能够在不混用旧新数据的情况下切换 |
如果只通过了服务启动检查,没有通过制品下载和摘要验证,应将恢复状态标记为“不通过”。
失败处理
备份阶段的常见失败
| 现象 | 可能原因 | 处理方式 |
|---|---|---|
| 停止服务后仍有 Nexus 进程或监听端口 | 服务停止超时、启动脚本与 systemd 状态不一致,或端口属于其他进程 | 暂停复制,查看服务日志和进程 PID;确认没有写入后再重新操作,不要直接强制终止 |
rsync 出现权限拒绝 | 备份账号无权读取、挂载点 ACL 限制或服务目录权限异常 | 使用 namei -l、getfacl 和挂载信息定位,不要用 chmod -R 777 覆盖问题 |
| 备份目标空间不足 | Blob Store 较大、保留多份完整副本或 inode 耗尽 | 检查 df -h 和 df -ih,扩容或调整目标;只清理明确标记为未完成的旧副本,不要删除生产数据 |
| 校验出现差异 | 复制中断、源目录仍在变化、目标存储损坏或 ACL/扩展属性未保留 | 本次目录不标记完成,停止写入后重新比较;必要时换用新的目标介质 |
默认 blobs 目录很小,但仓库中存在大量制品 | Blob Store 使用了自定义路径或外部对象存储 | 回到 Blob Store 配置逐项核对,补齐真实路径或对象存储快照 |
| 数据库备份与 Blob Store 时间不一致 | 数据库任务运行时仍有上传、删除或清理操作 | 该恢复点不作为正式备份,重新协调写入冻结和存储快照时间 |
如果备份中途失败,不能只根据复制命令返回成功就创建完成标记。保留失败目录便于排查,但必须显式命名为未完成,并与有效备份区分。
恢复阶段的常见失败
| 现象 | 可能原因 | 处理方式 |
|---|---|---|
| Nexus 无法启动 | 版本不一致、Java 不兼容、数据目录路径错误、文件所有权错误 | 先核对服务单元、版本、Java、NEXUS_DATA 和日志,不要直接修改数据库文件 |
| 数据库锁定或迁移失败 | 旧实例仍在运行,或使用了不同版本启动恢复数据 | 停止所有旧实例,使用备份时的同一版本恢复;不要在未做快照时反复启动不同版本 |
| 仓库存在但制品返回 404 | 数据库与 Blob Store 不配套、Blob Store 路径错误或对象存储未恢复 | 停止进一步写入,核对恢复点、挂载点和对象存储权限;先恢复匹配的数据对,不要立即运行修复任务 |
| 服务能启动但大量制品读取失败 | 文件权限、外部挂载未就绪、Blob Store 内容缺失 | 检查 findmnt、服务用户、对象存储连接和缺失制品范围 |
| 管理页面可访问但登录失败 | 密钥、keystore、外部身份认证或配置引用未恢复 | 核对密钥材料和外部认证依赖,不要通过删除安全数据库来“重置” |
| 状态接口正常但代理制品下载失败 | 恢复主机无法访问远端,或代理配置未恢复 | 先测试 hosted 和已缓存制品,再检查远程地址、证书、DNS 和认证 |
| 恢复后任务自动删除或修改数据 | 定时任务、清理任务或外部 CI 在恢复主机上运行 | 演练环境先隔离客户端和远端任务,验收前暂停可能产生写入的自动任务 |
遇到制品缺失时,不要先删除数据库、重建索引或运行带有修复含义的任务。先保留现场和日志,确认是数据库、Blob Store、挂载路径、权限还是外部对象存储问题。如果确认备份本身不完整,应切换到上一份已验证的恢复点。
回滚
备份完成但原服务启动失败
如果只是备份过程结束后原 Nexus 无法启动,而生产数据目录没有被覆盖,应保留原目录和日志,先检查服务单元、磁盘、权限与 Java 环境。确认没有未完成的数据库操作后再启动原服务:
sudo systemctl status "$SERVICE" --no-pager
sudo journalctl -u "$SERVICE" --no-pager -n 300
sudo systemctl start "$SERVICE"
不要为了让服务快速启动而删除数据库目录、锁文件或 Blob Store 元数据。任何删除操作都可能扩大损坏范围,必须先有可验证的完整备份和明确的回滚路径。
恢复演练失败
恢复命令中的 OLD_DATA_DIR 是恢复前保留的旧数据目录。确认该目录仍未被修改后,可以将失败恢复目录移走,再把旧目录放回原位置:
FAILED_DATA_DIR="${DATA_DIR}.failed.$(date -u +%Y%m%dT%H%M%SZ)"
sudo systemctl stop "$SERVICE"
sudo mv "$DATA_DIR" "$FAILED_DATA_DIR"
sudo mv "$OLD_DATA_DIR" "$DATA_DIR"
sudo chown -R "$NEXUS_USER:$NEXUS_GROUP" "$DATA_DIR"
sudo systemctl start "$SERVICE"
这组命令只适用于普通目录型数据目录,并且要求 OLD_DATA_DIR 与 DATA_DIR 位于同一文件系统、没有被自动迁移修改。若数据目录是挂载卷,应使用原卷快照或备用卷执行回滚,不要对挂载点本身执行普通 mv。
如果恢复过程中已经使用了不同版本启动并触发数据库迁移,不能简单地把几个目录拼回去,也不要尝试用新程序“降级”旧数据库。此时应使用恢复前的完整快照、原始数据卷或上一份经过验证的备份重新恢复。
对于外部数据库和外部对象存储,回滚必须同时回退数据库和对象存储到同一个时间点。只回滚数据库而保留较新的对象,或只回滚对象而保留较新的数据库,都可能产生制品缺失、孤儿对象或错误索引。
恢复失败目录和原数据目录都不应在刚启动成功后立即删除。至少要等到管理页面、仓库配置、制品下载、权限和关键客户端验证完成,并完成一次正式验收。
上线或验收检查清单
- [ ] 已确认 Nexus 版本、Java 版本、安装路径和服务用户。
- [ ] 已记录真实数据目录,不再依赖默认路径猜测。
- [ ] 已逐一核对所有 Blob Store,包括数据目录之外的路径和外部对象存储。
- [ ] 数据库与 Blob Store 来自同一冻结时间点或受支持的一致性备份方案。
- [ ] 已备份
etc、密钥、证书、服务单元、Java 参数和外部配置引用。 - [ ] 备份目标不与生产数据处于同一故障点,并已限制访问权限。
- [ ] 备份副本生成了 SHA-256 清单,校验结果全部通过。
- [ ] 只有复制完整并校验成功的目录才有
BACKUP.COMPLETE标记。 - [ ] 已在隔离主机使用相同版本完成恢复演练。
- [ ] Nexus 服务、状态接口和管理页面均正常。
- [ ] 仓库名称、类型、Blob Store 映射、用户、角色和权限与预期一致。
- [ ] 每个关键 Blob Store 至少验证了一个制品。
- [ ] 已验证旧制品、近期制品以及主要格式制品的下载和摘要。
- [ ] 已区分本地备份问题与代理仓库远程连接问题。
- [ ] 已记录实际恢复耗时,并与 RTO 对照。
- [ ] 已确认数据损失范围不超过 RPO。
- [ ] 已保留恢复前目录或快照,回滚步骤经过演练。
- [ ] 上线前已暂停恢复环境中不应执行的清理、发布和同步任务。
- [ ] 生产切换完成后,已再次观察日志、仓库请求和制品下载结果。
本文由A5数据原创发布,转载请注明出处:https://www.a5idc.com/helpcontent/3687.html



