• 谁接收通知
• 编辑通知设置
  • 通知范围
  • 通知级别
  • 全局通知设置
  • 群组通知
    • 更改群组通知级别
    • 更改用于群组通知的电子邮件地址
  • 更改项目通知级别
  • 选择退出产品营销电子邮件
• 通知事件
• 关于议题、合并请求和史诗的通知
  • 谁接收有关议题、合并请求和史诗的通知
  • 编辑议题、合并请求和史诗的通知设置
  • 关于议题、合并请求和史诗的通知事件
• 未知登录通知
• 使用错误的双重身份验证码尝试登录的通知
• 关于设计的通知
• 选择退订所有电子邮件
• 可用于过滤电子邮件的电子邮件标头
  • X-GitLab-NotificationReason

通知邮件

• 增强的电子邮件样式引入于 14.9 版本，功能标志名为 enhanced_notify_css。默认禁用。
• 增强的电子邮件样式在 SaaS 版上启用于 14.9 版本。
• 增强的电子邮件样式在 私有化部署版上启用于 15.0 版本。

通过电子邮件通知随时了解极狐GitLab 中发生的事情。 您可以接收有关议题、合并请求、史诗和设计中活动的更新。

谁接收通知

当为议题、合并请求或史诗启用通知时，极狐GitLab 会通知您在那里发生的操作。

由于以下原因之一，您可能会收到通知：

• 您参与议题、合并请求、史诗或设计。当您发表评论或编辑，或有人提及¹您时，您就成为参与者。
• 您已启用关于议题、合并请求和史诗的通知。
• 您已为项目或群组配置通知。
• 您已通过流水线电子邮件集成订阅群组或项目流水线通知。

1. 当编辑评论包含用户提及时，系统不会发送通知。

编辑通知设置

收到很多通知可能会让人不知所措。 您可以调整收到的通知。 例如，您可能希望收到有关特定项目中所有活动的通知。 对于其他项目，您只希望在被提及时收到通知。

这些通知设置仅适用于您。它们不会影响其他任何人收到的通知。

要编辑您的通知设置：

1. 在右上角，选择您的头像。
2. 选择 偏好设置。
3. 在左侧边栏上，选择 通知。
4. 编辑所需的全局、群组或项目通知设置。编辑的设置会自动保存。

通知范围

您可以通过为每个项目和群组选择不同的通知级别来调整通知的范围。

通知范围从最广泛到最具体的级别应用：

• 如果您没有为发生活动的项目或组选择通知级别，则您的 全局 或 默认 通知级别适用。
• 您的 群组 设置会覆盖您的默认设置。
• 您的 项目 设置会覆盖群组设置。

通知级别

对于每个项目和群组，您可以选择以下级别之一：

全局通知设置

除非您为项目或群组选择不同的值，否则您的 全局通知设置 是默认设置。

• 通知电子邮件：您的通知发送到的电子邮件地址。 默认为您的主要电子邮件地址。
• 接收产品营销电子邮件：选中此复选框可接收有关 GitLab 功能的 定期电子邮件。
• 全局通知级别：适用于所有通知的默认通知级别。
• 接收有关您自己活动的通知：选中此复选框可接收有关您自己活动的通知。默认不选择。

群组通知

您可以为每个群组选择通知级别和电子邮件地址。

更改群组通知级别

要为群组选择通知级别，请使用以下任一方法：

1. 在右上角，选择您的头像。
2. 选择 偏好设置。
3. 在左侧边栏上，选择 通知。
4. 在 群组 部分找到项目。
5. 选择所需的通知级别。

或者：

1. 在顶部栏上，选择 主菜单 > 群组 并找到您的群组。
2. 选择铃铛图标 () 旁边的通知下拉菜单。
3. 选择所需的通知级别。

更改用于群组通知的电子邮件地址

您可以选择一个电子邮件地址来接收您所属的每个群组的通知。 例如，如果您是自由职业者，并且希望将有关客户项目的电子邮件分开，您可以使用群组通知。

1. 在右上角，选择您的头像。
2. 选择 偏好设置。
3. 在左侧边栏上，选择 通知。
4. 在 群组 部分找到项目。
5. 选择所需的电子邮件地址。

更改项目通知级别

为了帮助您了解最新情况，您可以为每个项目选择一个通知级别。

要为项目选择通知级别，请使用以下任一方法：

1. 在右上角，选择您的头像。
2. 选择 首选项。
3. 在左侧边栏上，选择通知。
4. 在 项目 部分找到项目。
5. 选择所需的通知级别。

或者：

1. 在顶部栏上，选择 主菜单 > 项目 并找到您的项目。
2. 选择铃铛图标 () 旁边的通知下拉菜单。
3. 选择所需的通知级别。

选择退出产品营销电子邮件

您可以收到有关各种功能的电子邮件。 默认情况下启用这些电子邮件。

要选择退出：

