此版本的 GitHub Enterprise 已停止服务 2021-06-09. 即使针对重大安全问题,也不会发布补丁。 要获得更好的性能、改进的安全性和新功能,请升级到 GitHub Enterprise 的最新版本。 如需升级方面的帮助,请联系 GitHub Enterprise 支持

配置通知

选择 GitHub Enterprise Server 上您想要接收其通知的活动类型以及您希望如何发送这些更新。

注意: 手机版 GitHub 目前正在测试用于 GitHub Enterprise Server 3.0,可能会有变化。

通知递送选项

您可以在以下位置的 GitHub Enterprise Server 上接收活动的通知。

  • GitHub Enterprise Server Web 界面
  • 使用经验证电子邮件地址的电子邮件客户端,也可以与 GitHub Enterprise Server 上的通知收件箱同步

提示:如果您同时接收 Web 和电子邮件通知,您可以自动同步通知的已读或未读状态,以便在您阅读相应的电子邮件通知后,Web 通知自动标记为已读。 要启用此同步,您的电子邮件客户端必须能够查看来自 无需回复电子邮件地址 您的 您的 GitHub Enterprise Server 实例(您的站点管理员可以配置)的图像。

通知收件箱的优点

GitHub Enterprise Server 上的通知收件箱包含专为您的 GitHub Enterprise Server 通知流程设计的分类选项,包括:

  • 一次对多种通知进行分类。
  • 将已完成的通知标记为完成并从收件箱中删除它们。 要查看标记为完成的所有通知,请使用 is:done 查询。
  • 保存通知以供以后查看。 保存的通知将在收件箱中标记并无限期保留。 要查看所有已保存的通知,请使用 is:saved 查询。
  • 取消订阅并从收件箱中删除通知。
  • 从通知收件箱预览 GitHub Enterprise Server 上产生通知的议题、拉取请求或团队讨论。
  • 使用 reasons 标签查看收件箱中收到通知的最新原因之一。
  • 创建自定义过滤器,以便按需要关注不同的通知。
  • 按仓库或日期对收件箱中的通知进行分组,以快速概览通知,减少上下文切换

对通知使用电子邮件客户端的优点

使用电子邮件客户端的一个好处是,可以无限期地保留所有通知,具体取决于电子邮件客户端的存储容量。 收件箱通知仅保留 5 个月,除非您将它们标记为 Saved(已保存)Saved(已保存)通知将无限期保留。 有关收件箱保留政策的更多信息,请参阅“关于通知”。

向电子邮件客户端发送通知还允许您根据电子邮件客户端的设置(可以包括自定义或颜色编码的标签)自定义收件箱。

电子邮件通知还允许您灵活地设置收到的通知类型,并允许您选择不同的电子邮件地址进行更新。 例如,您可以向经验证的个人电子邮件地址发送仓库的某些通知。 有关电子邮件自定义选项的更多信息,请参阅“自定义电子邮件通知”。

关于参与和查看通知

关注仓库,意味着订阅该仓库中的活动更新。 同样,关注特定团队的讨论,意味着订阅该团队页面上的所有对话更新。 更多信息请参阅“关于团队讨论”。

要查看您关注的仓库,请参阅关注页面。 更多信息请参阅“在 GitHub 上管理订阅和通知”。

配置通知

您可以在仓库页面上或关注页面上为仓库配置通知。 您可以选择仅接收仓库中发布的通知,或忽略仓库的所有通知。 更多信息请参阅下面的“配置单个仓库的关注设置”。

参与对话

每当您在对话中发表评论或有人 @提及您的用户名时,您都在参与对话。 默认情况下,当您参与对话时,会自动订阅该对话。 您可以通过单击议题或拉取请求上的 Unsubscribe(取消订阅)或通过通知收件箱中的 Unsubscribe(取消订阅)选项,手动取消订阅已参与的对话。

对于您关注或参与的对话,您可以选择是通过电子邮件还是 GitHub Enterprise Server 上的收件箱接收通知。

参与和关注通知选项

例如:

  • 如果您不希望将通知发送到您的电子邮件地址,请取消选中 email(电子邮件)以便参与和查看通知。
  • 如果您希望在参与对话时通过电子邮件接收通知,则可以选中“Participating(参与)”下的 email(电子邮件)

