Linux服务器GitLab安装配置全指南

作为现代软件开发团队的重要协作平台，GitLab的自主部署能力让企业可以完全掌控代码管理环境。本文将详细介绍在Linux服务器上从零开始安装配置GitLab的全过程，包含CE（社区版）和EE（企业版）两种版本的安装方法。

一、准备工作

1.1 系统要求

推荐配置：

操作系统：Ubuntu 20.04/22.04 LTS或CentOS 7/8
CPU：4核及以上
内存：4GB（建议8GB）
存储：至少10GB可用空间

1.2 依赖安装

# Ubuntu/Debian
sudo apt update
sudo apt install -y curl openssh-server ca-certificates postfix

# CentOS/RHEL
sudo yum install -y curl policycoreutils openssh-server postfix

二、安装GitLab

2.1 添加GitLab仓库

# Ubuntu/Debian
curl https://packages.gitlab.com/install/repositories/gitlab/gitlab-ce/script.deb.sh | sudo bash

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

2.2 执行安装

社区版：

# Ubuntu/Debian
sudo EXTERNAL_URL="http://your-server-ip" apt install gitlab-ce

# CentOS/RHEL
sudo EXTERNAL_URL="http://your-server-ip" yum install gitlab-ce

企业版（需许可证）：

# 将命令中的-ce替换为-ee即可

三、初始配置

3.1 修改配置文件

sudo vim /etc/gitlab/gitlab.rb

关键配置项：

external_url 'http://your-domain.com' - 设置访问URL
gitlab_rails['time_zone'] = 'Asia/Shanghai' - 时区设置
gitlab_rails['smtp_enable'] = true - 邮件服务配置

3.2 应用配置

sudo gitlab-ctl reconfigure

四、防火墙设置

# 开放HTTP/HTTPS端口
sudo ufw allow http
sudo ufw allow https

# SSH端口（默认22）
sudo ufw allow ssh

五、访问与初始化

完成安装后，通过浏览器访问配置的URL地址，首次登录需设置root用户密码（长度至少8字符）。

登录后建议立即：

创建新用户
设置用户权限
配置SMTP邮件服务
设置备份策略

六、日常管理命令

功能	命令
启动服务	sudo gitlab-ctl start
停止服务	sudo gitlab-ctl stop
重启服务	sudo gitlab-ctl restart
检查状态	sudo gitlab-ctl status
备份数据	sudo gitlab-rake gitlab:backup:create

七、常见问题解决

7.1 502错误

可能原因：内存不足或unicorn工作进程异常

# 查看日志
sudo gitlab-ctl tail unicorn

7.2 邮件发送失败

检查SMTP配置后执行：

sudo gitlab-rake gitlab:check

通过以上步骤，您已经成功在Linux服务器上部署了功能完整的GitLab服务。建议定期执行系统更新和备份，对于生产环境，可以考虑配置HTTPS证书和负载均衡以增强安全性和可用性。