温馨提示×

gitlab linux版怎么配置

小樊
42
2026-07-28 13:25:40
栏目: 智能运维

在 Linux 上配置 GitLab(社区版 / CE) 通常有两种主流方式:
Omnibus 包安装(官方推荐,最简单)
Docker 安装(适合容器环境)

下面我按 最常见、最稳妥 的方式给你讲:Omnibus 安装 + 基础配置


一、安装前准备(Linux 服务器)

1️⃣ 系统要求

GitLab 对资源要求较高,建议:

项目 最低 推荐
CPU 2 核 4 核
内存 4 GB 8 GB+
磁盘 20 GB 50 GB+

✅ 支持系统:

  • Ubuntu(20.04 / 22.04)
  • Debian
  • CentOS / Rocky / AlmaLinux

二、Omnibus 方式安装 GitLab(官方推荐)

1️⃣ 安装依赖

sudo apt update
sudo apt install -y curl openssh-server ca-certificates tzdata

(CentOS 用 yum / dnf


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 CE

sudo apt update
sudo apt install -y gitlab-ce

安装完成后会看到类似提示:

Thank you for installing 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

浏览器访问:

http://服务器IP

首次登录

  • 用户名:root
  • 密码在:
sudo cat /etc/gitlab/initial_root_password

⚠️ 密码只在 24 小时内有效,建议登录后立即修改。


五、常用管理命令

功能 命令
查看状态 sudo gitlab-ctl status
重启 sudo gitlab-ctl restart
停止 sudo gitlab-ctl stop
查看日志 sudo gitlab-ctl tail

六、配置邮箱(可选但推荐)

gitlab_rails['smtp_enable'] = true
gitlab_rails['smtp_address'] = "smtp.qq.com"
gitlab_rails['smtp_port'] = 465
gitlab_rails['smtp_user_name'] = "xxx@qq.com"
gitlab_rails['smtp_password'] = "授权码"
gitlab_rails['smtp_domain'] = "qq.com"
gitlab_rails['smtp_authentication'] = "login"
gitlab_rails['smtp_enable_starttls_auto'] = true
gitlab_rails['smtp_tls'] = true

然后:

sudo gitlab-ctl reconfigure

七、Docker 方式(简单示例)

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

八、常见问题

❌ 访问 502

  • 内存不足
  • gitlab-ctl reconfigure 未完成
  • 端口被占用

❌ 很慢

  • 关闭部分服务(CI Runner、监控)
  • 增加 swap

九、我可以继续帮你

你可以直接告诉我: 1️⃣ 用的是 Ubuntu / CentOS / 其他?
2️⃣ 是 内网使用 还是 公网域名?
3️⃣ 是否需要 HTTPS / 邮件 / CI/CD?

我可以给你 定制版配置方案

0