偏好設定

偏好設定集中管理整個系統的品牌外觀、時間語系、登入安全與通知寄件等系統層級參數。這裡的設定一改就是全系統生效——包含前台登入頁、所有使用者的郵件介面、通知信，甚至主機端的顯示時間，因此建議由主要管理員統一維護，變更前先想清楚影響範圍。

什麼情況會來改這一頁：

• 公司要換品牌名稱、Logo 或登入頁背景圖
• 使用者反映「信件的時間不對」→ 檢查時區與 NTP
• 想加強登入安全，防止有人一直猜密碼 → 調整「登入保護」
• 郵件審核或召回通知信的連結點不開 → 檢查「通知信連結網域」
• 要讓外部系統用 API 管理帳號

頁面分成「伺服器設定」「安全設定」「通知設定」「API」四個分頁，調整後**一定要按最下方的「儲存設定」**才會寫入。有未儲存的變更就離開時，畫面會先問「有未儲存的變更，確定要關閉嗎？」。

伺服器設定

品牌與外觀

• 品牌名稱：顯示在登入頁與郵件通知中的系統名稱。最長 64 個字元；留空時會回到出廠值。範例：ACME 郵件伺服器
• 品牌動畫效果：開啟後側邊欄與登入頁的品牌名稱會有一道光線掃過的動畫。純視覺效果，不影響功能
• 品牌字型大小：品牌標誌的字體大小，單位 px。必填，可填 10～48，出廠預設 30。填太小在登入頁會看不清，填太大可能擠壓版面；建議 28～36
• 頁腳資訊：頁面最下方的版權或說明文字。最長 255 個字元；留空表示不顯示。範例：Copyright (c) 2026 ACME Corp.

登入背景圖

可上傳 JPEG、PNG、GIF、BMP、WEBP、AVIF 圖片。實際上限 5 MB（畫面上的說明文字建議「小於 500K」，是因為過大的圖會拖慢登入頁載入速度——功能上傳得動，但使用者要等，建議先自行壓縮）。右側縮圖會套用與登入頁相同的模糊效果，方便您預覽。

• 「選擇圖片」挑選新圖；「恢復預設」回到出廠背景圖（注意是恢復預設，不是把圖刪掉變空白）
• 背景圖模糊：登入頁背景的模糊程度，可選不模糊、極輕微、輕微、稍明顯、中度、明顯、強烈、極強（對應 0～40 的數值，出廠預設 4＝「輕微」）。背景圖太花時提高模糊可讓前景的登入表單更清楚

⚠️ 選圖或按「恢復預設」時，畫面只會標記為「待套用」，必須再按「儲存設定」才會真正寫入。儲存前登入頁完全不受影響——這是常見的誤會：「我明明換了圖，怎麼登入頁還是舊的？」

網站圖示 (favicon)

瀏覽器分頁上的小圖示。可上傳 PNG、JPG、SVG、ICO，實際上傳上限 2 MB；畫面建議使用 64×64 正方形（非正方形會被瀏覽器自動縮放，可能變形）。也可按「恢復預設」回到出廠圖示。與背景圖相同，選圖後必須按「儲存設定」才生效。

時間與語系

• 時區：系統時區。這一項影響範圍最大——主機時間、儀表板顯示、所有日誌與記錄的時間欄位、郵件記錄器的查詢結果都會跟著改變，主控台（tty1）的狀態畫面也會同步。出廠預設 Asia/Taipei。系統是既有伺服器在跑的話，變更時區會讓「切換前後的日誌時間」出現跳動，追查歷史事件時要留意
• 使用 UTC 時間：開啟後以 UTC 為系統時間基準。若您的維運團隊跨時區、或要與國際單位的日誌對齊，可考慮開啟
• NTP 伺服器：時間同步來源，可填多台，以分號或空白分隔（例：pool.ntp.org time.google.com）。留空時使用 pool.ntp.org，系統每小時自動對時一次。時間不準會連帶影響 SSL 憑證驗證、SPF/DKIM 簽章與日誌比對，建議保持啟用
• 系統預設語系：新建立的使用者與未登入頁面（例如登入頁）的預設語言。既有使用者若已自行選過語系，不受此設定影響
• 操作日誌欄位語系：操作日誌中「欄位名稱」要顯示哪種語言，三選一：
  • 程式欄位名（建議）：保留原始英文欄位名（如 user、action），方便用關鍵字搜尋與比對程式
  • 依操作者語系：依當時操作的管理員介面語言翻譯欄位名。缺點是不同語系的管理員操作後，同一份日誌會出現不同語言的欄位名
  • 固定指定語言：所有記錄固定用同一語言（繁中／簡中／英文）
• 顯示外部圖片：決定郵件檢視時是否自動載入外部（遠端）圖片。出廠為關閉：關閉時寄件者無法利用「圖片被讀取」來追蹤您何時看了信，較安全；若經常需要看含有遠端圖片的電子報，才考慮開啟。這是管理員的統一設定，使用者端沒有個人開關

安全設定

登入保護

登入保護用來限制短時間內連續失敗的登入嘗試，降低密碼被反覆猜測的風險。這裡的設定會直接改變登入頁的行為（安裝需求與安裝 / 登入管理介面）。出廠即為啟用狀態，以下是每個參數的預設值與可填範圍：

達到鎖定條件時，登入頁會顯示「嘗試次數過多，請 N 秒後再試」，N 會隨剩餘時間倒數。

範例：公司對外開放 Webmail，想擋住密碼暴力破解

