POP/IMAP日誌

這一頁記錄使用者郵件軟體與本機之間的 POP3／IMAP 代理連線，以及 SMTP 認證的過程。MailVSR-GW 站在真實郵件伺服器前方，使用者的 Outlook、手機郵件 App 連進來時，是由本機代為驗證帳密、再把連線轉到後端的信箱伺服器；這一頁就是這條路徑的紀錄。

當使用者說「Outlook 一直跳出要密碼」、「手機收不到信」、「登入信箱失敗」，或您要確認代理到後端的連線是否正常時，就來這一頁。

什麼時候會用到這一頁：

• 使用者反映郵件軟體無法登入、或反覆要求輸入密碼
• 要確認某個帳號的認證是成功還是失敗
• 懷疑有人在大量嘗試猜測信箱密碼
• 要確認本機與後端信箱伺服器之間的代理連線是否正常
• 調整代理或認證相關設定後，確認實際連線行為

頁面組成

頁面分成三個頁籤：

• 記錄：選日誌項目 → 選檔案 → 瀏覽內容
• 設定：這組日誌共用的輪替設定
• 空間使用：日誌檔（含輪替檔與壓縮檔）的空間占用

日誌項目與檔案

第一層「日誌項目」有兩個選項：

選定項目後，第二層「日誌檔案」列出該項目的輪替檔（新→舊），每個檔名後面標示最後修改時間。

⚠️ 這一頁在 MailVSR-GW 與 MailVSR-MS 是不同的日誌。MS 版讀的是本機信箱服務（Dovecot）的日誌；GW 沒有本機信箱，所以讀的是自己的代理日誌。若您同時操作兩個產品，請不要混淆。

記錄頁籤：查詢與閱讀

• 搜尋框：全文檢索日誌內容，輸入即時生效
• 搜尋語法：字A,字B＝任一命中（OR）；字A+字B＝兩個都要命中（AND）；其他寫法當成單一字串。+ 與 , 混用不會被拆解，會整串比對
• 比對不分大小寫；.gz 輪替檔會自動解壓後搜尋
• 欄位：只有「日誌內容」一欄，可點標題切換排序方向
• 預設排序：內容由大到小（最新在上面）；每頁 50 筆
• 沒有資料時顯示「暫無 IMAP 日誌資料」

排查時的實用關鍵字：

• 帳號（例如 jerry@yourcompany.com）：追單一使用者的連線與認證
• auth／login／password：認證相關訊息
• fail／failed／denied：失敗的連線或認證
• upstream／backend／connect：本機與後端伺服器之間的連線狀況
• timeout：連線逾時（對方無回應或網路不通）
• 來源 IP：追某個來源的所有嘗試

判讀重點：代理日誌會同時出現「使用者 → 本機」與「本機 → 後端」兩段。使用者抱怨無法登入時，先確認是哪一段失敗：

• 使用者 → 本機失敗：帳密錯誤、或政策擋下（認證失敗通常會伴隨錯誤訊息）
• 本機 → 後端失敗：後端伺服器無回應、連線逾時、後端拒絕本機（此時本機設定沒錯，問題在後端）

匯出與刪除

• 匯出：下載該檔完整內容（不受畫面搜尋與分頁影響），檔名自動加時間戳；系統以 root 讀取，權限受限的日誌檔也匯得出來
• 刪除：活檔（檔名與日誌項目完全相同）→ 只清空內容、保留檔案，確認視窗顯示「此為目前正在寫入的日誌，刪除將僅清空其內容（檔案保留）。確定要清空「:file」嗎？」；輪替檔（.1／.2.gz）→ 真正刪除，確認視窗顯示「確定要刪除日誌檔案「:file」嗎？」
• 成功訊息為「日誌檔案「:file」內容已清空」或「日誌檔案「:file」已刪除」
• 失敗訊息為「刪除日誌檔案失敗」、「刪除日誌檔案失敗：檔案無法刪除（權限或檔案屬性限制）」、「清空日誌檔案失敗：檔案無法寫入（權限或檔案屬性限制）」

