怎么搭建Linux GitLab

下面我按从零开始的方式，给你讲一下 如何在 Linux 上搭建 GitLab（CE 社区版），适合生产环境，也适合学习使用。

一、准备工作

1️⃣ 服务器要求（官方推荐）

项目	最低	推荐
CPU	2 核	4 核
内存	4 GB	8 GB+
磁盘	20 GB	50 GB+
系统	Linux	Ubuntu / CentOS / Rocky

✅ 内存一定要 ≥ 4GB，否则很容易卡死

2️⃣ 系统选择（任选一个）

✅ Ubuntu 20.04 / 22.04（最常用）
✅ Rocky Linux / AlmaLinux
❌ 不推荐太老的系统

下面示例以 Ubuntu 22.04 为主。

二、安装 GitLab（官方推荐方式）

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-keyring.gpg

echo "deb [signed-by=/usr/share/keyrings/gitlab-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

安装过程大约 3–10 分钟。

三、配置 GitLab

1️⃣ 修改配置文件

sudo vim /etc/gitlab/gitlab.rb

重点修改：

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

✅ 改成你的：

IP：http://192.168.1.100
域名：http://gitlab.yourdomain.com

2️⃣ 重新配置 GitLab

sudo gitlab-ctl reconfigure

⚠️ 这一步必须执行，会初始化所有组件。

四、访问 GitLab

1️⃣ 浏览器访问

http://服务器IP

2️⃣ 设置 root 密码

首次访问会让你设置 root 管理员密码

五、常用管理命令

# 查看状态
sudo gitlab-ctl status

# 启动 / 停止 / 重启
sudo gitlab-ctl start
sudo gitlab-ctl stop
sudo gitlab-ctl restart

# 查看日志
sudo gitlab-ctl tail

六、配置 SMTP 邮件（可选但强烈建议）

编辑：

sudo vim /etc/gitlab/gitlab.rb

示例（QQ 邮箱）：

gitlab_rails['smtp_enable'] = true
gitlab_rails['smtp_address'] = "smtp.qq.com"
gitlab_rails['smtp_port'] = 465
gitlab_rails['smtp_user_name'] = "123456@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

七、配置 HTTPS（推荐）

使用 Let’s Encrypt

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

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

sudo gitlab-ctl reconfigure

八、备份与恢复

备份

sudo gitlab-backup create

恢复

sudo gitlab-backup restore BACKUP=timestamp

九、常见问题

❌ 内存不足

free -h

解决：

加内存
或关闭部分服务（不推荐）

❌ 访问慢

关闭 CI/CD 不需要的功能
使用 SSD
避免低配云服务器

十、适合你的下一步

你可以告诉我： 1️⃣ 用的是 Ubuntu 还是 CentOS
2️⃣ 是 本地虚拟机 / 云服务器 / 公司内网
3️⃣ 是否需要 Docker 方式部署

我可以给你 定制版安装方案 ✅