建議維持出廠值即可（間隔 3 秒、每分鐘 5 次、鎖定 1 分鐘），因為這組值對正常使用者幾乎無感——正常人不會在 3 秒內連錯兩次。若您發現有人被鎖得很頻繁，先確認是不是使用者自己記錯密碼，再考慮把「失敗後間隔」降到 0 秒或把「每分鐘失敗上限」放寬到 10 次。反過來，若想更嚴格，可把「鎖定時間」拉到 5～10 分鐘。

⚠️ 注意：登入保護是綁 IP 的。若您的使用者都在同一個辦公室、透過同一條對外線路（同一個 NAT 出口 IP）上網，其中一人連續打錯密碼，其他人也可能一起被鎖。這種環境建議把「每分鐘失敗上限」放寬。

登入驗證碼

• 啟用登入驗證碼：啟用後每次登入都要輸入驗證碼。出廠為關閉（因為它對所有使用者都是額外負擔）
• 驗證碼長度：必填，3～10 個字元，預設 6
• 字體大小：必填，12～48，預設 32
• 包含字母：開啟為英數混合，關閉則為純數字。出廠為關閉（純數字，對使用者較好輸入）
• 驗證碼預覽：即時顯示目前參數產生的驗證碼；按圖或「重新整理」可換一組。改完參數記得先看預覽，確認在您常用的解析度下看得清楚

「登入保護」中由異常觸發的驗證碼不受這裡的開關影響。也就是說即使這一頁沒啟用驗證碼，只要有人連續失敗到達門檻，仍然會被要求輸入驗證碼——這是刻意的設計，用來對付自動化嘗試。

Console 存取密碼

系統若已設定主控台密碼，這裡會多出「清除 Console 密碼」選項。勾選並儲存後會移除主控台密碼保護，下次在主機螢幕（tty1）按 s 進入主控台就不需密碼（安裝需求與安裝 / 控制台設定）。

這是忘記主控台密碼時的救援管道——主控台密碼遺失時您進不去本機選單，但仍可從這裡（管理介面）清除。清除後任何能接觸機器的人都能進入主控台設定選單，建議處理完畢後儘快回到主控台重新設定密碼。

通知設定

系統在郵件審核、郵件召回、帳號防盜用等情況會寄發通知信，寄件者與信中的連結由這裡決定。

• 通知郵件地址：通知信的寄件者名稱與 Email。最長 128 字元，格式必須是 admin@example.com 或 管理員<admin@example.com>（名稱放在半形角括號內）。未設定時預設為 admin@本機名稱。格式不對時畫面顯示「通知郵件地址格式無效，請使用 admin@example.com 或 名稱admin@example.com 格式」

  • 建議填一個真實存在、且使用者會信任的位址，例如 郵件管理員<admin@yourcompany.com>。若填了一個不存在的位址，使用者回覆通知信時會退信

• 通知信連結網域：通知信內「返回伺服器功能頁面」的超連結網址。最長 255 字元。可填三種形式：

  • 網域名稱：mail.yourcompany.com
  • IP：192.0.2.10
  • 完整網址（含埠號）：https://mail.yourcompany.com:8443

  未設定時預設為 https://本機名稱。這一項填錯的症狀很明顯：使用者收到審核通知，但點連結打不開。 設定後建議自己實際走一次流程測試。若您的管理介面用非標準埠號，務必把埠號寫進去。

API

API 分頁讓外部系統以程式直接管理本機帳號，不需要登入後台。出廠全部為關閉。

• 啟用 API：主開關，開啟後才允許外部系統透過 API 管理本機帳號
• 連線來源：允許呼叫 API 的來源 IP，多個以逗點分隔。最長 255 字元。預設 127.0.0.1（僅本機）。除非有明確需求，否則不要填 any 或整個網段——API 能新增與刪除帳號，開放範圍越大風險越高
• 連線密碼：外部系統呼叫時須提供的口令。最長 64 字元。留空表示沿用目前已設定的密碼（不是清空）。⚠️ 未設定自訂連線密碼前 API 不生效，而預設值 api_password 是公開常數（放在產品說明文件中），非常容易被猜到，正式啟用前一定要改成自訂值
• 帳號操作權限：逐項勾選要開放的指令，出廠全部未勾：允許新增帳號、允許修改帳號、允許刪除帳號、允許驗證帳號密碼、允許檢查帳號存在、允許列出帳號。建議只勾真正需要的那幾項——例如外部系統只是要驗證密碼，就只勾「允許驗證帳號密碼」，不要勾刪除
• 「使用說明」按鈕會開啟 API 文件，內含啟用步驟、共通呼叫規則、範例程式與各指令的參數說明

範例：讓公司的人資系統自動開信箱

1. 「連線來源」填人資系統主機的 IP（例：192.0.2.50）
2. 「連線密碼」設一組長一點的自訂值（不要用 api_password）
3. 權限只勾「允許新增帳號」與「允許檢查帳號存在」
4. 儲存後，請人資系統依「使用說明」文件串接並先用測試帳號驗證
5. 驗證完成後，若人資系統不再需要，記得把「啟用 API」關掉

注意事項

• 這一頁多數設定儲存後立即對全系統生效，變更時區、語系、外部圖片等項目請避開使用尖峰
• 登入背景圖與網站圖示採「待套用」機制，選圖後務必按「儲存設定」，否則登入頁不會改變
• 通知信連結網域若填錯，使用者收到的審核／召回通知連結會失效，設定後建議實際測試一次
• 時區會影響儀表板與所有日誌顯示的時間，變更後請確認記錄時間符合預期
• 「登入保護」的鎖定是依來源 IP判定，同一出口 IP 的多位使用者會互相影響
• API 一旦啟用且權限開放，外部系統就能直接操作帳號，請定期檢視「連線來源」與已開放的權限清單
• 若不小心把主機時區或網路相關設定改到無法連線，仍可從主機主控台處理（安裝需求與安裝 / 控制台設定）