如果您未对 Web 启用关注或参与通知,则您的通知收件箱不会收到任何更新。

自定义电子邮件通知

在启用电子邮件通知后,GitHub Enterprise Server 将以多部分电子邮件向您发送通知,其中包含内容的 HTML 和明文副本。 电子邮件通知内容包含出现在 GitHub Enterprise Server 上的原始内容中的任何 Markdown、@提及、表情符号、哈希链接等。 如果您只想查看电子邮件中的文本,可以配置电子邮件客户端只显示明文副本。

:如果在 您的 GitHub Enterprise Server 实例 上启用了出站电子邮件支持,您将只收到邮件通知。 更多信息请联系站点管理员。

提示:如果您同时接收 Web 和电子邮件通知,您可以自动同步通知的已读或未读状态,以便在您阅读相应的电子邮件通知后,Web 通知自动标记为已读。 要启用此同步,您的电子邮件客户端必须能够查看来自 无需回复电子邮件地址 您的 您的 GitHub Enterprise Server 实例(您的站点管理员可以配置)的图像。

选择一个默认电子邮件地址,用于发送您参与或关注的对话的更新。 您还可以指定希望使用默认电子邮件地址接收 GitHub Enterprise Server 上哪些活动的更新。 例如,选择您的默认电子邮件地址是否要接收以下更新:

  • 对问题和拉取请求的评论。
  • 拉取请求审查.
  • 拉取请求推送。
  • 您自己的更新,例如当您打开、评论或关闭议题或拉取请求时。

您还可以向不同电子邮件地址发送通知,具体取决于拥有仓库的组织。 您的组织可能要求验证特定域的电子邮件地址。 更多信息请参阅“选择接收组织的电子邮件通知的位置”。

您也可以将特定仓库的通知发送到电子邮件地址。 更多信息请参阅“关于推送到仓库的电子邮件通知。”

只有在通知设置中选择了接收电子邮件通知时,才会收到通知电子邮件。

过滤电子邮件通知

GitHub Enterprise Server 发送的每封电子邮件通知都包含标头信息。 每封电子邮件的标头信息都是一致的,因此可用于电子邮件客户端中过滤或转发所有 GitHub Enterprise Server 通知,或特定类型的 GitHub Enterprise Server 通知。

如果您认为收到的通知不属于您,请检查 X-GitHub-recepientX-GitHub-recipient-Address 标头。 这些标头显示预期的收件人。 根据您的电子邮件设置,您可能会收到预期发给其他用户的通知。

来自 GitHub Enterprise Server 的电子邮件通知包含以下标头信息:

标头信息
From 地址此地址始终是 '网站管理员配置的无需回复电子邮件地址'。
To 字段此字段直接连接到线程。 如果您回复电子邮件,将在对话中添加一个新的评论。
Cc 地址如果您订阅了对话,GitHub Enterprise Server 将会 Cc 给您。 第二个 Cc 电子邮件地址与通知原因匹配。 这些通知原因的后缀是 基于站点管理员配置的无需回复电子邮件地址。 可能的通知原因包括:
  • assign:您被分配到议题或拉取请求。
  • author:您创建了议题或拉取请求。
  • comment:您评论了议题或拉取请求。
  • manual:您手动订阅的议题或拉取请求有更新。
  • mention:您提及了议题或拉取请求。
  • push:有人提交了您订阅的拉取请求。
  • review_requested:您或您所在的团队已请求审查拉取请求。
  • security_alert:GitHub 检测到您要接收其漏洞警报的仓库中存在漏洞。
  • state_change:您订阅的议题或拉取请求已关闭或打开。
  • subscribed:您查看的仓库有更新。
  • team_mention:您所属的团队在议题或拉取请求中被提及。
  • your_activity:您打开、评论或关闭了议题或拉取请求。
mailing list 字段此字段识别仓库名称及其所有者。 此地址的格式始终是 <仓库名称>.<仓库所有者>.[hostname]
X-GitHub-Severity 字段影响一个或多个仓库的安全警报电子邮件通知包含 X-GitHub-Severity 标头字段。 您可以使用 X-GitHub-Severity 标头字段的值过滤安全警报的电子邮件通知。 可能的严重程度等级包括:
  • 严重
