怎么配置Linux GitLab

下面给你一份在 Linux 上配置 GitLab 的完整指南，从安装到基本配置，适合自建 GitLab（CE/EE），不是 GitLab.com 的网页配置。

一、环境准备

1️⃣ 系统要求（推荐）

二、安装 GitLab（以 Ubuntu 为例）

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 CE

sudo apt update
sudo apt install -y gitlab-ce

三、基础配置（最重要）

1️⃣ 编辑配置文件

sudo vim /etc/gitlab/gitlab.rb

✅ 必须配置项

# 外部访问地址（域名或 IP）
external_url 'http://gitlab.example.com'

# 如果是 HTTPS
# external_url 'https://gitlab.example.com'

如果只用 IP：

external_url 'http://192.168.1.100'

2️⃣ 应用配置（耗时）

sudo gitlab-ctl reconfigure

✅ 成功后你会看到：

gitlab Reconfigured!

3️⃣ 启动 GitLab

sudo gitlab-ctl start

查看状态：

sudo gitlab-ctl status

四、首次访问 GitLab

1. 浏览器访问：

   http://服务器IP
   

2. 设置 root 密码

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

3. 登录：

   • 用户名：root
   • 密码：刚设置的

五、常用配置（强烈推荐）

1️⃣ 配置 SMTP 邮件（发邮件）

编辑 /etc/gitlab/gitlab.rb：

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

2️⃣ 配置 HTTPS（Let’s Encrypt）

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

letsencrypt['enable'] = true
letsencrypt['contact_emails'] = ['admin@example.com']

sudo gitlab-ctl reconfigure

3️⃣ 禁用注册（生产环境推荐）

Admin → Settings → General → Sign-up restrictions

六、常用管理命令

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

七、备份与恢复（非常重要）

备份

sudo gitlab-backup create

备份目录：

/var/opt/gitlab/backups/

恢复

sudo gitlab-backup restore BACKUP=timestamp
sudo gitlab-ctl reconfigure
sudo gitlab-ctl restart

八、常见问题

❌ 访问 502

原因：

• 内存不足
• unicorn/puma 未启动

解决：

free -h
sudo gitlab-ctl restart

九、你接下来可能需要的配置

• ✅ CI/CD Runner
• ✅ LDAP / 企业登录
• ✅ Docker Registry
• ✅ 项目权限 / 分支保护
• ✅ GitLab Pages

如果你愿意，可以告诉我：

• ✅ 你的 Linux 版本
• ✅ 是否需要 HTTPS
• ✅ 是否内网 / 公网
• ✅ 是否用于公司生产环境

我可以给你定制一套配置方案 ✅