告别频繁切换！这款开源工具统一管理 Outlook、Gmail 及 QQ 邮箱，支持 API 调用

你是否也拥有多个邮箱账号？

工作用 Outlook，个人用 Gmail，注册账号用 QQ 或 163，偶尔还需要生成几个临时邮箱接收验证码……每天在不同网页、不同客户端之间切换，不仅效率低下，还容易漏掉重要邮件。今天，给大家推荐一款强大的开源多邮箱管理工具—OutlookEmail。它不仅能将所有邮箱聚合在一个界面中，还提供了强大的 API 和自动化转发功能，真正实现了“邮件中枢”的概念。

• GitHub：https://github.com/assast/outlookEmail

全协议支持，统一聚合

OutlookEmail 打破了电子邮件服务商的壁垒，支持通过以下方式统一读取和管理邮件：

• Outlook/Hotmail/Live：优先使用 Microsoft Graph API，速度更快、更稳定；若失败则自动回退到 IMAP。
• Gmail, QQ, 163, 126, Yahoo, 阿里邮箱：通过标准 IMAP 协议接入。
• 自定义 IMAP：支持任何提供 IMAP 服务的邮箱。

更贴心的是，它还集成了 GPTMail、DuckMail 和 Cloudflare Temp Email，让你能在同一界面内生成和管理临时邮箱，无需再打开第三个网站。

OutlookEmail特点

1. 现代化四栏布局：

界面清晰分为“分组 – 账号 – 邮件列表 – 邮件详情”四部分。支持全屏查看、HTML 渲染、分页加载，体验媲美原生客户端

2. 强大的分组与代理管理：

• 你可以将邮箱按用途分组（如“工作”、“私人”、“注册”），并为每个分组设置不同的颜色。
• 分组级代理：每个分组可独立配置 HTTP/SOCKS5 代理。这对于需要隔离网络环境或访问受限服务的企业用户来说，简直是神器。

3. 自动化转发与通知：

• SMTP 转发：将重要邮件自动转发到其他邮箱。
• Telegram 推送：收到新邮件时，直接推送到你的 Telegram，实现移动端即时提醒。
• 灵活控制：支持设置时间窗口（仅转发最近 X 分钟）、过滤垃圾邮件、查看转发历史。

4. 开发者友好的 API：

提供完整的对外 API，支持通过 API Key 直接获取邮件、查询别名、筛选条件等。你可以轻松将其集成到自己的自动化工作流、监控脚本或 AI Agent 中。

5. 别名与高级路由：

支持为单个邮箱配置多个别名。你可以将外部邮箱自动转发到主邮箱，并在系统中将其标记为别名，从而实现统一的检索和管理。

如何部署？三种方式任选

方式一：Windows 用户（最简单）

直接从 GitHub Releases 下载 OutlookEmail-windows-x64-*.zip，解压后运行 OutlookEmail.exe（上不去GitHub，可以从下面的网盘下载）。

• 首次启动会自动创建本地数据库和 Web 服务。
• 默认地址：http://127.0.0.1:5000
• 默认密码：admin123（登录后请立即修改！）

方式二：Docker 部署（推荐服务器/ NAS 用户）

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/assast/outlookemail:latest

方式三：Docker Compose（便于管理）

创建 docker-compose.yml 文件：

version: '3.8'
services:
  outlook-mail-reader:
    image: ghcr.io/assast/outlookemail: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-stopped

然后执行 docker-compose up -d。

安全与隐私

• 数据本地化：所有数据存储在本地 SQLite 数据库中，不上传云端。
• 多重防护：支持 XSS/CSRF 防护、数据加密、速率限制和审计日志。
• OAuth2 助手：内置授权流程，安全获取 Refresh Token，避免手动复制粘贴的风险。

部署好 OutlookEmail 只是第一步，如何高效地配置和使用它，才是发挥其威力的关键。

如何使用

这份进阶使用指南，将带你从获取 OAuth2 令牌开始，一步步掌握别名管理、自动转发和 API 调用等核心功能。

第一步：获取 Outlook OAuth2 凭证（核心难点）

对于 Outlook/Hotmail/Live 邮箱，推荐使用 Graph API 以获得最佳体验。这需要你拥有 Microsoft Azure 账号（个人微软账号即可，部分功能可能需要 E3/E5 开发者权限）。

