温馨提示×

gitlab linux配置步骤是啥

小樊
36
2026-07-28 13:48:43
栏目: 智能运维

下面按最常见场景给你一份 GitLab 在 Linux 上的配置步骤(以 GitLab CE + Ubuntu / CentOS 为例),适合新手直接照做
如果你用的是别的系统或想用 Docker,我也可以再给你对应版本。


一、环境准备

1️⃣ 系统要求(建议)

  • 内存:≥ 4GB(8GB 更稳)
  • CPU:2 核以上
  • 磁盘:≥ 20GB
  • 系统
    • Ubuntu 20.04 / 22.04 ✅
    • CentOS 7 / Rocky / Alma ✅

二、安装 GitLab(CE 社区版)

✅ Ubuntu / Debian

# 1. 安装依赖
sudo apt update
sudo apt install -y curl openssh-server ca-certificates tzdata

# 2. 添加 GitLab 仓库
curl -fsSL https://packages.gitlab.com/gpg.key | sudo gpg --dearmor -o /usr/share/keyrings/gitlab-archive-keyring.gpg

echo "deb [signed-by=/usr/share/keyrings/gitlab-archive-keyring.gpg] https://packages.gitlab.com/gitlab/gitlab-ce/ubuntu $(lsb_release -cs) main" | \
sudo tee /etc/apt/sources.list.d/gitlab_gitlab-ce.list

# 3. 安装 GitLab
sudo apt update
sudo apt install -y gitlab-ce

✅ CentOS / Rocky / Alma

# 1. 安装依赖
sudo yum install -y curl policycoreutils openssh-server

# 2. 添加 GitLab 仓库
curl -fsSL https://packages.gitlab.com/gpg.key | sudo gpg --dearmor -o /etc/pki/rpm-gpg/gitlab-archive-keyring.gpg

sudo curl -o /etc/yum.repos.d/gitlab_gitlab-ce.repo \
https://packages.gitlab.com/install/repositories/gitlab/gitlab-ce/config_file.repo?os=el&dist=7

# 3. 安装 GitLab
sudo yum install -y gitlab-ce

三、配置 GitLab

1️⃣ 修改配置文件

sudo vim /etc/gitlab/gitlab.rb

重点配置项:

# 访问地址(必须)
external_url 'http://gitlab.example.com'

如果是 IP 访问

external_url 'http://192.168.1.100'

2️⃣ 应用配置(关键步骤)

sudo gitlab-ctl reconfigure

⚠️ 这一步会执行很久,不要中断。


四、启动 GitLab

sudo gitlab-ctl start

查看状态:

sudo gitlab-ctl status

五、第一次访问 GitLab

1️⃣ 浏览器访问

http://服务器IP

2️⃣ 设置 root 密码

  • 第一次访问会让你设置 root 密码
  • 用户名:root
  • 密码:你自己设置的

六、常用配置(可选但常用)

✅ 修改端口(如 8080)

external_url 'http://IP:8080'

然后:

sudo gitlab-ctl reconfigure

✅ 开启 HTTPS(推荐)

external_url 'https://gitlab.example.com'

并配置 SSL 证书路径。


✅ 查看日志

sudo gitlab-ctl tail

七、常用管理命令

sudo gitlab-ctl start      # 启动
sudo gitlab-ctl stop       # 停止
sudo gitlab-ctl restart    # 重启
sudo gitlab-ctl status     # 状态
sudo gitlab-ctl reconfigure # 重新加载配置

八、常见问题

❌ 访问很慢

  • 内存不足(最少 4G)
  • 可关闭部分服务(CI Runner、Prometheus)

❌ 502 错误

  • 端口冲突
  • external_url 配置错误
  • 服务未完全启动

九、Docker 方式(如果你想要)

docker run -d \
  --name gitlab \
  -p 80:80 \
  -p 443:443 \
  -v gitlab-config:/etc/gitlab \
  -v gitlab-logs:/var/log/gitlab \
  -v gitlab-data:/var/opt/gitlab \
  gitlab/gitlab-ce

如果你愿意,可以告诉我:

  • ✅ 你的 Linux 发行版
  • ✅ 是 本机 / 云服务器
  • ✅ 是否要 HTTPS / 域名

我可以直接给你定制版配置命令

0