清空活檔後系統會通知寫入該檔的服務重新開啟檔案。本頁沒有「不可刪除」的保護檔。

設定頁籤：輪替設定

• 記錄週期：每週（預設）或每天
• 保留天數／保留週數：可填 1–400，出廠預設保留 8 週（欄位名稱依週期切換為天／週）
• 單檔大小上限：可填 1–200 MB，出廠預設 50 MB
• 壓縮 rotate 檔：預設開啟

按「儲存設定」，成功顯示「logrotate 設定已儲存」，失敗顯示「logrotate 設定儲存失敗」。

⚠️ 這一組的輪替設定有一個特別之處：它所處的目錄權限較嚴，若輪替後沒有自動建立新檔，寫入端將無法自行建立，認證紀錄會退回系統日誌（也就是跑到（系統日誌 / 操作日誌）裡去），讓您誤以為「這一頁沒有紀錄」。系統在寫入設定時已自動處理這個細節（以正確的擁有者建立新檔），因此不建議手動編輯伺服器上的輪替設定檔；要調整請一律透過這個頁面儲存。

空間使用頁籤

列出這組日誌檔（含輪替檔與壓縮檔）的「檔案名稱／最後修改／空間占用」，最後顯示「總計（N 個檔案）」，依時間新到舊。沒有檔案顯示「目前沒有日誌檔。」；讀取失敗顯示「讀取失敗」。

⚠️ 這一頁的空間使用會比「記錄」頁籤多列一支檔案：除了 mailproxy.log 與 gwauth.log，這組輪替設定還包含一支由應用程式寫入的認證紀錄檔（位於同一個目錄）。它同樣會被輪替與統計，但不會出現在「記錄」頁籤的項目選單中——看到多一支檔案是正常的，不是異常。

這一頁的用途是判斷代理與認證的紀錄量：若 mailproxy.log 異常肥大，通常代表連線量很大或有大量重試；若認證紀錄檔快速成長，可能有人在持續嘗試登入，請一併看（系統日誌 / 阻斷記錄）。

常見情境與判讀

• 「Outlook 一直跳要密碼」：用該帳號搜尋，看認證是成功還是失敗。若持續失敗但使用者堅持密碼正確，請確認他的軟體是否使用完整 Email 當帳號（本機的帳號識別就是完整 Email）
• 「手機可以收、電腦不行」：比對兩者的連線紀錄，通常是軟體的加密或連接埠設定不同，而非帳號問題
• 「所有人都突然不能收信」：看代理日誌中「本機 → 後端」那一段是否大量失敗或逾時；若是，問題在後端伺服器或兩者之間的網路，不在本機設定
• 「有人在猜密碼」：搜尋失敗訊息並統計來源 IP；搭配（防火牆設定 / 自動防禦設定）確認是否已納入自動封鎖
• 「這一頁完全沒有紀錄」：先確認使用者是否真的透過本機連線（有些軟體可能被設定成直連後端）；再確認「空間使用」頁籤是否有檔案（若有檔案卻沒有紀錄可選，請參考上面關於輪替建立的說明）

注意事項

• 日誌內容是歷史紀錄，這一頁只讀不寫（唯一的例外是「設定」頁籤的輪替參數）
• 這一頁記錄的是代理層的行為；後端信箱伺服器內部的收信與投遞結果，本機看不到
• 認證成功的紀錄不等於「信件已收下」——郵件內容的傳輸細節在後端，本頁只看得到連線與認證
• GW 沒有本機信箱，這一頁不會出現本機投遞（lmtp）的訊息，這是產品定位的差異，不是功能缺漏
• 相關頁面：（郵件閘道 / 用戶管理）看帳號清單與最後登入時間、（郵件閘道 / LDAP伺服器設定）看通訊錄後端服務、（系統日誌 / SMTP日誌）看郵件本身的收送過程