更多信息请参阅“关于易受攻击的依赖项的警报”。

选择通知设置

  1. 在任何页面的右上角,单击 表示任何未读消息的通知
  2. 在左侧边栏中的仓库列表下,使用“Manage notifications(管理通知)”下拉按钮单击 Notification settings(通知设置)管理通知下拉菜单选项
  3. 在通知设置页面上,选择在以下情况下如何接收通知:
    • 在您关注的仓库或团队讨论或参与的对话中发生了更新。 更多信息请参阅“关于参与和关注通知”。
    • 您获得了新仓库的访问权限或加入了新团队。 更多信息请参阅“自动关注”。
    • 您的仓库中有新的安全警报。 更多信息请参阅“安全警报通知选项”。

自动关注

默认情况下,每当您获得新仓库的访问权限时,您将会自动开始关注该仓库。 每当您加入新团队时,您都会自动订阅更新,并在该团队被 @提及时收到通知。 如果不想自动订阅,您可以取消选择自动关注选项。

自动关注选项

如果禁用了“Automatically watch repositories(自动关注仓库)”,您将不会自动关注自己拥有的仓库。 您必须导航到仓库页面,然后选择关注选项。

配置单个仓库的关注设置

您可以选择关注还是取消关注单个仓库。 您也可以选择接收新版本的通知,或者完全忽略单个仓库。

  1. 在 GitHub Enterprise Server 上,导航到仓库的主页面。

  2. 在右上角,单击“Watch(关注)”下拉菜单选择关注选项。

    仓库下拉菜单中的关注选项

选择接收组织的电子邮件通知的位置

如果您属于某个组织,您可以选择要接收组织活动通知的电子邮件帐户。 例如,如果您属于某个工作组织,您可能希望通知发送到您的工作电子邮件地址,而不是您的个人地址。

只有在通知设置中选择了接收电子邮件通知时,才会收到通知电子邮件。

  1. 在任何页面的右上角,单击 表示任何未读消息的通知
  2. 在左侧边栏中的仓库列表下,使用“Manage notifications(管理通知)”下拉按钮单击 Notification settings(通知设置)管理通知下拉菜单选项
  3. 在“Default notification email(默认通知电子邮件)”下,选择要接收通知的电子邮件地址。
    默认通知电子邮件地址下拉菜单
  4. 单击 Save(保存)

自定义每个组织的电子邮件路由

如果您是多个组织的成员,您可以配置每个组织发送通知任何您已添加到 GitHub Enterprise Server 帐户的电子邮件地址。

  1. 在任何页面的右上角,单击 表示任何未读消息的通知
  2. 在左侧边栏中的仓库列表下,使用“Manage notifications(管理通知)”下拉按钮单击 Notification settings(通知设置)管理通知下拉菜单选项
  3. 在“Custom routing(自定义路由)”下,在列表中找到您组织的名称。
    组织和电子邮件地址列表
  4. 在要更改的电子邮件地址旁边单击 Edit(编辑)编辑组织的电子邮件地址
  5. 选择一个经验证电子邮件地址,然后单击 Save(保存)
    切换每个组织的电子邮件地址

安全警报通知选项

您可以选择 您关注的仓库中安全警报通知的递送方式,以及您接收通知的频率。

默认情况下,如果站点管理员为您实例上的通知配置了电子邮件,您将收到安全警报:

  • 通过电子邮件收到通知, 每次发现漏洞时都会发送电子邮件(每次发现漏洞时发送电子邮件选项)
  • 在用户界面中,作为仓库文件和代码视图中的警告(UI 警报选项)
  • 在命令行上接收通知,当您推送到具有漏洞的仓库时,警告将显示为回叫(命令行选项)
  • 在收件箱中收到警报,作为 web 通知(Web 选项)

您可以自定义接收安全警报通知的方式。 例如,您可以使用 Email a digest summary of vulnerabilities(以电子邮件发送漏洞摘要)Weekly security email digest(每周安全性电子邮件摘要)选项通过电子邮件接收最多 10 个仓库的每周警报摘要。

有关您可以使用的通知递送方法的更多信息,以及关于优化通知的建议

安全警报通知干扰的信息,请参阅“配置漏洞依赖项的通知”。