当前位置： 首页 > news >正文

在CentOS 7上搭建GitLab服务器的完整指南

news 2025/8/6 8:52:04

前言

GitLab是一个强大的DevOps平台，集代码托管、CI/CD、项目管理于一体。本文将详细介绍在CentOS 7上搭建GitLab企业级服务器的完整流程，包含关键配置和避坑指南。

一、环境准备

1.1 系统要求

  • 最低配置：

    • 4核CPU / 4GB内存（推荐8GB+）

    • 50GB+磁盘空间

    • CentOS 7.6+（64位）

⚠️ 注意：内存不足会导致GitLab运行缓慢甚至崩溃！

服务器配置参考：

场景CPU内存存储
小型团队4核8GB100GB
中型企业8核16GB500GB
大型部署16核32GB1TB+
 1.2基础服务配置
# 安装SSH服务、curl工具和系统管理工具
sudo yum install -y curl policycoreutils-python openssh-server# 设置SSH服务开机自启动
sudo systemctl enable sshd# 启动SSH服务（允许远程连接）
sudo systemctl start sshd# 安装防火墙管理工具
sudo yum install firewalld systemd -y# 启动防火墙服务
sudo systemctl start firewalld# 添加HTTP服务到防火墙（--permanent表示永久生效）
sudo firewall-cmd --permanent --add-service=http# 添加HTTPS服务到防火墙
sudo firewall-cmd --permanent --add-service=https# 添加SSH服务到防火墙
sudo firewall-cmd --permanent --add-service=ssh# 重新加载防火墙配置（使更改生效）
sudo systemctl reload firewalld# 安装邮件服务（用于GitLab通知）
sudo yum install postfix -y# 设置邮件服务开机自启动
sudo systemctl enable postfix# 启动邮件服务
sudo systemctl start postfix# 安装vim编辑器（配置文件修改）
sudo yum install -y vim# 安装wget下载工具（获取安装包）
sudo yum install -y wget

二、GitLab安装与配置

2.1 使用国内镜像加速安装
# 下载清华镜像站提供的GitLab RPM包（版本14.3.2）
wget https://mirrors.tuna.tsinghua.edu.cn/gitlab-ce/yum/el7/gitlab-ce-14.3.2-ce.0.el7.x86_64.rpm# 使用RPM包管理器安装GitLab
rpm -i gitlab-ce-14.3.2-ce.0.el7.x86_64.rpm
2.2 关键配置修改
# 编辑GitLab主配置文件
vim /etc/gitlab/gitlab.rb

进入gitlab.rb文件后，查找内容 

# 修改以下配置项（示例）：
#external_url ‘http://IP:Port’
#external_url ‘http://域名’
external_url 'http://your-server-ip:1000'  # 使用自定义端口 gitlab_rails['smtp_enable'] = true         # 启用邮件发送（可选）
gitlab_rails['smtp_address'] = "smtp.exmail.qq.com"  # 邮件服务器地址（可选）
gitlab_rails['time_zone'] = 'Asia/Shanghai' # 设置时区（可选）
2.3 防火墙与初始化
# 添加自定义端口到防火墙（示例端口1000）
firewall-cmd --permanent --add-port=1000/tcp# 重新加载防火墙配置
sudo systemctl reload firewalld# 重新配置GitLab（应用配置更改）
gitlab-ctl reconfigure# 重启GitLab服务
gitlab-ctl restart
 2.4 密码重置方法
# 进入GitLab控制台
sudo gitlab-rails console -e production# 执行密码重置命令序列
user = User.where(id: 1).first  # 获取root用户
user.password = 'YourNewPassword123!'  # 设置新密码
user.password_confirmation = 'YourNewPassword123!'  # 确认密码
user.save!  # 保存更改
exit  # 退出
2.5重启Gitlab
# 重启GitLab服务
gitlab-ctl restart

三、故障排除指南（附解决方案）

3.1 502错误（最常见）

原因分析：

  • 内存不足（GitLab至少需要4GB）

  • Unicorn服务崩溃

4.2 422页面错误

原因分析：

  • CSRF令牌验证失败

  • 代理服务器配置错误

四 GitLab服务管理命令

# 启动所有服务
gitlab-ctl start# 停止所有服务
gitlab-ctl stop# 重启所有服务
gitlab-ctl restart# 查看服务状态
gitlab-ctl status# 查看实时日志（Nginx）
gitlab-ctl tail nginx# 检查系统配置
gitlab-rake gitlab:check SANITIZE=true

五 实操截图 

 1.安装SSH服务、curl工具和系统管理工具

# 安装SSH服务、curl工具和系统管理工具

sudo yum install -y curl policycoreutils-python openssh-server

安装成功会出现如下图所示

2.设置SSH服务

# 设置SSH服务开机自启动
sudo systemctl enable sshd
# 启动SSH服务（允许远程连接）
sudo systemctl start sshd
# 安装防火墙管理工具
sudo yum install firewalld systemd -y

安装成功会出现如下图所示

