GitLab Notification Emails · Gitlab 中文文檔

# GitLab Notification Emails > 原文：[https://docs.gitlab.com/ee/user/profile/notifications.html](https://docs.gitlab.com/ee/user/profile/notifications.html) * [Receiving notifications](#receiving-notifications) * [Tuning your notifications](#tuning-your-notifications) * [Editing notification settings](#editing-notification-settings) * [Global notification settings](#global-notification-settings) * [Notification scope](#notification-scope) * [Project notifications](#project-notifications) * [Group notifications](#group-notifications) * [Group notification level](#group-notification-level) * [Group notification email address](#group-notification-email-address) * [Notification levels](#notification-levels) * [Notification events](#notification-events) * [Issue / Epics / Merge request events](#issue--epics--merge-request-events) * [Filtering email](#filtering-email) * [X-GitLab-NotificationReason](#x-gitlab-notificationreason) # GitLab Notification Emails[](#gitlab-notification-emails "Permalink") GitLab 通知使您可以隨時了解 GitLab 中發生的事情. 啟用通知后，您可以接收有關問題，合并請求和史詩活動的更新. 通知通過電子郵件發送. ## Receiving notifications[](#receiving-notifications "Permalink") 您將由于以下原因之一收到通知： * 您參與發行，合并請求或史詩. 在這種情況下， *參與*意味著評論或編輯. * You enable notifications in an issue, merge request, or epic. To enable notifications, click the **Notifications** toggle in the sidebar to *on*. 啟用通知后，您將收到有關該問題，合并請求或史詩中發生的操作的通知. **注意：**通知可能會被管理員阻止，從而阻止發送通知. ## Tuning your notifications[](#tuning-your-notifications "Permalink") 通知的數量可能是巨大的. GitLab 允許您調整收到的通知. 例如，您可能希望收到有關特定項目中所有活動的通知，而對于其他項目，僅當您的名字被提及時才得到通知. 您可以通過組合通知設置來調整收到的通知： * [Global notification settings](#global-notification-settings) * [Notification scope](#notification-scope) * [Notification levels](#notification-levels) ### Editing notification settings[](#editing-notification-settings "Permalink") 編輯通知設置： 1. 點擊您的個人資料圖片，然后選擇**設置** . 2. 點擊左側邊欄中的**通知** . 3. 編輯所需的通知設置. 編輯的設置將自動保存并啟用. 這些通知設置僅適用于您. 它們不會影響同一項目或組中其他任何人收到的通知. [![notification settings](https://img.kancloud.cn/b7/01/b701322d25331100bc1e196dfbda3135_1966x1348.png)](img/notification_global_settings.png) ## Global notification settings[](#global-notification-settings "Permalink") **全局通知設置**是默認設置，除非您為項目或組選擇不同的值. * 通知電子郵件 * 這是您的通知將發送到的電子郵件地址. * 全局通知級別 * 這是適用于所有通知的默認[通知級別](#notification-levels) . * 接收有關您自己的活動的通知. * 如果您想接收有關自己活動的通知，請選中此復選框. 默認值：未選中. ### Notification scope[](#notification-scope "Permalink") 您可以通過為每個項目和組選擇不同的通知級別來調整通知的范圍. 通知范圍按優先級順序應用（從高到低）： * Project * 對于每個項目，您可以選擇一個通知級別. 您的項目設置將覆蓋組設置. * Group * 對于每個組，您可以選擇一個通知級別. 您的群組設置會覆蓋您的默認設置. * 全局（默認） * 如果尚未為發生活動的項目或組選擇通知級別，則將應用全局或*默認*通知級別. #### Project notifications[](#project-notifications "Permalink") 您可以為每個項目選擇一個通知級別. 如果您需要密切監視選定項目中的活動，這將很有用. [![notification settings](https://img.kancloud.cn/17/e5/17e58e5f7061828f8d01c19f58e05516_994x502.png)](img/notification_project_settings_v12_8.png) 要為項目選擇通知級別，請使用以下兩種方法之一： 1. 點擊您的個人資料圖片，然后選擇**設置** . 2. 點擊左側邊欄中的**通知** . 3. 在" **項目"**部分中找到該項目. 4. 選擇所需的[通知級別](#notification-levels) . Or: 1. 導航到項目頁面. 2. 單擊帶有下拉圖標的通知下拉列表. 3. 選擇所需的[通知級別](#notification-levels) . 有關如何在有新版本發布時通知的演示，請參閱[發布通知](https://www.youtube.com/watch?v=qyeNkGgqmH4) . #### Group notifications[](#group-notifications "Permalink") 您可以為每個組選擇通知級別和電子郵件地址. [![notification settings](https://img.kancloud.cn/04/d4/04d4a1140fdaf931caa499a5697ca2e4_999x519.png)](img/notification_group_settings_v12_8.png) ##### Group notification level[](#group-notification-level "Permalink") 要為組選擇通知級別，請使用以下兩種方法之一： 1. 點擊您的個人資料圖片，然后選擇**設置** . 2. 點擊左側邊欄中的**通知** . 3. 在" **組"**部分中找到該項目. 4. 選擇所需的[通知級別](#notification-levels) . * * * 1. 導航到組的頁面. 2. 單擊帶有下拉圖標的通知下拉列表. 3. 選擇所需的[通知級別](#notification-levels) . ##### Group notification email address[](#group-notification-email-address "Permalink") 在 GitLab 12.0 中引入您可以選擇一個電子郵件地址，以接收您所屬的每個組的通知. 例如，如果您是自由職業者，并且希望將有關客戶項目的電子郵件分開存放，這可能會很有用. 1. 點擊您的個人資料圖片，然后選擇**設置** . 2. 點擊左側邊欄中的**通知** . 3. 在" **組"**部分中找到該項目. 4. 選擇所需的電子郵件地址. ### Notification levels[](#notification-levels "Permalink") 對于每個項目和組，您可以選擇以下級別之一： | Level | Description | | --- | --- | | Global | 您的全局設置適用. | | Watch | 接收任何活動的通知. | | 提一下 | `@mentioned`在評論中`@mentioned`接收通知. | | Participate | 接收有關您參與的線程的通知. | | Disabled | 關閉通知. | | Custom | 接收有關自定義選定事件的通知. | ## Notification events[](#notification-events "Permalink") 將通知用戶以下事件： | Event | 發給 | 設定等級 | | --- | --- | --- | | 添加了新的 SSH 密鑰 | User | 安全電子郵件，始終發送. | | 添加了新電子郵件 | User | 安全電子郵件，始終發送. | | 電郵已變更 | User | 安全電子郵件，始終發送. | | 密碼已更改 | User | 安全電子郵件，始終發送. | | 新用戶創建 | User | 在創建用戶時發送，但 OmniAuth（LDAP）除外 | | 用戶已添加到項目 | User | 將用戶添加到項目時發送 | | 項目訪問權限級別已更改 | User | 更改用戶項目訪問級別時發送 | | 用戶已添加到組 | User | 將用戶添加到組時發送 | | 群組訪問權限級別已更改 | User | 更改用戶組訪問級別時發送 | | 項目已移 | 項目成員（1） | （1）不禁用 | | 新品發布 | 項目成員 | 自定義通知 | ## Issue / Epics / Merge request events[](#issue--epics--merge-request-events "Permalink") 在以下大多數情況下，通知將發送到： * Participants: * 發行/合并請求的作者和受讓人 * 關于問題/合并請求的評論的作者 * `@username`在問題，合并請求或史詩的標題或描述中提到的任何人 * `@username`在有關問題，合并請求或史詩的任何評論中提及的"參與"或更高通知級別的任何人 * 觀察者：通知級別為"觀察"的用戶 * 訂閱者：手動訂閱問題，合并請求或史詩的任何人 * 自定義：通知級別為"自定義"的用戶針對下表中顯示的任何事件打開了通知 **注意：**為了最大程度地減少不需要任何操作的通知的數量，從[GitLab 12.9 起](https://gitlab.com/gitlab-org/gitlab/-/issues/616) ，不再為項目中的所有活動通知合格的批準者. 要接收它們，他們必須將其用戶通知設置更改為" **觀看"** . | Event | 發給 | | --- | --- | | 新問題 | ? | | 結束期 | ? | | 重新分配問題 | 以上，加上舊的受讓人 | | 重新打開問題 | ? | | 到期問題 | 選擇此事件的參與者和自定義通知級別 | | 更改里程碑問題 | 選擇了此事件的訂戶，提及的參與者和自定義通知級別 | | 消除里程碑問題 | 選擇了此事件的訂戶，提及的參與者和自定義通知級別 | | 新合并請求 | ? | | 推送合并請求 | 選擇此事件的參與者和自定義通知級別 | | 重新分配合并請求 | 以上，加上舊的受讓人 | | 關閉合并請求 | ? | | 重新打開合并請求 | ? | | 合并合并請求 | ? | | 更改里程碑合并請求 | 選擇了此事件的訂戶，提及的參與者和自定義通知級別 | | 刪除里程碑合并請求 | 選擇了此事件的訂戶，提及的參與者和自定義通知級別 | | 新評論 | 以上內容，加上評論中`@username`提及的任何人，通知級別為"提及"或更高 | | 管道失敗 | 管道的作者 | | 固定管道 | 管道的作者. 默認啟用. 在 GitLab 13.1 中[引入](https://gitlab.com/gitlab-org/gitlab/-/issues/24309) . 管理員可以使用`ci_pipeline_fixed_notifications` [功能標記](../../administration/feature_flags.html)禁用此通知選項. | | 成功的管道 | 管道的作者（如果他們具有成功管道的自定義通知設置）. 如果管道先前失敗，則將為失敗后的第一個成功管道發送`Fixed pipeline`消息，然后為任何進一步成功的管道發送`Successful pipeline`消息. | | 新史詩 | ? | | 接近史詩 | ? | | 重新開啟史詩 | ? | 此外，如果發布或合并請求的標題或描述發生了更改，則通知將通過`@username`發送到任何**新**提及的內容，就像在原始文本中提到的一樣. 您不會收到有關您自己創建的問題，合并請求或里程碑的通知（除非由于問題而定）. 僅當其他人對您創建或提及的內容進行評論或添加更改時，您才會收到自動通知. 如果開放的合并請求由于沖突而變得不可合并，則將通知其原因. 如果用戶還將合并請求設置為一旦管道成功就自動合并，則該用戶也會收到通知. ## Filtering email[](#filtering-email "Permalink") 通知電子郵件包括特定于 GitLab 的標題. 您可以根據這些標頭的內容過濾通知電子郵件，以更好地管理您的通知. 例如，您可以過濾特定項目的所有電子郵件，在該項目中您將被分配合并請求或問題. 下表列出了所有特定于 GitLab 的電子郵件標題： | Header | Description | | --- | --- | | `X-GitLab-Group-Id` | 組的 ID. 僅在史詩的通知電子郵件中顯示. | | `X-GitLab-Group-Path` | 組的路徑. 僅在史詩的通知電子郵件中顯示. | | `X-GitLab-Project` | 通知所屬的項目的名稱. | | `X-GitLab-Project-Id` | 項目的 ID. | | `X-GitLab-Project-Path` | 項目的路徑. | | `X-GitLab-(Resource)-ID` | 通知所針對的資源的 ID. 該資源例如可以是`Issue` ， `MergeRequest` ， `Commit`或其他此類資源. | | `X-GitLab-Discussion-ID` | 注釋所屬的線程的 ID，用于注釋的通知電子郵件中. | | `X-GitLab-Pipeline-Id` | 通知所針對的管道的 ID，在管道的通知電子郵件中. | | `X-GitLab-Reply-Key` | 支持通過電子郵件回復的唯一令牌. | | `X-GitLab-NotificationReason` | 通知原因. 可以`mentioned` ， `assigned`或`own_activity` . | | `List-Id` | The path of the project in an RFC 2919 mailing list identifier. This is useful for email organization with filters, for example. | ### X-GitLab-NotificationReason[](#x-gitlab-notificationreason "Permalink") `X-GitLab-NotificationReason`標頭包含`X-GitLab-NotificationReason`的原因. 該值是按優先級順序的以下值之一： * `own_activity` * `assigned` * `mentioned` 通知的原因也包含在通知電子郵件的頁腳中. 例如有原因的電子郵件`assigned`都會有這句話的注腳： * `You are receiving this email because you have been assigned an item on <configured GitLab hostname>.` **注意：**正在考慮將其他事件的通知包含在`X-GitLab-NotificationReason`標頭中. 有關詳細信息，請參見此[相關問題](https://gitlab.com/gitlab-org/gitlab/-/issues/20689) .