史上最详细的GitLab私有化部署 从Ubuntu安装到GitLab落地详细步骤

原创 已于 2026-03-21 13:52:54 修改 · 431 阅读 · 11 ·
本内容遵循CC 4.0 BY-SA版权协议
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
GEO检测
收录于
Ubuntu

当前文章被收录于：

Ubuntu
2 篇文章 0 人学习
订阅专栏 查看详情
GitLab

当前文章被收录于：

GitLab
1 篇文章 0 人学习
订阅专栏 查看详情
于 2026-03-21 13:51:28 首次发布

史上最详细的GitLab私有化部署 从Ubuntu安装到GitLab落地详细步骤

一、VMware的安装

版本:VMware Workstation Pro 25H2u1 for Windows
下载地址: https://pan.baidu.com/s/1hXEUUssMOsY1gdWJrs7piA?pwd=t3ij
因为VMware的产品现在已经个人免费使用了,所以也不需要破解什么的,安装好就可以直接使用
安装就一直下一步就好,这块不细说了
这是安装好后的界面
在这里插入图片描述

二、Ubuntu安装

这块我使用的版本是 ubuntu-24.04.3-live-server-amd64.iso

[!NOTE] 注: 这块一定要用Ubuntu 22 以上的版本,以下的版本GitLab国内镜像站没有对应的适配包

  1. 第一步:
    点击创建虚拟机
    在这里插入图片描述

会弹出新建虚拟向导弹框
直接下一步
在这里插入图片描述

选择这个 从硬盘镜像文件安装,点击Browse 浏览找到你下载的镜像文件
在这里插入图片描述

  1. 第二步
    Virtual machine name: 设置虚拟的名称,这个名称可以随意设置.
    Location:虚拟机安装后的文件存放位置,这个位置所在的磁盘大小会影响虚拟机内的磁盘容量,尽量选择大一点,默认虚拟机是20G容量,这个容量会直接被虚拟机占用.
    在这里插入图片描述

  2. 第三步
    设置磁盘容量,默认20GB,建议不要往小修改,因为系统需要占用4-5G左右,而且Gitlab也挺大,需要6-7GB.
    存储方式默认
    在这里插入图片描述

  3. 第四步
    这块内存建议修改一下 6G 以上,不然GitLab会很卡,其他默认
    可以通过滑块控制,也可以直接在输入框输入内存大小
    在这里插入图片描述

设置完成后点关闭,然后点完成,虚拟机就会自动重启

  1. 第五步
    这个界面就进入了系统安装的界面,选择第一项Try or Install Ubuntu Server,直接回车
    在这里插入图片描述

  2. 第六步
    这个时候Ubuntu就会自动加载然后进入下面这个页面;
    这块默认就是English,回车就好,因为没有中文,也没必要要中文,服务器系统没有图形界面,回车就好
    在这里插入图片描述

  3. 第七步
    选择第二个,继续安装,如果选择第一个会在安装的时候同时更新软件包比较慢.
    在这里插入图片描述

  4. 第八步
    默认选择的Done ,直接回车下一步
    在这里插入图片描述

  5. 第九步
    默认选择的Done ,直接回车下一步
    在这里插入图片描述

  6. 第十步
    这块是网卡界面,不用管,直接回车下一步
    在这里插入图片描述

  7. 第十一步
    直接回车下一步
    在这里插入图片描述

  8. 第十二步
    这是Ubuntu的默认软件包更新时的下载地址,这个一般不用改,Ubuntu官方的这个地址速度还可以.
    在这里插入图片描述

  9. 第十三步
    这个界面是配置磁盘信息的,按键盘的下键,一直跳到下面的Done上回车就好,不用管
    在这里插入图片描述

  10. 第十四步
    系统自动给磁盘的分区情况,直接Done,回车下一步
    在这里插入图片描述

  11. 第十五步
    确认框内容:选择“继续”下方的选项将开始安装过程，并会导致所选要格式化的磁盘上的数据丢失。一旦安装开始，您将无法返回此屏幕或之前的任何屏幕。您确定要继续吗？
    选择Contiune继续
    在这里插入图片描述

  12. 第十六步
    设置系统用户名和密码;
    您的姓名： 根据情况可随意设置
    您的服务器名称： 根据情况可随意设置
    用户名： 服务器登录用户名
    密码： 服务器登录密码
    确认您的密码：
    在这里插入图片描述

  13. 第十七步
    直接继续就好,默认不用管
    在这里插入图片描述

  14. 第十八步
    这块需要让你选择是否安装 OpenSSH 服务,光标默认在选择框上,敲空格选择.选择后按键盘下键一直跳到Done上回车下一步
    建议选上,因为要远程连接Ubuntu 必须要有
    在这里插入图片描述

  15. 第十九步
    按键盘下键一直跳到Done 下一步
    在这里插入图片描述

  16. 第二十步
    到这块系统就自动开始安装了,一直等待就好,约5-10分钟
    在这里插入图片描述

  17. 第二十一步
    安装完成后的界面,界面下面会出现[Rebot Now]选择回车后,系统会重启
    在这里插入图片描述

