Linux VPS服务器搭建GitLab代码托管平台完整指南

在软件开发团队的日常协作中，代码托管平台就像“数字仓库”，既需要安全存储代码，又要支持高效协作。GitLab作为开源代码托管与协作平台，凭借强大的CI/CD集成能力和灵活的权限管理，成为中小团队的优选。本文将以Linux VPS服务器为基础，手把手教你完成GitLab的搭建与配置。

环境准备：VPS服务器的基础要求

搭建GitLab前，首先需要一台稳定的Linux VPS服务器。系统建议选择Ubuntu 18.04及以上版本或CentOS 7及以上版本——这两个发行版对GitLab的兼容性经过长期验证，后续维护资料也更丰富。

硬件配置方面，基础环境至少需要2GB内存和10GB可用磁盘空间。若团队规模超过10人，建议升级至4GB内存+20GB磁盘，避免因资源不足导致的响应延迟。网络方面需确保VPS服务器能正常访问外网，后续安装GitLab官方仓库时需要下载较大的安装包。

安装必要依赖：系统运行的基石

无论是Ubuntu还是CentOS，都需要先安装基础依赖包。以Ubuntu系统为例，打开终端输入：

sudo apt-get update
sudo apt-get install -y curl openssh-server ca-certificates

CentOS用户则执行：

sudo yum install -y curl openssh-server openssh-clients ca-certificates

这一步主要安装了curl（用于下载文件）、OpenSSH（远程管理工具）和CA证书（保障HTTPS连接安全），是后续操作的基础。

安装GitLab：从仓库到本地的部署

依赖安装完成后，需要将GitLab官方仓库添加到系统源，确保能下载到最新稳定版。

Ubuntu用户执行仓库添加命令：

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

仓库添加成功后，输入对应系统的安装命令即可：
- Ubuntu：`sudo apt-get install gitlab-ce`
- CentOS：`sudo yum install gitlab-ce`

安装过程通常需要5-10分钟（具体时间受网络速度影响），完成后终端会提示“GitLab installed successfully”。

配置与访问：让平台跑起来

安装完成只是第一步，关键是正确配置访问地址。使用`nano`或`vim`打开配置文件：

sudo nano /etc/gitlab/gitlab.rb

找到`external_url`行，将其修改为服务器的公网IP或已解析的域名（例如`external_url 'http://192.168.1.100'`或`external_url 'https://gitlab.example.com'`）。保存退出后，执行重新配置命令：

sudo gitlab-ctl reconfigure

这个过程会初始化数据库、启动所有服务，大约需要3-5分钟。完成后通过浏览器访问设置的`external_url`，首次登录需设置管理员密码（建议使用12位以上字母+数字组合），之后即可用`root`账号登录管理后台。

后续优化：让平台更高效

正式投入使用前，建议完成两项优化：

• 配置SSL证书：通过Let's Encrypt免费证书实现HTTPS访问，提升代码传输安全性（修改`gitlab.rb`中的`nginx['ssl_certificate']`和`ssl_certificate_key`路径即可）；


• 调整资源限制：若服务器内存充足，可在`gitlab.rb`中修改`unicorn['worker_processes']`（默认2个，可根据内存调整为4-6个），提升并发处理能力。

通过Linux VPS服务器搭建GitLab，不仅能拥有完全自主的代码托管环境，还能根据团队需求定制功能（如集成企业微信通知、自定义CI/CD流水线）。从环境准备到后续优化，每个步骤都需要耐心验证，但完成后的高效协作体验，会让这些付出变得值得。