一、前期准备

1、虚拟机

2、外网

3、docker

4、docker compose

安装新版 Docker Compose（二进制方式，推荐）

适用于 CentOS 7.9。

 DOCKER_COMPOSE_VERSION="v2.23.0"
 curl -L "https://github.com/docker/compose/releases/download/${DOCKER_COMPOSE_VERSION}/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
 chmod +x /usr/local/bin/docker-compose
 ln -s /usr/local/bin/docker-compose /usr/bin/docker-compose

验证是否成功：

 docker-compose version

输出类似：

 Docker Compose version v2.23.0

二、docker compose 安装

1、创建目录：

 sudo mkdir -p /srv/gitlab

2、环境变量

配置一个新的环境变量 $GITLAB_HOME，设置为您创建的目录的路径：

 export GITLAB_HOME=/srv/gitlab

3、创建docker compose

/srv/gitlab 目录下 nano/vi docker-compose.yml

 services:
   gitlab:
     image: gitlab/gitlab-ce:18.4.1-ce.0   # ✅ 最新稳定版（截至 2025年10月）
     container_name: gitlab
     restart: always
     hostname: '192.168.22.200'
 ​
     environment:
       GITLAB_OMNIBUS_CONFIG: |
         external_url 'http://192.168.22.200:80'
         gitlab_rails['gitlab_shell_ssh_port'] = 2424
         letsencrypt['enable'] = false
     ports:
       - '80:80'
       - '443:443'
       - '2222:22'
     volumes:
       - '/srv/gitlab/config:/etc/gitlab'
       - '/srv/gitlab/logs:/var/log/gitlab'
       - '/srv/gitlab/data:/var/opt/gitlab'
     shm_size: '256m'

在与 docker-compose.yml 相同的目录中，启动GitLab：

 docker compose up -d

首次初始化boot根据配置大约需要10几分钟不等

通过external_url ‘http://192.168.22.200:80‘访问Gitlab

4、管理员账号密码

GitLab 在 首次启动完成后（初始化完毕），会自动生成一个默认管理员账号。

🧩 GitLab 初次登录默认账号信息

项目	内容
用户名 (Username)	root
密码 (Password)	存放在容器内文件 /etc/gitlab/initial_root_password

🔍 查看初始密码方法

你只需要执行下面这条命令（在宿主机上运行）：

 docker exec -it gitlab grep 'Password:' /etc/gitlab/initial_root_password

输出会类似这样：

 Password: k8HgFjW8M3ZJt3RyFZyA1234

这就是你第一次登录用的密码。

⚠️ 注意事项

• 这个文件默认只在 首次启动后 24 小时内有效（GitLab 会自动清理）。
• 登录成功后，请立即修改密码（网页右上角头像 → Preferences → Password）。

跨版本迁移恢复 14.6.1—>18.4.1

方案 A：临时启动旧版本恢复后再升级（推荐）

这是最稳妥的方式。

适合生产环境或重要数据。

这是唯一 100% 数据完整、官方支持的方式。

1️⃣ 关闭当前 GitLab 容器

 docker stop gitlab

2️⃣ 修改 docker-compose.yml

把版本改成与你备份匹配的旧版本：

 image: gitlab/gitlab-ce:14.6.1-ce.0

3️⃣ 重新启动容器

 docker-compose up -d

等待初始化完成后，再进入容器：

 docker exec -it gitlab bash

4️⃣ 执行恢复命令

 gitlab-ctl stop puma
 gitlab-ctl stop sidekiq
 gitlab-backup restore BACKUP=1760115906_2025_10_11_14.6.1
 gitlab-ctl restart

恢复成功后，在网页上确认数据可访问。

5️⃣ 按版本顺序升级 GitLab

升级路径建议如下（跨主版本要一步步来）：

 14.6.1 → 14.9 → 15.0 → 16.0 → 17.0 → 18.4.1

每升级一次：

• 修改 docker-compose.yml 中镜像标签；
• 启动后执行 gitlab-ctl reconfigure;
• 验证网页正常；
• 再备份一次（防止中途出错）。