如果没有重启并且出现这个界面,直接回车就重启了.
在这里插入图片描述

  1. 第二十二步
    如果出现这个界面不动,就敲一下回车,就会出现登录了
    在这里插入图片描述

回车后会出现登录,我这 ux 是我的自定义系统名称,这块输入你刚才设置的用户名
在这里插入图片描述

输入用户名和密码回车,密码输入不会显示,输入完成后回车就好.
在这里插入图片描述

这就代表登录成功了
在这里插入图片描述

  1. 第二十二步
    现在需要修改root用户的密码,否则无法使用root用户,Ubuntu默认root没有密码,
    输入命令
sudo passwd

在这里插入图片描述

回车后会显示让你输入当前用户的密码确认,输入后会显示以下内容
在这里插入图片描述

输入root密码,现在是新设置密码,这个设置完成后一定要记住,不然以后无法获取root权限
再输入一遍
在这里插入图片描述

如果提示password updated successfully 则设置成功,这个时候就安装完成了

三、使用xshell连接虚拟机

下载地址:https://www.xshell.com/zh/free-for-home-school/
现在xshell的家用,个人使用已经免费了,直接在官网下载安装即可
因为需要用xshell连接,所以需要查看系统IP,这个时候需要在虚拟机中安装 net-tools 这个网络工具,使用以下命令

sudo apt install net-tools

安装完成后输入

ifconfig

显示以下内容,箭头所指位置就是本机ip
在这里插入图片描述

接下来使用Xshell进行链接
这是Xshell界面,点击箭头所指方向
在这里插入图片描述

这个名称自定义,协议就SSH,主机就是我们查到的IP,端口号不变
在这里插入图片描述

输入完成后点击连接
弹出SSH密钥交互的警告,直接接受并保存
在这里插入图片描述

虚拟机的登录用户名
在这里插入图片描述

虚拟机登录密码
在这里插入图片描述

这样就连接成功了
在这里插入图片描述

四、GitLab安装

  1. 更新Ubuntu的依赖,依次执行下面命令
    输入命令后可能会弹出需要你输入密码的选项,这块需要输入刚才设置root密码
    如果出现是否继续,输入y继续
sudo apt update
sudo apt-get upgrade
  1. 安装GitLab所需依赖
sudo apt-get install curl openssh-server ca-certificates postfix

这行命令运行后会出现下面这给界面,选择No configuration按Tab键跳到OK 回车就好
在这里插入图片描述

  1. 现在开始安装GitLab
    执行下面这条命令,从GitLab官网下载配置脚本,后自动运行
curl https://packages.gitlab.com/install/repositories/gitlab/gitlab-ce/script.deb.sh |sudo bash

运行完成后显示结果
在这里插入图片描述

这个时候需要去修改gitlab的下载安装镜像地址,不然官方网站安装会很慢

cd /etc/apt/sources.list.d
ls

使用上述命令进入sources.list.d文件夹,通过ls命令查看是否有gitlab-ce.list或者gitlab_gitlab-ce.list任意一个文件
在这里插入图片描述

