Linux VPS服务器搭建GitLab：安装与团队协作配置教程

软件开发离不开高效的版本控制与团队协作。用Linux VPS服务器搭建Git仓库，搭配GitLab实现协作，是不少开发者的优选方案。本文将详细讲解安装与配置步骤。

GitLab简介

GitLab是基于Web的Git仓库管理工具，集成了代码托管、问题跟踪、持续集成等功能，尤其适合团队协作开发场景。

安装前准备

安装GitLab前，需确认Linux VPS服务器满足基础条件：至少2GB内存保障运行流畅，同时已安装curl、openssh-server、ca-certificates等必要依赖。若未安装可执行以下命令：

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

安装GitLab

首先添加GitLab官方仓库源：

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

接着安装GitLab社区版：

sudo apt-get install gitlab-ce

安装完成后需配置外部访问地址，编辑 `/etc/gitlab/gitlab.rb` 文件，将 `external_url 'http://your-server-ip'` 中的 `your-server-ip` 替换为实际VPS公网IP。修改后执行：

sudo gitlab-ctl reconfigure
sudo gitlab-ctl restart

团队协作配置

创建项目

浏览器输入设置的外部URL，首次访问需设置管理员密码。登录后点击“New project”，填写项目名称、描述等信息完成创建。

添加团队成员

进入项目页面，选择“Settings”→“Members”，输入成员邮箱或用户名，选择Developer（开发者）、Maintainer（维护者）等角色后点击“Invite”即可完成邀请。

配置SSH密钥

为方便代码提交，建议团队成员配置SSH密钥。本地执行：

ssh-keygen -t rsa -b 4096 -C "your_email@example.com"

生成后将公钥（路径通常为 `~/.ssh/id_rsa.pub`）复制到GitLab个人设置的“SSH Keys”页面添加。

代码管理操作

成员可通过以下命令克隆项目到本地：

git clone git@your-server-ip:your-project-path.git

本地修改代码后，使用以下命令提交并推送：

git add .
git commit -m "Your commit message"
git push origin master

常见问题及解决

若无法访问GitLab页面，可能是防火墙拦截了HTTP（80端口）或SSH（22端口）。可通过以下命令开放端口：

sudo ufw allow http
sudo ufw allow ssh

若Git连接异常，需检查SSH密钥是否正确添加，或尝试使用HTTPS协议克隆（地址格式为 `http://your-server-ip/your-project-path.git`）。

通过上述步骤，可在Linux VPS上顺利搭建GitLab并实现团队协作。合理利用其功能，能有效提升开发效率与代码管理质量。