一个面向多邮箱账号场景的邮件管理工具，支持通过 Outlook/Hotmail OAuth、Microsoft Graph API 和标准 IMAP 统一读取、管理和转发邮件，并提供 Web 界面、Chrome/Edge 浏览器扩展，用于分组管理、账号管理、邮件查看和对外 API 调用。当前支持 Outlook/Hotmail、Gmail、QQ、163、126、Yahoo、阿里邮箱以及自定义 IMAP 邮箱，同时集成 GPTMail、DuckMail、Cloudflare Temp Email 多提供商临时邮箱能力。
https://aso.de5.net admin123 注意：体验站点请勿修改密码或存放实际数据，部署在无持久化的服务上，数据随时可能丢失恢复初始状态
本项目采用轻量化双分支版本管理：main 为稳定发布分支，dev 为日常开发分支。
完整的发版步骤、工作流行为和核对清单见 发版说明。
从 GitHub Releases 下载对应版本的 OutlookEmail-windows-x64-*.zip，解压后直接运行 OutlookEmail.exe 即可。
桌面版首次启动会自动：
- 生成并持久化
SECRET_KEY - 创建本地数据目录和 SQLite 数据库
- 启动 Web 服务，默认地址
http://127.0.0.1:5000
说明：
- Windows 数据默认保存在
%APPDATA%\OutlookEmail - 默认登录密码仍然是
admin123，首次登录后建议立即修改
从 GitHub Releases 下载对应架构的 OutlookEmail-macos-*-*.dmg，打开后把 OutlookEmail.app 拖到 Applications 即可。
桌面版首次启动会自动：
- 生成并持久化
SECRET_KEY - 创建本地数据目录和 SQLite 数据库
- 启动 Web 服务，默认地址
http://127.0.0.1:5000
说明：
- macOS 数据默认保存在
~/Library/Application Support/OutlookEmail - 如果 macOS 提示Apple无法验证“OutlookEmail”是否包含可能危害Mac安全或泄漏隐私的恶意软件。可执行下面命令然后重试
sudo xattr -rd com.apple.quarantine /Applications/OutlookEmail.app - 默认登录密码仍然是
admin123，首次登录后建议立即修改
# 拉取最新镜像
docker pull ghcr.io/devmc12/outlook-email-manager:latest
# 运行容器
docker run -d \
--name outlook-mail-reader \
-p 5000:5000 \
-v $(pwd)/data:/app/data \
-e LOGIN_PASSWORD=admin123 \
-e SECRET_KEY=your-secret-key-here \
ghcr.io/devmc12/outlook-email-manager:latestgit clone https://github.com/devmc12/outlook-email-manager.git
cd outlook-email-manager
pip install -r requirements.txt
export SECRET_KEY=your-secret-key-here
python web_outlook_app.py访问 http://localhost:5000 即可使用。
如果是服务器部署，仍然建议显式设置固定 SECRET_KEY。
服务需要保持单 worker 运行。官方 Docker 镜像已固定为 Gunicorn 单 worker + 多线程；如果自定义部署，请不要增加 worker 数，需要并发时优先调整线程数。Token 刷新管理的流式任务会使用进程内短期状态，多个 worker 会导致任务初始化和 SSE 订阅落到不同进程。
version: '3.8'
services:
outlook-mail-reader:
image: ghcr.io/devmc12/outlook-email-manager:latest
container_name: outlook-mail-reader
ports:
- "5000:5000"
volumes:
- ./data:/app/data
environment:
- LOGIN_PASSWORD=admin123
- SECRET_KEY=your-secret-key-here
- FLASK_ENV=production
restart: unless-stoppeddocker-compose up -d界面里的 Docker 在线更新需要访问宿主机 Docker socket。/var/run/docker.sock 具有宿主机 Docker 管理权限，只建议在可信环境开启。
该功能只适用于使用可变镜像标签的容器，例如 latest、main、dev。如果当前容器固定使用 v2.0.39 这类版本标签，界面会拒绝在线更新，因为 Watchtower 不会自动把固定标签切换到新版本标签。
应用默认会在 daemon 明确返回“最低支持 API 版本”时自动按该版本重试；如果你的 Docker 环境或 socket 代理有特殊兼容要求，也可以显式设置 DOCKER_UPDATE_API_VERSION，其值可参考 docker version --format '{{.Server.APIVersion}}' 的输出。
可选环境变量 DOCKER_UPDATE_STATUS_TIMEOUT 用于单独控制状态查询和容器 inspect 的超时时间（秒），不影响实际更新任务的 DOCKER_UPDATE_TIMEOUT。
如果当前 latest / main / dev 标签没有新的镜像可拉取，界面会显示本次没有应用更新，而不是误报为更新失败。
如果想让界面里的「获取 Token」使用自己的 Azure 应用，请同时设置 OAUTH_CLIENT_ID 和 OAUTH_REDIRECT_URI。这两个值会用于生成 Microsoft 授权链接和换取 Refresh Token；换取成功后界面返回的 Client ID 需要和 Refresh Token 一起导入账号。未设置时会使用项目内置的默认 Client ID 和默认回调地址 http://localhost:8080。
version: '3.8'
services:
outlook-mail-reader:
image: ghcr.io/devmc12/outlook-email-manager:latest
container_name: outlook-mail-reader
ports:
- "5000:5000"
volumes:
- ./data:/app/data
- /var/run/docker.sock:/var/run/docker.sock
environment:
- LOGIN_PASSWORD=admin123
- SECRET_KEY=your-secret-key-here
- FLASK_ENV=production
- DOCKER_UPDATE_ENABLED=true
- DOCKER_UPDATE_CONTAINER=outlook-mail-reader
# 可选：在较新的 Docker daemon / socket 代理环境中显式指定 API 版本
# - DOCKER_UPDATE_API_VERSION=1.52
# 可选：让界面 OAuth 助手使用你自己的 Azure 应用
# - OAUTH_CLIENT_ID=your-azure-application-client-id
# - OAUTH_REDIRECT_URI=http://localhost:8080
restart: unless-stopped本工具当前包含三类读取链路：
- Outlook/Hotmail OAuth + Graph API - 优先方式，适合 Outlook / Hotmail / Live 账号
- Outlook/Hotmail OAuth + IMAP 回退 -
outlook.live.com/outlook.office365.com - 标准 IMAP - 适用于 Gmail、QQ、163、126、Yahoo、阿里邮箱和自定义 IMAP
普通邮箱本地保留开关 normal_mail_local_retention_enabled 默认关闭。用户需要在系统设置中明确开启后，普通 Outlook/Hotmail 与标准 IMAP 邮箱才会把列表元数据和已查看、补齐过的部分正文保存到本机 SQLite。
开启后，普通邮箱列表会优先从本地保留数据加载，命中时可立即显示最近一次保留的邮件列表；在本地优先模式下继续向下滚动加载更多，也会沿用本地保留分页，因此远程不可用时仍可查看超过首屏的已保留邮件。页面同时会在后台继续向 Graph API 或 IMAP 发起远程同步。远程同步成功后会把新列表元数据写回本地保留库；同步失败时，当前页面会保留本地列表并显示后台同步失败提示，而不会把列表清空。
后台同步发现本地尚未显示的新邮件时，页面会显示“有 N 封新邮件已同步”的非打断式提示。同步成功不会立即把新邮件并入当前列表；用户点击提示后，新邮件才会合并到当前列表，并执行高亮、列表缓存更新和新邮件正文保留的后台补齐，避免正在阅读或已选择的邮件被突然替换。
邮件详情会优先使用已保留的正文内容；如果本地行还没有正文，远程详情读取成功后会回填正文保留数据，供后续刷新页面、重启应用或临时网络失败时继续查看。若远程详情失败但本地已有正文，详情页会展示本地保留正文作为回退。关键词过滤也会先检查已缓存正文，只有缓存缺失时才补走远程详情读取。
Outlook/Hotmail OAuth 的 IMAP 回退链路默认按 UID 读取详情和附件；列表项、详情请求和附件下载可携带 id_mode=uid|sequence，避免 UID 与序列号混用导致取错邮件。标准 IMAP 账号继续使用其既有消息 ID 读取逻辑。
当前阶段只保留普通邮箱列表元数据和已读取过的详情正文，不包含附件二进制、原始 MIME 内容的下载或保留；附件下载仍依赖当前远程提供商链路。设置页会显示已保存邮件数、已缓存正文数、估算保留大小和当前 SQLite 数据库大小，并提供独立“清理缓存”操作。关闭本地保留开关时，界面会先要求确认；确认后会通过后台清理任务删除普通邮箱本地保留数据，并显示清理状态。清理任务会拒绝重复启动、对 SQLite 短暂锁进行有限重试，前端状态轮询使用退避间隔减少长任务压力。更完整的范围说明见 docs/local-mail-retention.md。
- 🔐 登录验证 - 密码保护的 Web 界面，支持在线修改密码
- 📁 分组管理 - 支持创建、编辑、删除邮箱分组，自定义分组颜色，支持分组级别代理设置
- 🌐 账号/分组代理 - 每个分组可配置 HTTP/SOCKS5 代理，单个账号也可设置代理并优先覆盖分组代理
- 📧 多邮箱管理 - 批量导入和管理 Outlook/Hotmail OAuth / IMAP 邮箱账号
- 🪪 别名管理 - 支持给单个邮箱配置多个别名邮箱，主邮箱和别名都可用于检索邮件和调用对外 API
- 🔀 别名高级用法 - 可将外部邮箱自动转发到本项目管理的邮箱 A，再把外部邮箱配置为 A 的别名，从而通过本项目统一读取邮件
- 📬 邮件查看 - Web 界面支持查看收件箱和垃圾邮件；API 支持
inbox、junkemail、deleteditems、all - 📎 附件下载 - 邮件详情支持单个附件下载，也支持将全部附件打包为 ZIP 下载
- 🔍 全屏查看 - 支持全屏模式查看邮件
- 📤 导出功能 - 支持按分组或全部导出邮箱账号信息
- 🧩 WebDAV 备份 - 支持将“导出全部分组”的文件按 Cron 定时上传到 WebDAV，也可手动上传
- 🎨 现代化 UI - 四栏布局，账号列表、邮件列表、邮件详情分区清晰
- ⚡ 性能优化 - 邮件列表与账号列表缓存，分组切换和账号切换更快
- 📄 分页加载 - 滚动到底部自动加载下一页（每页20封）
- 🔥 临时邮箱 - 集成 GPTMail + DuckMail + Cloudflare Temp Email，多提供商生成、导入、读取、查看详情；Cloudflare 支持多渠道配置，每个 Worker/管理员密码/邮件池独立管理，并按渠道查看全部邮件
- ⚙️ 系统设置 - 在线修改密码、API Key 等
- 🔄 OAuth2 助手 - 内置授权流程，快速获取 Refresh Token
- 💾 邮件缓存 - 智能缓存邮件列表，切换即时展示；普通邮箱本地保留默认关闭，可在设置页开启、查看统计并清理本地保留缓存
- 🏷️ 标签管理 - 支持给邮箱打标签、批量操作、按标签筛选
- 📦 批量移动分组 - 批量选择邮箱移动到指定分组
- ✅ 批量选择 - 邮箱列表、邮件列表均支持全选当前列表与清空选择
- 🗑️ 邮件删除 - 单封/批量永久删除邮件
- 🔄 API 优先级回退 - Graph API → IMAP(新) → IMAP(旧) 自动回退
- 🔑 对外 API - 通过 API Key 直接获取邮件，无需登录，支持别名邮箱、聚合文件夹和多条件筛选 带+号的附加电子邮箱自动识别，自动回退主邮箱/别名邮箱查询；如果要求的功能比较完善，建议直接对接完整API，文档已经改成了适合AI读取的形状，直接喂给AI让AI按照完整API使用登录密码而不是API Key对接即可
- 📮 按账号开启转发 - 每个账号单独控制是否参与自动转发
- 📨 多渠道转发 - 支持 SMTP 邮件转发和 Telegram 转发
- ⏱️ 时间窗口控制 - 支持仅转发最近 X 分钟内收到的邮件
- 🗑️ 垃圾箱转发可选 - 可配置是否把垃圾邮件一起纳入转发
- 📚 转发历史 - 支持查看最近转发记录和失败记录
▶️ 手动触发 - 支持从界面手动触发一次转发检查
- 🔁 全量刷新 - 一键刷新所有 Outlook/Hotmail OAuth 账号 Token
- ✅ 完整批量操作 - 在 Token 刷新管理列表中可直接批量刷新、复制、导出、转发、代理、打标签、移动分组和删除账号
- 📄 分页浏览 - Token 刷新管理列表支持页码跳转和每页数量切换，适合大量账号场景
- ⏰ 定时刷新 - 支持按天数或 Cron 表达式配置，Docker / Docker Compose 启动也会自动生效
- 📊 刷新统计 - 实时显示失败邮箱数量
- 📜 刷新历史 - 近半年完整记录
- 🗂️ 全部分组备份 - 备份文件复用“导出全部分组”的格式，包含普通邮箱和临时邮箱分组数据
- ⏲️ Cron 定时上传 - 支持 5 段 Cron 表达式，并使用常规设置里的应用时区计算下次执行时间
- 🧪 连接测试 - 可在设置页上传并清理测试文件，用于验证 WebDAV 目录是否可写
- 🔐 敏感操作确认 - 修改备份设置和手动上传真实备份时需要再次验证登录密码
- 🛡️ XSS 防护 | 🔒 CSRF 防护 | 🔐 数据加密 | 🚦 速率限制 | 📋 审计日志 | 🔑 二次验证
Web 应用采用四栏式布局设计：
- 分组面板 - 显示所有邮箱分组，点击切换
- 邮箱面板 - 显示当前分组下的邮箱账号列表
- 邮件列表 - 显示选中邮箱的邮件，支持切换文件夹和滚动加载
- 邮件详情 - 显示选中邮件的完整内容（支持 HTML 渲染）
要使用本工具，您需要获取以下 OAuth2 凭证：
- Client ID - Microsoft Azure 应用注册的客户端 ID
- Refresh Token - OAuth2 刷新令牌
界面中的 OAuth2 助手会读取服务启动时的 OAUTH_CLIENT_ID 和 OAUTH_REDIRECT_URI。如果你在 Docker / Docker Compose 里配置了自己的值，授权链接和换取 Token 都会使用这些值；如果没有配置，则使用项目内置默认值。账号导入时，Client ID 要和同一次授权换出的 Refresh Token 配套使用。
访问 Azure Portal，进入「应用注册」：
点击「新注册」，填写应用信息：
- 名称：自定义应用名称
- 支持的账户类型：选择「任何组织目录中的账户和个人 Microsoft 账户」
- 重定向 URI：选择「公共客户端/本机」，填写
http://localhost:8080
创建完成后，复制「应用程序(客户端) ID」：
在「API 权限」中添加以下权限：
offline_access- 获取刷新令牌Mail.Read- 读取邮件Mail.ReadWrite- 读写邮件User.Read- 读取用户信息IMAP.AccessAsUser.All- IMAP 访问
使用本工具内置的 OAuth2 助手获取 Refresh Token：
- 在 Web 界面点击「获取 Token」按钮
- 点击「生成授权链接」
- 复制链接到浏览器打开，完成授权
- 复制授权后的完整 URL（处于安全考虑，我没有统一建设授权回调服务，所有授权都在自己部署的服务内完成，不会外泄，所以重定向URI为http://localhost:8080，这个链接肯定是打不开的，所以要复制过来在部署的服务走后半段的换取Refresh Token）
- 粘贴到「授权后的 URL」输入框
- 点击「换取 Token」按钮
- 复制获得的 Refresh Token
在 Web 界面中点击「导入邮箱」后，可根据邮箱类型选择对应导入格式。
支持两种格式：
邮箱----密码----client_id----refresh_token
邮箱----密码----refresh_token----client_id示例：
user@outlook.com----password123----24d9a0ed-8787-4584-883c-2fd79308940a----0.AXEA...适用于 Gmail、QQ、163、126、Yahoo、阿里邮箱等：
邮箱----IMAP授权码/应用密码示例：
user@gmail.com----app-password
user@qq.com----imap-auth-code支持两种格式：
邮箱----IMAP密码
邮箱----IMAP密码----imap_host----imap_port示例：
user@example.com----app-password
user@example.com----app-password----imap.example.com----993支持批量导入，每行一个账号。导入文件格式保持不变；导入弹窗可为本次新增账号统一设置备注、标签、状态，并可选择是否立即开启邮件转发。普通邮箱导入时不能选择临时邮箱分组。
- 从左侧选择分组
- 选择邮箱账号
- 点击「获取邮件」按钮
- 在 Web 界面切换「收件箱」「垃圾邮件」查看邮件
- 滚动到邮件列表底部自动加载下一页（每页 20 封）
- 点击邮件查看详情，支持 HTML 渲染与全屏查看
- 需要查看
deleteditems或all聚合结果时，建议使用对外 API 或内部 API
邮箱账号列表左侧有选择框，适合对多个账号同时刷新 Token、复制邮箱、修改转发状态、打标签、移动分组或删除。
常用选择方式：
- 单选/取消单选：点击账号左侧的选择框。
- 进入批量选择模式：点击邮箱面板顶部的「☑」按钮。按钮高亮后，可点击账号行来切换选中状态，不必点中选择框。
- 连续范围选择：先选中一个账号，再按住
Shift点击另一个账号或选择框，会选中两者之间的连续范围。 - 拖拽选择：进入批量选择模式后，在账号行或选择框上按住鼠标/触控板并向上或向下拖动，可连续选中经过的账号；如果起点账号已选中，本次拖拽会批量取消选中经过的账号。
- 全选当前列表：点击批量菜单里的「全选」或「全选已加载」。账号列表分页加载时，该按钮只作用于当前已经加载到页面中的账号；继续向下滚动加载更多后，可再次点击全选已加载。
- 清空选择：点击「清空选择」取消当前列表中的所有选择。
选中至少一个账号后，会出现批量菜单：
- PC 端：菜单悬浮在第一个选中账号的右侧，并随账号列表滚动重新定位。
- 移动端：菜单显示在底部，便于触控操作。
普通邮箱账号支持的批量操作：
- 刷新 Token：只对 Outlook/Hotmail OAuth 账号可用；IMAP 账号不可刷新，按钮会按可刷新数量提示。
- 复制邮箱+别名：复制选中账号的主邮箱和已配置别名。
- 导出：二次验证后导出选中账号，适合先按标签或搜索筛选后只导出当前勾选的账号。
- 开启转发 / 取消转发：批量修改账号级转发开关。全局转发渠道仍需在「设置 -> 邮件转发设置」中配置。
- 标签+ / 标签-：给选中账号批量添加或移除一个标签。
- 移动：把选中账号移动到指定分组。
- 删除：永久删除选中账号，操作前会再次确认。
临时邮箱分组也使用同一套选择方式，但批量菜单只显示适用于临时邮箱的操作，例如复制邮箱、标签添加/移除和删除；刷新 Token、转发开关、移动分组等普通账号专属操作会隐藏。
「Token刷新管理」里的邮箱列表也支持同一套批量选择方式：
- 点击列表头部的「☑」进入批量选择模式。
- 通过复选框、账号行点击、
Shift连续范围选择或拖拽选择账号。 - 点击「全选当前列表」只选中当前筛选后已经显示的账号。
- 搜索关键词或切换状态筛选时，已选账号会清空，避免误操作筛选外账号。
选中账号后可直接执行这些批量动作：
- 刷新 Token：继续使用 Token 刷新管理的流式任务日志，可查看账号级进度和结果。
- 复制邮箱+别名 / 导出：复用普通邮箱列表的复制和二次验证导出流程。
- 开启转发 / 取消转发 / 代理 / 标签+ / 标签- / 移动 / 删除：复用普通邮箱账号批量接口，完成后会同步刷新 Token 刷新管理列表、主邮箱列表和分组计数。
普通邮箱的邮件列表左侧也有选择框，适合批量处理当前邮箱的邮件：
- 点击邮件左侧选择框选中或取消选中单封邮件。
- 点击「全选」选中当前已加载的邮件列表。
- 点击「清空选择」取消已选邮件。
- 点击「设为已读」把选中的未读邮件批量标记为已读；如果所选邮件都已读，该按钮会禁用。
- 点击「删除」批量永久删除选中邮件，操作前会再次确认。
邮件批量选择只作用于当前邮箱当前文件夹/聚合视图里已经加载的邮件；切换邮箱、刷新邮件列表或列表为空时，已选邮件会被清空。
- 打开某个邮箱账号的「编辑账号」
- 在「别名邮箱」中按行填写多个别名
- 保存后，主邮箱和别名都会指向同一个账号
适合这些场景：
- 同一账号有多个注册邮箱名称
- 某些站点使用了
user+tag@example.com - 外部邮箱自动转发到本项目管理邮箱后，希望继续用原邮箱名来取信
邮件转发分成两层控制：
- 账号级开关 在导入账号或编辑账号时，选择是否为该账号开启转发
- 全局转发设置
在「设置 -> 邮件转发设置」中配置：
- 轮询间隔
- 转发邮件时间范围
- 是否转发垃圾箱邮件
- 转发渠道（SMTP / Telegram）
- SMTP / Telegram 的具体参数
补充说明：
- 转发轮询只处理“账号里已开启转发”的邮箱
- 可以手动触发一次转发检查
- 可以查看最近转发历史和失败记录
在「设置 -> WebDAV 备份」中配置：
- 填写 WebDAV 目录 URL，例如
https://dav.example.com/backups - 按需填写 WebDAV 用户名和密码 / App Password
- 填写 5 段 Cron 表达式，例如
0 3 * * * - 点击「计算下次执行时间」确认 Cron 预览，时间会使用常规设置里的应用时区
- 点击「测试 WebDAV」验证目录可写；测试只上传临时测试文件，不需要登录密码
- 修改备份设置时，在“敏感操作确认”中输入登录密码后保存
补充说明：
- 定时备份会上传与“导出全部分组”一致的文本文件，文件名形如
all_groups_backup_YYYYMMDD_HHMMSS.txt - 坚果云需要先创建专用目录，再填写该目录 URL，例如
https://dav.jianguoyun.com/dav/mailBackup；不要只填写https://dav.jianguoyun.com/dav - 「手动上传」会立即上传真实备份文件，需要输入登录密码
- WebDAV 备份涉及账号、令牌、临时邮箱凭据等敏感数据，建议使用专用 WebDAV 目录并控制访问权限
仓库内置 Chrome / Edge Manifest V3 扩展，目录为 browser-extension/。扩展使用 Web 端登录密码，不需要对外 API Key。
安装方式：
- 打开浏览器扩展管理页，例如
chrome://extensions/或edge://extensions/ - 开启开发者模式
- 选择“加载已解压的扩展程序”
- 选择本仓库的
browser-extension目录
使用方式：
- 点击扩展图标
- 填写 OutlookEmail 服务地址和 Web 登录密码
- 点击“保存配置”，或直接点侧边栏里的功能入口
扩展会在浏览器侧边栏内提供原生操作面板，当前网页标签不会被切走。现在可直接使用邮箱、导入、刷新、Token、导出、标签和设置等功能。完整安装、配置、功能和故障排查说明见 浏览器扩展使用说明。
通过 API Key 直接获取邮件，无需登录 Web 界面。
当前额外支持：
- 使用主邮箱或别名邮箱取信
folder=all一次聚合收件箱和垃圾邮件并按标准化后的邮件时间倒序排序，top按每个文件夹分别计算- 支持按主题、发件人、关键词筛选列表
- 支持特殊字符别名，例如
user+alias@example.com - 查询
@gmail.com/@googlemail.com地址时，原后缀未命中会自动回退到另一个后缀 - 默认
top=1 skip/top会做安全解析：非数字使用默认值，负数按0处理；top最大50
配置步骤：
- 点击「⚙️ 设置」→ 在「对外 API Key」处点击「🔑 随机生成」→ 保存
调用示例：
curl -H "X-API-Key: your-api-key" \
"http://localhost:5000/api/external/emails?email=user@outlook.com&folder=inbox"
curl -H "X-API-Key: your-api-key" \
"http://localhost:5000/api/external/emails?email=alias@example.com&folder=all&top=10"
curl -H "X-API-Key: your-api-key" \
"http://localhost:5000/api/external/emails?email=alias@example.com&folder=all&top=10&subject_contains=verify&from_contains=github&keyword=reset"
curl -H "X-API-Key: your-api-key" \
"http://localhost:5000/api/external/emails?email=user%2Balias%40example.com"如果邮箱或别名里带特殊字符：
@可以直接传+建议编码成%2B&必须编码成%26
如果你把外部邮箱 B 自动转发到本项目管理的邮箱 A，再把 B 配成 A 的别名，那么后续可以直接用 B 作为 email 参数调用对外 API。
详细文档见 API 文档。
| 文档 | 说明 |
|---|---|
| 🚀 部署指南 | Docker、Docker Compose、Nginx/Caddy 部署、环境变量配置 |
| ⬆️ 升级指南 | Windows、Docker、Python 直跑升级与回滚建议 |
| 🔐 安全配置 | XSS/CSRF 防护、数据加密、速率限制、审计日志 |
| 📡 API 文档 | 对外简易API、完整API、代理配置 |
| 🛠️ 故障排查 | 常见问题、故障排查步骤 |
| 📋 更新日志 | 版本更新历史 |
| 🚢 发版说明 | 标准发版步骤、版本号规则、GitHub Release 说明 |
| 🛡️ 分支保护建议 | main/dev 使用边界、保护规则与构建触发建议 |
- Flask 3.0+ - Web 框架
- SQLite 3 - 数据库
- Requests / requests[socks] - HTTP 客户端与代理支持
- IMAP4_SSL - IMAP 协议支持
- Microsoft Graph API - Outlook/Hotmail 邮件 API
- APScheduler + croniter - 定时刷新与转发轮询
- bcrypt + cryptography - 密码哈希与敏感字段加密
- 原生 JavaScript - 无框架依赖
- CSS3 - 现代化样式
- Fetch API - 异步请求
- DOMPurify 3.0.8 - HTML 净化
- Python 3.9+
- SQLite 3
- Docker（可选）
- 2GB+ 内存
flask>=3.0.0
flask-wtf>=1.2.0 # CSRF 防护（推荐安装）
werkzeug>=3.0.0
requests[socks]>=2.25.0 # HTTP 请求与代理支持
APScheduler>=3.10.0 # 定时任务
croniter>=1.3.0 # Cron 表达式解析
bcrypt>=4.0.0 # 密码哈希
cryptography>=41.0.0 # 数据加密开启2fa，然后在这里创建应用密码
https://support.google.com/mail/answer/185833?hl=zh-Hans
在 Telegram 搜索框搜索 @userinfobot 或 @getmyid_bot。
点击 Start。
机器人会立即回复你的 User ID（一串数字）。
如果你想知道别人的 ID：只需将对方发给你的消息转发给这个机器人，它就会显示该用户的 ID。
将上述机器人（如 @getmyid_bot）拉进你的群组。
在群组里输入 /myid（或者机器人指定的指令）。
机器人会返回该群组的 ID。
注意： 普通群组 ID 通常以数字开头，而**超级群组（Supergroup）或频道（Channel）**的 ID 通常以 -100 开头。
欢迎提交 Issue 和 Pull Request！
git clone https://github.com/devmc12/outlook-email-manager.git
cd outlook-email-manager
python -m venv venv
source venv/bin/activate
pip install -r requirements.txt
python web_outlook_app.pyMIT License - 详见 LICENSE
本项目已在 LINUX DO 社区 发布，感谢社区的支持与反馈。
⭐ 如果这个项目对你有帮助，请给个 Star 支持一下！你的 Star 是我持续更新的动力！ ⭐
初次维护一个项目，2026年04月11日15:45:33才发现有几个pull没合并，非常抱歉，这是我的联系方式如果我没看到的话，可以提醒我一下，有好的建议也可以提，感谢~ 邮箱：u3794336@outlook.com
本项目仅供学习、研究和技术交流使用，请遵守相关平台和服务条款，不要用于违规、滥用或非法用途。 因使用本项目产生的任何风险和后果，由使用者自行承担。