如何在 Thunderbird 中為 Gmail 設定 OAuth2 身份驗證

將 Gmail 連接到 Thunderbird 時，應該使用 Google 的登入介面，而不是儲存在郵件用戶端基本憑證中的密碼。 Thunderbird 將此稱為 OAuth；它基於 OAuth 2.0，這是一種登入方法，可讓 Google 驗證您的身分並向 Thunderbird 頒發存取權杖。此令牌可讓 Thunderbird 無需重複發送您的 Google 密碼即可同步郵件。

本教學遵循 Mozilla 針對 Thunderbird ESR 153 及每月更新的 Thunderbird 153 或更高版本的最新說明，文件更新於 2026 年 6 月 18 日。舊版可能會顯示不同的選單，或在 Thunderbird 標籤頁而非系統瀏覽器中開啟 Google 登入頁面。如果可以，請在開始之前更新 Thunderbird。 Google 也表示，自 2025 年 1 月起，個人 Gmail 帳戶已自動啟用 IMAP，因此這些帳戶無需手動啟用 IMAP 開關。

有關具體版本的官方詳細信息，請參閱Mozilla 的 Thunderbird 和 Gmail 指南以及Google 的將 Gmail 添加到其他電子郵件用戶端的說明。

開始之前

請準備好您的完整 Gmail 地址和 Google 帳戶密碼。您只需在 Google 登入頁面輸入密碼，無需在 Thunderbird 的「普通密碼」驗證欄位中輸入。如果您的帳戶啟用了兩步驟驗證，請同時準備好第二重驗證方式，例如手機提示或驗證碼。

OAuth 設定需要 Thunderbird 開啟 Google 登入流程。如果您使用了嚴格的隱私設置，請在 Thunderbird 中允許 Cookie，並確保您的瀏覽器可以存取 Google 帳戶。在工作或學校的 Google Workspace 帳戶中，管理員可能會限制第三方應用程式的存取權限；如果 Google 封鎖了 Thunderbird，請諮詢管理員帳戶原則是否允許連線。

使用 Google 登入將 Gmail 新增至 Thunderbird

開啟帳戶設定介面。在目前版本的 Thunderbird 中，開啟應用程式選單，選擇「新增帳戶」，然後選擇「電子郵件」。在其他版本中，該選項可能顯示為「帳戶設定」或「新帳戶」。選擇新增現有電子郵件帳號的選項。
輸入您的姓名和 Gmail 地址。請使用收件人看到的姓名和完整的 Gmail 地址，包括網域名稱。選擇“繼續”。 Thunderbird 應該會自動偵測 Google 的伺服器設定。如果它提供了 Google 帳戶類型或 OAuth 登入選項，請選擇該選項。
繼續在 Google 登入視窗中操作。 Thunderbird會開啟一個 Google 品牌的授權流程，在目前版本中通常會在您的預設系統瀏覽器中開啟。確認該頁面位於 Google 登入網域下，輸入您的 Gmail 地址和密碼，並完成任何兩步驟驗證提示。請勿將您的常規 Google 密碼貼到 Thunderbird 的通用密碼提示框中。
查看並授予存取權限。 Google將顯示 Thunderbird 想要存取的服務。查看請求的權限，僅當它們與您想要使用的帳戶功能相符時才繼續。根據您的設置，Google 可能會列出電子郵件，也可能列出日曆或聯絡人。批准返回 Thunderbird 的請求。
等待初始同步完成。 Thunderbird會開始下載郵件列表，並根據同步設定下載郵件內容。較大的郵箱可能需要一些時間才能完成同步。在首次同步期間，請保持 Thunderbird 開啟並連接網路。

OAuth 是身分驗證步驟；IMAP 和 SMTP 是 Thunderbird 用於收發郵件的協定。大多數用戶無需手動輸入伺服器詳細信息，因為 Thunderbird 會自動配置 Gmail。

如果自動設定不起作用

