Linux GitLab如何恢复数据

在 Linux 上恢复 GitLab 数据，主要取决于你是否有备份以及 GitLab 的安装方式（Omnibus / Docker / 源码）。下面按最常见、最安全的方式给你一个完整恢复流程。

一、前提条件（非常重要）

✅ GitLab 版本必须与备份时一致或更高（不能降级）
✅ 恢复会 覆盖当前数据
✅ 建议先在测试环境验证

二、确认备份文件是否存在

默认备份路径：

/var/opt/gitlab/backups/

查看备份文件：

ls -lh /var/opt/gitlab/backups/

示例：

1690000000_2023_07_22_gitlab_backup.tar

三、停止 GitLab 部分服务（避免数据写入）

gitlab-ctl stop puma
gitlab-ctl stop sidekiq

确认状态：

gitlab-ctl status

四、恢复 GitLab 数据（核心步骤）

1️⃣ 执行恢复命令

gitlab-backup restore BACKUP=1690000000_2023_07_22

⚠️ 不要加 .tar，只写时间戳前缀

2️⃣ 恢复配置文件（非常重要）

备份时通常包含：

/etc/gitlab/gitlab-secrets.json
/etc/gitlab/gitlab.rb

恢复方式：

cp /var/opt/gitlab/backups/gitlab-secrets.json /etc/gitlab/
cp /var/opt/gitlab/backups/gitlab.rb /etc/gitlab/   # 如果存在

然后重新加载配置：

gitlab-ctl reconfigure

❗ 不恢复 gitlab-secrets.json 会导致：

CI/CD 变量无法解密
Runner 无法注册
2FA 失效

五、启动 GitLab

gitlab-ctl start

检查状态：

gitlab-ctl status
gitlab-rake gitlab:check SANITIZE=true

六、验证恢复是否成功

登录 GitLab Web
检查：
- 项目是否完整
- 分支、提交记录
- CI/CD 变量
- 用户权限

七、Docker 方式 GitLab 恢复（如适用）

1️⃣ 进入容器

docker exec -it gitlab bash

2️⃣ 执行恢复

gitlab-backup restore BACKUP=timestamp

3️⃣ 重启容器

docker restart gitlab

八、没有备份怎么办？（紧急补救）

⚠️ 没有备份 = 无法完整恢复

你可以尝试：

恢复 /var/opt/gitlab/git-data/repositories
但 数据库、用户、权限、CI/CD 会丢失

建议：

# 尝试从磁盘恢复
extundelete
testdisk

九、常见错误与解决

❌ 版本不一致

Backup is from a different version

✅ 解决：

安装 与备份时相同版本
再升级

❌ 权限错误

chown -R git:git /var/opt/gitlab/git-data

十、建议的备份策略（防止再次丢失）

# 定时备份
0 2 * * * /opt/gitlab/bin/gitlab-backup create

备份到远程：

NFS
S3
对象存储

十一、我可以继续帮你

你可以直接告诉我：

✅ GitLab 安装方式（Omnibus / Docker / K8s）
✅ 是否有备份
✅ 要恢复哪些数据（仓库 / 数据库 / CI）
✅ 报错信息（如果有）

我可以给你 精确到命令级别 的恢复方案。