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

环境变量

  • 版本：Free, Premium, Ultimate
  • 产品：GitLab Self-Managed

GitLab 提供了某些环境变量，这些变量可用于覆盖其默认值。

人们通常通过以下方式配置 GitLab：

  • 对于 Linux 软件包安装，使用 /etc/gitlab/gitlab.rb。
  • 对于自行编译安装，使用 gitlab.yml。

您可以使用以下环境变量来覆盖某些值：

支持的环境变量

变量 类型 描述
DATABASE_URL string 数据库 URL；格式为：postgresql://localhost/blog_development。
ENABLE_BOOTSNAP string 用于切换 Bootsnap 以加速 Rails 的初始启动。在非生产环境中默认启用。设置为 0 可禁用。
EXTERNAL_URL string 在安装时指定外部 URL。
EXTERNAL_VALIDATION_SERVICE_TIMEOUT integer 外部 CI/CD 流水线验证服务的超时时间（单位：秒）。默认为 5。
EXTERNAL_VALIDATION_SERVICE_URL string 外部 CI/CD 流水线验证服务的 URL。
EXTERNAL_VALIDATION_SERVICE_TOKEN string 用于与外部 CI/CD 流水线验证服务进行身份验证的 X-Gitlab-Token。
GITLAB_CDN_HOST string 设置用于提供静态资产的 CDN 的基础 URL（例如，https://mycdnsubdomain.fictional-cdn.com）。
GITLAB_EMAIL_DISPLAY_NAME string GitLab 发送邮件时，发件人字段中使用的名称。
GITLAB_EMAIL_FROM string GitLab 发送邮件时，发件人字段中使用的电子邮件地址。
GITLAB_EMAIL_REPLY_TO string GitLab 发送邮件时，回复至字段中使用的电子邮件地址。
GITLAB_EMAIL_SUBJECT_PREFIX string GitLab 发送邮件时使用的电子邮件主题前缀。
GITLAB_EMAIL_SUBJECT_SUFFIX string GitLab 发送邮件时使用的电子邮件主题后缀。
GITLAB_HOST string GitLab 服务器的完整 URL（包括 http:// 或 https://）。
GITLAB_MARKUP_TIMEOUT string gitlab-markup gem 执行的 rest2html 和 pod2html 命令的超时时间（单位：秒）。默认为 10。
GITLAB_ROOT_PASSWORD string 在安装时为 root 用户设置密码。
GITLAB_SHARED_RUNNERS_REGISTRATION_TOKEN string 设置用于 Runner 的初始注册令牌。在 GitLab 16.11 中已弃用。
RAILS_ENV string Rails 环境；可以是 production、development、staging 或 test 之一。
GITLAB_RAILS_CACHE_DEFAULT_TTL_SECONDS integer 存储在 Rails 缓存中的条目的默认 TTL。默认为 28800。于 15.3 版本引入。
GITLAB_CI_CONFIG_FETCH_TIMEOUT_SECONDS integer 解析 CI 配置中的远程包含项的超时时间（单位：秒）。必须在 0 到 60 之间。默认为 30。于 15.11 版本引入。
GITLAB_DISABLE_MARKDOWN_TIMEOUT string 如果设置为 true、1 或 yes，则后端的 Markdown 渲染不会超时。默认为 false。于 17.4 版本引入。
GITLAB_LFS_LINK_BATCH_SIZE integer 设置链接 LFS 文件的批次大小。默认为 1000。
GITLAB_LFS_MAX_OID_TO_FETCH integer 设置要链接的 LFS 对象的最大数量。默认为 100,000。
SIDEKIQ_SEMI_RELIABLE_FETCH_TIMEOUT integer 设置 Sidekiq 半可靠获取的超时时间。默认为 5。在 GitLab 16.7 之前，默认为 3。如果您在 GitLab 16.6 及更早版本上遇到 Redis CPU 使用率过高，或者您自定义了此变量，则应将此变量更新为 5。
SSL_IGNORE_UNEXPECTED_EOF string OpenSSL 3.0 要求服务器在关闭 SSL 连接之前发送 close_notify。将其设置为 true 将禁用此功能。更多详情请参阅 OpenSSL 文档。默认为 false。

添加更多变量

我们欢迎通过合并请求（Merge Request）来使更多设置可以通过变量进行配置。 请修改 config/initializers/1_settings.rb 文件，并使用 GITLAB_#{1_settings.rb 中的大写名称} 的命名方案。

Linux 软件包安装配置

要设置环境变量，请遵循这些说明。

可以通过在 docker run 命令中添加环境变量 GITLAB_OMNIBUS_CONFIG 来预配置 GitLab Docker 镜像。 更多信息，请参阅预配置 Docker 容器。