GitLab 邮件通知配置完全指南

GitLab 邮件通知配置完全指南

gitlabhq GitLab CE Mirror | Please open new issues in our issue tracker on GitLab.com 项目地址: https://gitcode.com/gh_mirrors/gi/gitlabhq

前言

作为企业级代码托管和协作平台，GitLab 提供了丰富的邮件通知功能。本文将详细介绍如何配置 GitLab 实例中的各类邮件通知设置，帮助管理员根据企业需求定制邮件通知内容、格式和接收规则。

邮件自定义基础配置

自定义邮件LOGO

GitLab 允许管理员自定义邮件中的LOGO显示：

1. 该LOGO会出现在部分系统邮件的顶部
2. 修改方法与主页按钮LOGO相同
3. 建议使用清晰度高且尺寸合适的图片

多格式邮件支持

GitLab 支持两种邮件格式发送：

• 纯文本格式：简洁无格式的文本邮件
• 多格式(HTML+纯文本)：包含格式化的HTML内容和纯文本备用

启用多格式邮件步骤：

1. 进入管理区域 → 设置 → 偏好设置
2. 展开"Email"部分
3. 勾选"Enable multipart email"选项
4. 保存更改

高级邮件内容定制

显示作者信息

默认情况下，GitLab 会使用问题/合并请求/评论作者的邮箱作为发件人地址。管理员可以配置在邮件正文中显示作者信息：

1. 进入管理区域 → 设置 → 偏好设置
2. 展开"Email"部分
3. 勾选"Include author name in email notification email body"
4. 保存更改

应用场景：当企业使用统一发件邮箱时，仍可在邮件内容中识别实际作者。

自定义附加文本

企业可能因合规或法律要求需要在所有系统邮件底部添加固定文本：

1. 进入管理区域 → 设置 → 偏好设置
2. 展开"Email"部分
3. 在"Additional text"字段输入需要添加的内容
4. 保存更改

典型用途：

• 法律免责声明
• 企业联系信息
• 数据保护声明

私有提交邮箱配置

GitLab 提供私有提交邮箱功能，保护用户真实邮箱不被公开：

1. 默认格式：users.noreply.YOUR_CONFIGURED_HOSTNAME
2. 可自定义主机名部分

配置步骤：

1. 进入管理区域 → 设置 → 偏好设置
2. 展开"Email"部分
3. 在"Custom hostname (for private commit emails)"字段输入新主机名
4. 保存更改

重要注意事项：

• 修改后，之前使用旧主机名的私有提交邮箱将不再被识别
• 可能影响推送规则检查，如"检查作者是否为GitLab用户"

账户管理相关邮件

用户停用通知

当用户账户被停用时，系统会发送通知邮件。管理员可禁用此功能：

1. 进入管理区域 → 设置 → 偏好设置
2. 展开"Email"部分
3. 取消勾选"Enable user deactivation emails"
4. 保存更改

停用邮件附加文本

从GitLab 15.9开始，可专门为账户停用邮件设置附加文本：

1. 进入管理区域 → 设置 → 偏好设置
2. 展开"Email"部分
3. 在"Additional text for deactivation email"字段输入内容
4. 保存更改

与通用附加文本区别：

• 仅出现在账户停用邮件中
• 可包含账户恢复指引等特定内容

访问令牌到期通知

从GitLab 17.7开始，可配置将组和项目访问令牌到期通知发送给继承成员：

接收范围选项：

1. 仅直接成员（传统行为）
2. 所有直接和继承成员（新功能）

配置步骤：

1. 进入管理区域 → 设置 → 偏好设置
2. 展开"Email"部分
3. 选择"All direct and inherited members of the group or project"
4. 勾选"Enforce this setting for all groups on this instance"以全局应用
5. 保存更改

继承成员范围：

• 对于组：继承Owner角色的成员
• 对于项目：继承Owner或Maintainer角色的项目成员

最佳实践建议

1. 企业品牌一致性：建议自定义邮件LOGO以保持品牌统一
2. 合规性考虑：附加文本功能可帮助企业满足各类合规要求
3. 安全通知：谨慎考虑是否禁用账户停用通知
4. 测试验证：重要配置更改后，建议发送测试邮件验证效果
5. 变更影响评估：特别是修改私有提交邮箱主机名时，需评估对现有提交的影响

通过合理配置这些邮件设置，企业可以使GitLab的通知系统更好地符合内部流程和外部合规要求，同时提升用户体验。

gitlabhq GitLab CE Mirror | Please open new issues in our issue tracker on GitLab.com 项目地址: https://gitcode.com/gh_mirrors/gi/gitlabhq