Ubuntu 22.04 局域网安装GitLab

下面直接给你一份Ubuntu 22.04 在局域网安装 GitLab 的可执行教程。
场景固定为：

• 非 Docker
• 非源码
• 服务器 IP：192.168.1.42
• 安装方式：GitLab Linux package（Omnibus）
• 先按HTTP 内网访问部署，最快跑通；GitLab 官方也明确支持把external_url直接设成服务器 IP，只是更推荐 FQDN。(GitLab 文档)

0. 先确认前提

这套教程默认：

• 系统是Ubuntu 22.04
• 这台机器能被局域网其他机器访问到192.168.1.42
• 这台机器自己能访问 GitLab 官方包源；官方说明安装时需要访问packages.gitlab.com和storage.googleapis.com/packages-ops。(GitLab 文档)

GitLab 官方对 Ubuntu Linux package 的支持包含Ubuntu 20.04 / 22.04 / 24.04。同时，基础安装建议至少预留40 GB 磁盘；对中等规模场景，官方建议8 vCPU / 16 GB RAM，较小环境在部分情况下可从8 GB RAM起步。(GitLab 文档)

1. 更新系统并开放端口

先登录到192.168.1.42这台 Ubuntu 22.04 服务器，执行：

sudoaptupdatesudoapt-yupgradesudoaptinstall-ycurlopenssh-server ca-certificates tzdata perl

然后启用 SSH，并开放 GitLab 常用端口。GitLab 官方 Ubuntu 安装页给出的端口就是22 / 80 / 443。(GitLab 文档)

sudosystemctlenable--nowsshsudoufw allow22/tcpsudoufw allow80/tcpsudoufw allow443/tcpsudoufwenable

确认防火墙状态：

sudoufw status

2. 添加 GitLab 官方软件源

如果你安装的是社区版 CE，执行：

curl--location"https://packages.gitlab.com/install/repositories/gitlab/gitlab-ce/script.deb.sh"|sudobash

如果你安装的是企业版 EE，把上面的gitlab-ce改成gitlab-ee。这是 GitLab 官方 Ubuntu 包安装方式。(GitLab 文档)

3. 安装 GitLab（直接绑定到 192.168.1.42）

因为你已经给了固定 IP，所以这里直接用 IP 做external_url。GitLab 官方文档明确说明：

• external_url可以直接使用服务器 IP
• EXTERNAL_URL可以在安装时传入，并会写入/etc/gitlab/gitlab.rb
• 但不要把EXTERNAL_URL设成全局环境变量，最好只在安装命令这一行临时传入。(GitLab 文档)

执行：

sudoEXTERNAL_URL="http://192.168.1.42"aptinstall-ygitlab-ce

这一步会安装并初始化 GitLab。官方说明如果安装时不额外指定 root 密码，GitLab 会自动生成一个随机 root 密码，写到：

/etc/gitlab/initial_root_password

这个文件默认保留24 小时。(GitLab 文档)

4. 获取初始管理员密码并登录

安装完成后，读取初始密码：

sudocat/etc/gitlab/initial_root_password

浏览器访问：

http://192.168.1.42

登录信息：

• 用户名：root
• 密码：上面文件里的内容。(GitLab 文档)

首次登录后，立刻修改 root 密码和邮箱。

5. 核对主配置文件

Linux package 的主配置文件是：

/etc/gitlab/gitlab.rb

GitLab 官方说明，Linux package 的核心配置都在这个文件里；改完后执行：

sudogitlab-ctl reconfigure

让配置生效。(GitLab 文档)

先检查一下当前值：

sudogrep-n"^external_url"/etc/gitlab/gitlab.rb

你应该能看到类似：

external_url"http://192.168.1.42"

如果没有，就手动改成：

sudoeditor /etc/gitlab/gitlab.rb

把这一行设为：

external_url"http://192.168.1.42"

保存后执行：

sudogitlab-ctl reconfigure

GitLab 官方明确给出的 IP 配置示例就是这种写法。(GitLab 文档)

6. 做一次安装后自检

先看服务状态：

sudogitlab-ctl status

如需重启整套 GitLab：

sudogitlab-ctl restart

GitLab 官方维护命令里明确支持这些命令。(GitLab 文档)

再执行一次健康检查：

sudogitlab-rake gitlab:check

这个是 GitLab 官方推荐的维护检查命令。(GitLab 文档)

你还可以导出环境信息，便于后续排障：

sudogitlab-rake gitlab:env:info

这也是官方维护任务之一。(GitLab 文档)