Help us learn about your current experience with the documentation. Take the survey.

在 Ubuntu 上安装 Linux 包

Tier: 免费, 高级, 终极
Offering: GitLab 自托管

查看支持的平台以获取完整的支持发行版和架构列表。

先决条件

操作系统要求：
- Ubuntu 20.04
- Ubuntu 22.04
- Ubuntu 24.04
查看安装要求了解最低硬件要求。
开始之前，请确保您已正确设置您的 DNS，并将 https://gitlab.example.com 更改为您希望访问 GitLab 实例的 URL。安装程序会自动在该 URL 配置并启动 GitLab。
对于 https:// URL，GitLab 会自动请求 Let’s Encrypt 证书，这需要入站 HTTP 访问和有效的域名。您也可以使用您自己的证书，或者仅使用 http://（不带 s）作为未加密的 URL。

启用 SSH 并打开防火墙端口

要打开所需的防火墙端口（80、443、22）并能够访问 GitLab：

启动并启动 OpenSSH 服务器守护进程：
```
sudo systemctl enable --now ssh
```

安装 ufw 后，打开防火墙端口：

sudo ufw allow 22/tcp
sudo ufw allow 80/tcp
sudo ufw allow 443/tcp
sudo ufw enable

添加 GitLab 包仓库

要安装 GitLab，首先添加 GitLab 包仓库。

安装所需的包：
```
sudo apt install -y curl
```

使用以下脚本添加 GitLab 仓库（您可以将脚本的 URL 粘贴到浏览器中查看其功能，然后再通过管道传输到 bash）：

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

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

安装包

使用系统的包管理器安装 GitLab。您可以通过在安装前配置环境变量来自定义初始设置。

如果您在安装期间不自定义根凭据：

GitLab 会为根管理员账户生成随机密码和电子邮件地址。
密码存储在 /etc/gitlab/initial_root_password 中 24 小时。
24 小时后，出于安全原因，该文件会自动删除。

虽然您也可以通过在 /etc/gitlab/gitlab.rb 中设置 gitlab_rails['initial_root_password'] = "password" 来设置初始密码，但不推荐这样做。如果您使用此方法设置密码，请确保从 /etc/gitlab/gitlab.rb 中删除密码，因为它只在安装包后的第一次重新配置时读取。

可用的环境变量

您可以通过设置以下可选环境变量来自定义您的 GitLab 安装。 这些变量仅在首次安装时有效，对后续的重新配置运行没有影响。对于现有安装，请使用 /etc/gitlab/initial_root_password 中的密码或重置根密码。

变量	用途	必需性	示例
`EXTERNAL_URL`	设置您的 GitLab 实例的外部 URL	推荐	`EXTERNAL_URL="https://gitlab.example.com"`
`GITLAB_ROOT_EMAIL`	根管理员账户的自定义电子邮件	可选	`GITLAB_ROOT_EMAIL="admin@example.com"`
`GITLAB_ROOT_PASSWORD`	根管理员账户的自定义密码（最少 8 个字符）	可选	`GITLAB_ROOT_PASSWORD="strongpassword"`

如果 GitLab 在安装期间无法检测到有效的域名，则不会自动运行重新配置。在这种情况下，将所需的环境变量传递给您的第一个 gitlab-ctl reconfigure 命令。

安装命令

选择您的 GitLab 版本并使用上述环境变量进行自定义：

基本安装：

sudo EXTERNAL_URL="https://gitlab.example.com" apt install gitlab-ee

使用自定义根凭据：

sudo GITLAB_ROOT_EMAIL="admin@example.com" GITLAB_ROOT_PASSWORD="strongpassword" EXTERNAL_URL="https://gitlab.example.com" apt install gitlab-ee

基本安装：

sudo EXTERNAL_URL="https://gitlab.example.com" apt install gitlab-ce

使用自定义根凭据：

sudo GITLAB_ROOT_EMAIL="admin@example.com" GITLAB_ROOT_PASSWORD="strongpassword" EXTERNAL_URL="https://gitlab.example.com" apt install gitlab-ce

设置您的通信偏好

访问我们的电子邮件订阅偏好中心让我们知道何时与您联系。我们采用明确的电子邮件选择加入政策，因此您可以完全控制我们向您发送电子邮件的内容和频率。

我们每月两次发送您需要了解的 GitLab 新闻，包括新功能、集成、文档以及我们开发团队的幕后故事。对于与错误和系统性能相关的关键安全更新，请订阅我们的专门安全通讯。

如果您不选择加入安全通讯，您将不会收到安全警报。