使用命令sudo vim gitlab_gitlab-ce.list打开该文件
在这里插入图片描述

修改这两行内容的红色部分
这是腾讯的镜像源速度不错:https://mirrors.tencent.com/gitlab-ce/ubuntu/noble
可以直接复制下面的内容替换

deb [signed-by=/etc/apt/keyrings/gitlab_gitlab-ce-archive-keyring.gpg] https://mirrors.tencent.com/gitlab-ce/ubuntu/noble noble main
deb-src [signed-by=/etc/apt/keyrings/gitlab_gitlab-ce-archive-keyring.gpg] https://mirrors.tencent.com/gitlab-ce/ubuntu/noble noble main

在xshell可以直接右键粘贴内容到编辑框
将光标上下左右方向键移动到原内容头部按del键删除原内容
vim操作 i插入;:wq保存并退出
更新镜像源信息

sudo apt-get update
  1. 安装GitLab
sudo apt-get install gitlab-ce

如果下载显示地址是tencent说明换源成功
在这里插入图片描述

出现这个界面说明安装成功
在这里插入图片描述

  1. 现在需要去修改GitLab的对外访问地址
sudo vim /etc/gitlab/gitlab.rb

打开这个文件,找到 external_url 'http://gitlab.example.com'修改网址信息为'http://虚拟器IP' 然后保存退出
在这里插入图片描述

在这里插入图片描述

  1. 启动GitLab
sudo gitlab-ctl stop //--停止服务
sudo gitlab-ctl reconfigure //--启动服务
sudo gitlab-ctl restart //--重启所有gitlab组件
sudo gitlab-ctl start //--启动所有gitlab组件

先执行停止服务,不管后台有没有运行,先执行一遍
然后执行sudo gitlab-ctl reconfigure刷新配置信息,这个刷新后系统会自动启动.
可以 在主机上通过http://虚拟机ip尝试访问 可能需要等等3-5分钟
在这里插入图片描述

能访问成功就算是部署成功了, 这块登录的默认账号是root;
密码在以下文件中

sudo cat /etc/gitlab/initial_root_password

在这里插入图片描述

  1. 登录成功后第一步肯定是先设置中文

注:如果登录后发下加载缓慢,卡顿等问题,就查一下虚拟的内存是否够用,如果不够就扩一下内存然后重新启动,使用命令top查看,最少留1.5G左右的空闲内存,比如我这个肯定是不够的,界面很卡
在这里插入图片描述

点击右上角Admin,进入管理员界面
在这里插入图片描述

找到Settings→Proferences
在这里插入图片描述

找到Localization打开
在这里插入图片描述

选择
在这里插入图片描述

点保存
在这里插入图片描述

重新登录进入就是中文了
8. 修改Root密码
在这里插入图片描述

大功告成,GitLab部署完成,服务器重启后GitLab会随开机自动启动.
在这里插入图片描述

如果虚拟机重启后出现这个界面是GitLab服务正在启动,等一会就好
在这里插入图片描述