# 启动防火墙服务
sudo systemctl start firewalld
# 添加HTTP服务到防火墙（--permanent表示永久生效）
sudo firewall-cmd --permanent --add-service=http
# 添加HTTPS服务到防火墙
sudo firewall-cmd --permanent --add-service=https
# 添加SSH服务到防火墙
sudo firewall-cmd --permanent --add-service=ssh
# 重新加载防火墙配置（使更改生效）
sudo systemctl reload firewalld 

3.安装Postfix 

# 安装邮件服务（用于GitLab通知）
sudo yum install postfix -y 

 

# 设置邮件服务开机自启动
sudo systemctl enable postfix
# 启动邮件服务
sudo systemctl start postfix 

4.安装vim编辑器和wget下载器 

# 安装vim编辑器（配置文件修改）
sudo yum install -y vim
# 安装wget下载工具（获取安装包）
sudo yum install -y wget 

5.添加GitLab镜像源并安装gitlab

# 下载清华镜像站提供的GitLab RPM包（版本14.3.2）
wget https://mirrors.tuna.tsinghua.edu.cn/gitlab-ce/yum/el7/gitlab-ce-14.3.2-ce.0.el7.x86_64.rpm
# 使用RPM包管理器安装GitLab
rpm -i gitlab-ce-14.3.2-ce.0.el7.x86_64.rpm

 6.关键配置修改

  • # 编辑GitLab主配置文件

  • vim /etc/gitlab/gitlab.rb

  • # 修改以下配置项（示例）：

  • #external_url ‘http://IP:Port’

  • #external_url ‘http://域名’

  • external_url 'http://your-server-ip:1000' # 使用自定义端口

 7.防火墙与初始化

 # 添加自定义端口到防火墙（示例端口1000）
firewall-cmd --permanent --add-port=1000/tcp
# 重新加载防火墙配置
sudo systemctl reload firewalld
# 重新配置GitLab（应用配置更改） 重置过程需要一些时间等待
gitlab-ctl reconfigure

 重置成功后，最后几行的信息如下图所示 

8.重启GitLab服务 

     # 重启GitLab服务

  1. gitlab-ctl restart

9.访问GitLab页面

访问方式：IP地址+端口号

访问地址是来源

#external_url ‘http://IP:Port’
#external_url ‘http://域名’
external_url 'http://your-server-ip:1000'  # 使用自定义端口

10.密码重置方法 

# 进入GitLab控制台
sudo gitlab-rails console -e production
# 执行密码重置命令序列
user = User.where(id: 1).first  # 获取root用户
user.password = 'dafu200..'  # 设置新密码
user.password_confirmation = 'dafu200..'  # 确认密码
user.save!  # 保存更改
exit  # 退出

11.重置完成登录 

 

11.创建项目仓库

 

 

完美结束，接下来创建分支

http://www.dtcms.com/a/316068.html

相关文章：

  • 第二十五天（数据结构：树）
  • 智慧社区(七)——基于 ECharts 与 Spring Boot 实现小区住户数据统计可视化
  • Java面试宝典：对象的内存布局
  • 龙芯(loongson) ls2k1000 openwrt
  • 人工智能领域、图欧科技、IMYAI智能助手2025年3月更新月报
  • 网络巡查平台管理办法对政务管理有哪些作用
  • 进阶向:PDF合并/拆分工具
  • RabbitMQ削峰填谷详解：让系统在流量洪峰中“稳如泰山”
  • 在 MCP 中实现 “askhuman” 式交互：原理、实践与开源方案
  • Java: jwt 入门介绍（Introduction to JSON Web Tokens）
  • Spring 的依赖注入DI是什么？
  • ChatGPT以及ChatGPT强化学习步骤
  • 陪诊小程序开发：用科技重构就医陪伴的“温度经济”
  • K8S健康检查巡检清单
  • 【JMeter】压测脚本生成完善增强
  • 奇偶校验码原理与FPGA实现
  • Java 配置文件深度解析：application.properties 与 application.yml 全方位对比
  • 制氧机语音控制方案设计以及使用场景
  • 北京JAVA基础面试30天打卡02
  • 浮雕软件Artcam安装包百度云网盘下载与安装指南
  • Linux-Day11.WEB服务，虚拟主机
  • 布控球是什么？布控球有什么作用？什么场景下会使用到布控球设备？一篇短文带你了解
  • 人工智能之数学基础：利用全概率公式如何将复杂事件转为简单事件
  • 寿司：米粒里藏着的鲜与巧
  • Java 大视界 -- Java 大数据在智能医疗电子病历数据分析与临床决策支持中的应用（382）
  • 【测试报告】Hsu营销平台系统 - 测试报告
  • 嵌入式#define __assert __assert写法解析
  • 起落架大型结构件深孔测量探究 - 激光频率梳 3D 轮廓检测
  • 智慧会所：科技赋能，开启休闲新体验
  • 解决 Windows 下的“幽灵文件”——记一次与带空格的 .gitignore 文件的艰难斗争