開啟「帳戶設定」，選擇 Gmail 帳戶，然後檢查接收郵件的伺服器設定。對於傳送郵件，請在帳戶設定中選擇「傳送伺服器 (SMTP)」，並編輯此 Gmail 帳戶所使用的伺服器。收發郵件的身份驗證都應使用 OAuth2。如果只將其中一方設定為 OAuth2，可能會導致收發郵件功能失效。

如果您必須查看連線詳情，Google 建議的安全設定如下：

聯繫	伺服器	港口和安全	驗證
傳入的 IMAP	imap.gmail.com	993，SSL/TLS	OAuth2
外發 SMTP	smtp.gmail.com	465，SSL/TLS；或 587，STARTTLS	OAuth2

請使用完整的 Gmail 位址作為 Thunderbird 和 Google 用戶端的使用者名稱。如果 Thunderbird 可以自動偵測 Google 設置，請優先使用此功能；手動輸入設定有助於診斷主機、連接埠、加密方法或驗證選項錯誤等問題。 Google 的說明頁面解釋了建議的 Gmail IMAP 行為以及第三方郵件用戶端的連線細節。

修復常見的 OAuth 登入問題

Thunderbird 一直要求輸入密碼

檢查傳入伺服器及其 SMTP 伺服器的驗證方法。如果其中任何一個設定為「普通密碼」，請將其變更為OAuth2，儲存設置，然後重新啟動 Thunderbird。只有當 Thunderbird 持續重複使用已儲存的過期 Gmail 憑證時，才刪除這些憑證；然後重新登入 Google。在配置為 OAuth2 的連線中輸入應用密碼無法解決憑證不符的問題。

Google 登入視窗無法開啟或完成

更新 Thunderbird，暫時檢查是否有瀏覽器擴充功能或安全性工具封鎖了授權頁面，並確認 Google 登入已啟用 Cookie。如果出現帳戶選擇器，請選擇您在 Thunderbird 中輸入的相同 Gmail 帳戶。如果 Google 傳回「存取被拒絕」訊息，下一步很可能是管理員原則檢查，而不是重複嘗試密碼。

郵件已接收，但發送失敗

請單獨驗證外發 SMTP 伺服器。它必須指向 Gmail 的 SMTP 伺服器，使用受支援的加密端口，並透過 OAuth2 和完整的 Gmail 位址進行身份驗證。請檢查所選的 SMTP 項目是否已實際指派給 Gmail 帳戶；在多帳戶 Thunderbird 設定檔中可以選擇不同的外寄伺服器。

收件匣看起來不完整或同步速度很慢。

即使資料夾同步仍在進行中或受設定限制，OAuth 身份驗證仍可能成功。 Gmail 標籤在 Thunderbird 中顯示為資料夾，因此可能需要訂閱或將缺少的標籤新增至同步清單。 Google 指出，同步非常大的資料夾可能會降低用戶端速度；如果首次下載的檔案異常大，請調整資料夾同步設定。這些都是郵件同步問題，不一定是登入失敗。

檢查設定是否完成

使用 Gmail 帳戶向您可查收的地址發送一封簡短的測試郵件，然後回覆該郵件。確認已傳送郵件出現在 Gmail 的「已傳送郵件」資料夾中，且回覆郵件已送達 Thunderbird。同時，驗證同步後，一個位置標記為已讀或已移動的郵件在另一個位置的狀態是否與預期一致。如果傳送或接收失敗，請在刪除帳戶之前重新檢查對應的 OAuth2 收發郵件設定。

OAuth 並不能保證本機免受攻擊：任何能夠存取您的 Thunderbird 個人資料的人都可能存取您帳戶中儲存的授權資料。請使用作業系統自帶的安全功能和鎖定螢幕保護您的裝置。 Google 建議支援的郵件用戶端使用「使用 Google 登入」；應用程式密碼是某些帳戶的可選備用方案，但 Google 表示在大多數情況下沒有必要，而且並非 Thunderbird 的首選設定。