标签
#gitlab #git #linux #ubuntu
别再折腾云服务了！手把手教你在Ubuntu 22.04上搭建私有GitLab服务器（含内存优化与邮件配置）
weixin_28736335的博客
05-05 234
本文详细指导在Ubuntu 22.04上搭建私有GitLab服务器，涵盖从基础部署到内存优化、邮件配置等关键步骤。针对中小团队需求，提供资源优化方案和常见问题解决方案，帮助实现高效、安全的代码托管环境。特别适合寻求替代云服务、注重数据自主权的开发者。
GitLab从入门到精通超详细教程【一】
GitLab 中国发行版
03-28 2954
极狐GitLab 新手指南。
在ubuntu上部署gitlab详细步骤
landeli2的专栏
12-12 1万+
ubuntu系统下部署gitlab实现本地化代码管理
2023最新Ubuntu安装部署Gitlab详细教程（每个步骤均配图）
热门推荐
m0_63230155的博客
07-27 3万+
打开终端，运行如下命令： sudo apt update sudo apt-get upgrade sudo apt-get install curl openssh-server ca-certificates postfix
ubuntu 22.04 安装部署gitlab详细过程
CHNIM的博客
07-23 6299
GitLab 是一个非常流行的 DevOps 平台，主要用于版本控制和源代码管理。它提供了许多优势，使其成为软件开发团队的首选工具之一。集中式与分布式版本控制GitLab 支持 Git，这是一种分布式版本控制系统，允许开发者在本地进行大部分工作，然后将更改推送到中心仓库。这提高了开发效率，并有助于避免冲突。项目管理功能GitLab 提供了项目管理工具，如问题跟踪、里程碑、标签、看板等，帮助团队更好地组织和跟踪项目进度。持续集成/持续部署 (CI/CD)
如何用GitLab本地私有化部署代码库？
qq_42828949的博客
12-29 4547
像SVN、Git这样的源代码版本控制系统，大家肯定并不陌生。 如今，微软收购了GitHub，很多人都有所担心代码安全性，迁移到了私有代码库，放弃了公共代码托管平台。 其中，GitLab是比较知名的开源方案，几乎可以实现GitHub的全部功能，并支持本地私有化部署。 但是在很多情况下，内网主机、虚拟机并没有公网IP，而且也无法进行端口映射或设置DMZ主机。 如何远程访问私有化部署的GitLab服务...
GitLab部署手册：Ubuntu系统安装与配置
qq_57526628的博客
11-21 2078
GitLab 是一个开源应用程序，主要用于托管 Git 仓库，并提供额外的开发相关功能，如问题跟踪。它被设计为使用自己的基础设施进行托管，提供灵活性，可以作为开发团队的内部仓库存储、与用户交互的公共方式，或者作为贡献者托管他们自己项目的途径。GitLab 项目允许在自己的硬件上创建一个 GitLab 实例，具有最小的安装机制。本指南将教如何在 Ubuntu 服务器上安装和配置 GitLab 社区版。
使用 Omnibus 安装一个极狐GitLab私有化部署版本
GitLab 中国发行版
02-22 1554
极狐GitLab 私有化部署安装方式。
GitLab私有化部署全链路实操：Ubuntu+nginx+MySQL生产级落地
最新发布
weixin_30535843的博客
06-21 537
GitLab作为企业级DevOps平台，其私有化部署远不止安装软件，而是涉及操作系统适配、反向代理深度配置与数据库兼容性治理的技术体系。核心原理在于理解GitLab Omnibus包对Ubuntu 22.04 LTS的ABI依赖、nginx对Git over HTTP(S)和WebSocket的协议级支持要求，以及MySQL替代PostgreSQL时的严格模式与功能取舍。该方案具备高可控性、审计合规性与内网安全价值，广泛应用于金融、政务、制造业等对代码不出域、日志留存、物理隔离有强约束的场景，是构建自主可控
ubuntu20 安装、配置Gitlab
wzg2016的博客
03-13 1484
对于postfix的安装，请在出现提示时选择“ Internet站点”，其余选项按默认值即可。
搭建私有Git服务器：GitLab部署详解
欢迎来到“Python算法探索”，我是GT算法工程师，一名热爱计算机算法的博主。在这里，我们将一起深入探索Python世界中的各种算法，从基础到高级，从理论到实践。我参加过很多算法比赛，积累了丰富的经验，希望通过这个播客与你分享。让我们一起用Python探
02-24 1万+
本文将指导你通过Bash命令在Linux服务器上部署GitLab，帮助你搭建一个功能强大的私有Git服务器。我们将介绍安装依赖、配置服务器、下载GitLab软件包、运行GitLab服务等步骤，并提供相应的Bash命令。通过本文的详细指导，你将能够轻松搭建起一个安全、稳定的Git服务器，满足团队的协作开发需求。
centos7 gitlab私有化部署搭建 踩坑之旅
skylar2的博客
08-04 888
由于我只是学习使用，那就这样吧（…可视化编排支持能力有限，比如邮件不能发送到qq邮箱，指定分支代码提交commit包含关键字打tag也不支持，自定义脚本想做这件事也遇到许多问题：指定镜像跑脚本失败，不知道是为什么，日志也输出失败；指定端口是否会阻塞gitlab其他服务的运行，如gitlab中的puma运行在8080端口，如果指定访问端口是8080，会阻塞puma服务，导致服务无法运行。我没有选择docker安装，因为docker安装每次要启动，而且由于我用docker做实验，常清空镜像和容器，容易误操作。
Ubuntu 20.04安装配置GitLab
博客
06-20 2万+
Ubuntu 20.04安装配置GitLab 介绍 GitLab CE或Community Edition是一个开源应用程序，主要用于托管Git存储库，以及其他与开发相关的功能，如问题跟踪。它旨在使用您自己的基础架构进行托管，并为您的开发团队提供部署内部存储库的灵活性，与用户交互的公共方式，或者为贡献者提供托管自己项目的方法。 GitLab项目使用简单的安装机制在您自己的硬件上设置GitLab实例变得相对简单。在本指南中，我们将介绍如何在阿里云Ubuntu 20.04服务器上安装和配置GitLab。 前提条
ubuntu部署gitlab-ce及数据迁移
qq_70531838的博客
02-28 1720
我这里版本是gitlab-ee16.9.2对应的gitlab-ce16.9.2，还是有些区别，加上之前的仓库不多，分支也挺乱的，准备重新提交代码。上面链接的博客写得不错，可以看看。# 因为博主安装的gitlab版本是gitlab-ce_16.10.10，目的是为了实现数据迁移，结果出现了版本不一的问题。# GitLab迁移的思路是： 旧服务器使用gitlab-rake备份-----迁移到新服务器指定目录并授予权限（文件是迁移 GitLab 的关键文件，必须一起迁移）------使用指定命令恢复。
Ubuntu离线安装Gitlab
mfkjq的专栏
03-02 2354
如果对gitlab版本无要求可参照此链接：https://blog.csdn.net/longgeaisisi/article/details/100667239 准备工作 1. 下载Ubuntu，http://mirrors.aliyun.com/ubuntu-releases/（国内镜像）https://ubuntu.com/download/desktop（官网） 2. 下载Gitlab，https://mirrors.tuna.tsinghua.edu.cn/gitlab-ce/ubu..
如何在 Ubuntu 上安装和配置 GitLab
weixin_53510183的博客
11-03 7794
GitLab是一个开源应用程序，主要用于托管 Git 仓库，并提供与开发相关的附加功能（如问题跟踪）。GitLab 可由用户自己的基础架构托管，可灵活部署为开发团队的内部存储库、与用户对接的公共方式或供稿者托管自己项目的途径。通过 GitLab 项目，你可以在自己的硬件上创建一个 GitLab 实例，只需最简单的安装机制。本篇文章将教你如何在 Ubuntu 服务器上安装和配置 GitLab 社区版。
gitlab 本地私有化教程
xhwy_zh的博客
10-17 616
在与 `docker-compose.yml` 同级目录下创建三个目录：`config`、`logs` 和 `data`。替换 `your-gitlab-domain.com` 为你想要使用的 GitLab 域名。3. **创建 GitLab 实例的 Docker Compose 文件：**1. **安装 Docker 和 Docker Compose：**2. **获取 GitLab Docker 镜像：**7. **初始化 GitLab 实例：**5. **启动 GitLab 实例：**
在Ubuntu用Docker部署汉化版GitLab
dora_310的博客
09-05 2672
项目的开发通常都离不开对代码的版本管理。简单的方式可以在内网搭建一个仓库，然后添加各个组员的公钥来共同开发。这种方式不仅不利于管理和维护，而且功能过于单一。我们很希望有像GitHub这样的平台服务，功能齐全且好维护。但由于GFW的原因，有时候访问延迟过大。更重要的是，github免费版只支持开源项目，私有项目需要付费，而且比较昂贵，并不适合公司的项目。 GitLab 是一个类似与GitHub的项...
Ubuntu 安装设置 Gitlab
weixin_43978579的博客
11-28 1596
在 Ubuntu 下安装和设置 GitLab CE（Community Edition）涉及多个步骤，包括安装依赖、下载GitLab CE 安装包、配置 GitLab 以及优化性能等。
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值