ubuntu下gitlab怎样备份

在 Ubuntu 下备份 GitLab，官方推荐使用的是 GitLab 自带的备份工具。下面按常见场景给你说明。

一、使用 GitLab 官方备份命令（最常用）

1. 执行备份

sudo gitlab-rake gitlab:backup:create

备份完成后，文件会生成在：

/var/opt/gitlab/backups/

文件名类似：

1700000000_2023_11_15_16.5.1_gitlab_backup.tar

2. 查看备份文件

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

二、备份内容包含什么

GitLab 备份默认包括：

• 代码仓库
• 数据库（PostgreSQL）
• 用户、组、项目配置
• CI/CD 数据
• 附件（uploads）
• LFS 等

⚠️ 不包含：

• GitLab 配置文件（需单独备份）
• SSL 证书
• secrets 文件（非常重要）

三、必须额外备份的文件（非常重要）

1. 配置文件

sudo cp /etc/gitlab/gitlab.rb /backup/gitlab.rb

2. 密钥文件（不备份无法恢复）

sudo cp /etc/gitlab/gitlab-secrets.json /backup/gitlab-secrets.json

✅ 恢复时必须原样放回

四、自动定时备份（推荐）

1. 编辑 crontab

sudo crontab -e

2. 每天凌晨 2 点备份

0 2 * * * /opt/gitlab/bin/gitlab-rake gitlab:backup:create

五、只备份配置（轻量）

sudo gitlab-ctl backup-etc

默认位置：

/etc/gitlab/config_backup/

六、备份到远程（示例：rsync）

rsync -avz /var/opt/gitlab/backups/ user@backup-server:/gitlab/backups/

七、恢复备份（简要）

sudo gitlab-rake gitlab:backup:restore BACKUP=1700000000_2023_11_15_16.5.1

恢复前需：

• 停止相关服务
• 放回 gitlab-secrets.json
• 版本必须一致

如果你需要：

• Docker 版 GitLab 备份
• Omnibus / 源码安装区别
• 增量备份方案
• 恢复到新服务器

可以告诉我你的 GitLab 安装方式，我可以给你更精确的命令。