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

在 Debian 上安装 Linux 包

Tier: Free, Premium, Ultimate
Offering: GitLab Self-Managed

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

先决条件

操作系统要求：
- Debian 11
- Debian 12
查看安装要求了解最低硬件要求。
开始之前，请确保您已正确设置您的 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。您可以通过在安装前配置环境变量来自定义初始设置。

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

GitLab 会为 root 管理员账户生成随机密码和电子邮件地址。
密码存储在 /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 中的密码或重置 root 密码。

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

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

安装命令

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

基本安装：

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

使用自定义 root 凭据：

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

使用自定义 root 凭据：

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

设置您的通信偏好

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

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

如果您不订阅安全通讯，您将不会收到安全警报。