Linux云服务器GitLab配置全指南：从零开始搭建代码托管平台

作为现代软件开发的核心基础设施，GitLab已成为众多开发团队的首选工具。本文将手把手教您在Linux云服务器上完成GitLab的完整配置过程，涵盖从环境准备到安全优化的全流程。

一、环境准备与系统要求

在开始安装前，请确保您的云服务器满足以下条件：

操作系统：Ubuntu 20.04/22.04或CentOS 7/8
硬件配置：至少4核CPU、4GB内存（推荐8GB）
存储空间：至少10GB可用空间
网络环境：配置固定IP地址，开放80/443端口

建议先执行系统更新：

sudo apt update && sudo apt upgrade -y  # Ubuntu
sudo yum update -y                     # CentOS

二、GitLab安装步骤详解

1. 添加官方软件源

Ubuntu系统：

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

2. 执行安装命令

sudo EXTERNAL_URL="https://your-domain.com" apt-get install gitlab-ce

将your-domain.com替换为您的实际域名或服务器IP

3. 初始化配置

sudo gitlab-ctl reconfigure

此过程可能需要5-10分钟，请耐心等待

三、基础配置优化

1. 邮件服务配置

编辑配置文件：

sudo nano /etc/gitlab/gitlab.rb

添加SMTP配置示例：

gitlab_rails['smtp_enable'] = true
gitlab_rails['smtp_address'] = "smtp.example.com"
gitlab_rails['smtp_port'] = 587
gitlab_rails['smtp_user_name'] = "[email protected]"
gitlab_rails['smtp_password'] = "your-password"
gitlab_rails['smtp_domain'] = "example.com"
gitlab_rails['smtp_authentication'] = "login"

2. 性能调优

根据服务器配置调整工作进程数：

unicorn['worker_processes'] = 4  # 建议设置为CPU核心数
sidekiq['concurrency'] = 10

四、安全加固措施

定期备份：sudo gitlab-rake gitlab:backup:create
防火墙配置：仅开放必要端口
HTTPS强制：在配置文件中启用external_url 'https://...'
双因素认证：在管理面板启用2FA功能

五、常见问题解决方案

问题现象	解决方案
502错误	检查unicorn和nginx服务状态，查看日志`/var/log/gitlab/nginx/error.log`
内存不足	增加swap空间或升级服务器配置
邮件发送失败	检查SMTP配置和端口是否被屏蔽

六、后续维护建议

建议设置定期任务执行：

# 每天自动备份
0 2 * * * /opt/gitlab/bin/gitlab-rake gitlab:backup:create

定期检查更新：sudo apt update && sudo apt install gitlab-ce

通过本文指导，您已成功在Linux云服务器上部署了功能完整的GitLab服务。后续可根据团队需求配置CI/CD流水线、容器注册表等高级功能。