1. 注册应用：
   • 访问 Azure Portal(https://portal.azure.com) -> 「应用注册」 -> 「新注册」。
   • 名称：随意填写（如 OutlookEmail）。
   • 支持的账户类型：选择「任何组织目录中的账户和个人 Microsoft 账户」。
   • 重定向 URI：选择「公共客户端/本机」，填写 http://localhost:8080。
2. 获取 Client ID：
   • 注册完成后，在概览页面复制「应用程序(客户端) ID」。
3. 配置权限（可选但推荐）：
   • 进入「API 权限」 -> 「添加权限」 -> 「Microsoft Graph」 -> 「委托的权限」。
   • 添加：offline_access, Mail.Read, Mail.ReadWrite, User.Read, IMAP.AccessAsUser.All。
   • 注：目前内置客户端 ID 可能已预设权限，若报错再手动添加。
4. 换取 Refresh Token：
   • 打开 OutlookEmail Web 界面，点击「获取 Token」。
   • 生成授权链接，在浏览器中打开并登录微软账号授权。
   • 关键步骤：授权后会跳转到一个打不开的 localhost 链接。复制这个完整的 URL。
   • 回到 OutlookEmail 界面，粘贴 URL 到「授权后的 URL」框，点击「换取 Token」。
   • 保存生成的 Refresh Token。

第二步：批量导入邮箱账号

OutlookEmail 支持多种格式的批量导入，每行一个账号。

Outlook OAuth 格式：

• 邮箱—-密码—-client_id—-refresh_token
• 示例： [email protected]—-pass123—-24d9a…—-0.AXEA…

标准 IMAP 格式（Gmail/QQ/163等）：

• 邮箱—-IMAP授权码/应用密码（注意：QQ/163 需在邮箱设置中开启 IMAP 并获取专用授权码，而非登录密码。）
• 示例： [email protected]—-abcd efgh ijkl mnop

自定义 IMAP 格式：

• 邮箱—-密码—-imap_host—-imap_port
• 示例： [email protected]—-pass—-imap.company.com—-993

导入时，你可以选择是否立即开启该账号的邮件转发。

第三步：别名管理——统一入口的神器

这是 OutlookEmail 最强大的功能之一。

场景：你有一个主邮箱 [email protected]，但很多网站注册时用了 [email protected] 或完全不同的别名 [email protected]（已转发到主邮箱）。

操作：

1. 编辑 [email protected] 账号。
2. 在「别名邮箱」栏中，按行填入 [email protected] 和 [email protected]。
3. 保存。

效果：

• 在 Web 界面搜索或筛选时，输入别名也能找到对应邮件。
• 调用 API 时，可以直接使用别名作为 email 参数，系统会自动映射到主账号。这让你的自动化脚本无需关心底层是哪个账号在收信。

第四步：配置智能转发与 Telegram 推送

不再需要频繁刷新网页，让重要邮件主动找你。

1. 账号级开关：在导入或编辑账号时，勾选「开启转发」。
2. 全局设置：
   • 进入「设置」->「邮件转发设置」。
   • 轮询间隔：建议设置为 5-10 分钟，平衡实时性与服务器压力。
   • 时间范围：仅转发最近 X 分钟的邮件，避免重复推送旧信。
   • 渠道配置：
     • SMTP：填入你的通知邮箱 SMTP 信息。
     • Telegram：填入 Bot Token 和 Chat ID，实现手机端即时弹窗提醒。
3. 查看历史：随时在「转发历史」中检查是否有发送失败的记录，便于排查网络或配置问题。

第五步：对外 API 调用——自动化工作流的基石

通过 API，你可以让 Python 脚本、Node.js 服务甚至 AI Agent 直接读取邮件。

1. 获取 API Key：在「设置」中生成并保存你的 X-API-Key。
2. 常用调用示例：
   • 获取最新一封收件箱邮件：curl -H "X-API-Key: your-key" \   "http://localhost:5000/api/external/[email protected]&folder=inbox&top=1"
   • 聚合查询（收件箱+垃圾箱）并筛选关键词：curl -H "X-API-Key: your-key" \   "http://localhost:5000/api/external/[email protected]&folder=all&subject_contains=verify&keyword=code"
   • 处理特殊字符： 如果邮箱包含 + 或 &，请进行 URL 编码（如 + 变为 %2B）。

通过熟练掌握 OAuth 配置、别名路由和 API 调用，你可以构建出诸如“收到验证码自动填入表单”、“重要邮件推送到手机”、“垃圾邮件自动归档”等高效工作流。

• 百度网盘：https://pan.baidu.com/s/1NTdM3L4qG9zRZooBtVy7Aw?pwd=2xvb
• 夸克网盘：https://pan.quark.cn/s/5a2a570acf9f 提取码：nfY6