极狐 GitLab

自定义 HTML 头部标签

Tier: 基础版，专业版，旗舰版

Offering: 私有化部署

版本历史
  • 引入于极狐GitLab 17.1。

自定义 HTML 头部标签#

如果您在欧盟或任何需要 Cookie 同意横幅的司法管辖区中私有化部署极狐GitLab 实例，则需要额外的 HTML 头部标签来添加脚本和样式表。

安全影响#

在启用此功能之前，您应了解可能带来的安全影响。

之前合法外部资源最终可能会被攻破，然后用于从极狐GitLab 实例的任何用户中窃取几乎所有数据。因此，您绝不应添加来自不受信任的外部源的内容。如果可能的话，您应始终使用第三方资源的完整性检查，如子资源完整性（Subresource Integrity），以确认所加载资源的真实性。

将您通过 HTML 头部标签添加的功能限制到最少。否则，如果您与极狐GitLab 的其他应用程序代码进行交互，也可能导致稳定性或功能问题。

添加自定义 HTML 头部标签#

您必须在 content_security_policy 选项中可用的内容安全策略 (CSP) 中添加外部源。对于以下示例，您必须扩展 script_src 和 style_src。

要添加自定义 HTML 头部标签：

  1. 编辑 /etc/gitlab/gitlab.rb 并添加您的配置。例如：

    ruby
    1gitlab_rails['custom_html_header_tags'] = <<-'EOS'
2<script src="https://example.com/cookie-consent.js" integrity="sha384-Li9vy3DqF8tnTXuiaAJuML3ky+er10rcgNR/VqsVpcw+ThHmYcwiB1pbOxEbzJr7" crossorigin="anonymous"></script>
3<link rel="stylesheet" href="https://example.com/cookie-consent.css" integrity="sha384-+/M6kredJcxdsqkczBUjMLvqyHb1K/JThDXWsBVxMEeZHEaMKEOEct339VItX1zB" crossorigin="anonymous">
4EOS
5
6gitlab_rails['content_security_policy'] = {
7# extend the following directives
8  'directives' => {
9    'script_src' => "'self' 'unsafe-eval' https://example.com https://www.google.com/recaptcha/ https://www.recaptcha.net/ https://www.gstatic.com/recaptcha/ https://apis.google.com",
10    'style_src' => "'self' 'unsafe-inline' https://example.com",
11  }
12 }

  2. 保存文件，然后重新配置并重启极狐GitLab。

</to_translate>