linux gitlab怎么备份配置

在 Linux 上备份 GitLab 配置，通常分为 官方推荐备份方式 和 手动备份关键文件 两种。下面按常见场景说明。

一、使用 GitLab 官方备份（推荐）

1. 备份命令（包含配置）

sudo gitlab-rake gitlab:backup:create

默认会生成在：

/var/opt/gitlab/backups/

⚠️ 注意：

• 该备份包含仓库、数据库、附件
• 不包含 /etc/gitlab/ 和 /var/opt/gitlab/ 的配置文件

二、必须单独备份的配置目录（非常重要）

1. 核心配置文件

sudo tar czf gitlab-config-$(date +%F).tar.gz -C / etc/gitlab

主要包含：

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

⚠️ gitlab-secrets.json 丢失会导致：

• CI/CD 变量无法解密
• Runner 注册失败
• 部分集成失效

2. 数据目录（可选但建议）

sudo tar czf gitlab-data-$(date +%F).tar.gz -C / var/opt/gitlab

包含：

• Redis
• PostgreSQL
• Git 仓库裸数据

三、完整备份脚本示例

#!/bin/bash
DATE=$(date +%F)
BACKUP_DIR=/backup/gitlab

mkdir -p $BACKUP_DIR

# 官方备份
gitlab-rake gitlab:backup:create

# 配置备份
tar czf $BACKUP_DIR/gitlab-etc-$DATE.tar.gz -C / etc/gitlab
tar czf $BACKUP_DIR/gitlab-var-$DATE.tar.gz -C / var/opt/gitlab

四、备份恢复简要说明

恢复配置

tar xzf gitlab-etc-2026-01-21.tar.gz -C /

恢复数据

gitlab-rake gitlab:backup:restore BACKUP=1142345678_2026_01_21

五、建议备份策略

如果你用的是：

• Omnibus GitLab
• Docker GitLab
• Kubernetes GitLab

可以告诉我，我可以给你对应版本的备份方案。