【笔记】Docker 搭建 GitLab 服务器

609 字

3 分钟

【笔记】Docker 搭建 GitLab 服务器

2026-06-12

学习&笔记

Docker

/

GitLab

/

DevOps

1. 拉取 GitLab 镜像#

1
# 拉取 GitLab CE（社区版）最新镜像
2
docker pull gitlab/gitlab-ce:latest

2. 启动 GitLab 容器#

1
docker run \
2
 -itd  \
3
 -p 9980:80 \
4
 -p 9922:22 \
5
 -v /home/gitlab/etc:/etc/gitlab  \
6
 -v /home/gitlab/log:/var/log/gitlab \
7
 -v /home/gitlab/opt:/var/opt/gitlab \
8
 --restart always \
9
 --privileged=true \
10
 --name gitlab \
11
 gitlab/gitlab-ce

参数说明#

参数	说明
`-itd`	交互模式 + 伪终端 + 后台运行
`-p 9980:80`	宿主机 9980 端口 → 容器 80 端口（Web 访问）
`-p 9922:22`	宿主机 9922 端口 → 容器 22 端口（SSH）
`-v`	目录挂载（配置、日志、数据）到宿主机
`--restart always`	容器自动重启
`--privileged=true`	获取宿主机 root 权限
`--name gitlab`	容器名称

⚠️ 注意：后续配置请在容器内修改，不要直接改宿主机挂载文件，否则可能不生效。

3. 修改 GitLab 配置#

3.1 进入容器#

1
docker exec -it gitlab /bin/bash

3.2 修改 `gitlab.rb`#

1
vi /etc/gitlab/gitlab.rb
2

3
# 在 vi 中：
4
# 1. 按 Shift + G 直接跳到文件末尾开始添加配置
5
# 2. 按 i 进入插入模式开始编辑
6
# 3. 添加 external_url 等配置
7
# 4. 按Esc退出编辑模式
8
# 5. :wq保存并退出|:w仅保存，不退出|:q不保存退出|:q!强制不保存退出|:wq强制保存并退出

添加以下内容：

1
# GitLab 访问地址（HTTP）：宿主机的IP或分配给宿主机的公网IP
2
external_url 'http://192.168.1.192:9980'
3

4
# SSH 主机 IP
5
gitlab_rails['gitlab_ssh_host'] = '192.168.1.192'
6

7
# SSH 连接端口（映射后的宿主机端口）
8
gitlab_rails['gitlab_shell_ssh_port'] = 9922
9

10
# 指定 nginx 监听 80 端口
11
nginx['listen_port'] = 80

3.3 使配置生效#

1
gitlab-ctl reconfigure

3.4 修改 `gitlab.yml`（重要）#

因为 HTTP 端口映射为 9980，需要同步修改：

1
vi /opt/gitlab/embedded/service/gitlab-rails/config/gitlab.yml

找到 gitlab 部分，修改为：external_url填写时加上了端口号9980则不需要

1
gitlab:
2
  host: 192.168.1.192
3
  port: 9980   # 关键：改为映射后的端口
4
  https: false

3.5 重启 GitLab 并退出容器#

1
gitlab-ctl restart
2
exit
3

4
# 其它常用指令
5
# 停止容器
6
docker stop 容器名
7
# 删除容器
8
docker rm 容器名

4. 浏览器访问#

访问地址：http://192.168.1.192:9980/

⚠️ 要求：宿主机内存 ≥ 4G，否则 GitLab 可能启动失败（502 错误）。

首次访问会提示设置 root 密码
设置完成后使用 root 用户登录
管理员账号root&R@nd0m!P@ssw0rd#2026

普通用户账号

5. 修改 root 密码（命令行方式）#

如果需要通过命令行修改密码：

1
# 进入容器
2
docker exec -it gitlab /bin/bash
3

4
# 进入 Rails 控制台
5
gitlab-rails console -e production
6

7
# 查找 root 用户（id=1）
8
user = User.where(id:1).first
9

10
# 修改密码
11
user.password='你的新密码'
12

13
# 保存
14
user.save!
15

16
# 退出
17
exit