CentOS 上 GitLab 安装问题排查与解决
一 环境准备与标准安装
- 安装基础依赖并启动服务（以 CentOS 7/8 为例，注意 policycoreutils 包名差异）：
- CentOS 7：sudo yum install -y curl policycoreutils-python openssh-server postfix
- CentOS 8：sudo yum install -y curl policycoreutils-python-utils openssh-server postfix
- 启动与开机自启：sudo systemctl enable --now sshd
- 防火墙放行 HTTP/HTTPS：
- sudo firewall-cmd --permanent --add-service=http
- sudo firewall-cmd --permanent --add-service=https
- sudo firewall-cmd --reload
- 添加仓库并安装（社区版 CE）：
- curl -sS https://packages.gitlab.com/install/repositories/gitlab/gitlab-ce/script.rpm.sh | sudo bash
- sudo yum install -y gitlab-ce
- 首次配置与启动：
- 编辑 /etc/gitlab/gitlab.rb，设置 external_url ‘http://你的域名或IP’
- 执行 sudo gitlab-ctl reconfigure 并访问页面完成管理员初始化
二 安装过程卡住或 reconfigure 无响应
- 现象：执行 sudo gitlab-ctl reconfigure 或安装时长时间无进度，甚至卡在 ruby_block 阶段。
- 处理步骤：
- 按下 CTRL+C 中断当前执行
- 重启 runsvdir：sudo systemctl restart gitlab-runsvdir
- 再次执行：sudo gitlab-ctl reconfigure
- 如仍异常，检查系统资源与端口占用，必要时重启系统后重试
三 访问 502 或端口冲突
- 常见成因：
- 内存不足（小内存/无 swap 的虚机常见）
- 端口被占用（默认 80/8080 等）
- 解决方案：
- 内存不足：增加 swap 分区或文件后重启；再执行 reconfigure
- 端口冲突：在 /etc/gitlab/gitlab.rb 调整端口，例如
- unicorn[‘port’] = 9090
- nginx[‘listen_port’] = 9099
- 执行 sudo gitlab-ctl reconfigure 与 sudo gitlab-ctl restart 使配置生效
四 邮件服务 Postfix 启动失败
- 现象：systemctl start postfix 失败。
- 快速修复（/etc/postfix/main.cf）：
- 设置 inet_protocols = ipv4
- 设置 inet_interfaces = all
- 重启：systemctl restart postfix
- 说明：Postfix 并非必选，也可改用外部 SMTP 并在 /etc/gitlab/gitlab.rb 中配置 gitlab_rails[‘smtp_*’] 项
五 其他高频问题与 SELinux 故障
- 主机名解析失败：
- 在 /etc/hosts 增加 “IP 主机名” 记录，并执行 hostnamectl set-hostname 主机名
- undefined method ‘downcase’ for nil:NilClass：
- 可能 /etc/redhat-release 文件缺失或被清空，补充类似：
- Red Hat Enterprise Linux Server release 7.x.x (Maipo)
- SELinux 策略安装失败（semodule 报错）：
- 安装依赖：sudo yum install -y libsemanage-static libsemanage-devel
- 完全卸载重装（版本需与安装一致：ce 或 ee）：
- 停止：sudo gitlab-ctl stop
- 卸载：sudo rpm -e gitlab-ce 或 gitlab-ee
- 清理残留文件与进程后，按“标准安装”步骤重装