温馨提示×

linux上gitlab怎么搭建

小樊
52
2026-09-10 10:31:18
栏目: 智能运维

下面给你一份在 Linux 上搭建 GitLab(社区版 CE)的实用指南,按最常见、最稳妥的方式来讲(以 Ubuntu / CentOS 为主)。


一、准备工作

1. 服务器建议配置

  • 最低:2 核 CPU / 4GB 内存(2GB 会很卡)
  • 推荐:4 核 / 8GB 以上
  • 系统:Ubuntu 20.04/22.04 或 CentOS 7/8

2. 基础环境

# Ubuntu
sudo apt update
sudo apt install -y curl openssh-server ca-certificates postfix
# CentOS
sudo yum install -y curl policycoreutils openssh-server postfix
sudo systemctl enable sshd postfix

postfix 用于邮件通知,可选(以后也能配)


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

✅ Ubuntu 安装

curl -fsSL https://packages.gitlab.com/install/repositories/gitlab/gitlab-ce/script.deb.sh | sudo bash

sudo EXTERNAL_URL="http://你的IP或域名" apt install gitlab-ce

✅ CentOS 安装

curl -fsSL https://packages.gitlab.com/install/repositories/gitlab/gitlab-ce/script.rpm.sh | sudo bash

sudo EXTERNAL_URL="http://你的IP或域名" yum install gitlab-ce

安装完成后会看到:

Thank you for installing GitLab!

三、初始化配置

sudo gitlab-ctl reconfigure

这一步会:

  • 生成配置
  • 启动 nginx / redis / postgresql / sidekiq

四、访问 GitLab

浏览器访问:

http://服务器IP

首次登录:

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

⚠️ 该文件 24 小时后会被删除,记得改密码


五、常用管理命令

sudo gitlab-ctl start      # 启动
sudo gitlab-ctl stop       # 停止
sudo gitlab-ctl restart    # 重启
sudo gitlab-ctl status     # 状态
sudo gitlab-ctl tail       # 查看日志

六、配置域名 + HTTPS(强烈推荐)

编辑配置文件:

sudo vim /etc/gitlab/gitlab.rb
external_url 'https://gitlab.example.com'

启用 Let’s Encrypt:

letsencrypt['enable'] = true
letsencrypt['auto_renew'] = true

然后:

sudo gitlab-ctl reconfigure

七、防火墙 & 端口

# Ubuntu
sudo ufw allow 80
sudo ufw allow 443

# CentOS
sudo firewall-cmd --permanent --add-service=http
sudo firewall-cmd --permanent --add-service=https
sudo firewall-cmd --reload

八、常见问题

1️⃣ 内存不足

  • 修改:
unicorn['worker_processes'] = 2
postgresql['shared_buffers'] = "256MB"

然后:

sudo gitlab-ctl reconfigure

2️⃣ 502 错误

  • 多半是内存不足或 reconfigure 未完成

3️⃣ 忘记 root 密码

sudo gitlab-rake "gitlab:password:reset[root]"

九、Docker 方式(可选)

如果你更想用 Docker:

docker run -d \
  --hostname gitlab.example.com \
  -p 443:443 -p 80:80 -p 22:22 \
  --name gitlab \
  gitlab/gitlab-ce

十、总结

✅ 最推荐:
GitLab CE 官方包 + Ubuntu + Nginx + HTTPS

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

  • 用的是 哪款 Linux
  • 是 内网 / 公网
  • 是否要 Docker / 高可用 / CI/CD

我可以直接给你定制部署方案。

0 踩