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

GitLab 外观

  • 层级：免费、高级、旗舰
  • 产品：GitLab 自管版、GitLab 专属版

您可以更新设置以更改实例的外观和体验。

要打开 外观 设置：

  1. 在左侧边栏底部，选择 管理员。
  2. 选择 设置 > 外观。

自定义主页按钮

自定义主页按钮的外观。

主页按钮位于左侧边栏的左上角。 将默认的 GitLab 徽标 tanuki 替换为任意图片。

  • 文件大小应小于 1 MB。
  • 图片高度应为 24 像素。超过 24 像素的图片将被调整大小。

要自定义主页图标图片：

  1. 在左侧边栏底部，选择 管理员。
  2. 选择 设置 > 外观。
  3. 在 导航栏 下，选择 选择文件。
  4. 在页面底部，选择 更新外观设置。

流水线状态邮件也会显示您的自定义徽标。但是，某些电子邮件应用程序不支持 SVG 图片。如果您的自定义图片是 SVG 格式，流水线邮件将显示默认徽标。

自定义网站图标 (Favicon)

自定义网站图标 (Favicon) 的外观。网站图标是显示在浏览器标签页中的网站图标。GitLab 徽标 tanuki 是默认的浏览器和 CI/CD 状态网站图标。将默认图标替换为任意尺寸为 32 x 32 像素且格式为 .png 或 .ico 的图片。

要更改网站图标：

  1. 在左侧边栏底部，选择 管理员。
  2. 选择 设置 > 外观。
  3. 在 网站图标 下，选择 选择文件。
  4. 在页面底部，选择 更新外观设置。

添加系统页眉和页脚消息

为您的 GitLab 实例界面添加一个小的页眉消息、一个小的页脚消息，或两者都添加。这些消息会显示在实例的所有项目和页面上，例如登录和注册页面。

  • 您可以使用 Markdown 为消息添加斜体、粗体或链接。
  • 不支持 Markdown 列表、图片和引用，因为系统消息必须是单行的。

要添加系统页眉、页脚消息或两者：

  1. 在左侧边栏底部，选择 管理员。
  2. 选择 设置 > 外观。
  3. 转到 系统页眉和页脚 部分。
  4. 填写字段。
  5. 可选。选中 在邮件中启用页眉和页脚 复选框。将您的系统消息添加到 GitLab 实例发送的所有邮件中。
  6. 在页面底部，选择 更新外观设置。

默认情况下，系统页眉和页脚文本是橙色背景上的白色文本。要自定义消息颜色：

  • 转到 系统页眉和页脚 部分并选择 自定义颜色。

自定义您的登录和注册页面

自定义登录和注册页面上的标题、描述和徽标。默认情况下，注册页面徽标位于页面左侧，在标题和描述之间。

要自定义您的登录和注册页面标题或描述：

  1. 在左侧边栏底部，选择 管理员。
  2. 选择 设置 > 外观。
  3. 转到 登录/注册页面 部分。
  4. 填写字段。您可以使用 Markdown 格式化页面 标题 和 描述。
  5. 在页面底部，选择 更新外观设置。

要自定义您的登录和注册页面上的徽标：

  • 文件大小应小于 1 MB。
  • 图片高度应为 128 像素。超过 128 像素的图片将被调整大小。
  1. 在左侧边栏底部，选择 管理员。
  2. 选择 设置 > 外观。
  3. 转到 登录/注册页面 部分。
  4. 在 徽标 下，选择 选择文件。
  5. 在页面底部，选择 更新外观设置。

您还可以在登录消息下方添加自定义帮助消息或添加登录文本消息。

  • 产品：GitLab 自管版

在 GitLab 自管版上，默认情况下此功能不可用。要启用它，管理员可以启用名为 disable_preferred_language_cookie 的功能标志。 在 GitLab.com 和 GitLab 专属版上，此功能不可用。

您可以通过启用 disable_preferred_language_cookie 功能标志，从登录和注册页面的页脚中移除基于 Cookie 的语言选择器。

自定义渐进式 Web 应用 (PWA)

为您的渐进式 Web 应用 (PWA) 自定义图标、显示名称、简称和描述。更多信息，请参阅渐进式 Web 应用。

要添加渐进式 Web 应用名称和简称：

  1. 在左侧边栏底部，选择 管理员。
  2. 选择 设置 > 外观。
  3. 转到 渐进式 Web 应用 (PWA) 部分。
  4. 填写字段。
    • 名称 是您的 PWA 的显示名称。
    • 简称 显示在移动设备和小屏幕上。
  5. 在页面底部，选择 更新外观设置。

要添加渐进式 Web 应用描述：

  1. 在左侧边栏底部，选择 管理员。
  2. 选择 设置 > 外观。
  3. 转到 渐进式 Web 应用 (PWA) 部分。
  4. 填写字段。您可以使用 Markdown 格式化 描述。
  5. 在页面底部，选择 更新外观设置。

要自定义您的渐进式 Web 应用图标：

  1. 在左侧边栏底部，选择 管理员。
  2. 选择 设置 > 外观。
  3. 转到 渐进式 Web 应用 (PWA) 部分。
  4. 在 图标 下，选择 选择文件。
  5. 在页面底部，选择 更新外观设置。

成员指南

您可以为 GitLab 中的群组和项目成员页面添加成员指南。 您可以在描述中使用 Markdown。

成员指南对拥有管理权限的用户可见，可管理以下任一对象：

  • 群组成员。
  • 项目成员。

如果您通过以下任一方式管理群组和项目成员，则应添加成员指南：

  • 使用预定义的群组，而不是逐个管理。
  • 使用外部工具。

为新建项目页面添加指南

为 新建项目页面 添加指南消息。您可以使用 Markdown 格式化您的消息。指南消息显示在 新建项目 消息下方，以及 新建项目页面 的左侧。

要为 新建项目页面 添加指南消息：

  1. 在左侧边栏底部，选择 管理员。
  2. 选择 设置 > 外观。
  3. 转到 新建项目页面 部分。
  4. 填写字段。您可以使用 Markdown 格式化您的指南。

添加个人资料图片指南

为个人资料图片添加指南。

  1. 在左侧边栏底部，选择 管理员。
  2. 选择 设置 > 外观。
  3. 转到 个人资料图片指南 部分。
  4. 填写字段。您可以使用 Markdown 格式化您的文本。

Libravatar

GitLab 支持 Libravatar 作为头像图片服务，但您必须在 GitLab 实例上手动启用 Libravatar 支持。有关使用该服务的更多信息，请参阅 Libravatar。

为所有新用户更改颜色主题

  • 产品：GitLab 自管版

要为所有新用户更改默认导航主题：

  1. 将 gitlab_rails['gitlab_default_theme'] 添加到您的 GitLab 配置文件 /etc/gitlab/gitlab.rb 中：

    gitlab_rails['gitlab_default_theme'] = 2

  2. 重新配置并重启 GitLab。

从 GitLab 17.8 开始，gitlab_default_theme 可以指定 1 到 10 之间的值 来设置默认主题。

值 颜色
1 靛蓝
2 深色
3 浅色
4 蓝色
5 绿色
6 浅靛蓝
7 浅蓝色
8 浅绿色
9 红色
10 浅红色