CentOS GitLab怎么配置

下面给你一份在 CentOS 上配置 GitLab（CE 社区版）的完整实操指南，从安装到常见配置，适合服务器环境（CentOS 7 / 8 / Stream 都适用，略有差异我会说明）。

一、准备工作

1️⃣ 系统要求

内存：至少 4GB（2GB 会很卡）
CPU：2 核及以上
磁盘：20GB+（代码仓库会增长）
系统：CentOS 7 / 8 / Stream

2️⃣ 关闭或配置防火墙

systemctl stop firewalld
systemctl disable firewalld

或放行 HTTP / HTTPS：

firewall-cmd --permanent --add-service=http
firewall-cmd --permanent --add-service=https
firewall-cmd --reload

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

1️⃣ 安装依赖

sudo yum install -y curl policycoreutils openssh-server openssh-clients
sudo systemctl enable sshd
sudo systemctl start sshd

2️⃣ 添加 GitLab 官方仓库

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

3️⃣ 安装 GitLab CE

sudo EXTERNAL_URL="http://gitlab.example.com" yum install -y gitlab-ce

✅ 注意：

EXTERNAL_URL 填你的 服务器 IP 或域名
例如：

sudo EXTERNAL_URL="http://192.168.1.100" yum install -y gitlab-ce

三、初始化配置

1️⃣ 重新配置 GitLab

sudo gitlab-ctl reconfigure

⏳ 首次执行时间较长（2–5 分钟）

2️⃣ 查看服务状态

sudo gitlab-ctl status

四、访问 GitLab

浏览器访问：

http://服务器IP

首次登录：

用户名：root
密码：

sudo cat /etc/gitlab/initial_root_password

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

五、常用配置（重点）

✅ 修改访问地址

sudo vi /etc/gitlab/gitlab.rb

修改：

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

然后：

sudo gitlab-ctl reconfigure

✅ 配置 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'] = true
gitlab_rails['smtp_tls'] = true

sudo gitlab-ctl reconfigure

测试：

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

✅ 开启 HTTPS（推荐）

使用 Let’s Encrypt

letsencrypt['enable'] = true
letsencrypt['contact_emails'] = ['admin@example.com']
external_url 'https://gitlab.example.com'

sudo gitlab-ctl reconfigure

六、日常维护命令

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

七、常见问题

❌ 访问 502

内存不足（最常见）
GitLab 还没启动完成，等 1–2 分钟
端口被占用（80/8080）

❌ 卡、慢

建议至少 4GB 内存
禁用部分服务（CI Runner、Prometheus）

gitlab_rails['gitlab_ci_enabled'] = false
prometheus_monitoring['enable'] = false

八、卸载 GitLab

sudo gitlab-ctl uninstall
sudo rpm -e gitlab-ce
sudo rm -rf /var/opt/gitlab
sudo rm -rf /etc/gitlab

九、要不要我帮你？

你可以直接告诉我：

✅ CentOS 版本
✅ 是否生产环境
✅ 是否配置 HTTPS / 邮箱
✅ 服务器配置（CPU / 内存）

我可以给你 定制版配置方案 或 Docker 方式部署（更轻量）。