ccy2026/OutLookEmailPlus-Manager

1---2title: OutLookEmailPlus-Manager3emoji: 📧4colorFrom: blue5colorTo: indigo6sdk: docker7app_port: 50008---9 10## 中文说明11 12### 运行方式13 14- 当前 Space 固定为 ``15- 默认使用当前项目已发布镜像：`ghcr.io/zeropointsix/outlook-email-plus:latest`16- 构建阶段会额外 clone 源仓库 `https://github.com/ZeroPointSix/outlookEmailPlus.git` 作为兜底启动路径17- 默认运行模式是 `APP_SOURCE=image`18- 只有你明确需要从源码目录启动时，才设置 `APP_SOURCE=git`19- 持久化数据目录是 `/data`，应由 HF bucket 挂载并保持 `Read & Write`20 21### GitHub Repository Secrets22 23这些是 GitHub 仓库里的 Secrets，不是 HF Space 里的 Variables/Secrets，用于 `.github/workflows/sync-hf-space.yml` 同步 Space：24 25- `HF_TOKEN`：必填，用于同步 `EmilyReed96989/OutLookEmailPlus-Manager`26- `HF_BUCKET`：当前 workflow 不依赖它推导 Space 名，但建议保留，方便你以后切回 bucket 推导方案27 28### HF Space Secrets29 30- `SECRET_KEY`：必填。Flask 启动所需密钥，不设置会直接启动失败31- `LOGIN_PASSWORD`：强烈建议配置。后台登录密码；不设置时会回退到项目默认值 `admin123`32- `OAUTH_CLIENT_ID`：可选。仅在你启用 Outlook OAuth 时配置33- `GPTMAIL_API_KEY`：可选。仅在你启用 GPTMail/正式临时邮箱上游时配置34- `EMAIL_NOTIFICATION_SMTP_PASSWORD`：可选。仅在你启用邮件通知 SMTP 时配置35- `CF_WORKER_ADMIN_KEY`：可选。Cloudflare Temp Email Worker 的 Admin Key，建议放在 Secret36 37### HF Space Variables38 39建议至少配置：40 41- `APP_SOURCE=image`42- `DATABASE_PATH=/data/outlook_accounts.db`43- `PORT=5000`44- `GUNICORN_THREADS=4`45- `GUNICORN_TIMEOUT=300`46- `ALLOW_LOGIN_PASSWORD_CHANGE=false`47- `SCHEDULER_AUTOSTART=true`48- `PROXY_FIX_ENABLED=true`49- `TRUSTED_PROXIES=`50 51按需配置：52 53- `OAUTH_REDIRECT_URI`54- `GPTMAIL_BASE_URL`55- `CF_WORKER_BASE_URL`56- `EMAIL_NOTIFICATION_SMTP_HOST`57- `EMAIL_NOTIFICATION_SMTP_PORT`58- `EMAIL_NOTIFICATION_FROM`59- `EMAIL_NOTIFICATION_SMTP_USERNAME`60- `EMAIL_NOTIFICATION_SMTP_USE_TLS`61- `EMAIL_NOTIFICATION_SMTP_USE_SSL`62- `EMAIL_NOTIFICATION_SMTP_TIMEOUT`63 64### 重要说明65 66- 当前方案下，容器内不再执行 bucket 双向同步，HF bucket 直接挂载到 `/data`67- `HF_TOKEN` 和 `HF_BUCKET` 只用于 GitHub Action 同步 Space 仓库，不是应用运行期环境变量68- `PROXY_FIX_ENABLED` / `TRUSTED_PROXIES` 才是代码真实识别的代理相关变量，不要再使用旧的 `TRUST_PROXY_HEADERS`69- Telegram 推送、`cf_worker_base_url`、`cf_worker_admin_key`、`email_notification_recipient`、`telegram_bot_token`、`telegram_chat_id`、`telegram_poll_interval` 等，主要是应用启动后保存在数据库设置中，不是必须通过 HF 环境变量预置70 71## English Notes72 73### Runtime74 75- This Space is fixed to ``76- The default runtime image is `ghcr.io/zeropointsix/outlook-email-plus:latest`77- The build also clones `https://github.com/ZeroPointSix/outlookEmailPlus.git` as a fallback source path78- Default runtime mode is `APP_SOURCE=image`79- Set `APP_SOURCE=git` only when you explicitly want to boot from the cloned source tree80- Persistent application data lives in `/data`, backed by the mounted HF bucket81 82### GitHub Repository Secrets83 84- `HF_TOKEN`: required for syncing the Space repository from GitHub Actions85- `HF_BUCKET`: currently not required by the workflow for Space name resolution, but kept for future bucket-derived workflows86 87### HF Space Secrets88 89- `SECRET_KEY`: required90- `LOGIN_PASSWORD`: strongly recommended; otherwise the app falls back to `admin123`91- `OAUTH_CLIENT_ID`: optional, only for Outlook OAuth92- `GPTMAIL_API_KEY`: optional, only for GPTMail/upstream temp mail93- `EMAIL_NOTIFICATION_SMTP_PASSWORD`: optional, only for SMTP email notifications94- `CF_WORKER_ADMIN_KEY`: optional, recommended as a Secret95 96### HF Space Variables97 98Recommended baseline values:99 100- `APP_SOURCE=image`101- `DATABASE_PATH=/data/outlook_accounts.db`102- `PORT=5000`103- `GUNICORN_THREADS=4`104- `GUNICORN_TIMEOUT=300`105- `ALLOW_LOGIN_PASSWORD_CHANGE=false`106- `SCHEDULER_AUTOSTART=true`107- `PROXY_FIX_ENABLED=true`108- `TRUSTED_PROXIES=`109 110Optional values when needed:111 112- `OAUTH_REDIRECT_URI`113- `GPTMAIL_BASE_URL`114- `CF_WORKER_BASE_URL`115- `EMAIL_NOTIFICATION_SMTP_HOST`116- `EMAIL_NOTIFICATION_SMTP_PORT`117- `EMAIL_NOTIFICATION_FROM`118- `EMAIL_NOTIFICATION_SMTP_USERNAME`119- `EMAIL_NOTIFICATION_SMTP_USE_TLS`120- `EMAIL_NOTIFICATION_SMTP_USE_SSL`121- `EMAIL_NOTIFICATION_SMTP_TIMEOUT`122 123### Important Notes124 125- In the current deployment mode, the container does not perform bucket sync; HF mounts the bucket directly to `/data`126- `HF_TOKEN` and `HF_BUCKET` are for GitHub Actions only, not runtime application configuration127- The code recognizes `PROXY_FIX_ENABLED` and `TRUSTED_PROXIES`; do not use the outdated `TRUST_PROXY_HEADERS`128- Telegram push settings and several provider settings are primarily stored in the application's database-backed settings after startup, not required as HF environment variables129