Linux下GitLab怎么配

下面按从零开始的思路，给你一个**在 Linux 下配置 GitLab（社区版）**的完整说明，适用于 Ubuntu / Debian / CentOS / Rocky / Alma 等常见发行版。
如果你只想要某一步（比如只配邮箱、HTTPS、CI），可以直接跳到对应部分。

一、GitLab 常见部署方式

方式	适合
Omnibus 包（官方推荐）	生产环境、新手
Docker	快速测试
源码安装	不推荐
Kubernetes Helm	大规模集群

✅ 下面默认用 Omnibus 方式（最常用）

二、安装 GitLab（Linux）

1️⃣ 系统要求（建议）

CPU：2 核+
内存：至少 4GB（推荐 8GB）
磁盘：20GB+

2️⃣ Ubuntu / Debian

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

安装 GitLab CE

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

sudo apt update
sudo apt install gitlab-ce

3️⃣ CentOS / Rocky / Alma

sudo yum install -y curl policycoreutils openssh-server

curl -fsSL https://packages.gitlab.com/gpg.key | sudo gpg --dearmor -o /etc/pki/rpm-gpg/gitlab-gpg

sudo yum install -y gitlab-ce

三、基础配置（最重要）

1️⃣ 修改配置文件

sudo vim /etc/gitlab/gitlab.rb

核心配置项

# 域名（必须）
external_url 'http://gitlab.example.com'

如果是 HTTPS：

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

2️⃣ 应用配置（每次改完都要执行）

sudo gitlab-ctl reconfigure

这一步会：

生成配置文件
启动服务
初始化数据库

✅ 第一次会比较慢（1–3 分钟）

四、访问 GitLab

浏览器访问：

http://服务器IP

或你配置的域名。

获取 root 密码

sudo cat /etc/gitlab/initial_root_password

登录：

用户：root
密码：上面文件中的密码

⚠️ 该文件 24 小时后自动删除

五、常用基础配置

1️⃣ 修改时区

gitlab_rails['time_zone'] = 'Asia/Shanghai'

2️⃣ 配置邮件（QQ / 企业邮箱 / SMTP）

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'] = false
gitlab_rails['smtp_tls'] = true

gitlab_rails['gitlab_email_from'] = '123456@qq.com'

然后：

sudo gitlab-ctl reconfigure

测试邮件：

gitlab-rails console
Notify.test_email('test@example.com', 'Test', 'Hello').deliver_now

六、HTTPS（可选但强烈推荐）

自动 HTTPS（Let’s Encrypt）

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

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

sudo gitlab-ctl reconfigure

GitLab 会自动申请证书并续期。

七、常用维护命令

# 查看状态
sudo gitlab-ctl status

# 重启
sudo gitlab-ctl restart

# 查看日志
sudo gitlab-ctl tail

# 备份
sudo gitlab-backup create

# 恢复
sudo gitlab-backup restore BACKUP=timestamp

八、推荐目录结构

路径	说明
`/etc/gitlab/`	配置文件
`/var/opt/gitlab/`	数据
`/var/log/gitlab/`	日志
`/var/opt/gitlab/git-data/`	Git 仓库

九、最小生产建议 ✅

✅ 使用域名
✅ 开启 HTTPS
✅ 配置 SMTP
✅ 定期备份
✅ 不要小于 4GB 内存

十、如果你愿意，我可以继续帮你

你可以直接说：

✅ “我要用 Docker 部署 GitLab”
✅ “我要配置 GitLab CI/CD”
✅ “我要接 LDAP / 企业微信 / 钉钉”
✅ “我要迁移老 GitLab”
✅ “我只配到能跑就行”

我可以按你的 Linux 发行版、机器配置一步步给你定制命令。