官方备份文档 : 备份和恢复极狐GitLab

---

一. 要求

为了能够进行备份和恢复，请确保您系统已安装 Rsync。 如果您安装了极狐GitLab：

• 如果您使用 Omnibus 软件包，则无需额外操作。
• 如果您使用源代码安装，您需要确定是否安装了 rsync。例如：

# Debian/Ubuntu
sudo apt-get install rsync

# RHEL/CentOS
sudo yum install rsync

---

二. 备份时间戳

备份归档保存在 backup_path 中，该路径在 config/gitlab.yml 文件中指定。文件名是 [TIMESTAMP]_gitlab_backup.tar， 其中 TIMESTAMP 标识每个备份的创建时间和极狐GitLab 的版本。恢复极狐GitLab 需要时间戳，也可以使用多个备份。

例如，如果备份名称是 1493107454_2018_04_25_10.6.4-ce_gitlab_backup.tar，时间戳为 1493107454_2018_04_25_10.6.4-ce。

---

三. 备份极狐GitLab

极狐GitLab 提供了一个命令行界面来备份您的整个实例包含：

• 数据库
• 附件
• Git 仓库数据
• CI/CD 作业输出日志
• CI/CD 作业产物
• LFS 对象
• Terraform 状态（引入于极狐GitLab 14.7）
• 容器镜像库镜像
• 极狐GitLab 页面内容
• 包（引入于极狐GitLab 14.7）
• 代码片段
• 群组 Wiki

备份不包括

• Mattermost 数据
• Redis（和 Sidekiq 作业）

命令

• 极狐GitLab 12.2 及更高版本：

sudo gitlab-backup create

• 极狐GitLab 12.1 及更早版本：

gitlab-rake gitlab:backup:create

如果您使用源代码安装极狐GitLab，请使用以下命令：

sudo -u git -H bundle exec rake gitlab:backup:create RAILS_ENV=production

如果您在 Docker 容器中运行极狐GitLab，请基于您安装的极狐GitLab 版本从主机运行备份：

• 极狐GitLab 12.2 及更高版本：

docker exec -t <container name> gitlab-backup create

• 极狐GitLab 12.1 及更早版本：

docker exec -t <container name> gitlab-rake gitlab:backup:create

示例输出：

检查备份文件

ls -l /var/opt/gitlab/backups/

---

四. 完整命令

## 备份
sudo gitlab-backup create

## 检查文件
ls -l /var/opt/gitlab/backups/

# 创建目标目录
mkdir -p /home/mada/gitlab-backups

# 复制所有备份文件
sudo cp /var/opt/gitlab/backups/*.tar /home/mada/gitlab-backups/

# 或者只复制特定的备份文件
sudo cp /var/opt/gitlab/backups/1737767819_2025_01_25_17.7.0-jh_gitlab_backup.tar /home/mada/gitlab-backups/

# 复制 gitlab.rb 和 gitlab-secrets.json 文件
sudo cp /etc/gitlab/gitlab.rb /home/mada/gitlab-backups/
sudo cp /etc/gitlab/gitlab-secrets.json /home/mada/gitlab-backups/

# 验证文件是否已成功复制
ls -l /home/mada/gitlab-backups/

# 调整文件权限（可选）
sudo chown -R mada:mada /home/mada/gitlab-backups/
sudo chmod -R 600 /home/mada/gitlab-backups/*