1. 在右上角，选择您的头像。
2. 选择 偏好设置。
3. 在左侧边栏上，选择 通知。
4. 清除 接收产品营销电子邮件 复选框。 编辑的设置会自动保存并启用。

禁用这些电子邮件不会禁用所有电子邮件。 了解如何退订所有电子邮件。

通知事件

用户会收到以下事件的通知：

关于议题、合并请求和史诗的通知

您还会收到有关议题、合并请求和史诗事件的通知。

谁接收有关议题、合并请求和史诗的通知

在议题、合并请求和史诗中，对于大多数事件，通知发送到：

• 参与者：
  • 作者和指派人。
  • 评论的作者
  • 任何在标题或描述中被提及用户名的人。
  • 如果他们的通知级别为“参与”或更高级别，则在评论中使用用户名提及的任何人。
• 关注者：通知级别为“关注”的用户。
• 订阅者：手动订阅通知的任何人。
• 自定义：打开了适合类型事件的通知级别为“自定义”的用户。

编辑议题、合并请求和史诗的通知设置

要启用有关特定议题、合并请求或史诗的通知，您必须打开右侧边栏中的 通知 开关。

• 要订阅，如果您不是讨论的参与者，但希望在每次更新时收到通知，请 开启。

  当您在史诗中打开通知时，您不会自动订阅与史诗相关的议题。

• 要取消订阅，如果您收到更新通知但不想再收到它们，请 关闭。

  关闭此开关只会取消订阅与此议题、合并请求或史诗相关的更新。

  了解如何退订所有电子邮件。

关于议题、合并请求和史诗的通知事件

下表显示了为议题、合并请求和史诗生成通知的事件：

如果议题或合并请求的标题或描述发生更改，通知将发送到任何 新 提及用户名的人，类似与在原始文本中提及一样。

如果打开的合并请求由于冲突而无法合并，则会通知其作者原因。 如果用户还将合并请求设置为在流水线成功时自动合并，则该用户也会收到通知。

默认情况下，您不会收到有关您自己创建的议题、合并请求或史诗的通知。 要始终接收有关您自己的问题、合并请求等的通知，请打开关于您自己活动的通知。

未知登录通知

当用户从以前未知的 IP 地址或设备成功登录时，极狐GitLab 会通过电子邮件通知用户。通过这种方式，极狐GitLab 会主动提醒用户潜在的恶意或未经授权的登录。

极狐GitLab 使用多种方法来识别已知登录。所有方法都失败才会发送通知电子邮件。

• 上次登录 IP：将当前登录 IP 地址与上次登录 IP 地址进行核对。
• 当前活动会话：如果用户具有来自同一 IP 地址的现有活动会话。请参阅活动会话。
• Cookie：登录成功后，浏览器中会存储一个加密的 cookie。此 cookie 设置为在最后一次成功登录后 14 天过期。

使用错误的双重身份验证码尝试登录的通知

引入于 15.5 版本。

如果极狐GitLab 检测到尝试使用错误的双重身份验证 (2FA) 码登录您的帐户，它会向您发送电子邮件通知。这可以帮助您检测到恶意攻击者获得了您的用户名和密码的访问权限，并试图暴力破解 2FA。

关于设计的通知

引入于 13.6 版本。

当有人对设计发表评论时，会向参与者发送电子邮件通知。

参与者是：

• 设计的作者（如果不同的作者上传了不同版本的设计，可以是多人）。
• 设计评论的作者。
• 在设计评论中提及的任何人。

选择退订所有电子邮件

如果您不再希望收到任何电子邮件通知：

1. 在右上角，选择您的头像。
2. 选择 偏好设置。
3. 在左侧边栏上，选择 通知。
4. 清除 接收产品营销电子邮件 复选框。
5. 将您的 全局通知级别 设置为 已禁用。
6. 清除 接收关于您自己活动的通知 复选框。
7. 如果您属于任何群组或项目，请将其通知设置为 全局 或 停用。

在自助管理安装中，即使在执行此操作后，您的实例管理员仍然可以向您发送电子邮件。 要取消订阅，请选择其中一封电子邮件中的取消订阅链接。

可用于过滤电子邮件的电子邮件标头

通知电子邮件消息包括特定的标头。为了更好地管理您的通知，您可以根据这些标头的内容过滤通知电子邮件。

例如，您可以过滤来自特定项目的所有电子邮件，在该项目中您被分配了合并请求或议题。

下表列出了所有特定的电子邮件标头：

X-GitLab-NotificationReason

X-GitLab-NotificationReason header 包含通知的原因。 该值是以下之一，按优先级排序：

• own_activity
• assigned
• mentioned

通知的原因也包含在通知电子邮件的页脚中。 例如，一封带有原因assigned的电子邮件在页脚中有这句话：

You are receiving this email because you have been assigned an item on <configured GitLab hostname>.

例如，警报通知电子邮件可以具有警报的状态之一：

• alert_triggered
• alert_acknowledged
• alert_resolved
• alert_ignored