注意: 手机版 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-recepient
和 X-GitHub-recipient-Address
标头。 这些标头显示预期的收件人。 根据您的电子邮件设置,您可能会收到预期发给其他用户的通知。
来自 GitHub Enterprise Server 的电子邮件通知包含以下标头信息:
标头 | 信息 |
---|---|
From 地址 | 此地址始终是 '网站管理员配置的无需回复电子邮件地址'。 |
To 字段 | 此字段直接连接到线程。 如果您回复电子邮件,将在对话中添加一个新的评论。 |
Cc 地址 | 如果您订阅了对话,GitHub Enterprise Server 将会 Cc 给您。 第二个 Cc 电子邮件地址与通知原因匹配。 这些通知原因的后缀是 基于站点管理员配置的无需回复电子邮件地址。 可能的通知原因包括:
|
mailing list 字段 | 此字段识别仓库名称及其所有者。 此地址的格式始终是 <仓库名称>.<仓库所有者>.[hostname] 。 |
X-GitHub-Severity 字段 | 影响一个或多个仓库的安全警报电子邮件通知包含 X-GitHub-Severity 标头字段。 您可以使用 X-GitHub-Severity 标头字段的值过滤安全警报的电子邮件通知。 可能的严重程度等级包括:
|
选择通知设置
- 在任何页面的右上角,单击 。
- 在左侧边栏中的仓库列表下,使用“Manage notifications(管理通知)”下拉按钮单击 Notification settings(通知设置)。
- 在通知设置页面上,选择在以下情况下如何接收通知:
自动关注
默认情况下,每当您获得新仓库的访问权限时,您将会自动开始关注该仓库。 每当您加入新团队时,您都会自动订阅更新,并在该团队被 @提及时收到通知。 如果不想自动订阅,您可以取消选择自动关注选项。
如果禁用了“Automatically watch repositories(自动关注仓库)”,您将不会自动关注自己拥有的仓库。 您必须导航到仓库页面,然后选择关注选项。
配置单个仓库的关注设置
您可以选择关注还是取消关注单个仓库。 您也可以选择接收新版本的通知,或者完全忽略单个仓库。
-
在 GitHub Enterprise Server 上,导航到仓库的主页面。
-
在右上角,单击“Watch(关注)”下拉菜单选择关注选项。
选择接收组织的电子邮件通知的位置
如果您属于某个组织,您可以选择要接收组织活动通知的电子邮件帐户。 例如,如果您属于某个工作组织,您可能希望通知发送到您的工作电子邮件地址,而不是您的个人地址。
只有在通知设置中选择了接收电子邮件通知时,才会收到通知电子邮件。
- 在任何页面的右上角,单击 。
- 在左侧边栏中的仓库列表下,使用“Manage notifications(管理通知)”下拉按钮单击 Notification settings(通知设置)。
- 在“Default notification email(默认通知电子邮件)”下,选择要接收通知的电子邮件地址。
- 单击 Save(保存)。
自定义每个组织的电子邮件路由
如果您是多个组织的成员,您可以配置每个组织发送通知任何您已添加到 GitHub Enterprise Server 帐户的电子邮件地址。
- 在任何页面的右上角,单击 。
- 在左侧边栏中的仓库列表下,使用“Manage notifications(管理通知)”下拉按钮单击 Notification settings(通知设置)。
- 在“Custom routing(自定义路由)”下,在列表中找到您组织的名称。
- 在要更改的电子邮件地址旁边单击 Edit(编辑)。
- 选择一个经验证电子邮件地址,然后单击 Save(保存)。
安全警报通知选项
您可以选择 您关注的仓库中安全警报通知的递送方式,以及您接收通知的频率。
默认情况下,如果站点管理员为您实例上的通知配置了电子邮件,您将收到安全警报:
- 通过电子邮件收到通知, 每次发现漏洞时都会发送电子邮件(每次发现漏洞时发送电子邮件选项)
- 在用户界面中,作为仓库文件和代码视图中的警告(UI 警报选项)
- 在命令行上接收通知,当您推送到具有漏洞的仓库时,警告将显示为回叫(命令行选项)
- 在收件箱中收到警报,作为 web 通知(Web 选项)
您可以自定义接收安全警报通知的方式。 例如,您可以使用 Email a digest summary of vulnerabilities(以电子邮件发送漏洞摘要)和 Weekly security email digest(每周安全性电子邮件摘要)选项通过电子邮件接收最多 10 个仓库的每周警报摘要。
有关您可以使用的通知递送方法的更多信息,以及关于优化通知的建议
安全警报通知干扰的信息,请参阅“配置漏洞依赖项的通知”。