{"repo":"banana2556/hme-manager","free":true,"listed":false,"github":"https://github.com/banana2556/hme-manager","clone":"git clone https://github.com/banana2556/hme-manager.git","description":"zero-dependency, self-hosted web dashboard and HTTP API service for managing Apple's iCloud \"Hide My Email\" (HME) aliases.","language":"Python","stars":35,"topics":[],"license":"MIT","category":"self-hosted-apps","readme_excerpt":"HME Manager 零相依、自架的 iCloud「隱藏我的電子郵件」管理後台與 HTTP API。 功能 - 管理「隱藏我的電子郵件」信箱：建立、列出、停用、啟用、刪除與 CSV 匯出。 - 收件匣讀信 ：用同一份 Session 直接讀 iCloud 網頁郵件（資料夾、清單、內容），自動偵測並一鍵複製驗證碼——用別名註冊服務後，驗證信不用離開工作台。 - 雙區域支援 ：全球（icloud.com）與中國大陸（icloud.com.cn）帳號皆可匯入，區域依主機自動判定，Origin/Referer/langCode 一併處理。 - 固定格式的 HTTP API；所有 /v1/ 皆以 X-API-Key 驗證。 - Session 只透過 iCloud 網頁請求的 Copy as cURL (bash) 或 HAR 匯入，不接收 Apple ID、密碼或 2FA。 - 自動刷新 預設啟用，每 10 分鐘使用現有 Session 保活；失效時自動停用。 - 響應式工作台： 信箱清單 、 收件匣 、 API Builder 、 Session & 自動刷新 ，支援亮／暗主題、手機版與 toast 操作回饋。 - 純 Python 標準庫、 零第三方相依 ；多執行緒 HTTP 服務；支援本機、Docker 與 Render。 快速開始 1. 取得專案 2. 環境變數 變數 必填 說明 --- --- --- HME API KEY ✅ API 與後台共用的金鑰；未設定時拒絕所有請求 ICLOUD HME CONFIG 匯入後的 Session 設定路徑；預設 hme-config.json ，Docker 為 /data/hme-config.json HME STATE DIR Session 檢查與自動刷新狀態目錄；預設 state ，Docker 為 /data/state macOS / Linux： Windows PowerShell： 3. 啟動服務 本地（Python 3.10+） 開啟 ，輸入剛才的 HME API KEY 。 Docker Render（一鍵） 4. 匯入 Session 1. 前往 iCloud+（大陸帳號改用 icloud.com.cn），開啟 Hide My Email（隱藏我的電子郵件） 。 2. 按 F12 開啟 DevTools → Network，找到包含 list?clientBuildNumber 的請求。 3. 對該請求選擇 Copy as cURL (bash) ；也可匯出包含 request cookies 的 HAR。 4. 到後台的 Session & 自動刷新 → 手動匯入 Session 貼上並送出。區域（全球／中國大陸）依主機自動判定。 5. 若要在 收件匣 讀信，匯入前請先在 iCloud 網頁開啟過一次「郵件」，確保 cookie 帶有郵件授權（ X-APPLE-WEBAUTH-PCS-Mail ）。 API 所有 /v1/ 需帶 X-API-Key: ； /health 免驗證。 方法 路徑 說明 --- --- --- GET /health 健康檢查 GET /v1/session/status 目前 Session 狀態（含 region ） POST /v1/session/refresh 用現有 Session 做一次低風險檢查 POST /v1/session/import 匯入 Session（body： {\"curl text\": \"...\"} ；支援 ic","default_branch":null,"files":null,"tree":[],"storefront":"/r/banana2556","claimed":false,"request_supported":{"post":"https://gitbuyer.com/r/banana2556/hme-manager/request-supported","requests":0},"note":"indexed from public GitHub; nothing is for sale on this page. Clone it from GitHub. Paid listings live at /search."}