GitLab代码托管协作平台

GitLab 是一个开源的端到端软件开发平台，内置了强大的版本控制（Git）、代码审查、问题跟踪以及 CI/CD（持续集成/持续部署）功能。如果你希望在公司内部或个人服务器上搭建一个“私有版的 GitHub”，GitLab 是最主流的选择。

本教程将以最常见的 Ubuntu 系统 和 GitLab 社区免费版（CE） 为例，带你完成从安装部署到日常使用的全流程。

一、 部署准备（硬性要求）

GitLab 是一个庞大的应用集合（包含 Nginx, PostgreSQL, Redis 等），对服务器配置有严格要求。千万不要在配置极低的服务器上强行安装，否则会频繁死机。

操作系统：推荐 Ubuntu 20.04/22.04 LTS 或 CentOS 7/8。

内存 (RAM)：最低 4GB（建议 8GB 及以上）。如果只有 2GB 或 4GB 内存，必须配置额外的虚拟内存（Swap）。

CPU：最低 2 核，推荐 4 核。

网络：需要一个固定的内网或外网 IP，最好准备一个域名。

二、 下载与安装（Ubuntu 环境）

官方推荐使用 Omnibus 包进行安装，它将所有依赖项打包在了一起，过程最简单。

1. 安装基础依赖

更新系统包列表并安装必要的依赖：

sudo apt-get update

sudo apt-get install -y curl openssh-server ca-certificates tzdata perl

2. 添加 GitLab 官方镜像源

通过脚本自动配置 GitLab 社区版（CE）的软件源：

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

3. 执行安装

设置你的 GitLab 访问地址（例如 http://gitlab.yourdomain.com 或直接使用 IP http://192.168.1.100），然后执行安装命令：

sudo EXTERNAL_URL="http://你的域名或IP" apt-get install gitlab-ce

安装过程可能需要 3-10 分钟，请耐心等待。看到一个巨大的 GitLab ASCII 字符画，即代表安装成功！

三、 配置与初始化部署

1. 获取初始管理员密码

安装完成后，系统会自动生成一个默认的 root 用户密码。查看密码文件：

sudo cat /etc/gitlab/initial_root_password

注意： 此文件会在 24 小时后自动删除，请尽快登录并修改密码。

2. 登录 Web 界面

在浏览器中输入你刚才设置的 EXTERNAL_URL。

账号输入 root。

密码输入刚才查看到的初始密码。

登录成功后，第一时间点击右上角头像 -> Edit profile -> Password 修改密码。

3. 修改系统配置（可选）

如果后续需要修改域名或端口，编辑核心配置文件：

sudo nano /etc/gitlab/gitlab.rb

修改完成后，必须重新配置并重启服务才能生效：

sudo gitlab-ctl reconfigure

sudo gitlab-ctl restart

四、 基础使用保姆指南

1. 创建第一个项目 (Project)

在 GitLab 首页，点击绿色的 New project 按钮。

选择 Create blank project。

填写 Project name（项目名称）。

选择可见性级别（Private 私有、Internal 内部、Public 公开）。

点击 Create project。

2. 配置本地 Git (如果之前未配置)

在你的本地电脑终端中执行：

git config --global user.name "你的名字"

git config --global user.email "你的邮箱"

3. 添加 SSH 密钥（免密推送必备）

为了避免每次提交都输入密码，需要配置 SSH 密钥。

在本地电脑生成密钥：ssh-keygen -t rsa -C "你的邮箱" (一路回车即可)。

查看公钥内容并复制：cat ~/.ssh/id_rsa.pub。

回到 GitLab 网页，点击右上角头像 -> Preferences -> 左侧菜单 SSH Keys。

将复制的代码粘贴到 Key 框中，点击 Add key。

4. 本地代码推送到 GitLab

在本地项目目录中执行：

git init

git remote add origin git@你的GitLab地址:root/你的项目名.git

git add .

git commit -m "Initial commit"

git push -u origin master

五、 常见问题排查 (Troubleshooting)

问题现象	常见原因	解决办法
页面显示 502 Bad Gateway	内存不足，或者服务刚启动还未加载完毕	1. 刚启动请等待 1-2 分钟刷新

2. 检查内存是否占满，增加 Swap 空间

3. 检查端口冲突（默认占用 8080） | | 无法访问 Web 界面 | 防火墙未开放端口 / URL 配置错误 | 1. 检查 ufw 或安全组是否放行 80/443 端口

2. 检查 gitlab.rb 中的 external_url | | Git Push 报错权限拒绝 | SSH Key 未正确配置 / 仓库权限不足 | 重新生成并添加 SSH Key，或检查账号是否被赋予了该仓库的 Developer 或 Maintainer 权限。 |

六、 日常维护指令速查

GitLab 自带了强大的命令行工具 gitlab-ctl 和 gitlab-rake，日常运维主要依赖它们。

1. 服务管理

sudo gitlab-ctl start     # 启动所有 GitLab 组件

sudo gitlab-ctl stop      # 停止所有 GitLab 组件

sudo gitlab-ctl restart   # 重启所有 GitLab 组件

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

2. 数据备份 (Backup)

定期备份是防止数据丢失的关键。执行以下命令即可打包整个数据库和仓库：

sudo gitlab-rake gitlab:backup:create

备份文件默认会存放在 /var/opt/gitlab/backups/ 目录下（一个 .tar 文件）。

3. 系统升级

如果是通过 apt 安装的，升级非常简单（建议升级前先执行一次备份）：

sudo apt-get update

sudo apt-get install gitlab-ce

上一条：Docker 部署 GitLab CE 完整版教程

下一条：gitlab设置仓库路径