手把手教你用Linux云服务器搭建GitLab代码托管平台

在当今软件开发领域，GitLab作为一款开源的代码托管平台，已经成为团队协作开发的重要工具。本文将详细介绍如何在Linux云服务器上从零开始搭建GitLab服务，让你拥有专属的代码托管环境。

一、准备工作

在开始安装前，请确保你的云服务器满足以下要求：

操作系统：Ubuntu 20.04/22.04 LTS 或 CentOS 7/8
硬件配置：至少4GB内存（推荐8GB），50GB存储空间
网络环境：固定公网IP地址，开放80/443端口
域名准备：可选但推荐，如gitlab.yourdomain.com

二、安装步骤详解

1. 服务器基础环境配置

# 更新系统软件包
sudo apt update && sudo apt upgrade -y  # Ubuntu
sudo yum update -y                     # CentOS

# 安装必要依赖
sudo apt install -y curl openssh-server ca-certificates postfix

2. 添加GitLab官方仓库

# 下载安装脚本
curl -sS https://packages.gitlab.com/install/repositories/gitlab/gitlab-ce/script.deb.sh | sudo bash

# 对于CentOS系统
curl -sS https://packages.gitlab.com/install/repositories/gitlab/gitlab-ce/script.rpm.sh | sudo bash

3. 安装GitLab CE

# 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

4. 初始配置

# 运行配置脚本
sudo gitlab-ctl reconfigure

# 检查服务状态
sudo gitlab-ctl status

三、重要配置项

1. 修改配置文件

编辑/etc/gitlab/gitlab.rb文件，配置关键参数：

external_url 'http://gitlab.example.com'
gitlab_rails['gitlab_email_from'] = '[email protected]'
gitlab_rails['smtp_enable'] = true
gitlab_rails['smtp_address'] = "smtp.example.com"

2. 配置HTTPS安全访问

使用Let's Encrypt免费证书：

letsencrypt['enable'] = true
letsencrypt['contact_emails'] = ['[email protected]']

3. 配置备份策略

gitlab_rails['backup_path'] = "/var/opt/gitlab/backups"
gitlab_rails['backup_keep_time'] = 604800  # 保留7天

四、日常维护与管理

1. 常用管理命令

启动服务：sudo gitlab-ctl start
停止服务：sudo gitlab-ctl stop
重启服务：sudo gitlab-ctl restart

2. 数据备份与恢复

# 手动备份
sudo gitlab-rake gitlab:backup:create

# 恢复备份
sudo gitlab-rake gitlab:backup:restore BACKUP=备份文件名

3. 版本升级

建议定期升级到最新版本：

sudo apt update
sudo apt install gitlab-ce

五、常见问题解决

1. 502错误解决方案

通常与内存不足有关，可以尝试：

sudo gitlab-ctl restart unicorn
sudo gitlab-ctl restart sidekiq

2. 邮件发送失败

检查SMTP配置，测试邮件发送：

sudo gitlab-rails console
Notify.test_email('[email protected]', 'Test', 'Test Body').deliver_now

3. 性能优化建议

增加服务器swap空间
调整Unicorn worker数量
定期清理日志文件

六、总结

通过以上步骤，你已经成功在Linux云服务器上搭建了GitLab代码托管平台。GitLab不仅提供代码托管功能，还包括CI/CD、项目管理等强大功能，是现代化开发团队不可或缺的工具。建议定期进行维护更新，并做好数据备份工作。

对于企业级应用，可以考虑安装GitLab EE版或使用官方SaaS服务。小型团队或个人开发者使用社区版(CE)即可满足大部分需求。