体验站点#

https://aso.de5.net admin123 注意：体验站点请勿修改密码或存放实际数据，部署在无持久化的服务上，数据随时可能丢失恢复初始状态

方式一：下载 Windows exe(win可用)#

从 GitHub Releases 下载对应版本的 OutlookEmail-windows-x64-*.zip，解压后直接运行 OutlookEmail.exe 即可。

桌面版首次启动会自动：

• 生成并持久化 SECRET_KEY
• 创建本地数据目录和 SQLite 数据库
• 启动 Web 服务，默认地址 http://127.0.0.1:5000

说明：

• Windows 数据默认保存在 %APPDATA%\OutlookEmail
• 默认登录密码仍然是 admin123，首次登录后建议立即修改

方式二：使用 Docker（推荐服务器部署）#

1
# 拉取最新镜像
2
docker pull ghcr.io/assast/outlookemail:latest
3

4
# 运行容器
5
docker run -d \
6
  --name outlook-mail-reader \
7
  -p 5000:5000 \
8
  -v $(pwd)/data:/app/data \
9
  -e LOGIN_PASSWORD=admin123 \
10
  -e SECRET_KEY=your-secret-key-here \
11
  ghcr.io/assast/outlookemail:latest

方式三：使用 Python 直接运行#

1
git clone https://github.com/assast/outlookEmail.git
2
cd outlookEmail
3
pip install -r requirements.txt
4
export SECRET_KEY=your-secret-key-here
5
python web_outlook_app.py

访问 http://localhost:5000 即可使用。 如果是服务器部署，仍然建议显式设置固定 SECRET_KEY。

使用 Docker Compose#

1
version: '3.8'
2
services:
3
  outlook-mail-reader:
4
    image: ghcr.io/assast/outlookemail:latest
5
    container_name: outlook-mail-reader
6
    ports:
7
      - "5000:5000"
8
    volumes:
9
      - ./data:/app/data
10
    environment:
11
      - LOGIN_PASSWORD=admin123
12
      - SECRET_KEY=your-secret-key-here
13
      - FLASK_ENV=production
14
    restart: unless-stopped

1
docker-compose up -d

邮件读取方式#

本工具当前包含三类读取链路：

1. Outlook/Hotmail OAuth + Graph API - 优先方式，适合 Outlook / Hotmail / Live 账号
2. Outlook/Hotmail OAuth + IMAP 回退 - outlook.live.com / outlook.office365.com
3. 标准 IMAP - 适用于 Gmail、QQ、163、126、Yahoo、阿里邮箱和自定义 IMAP

Web 应用功能#

界面布局#

Web 应用采用四栏式布局设计：

1. 分组面板 - 显示所有邮箱分组，点击切换
2. 邮箱面板 - 显示当前分组下的邮箱账号列表
3. 邮件列表 - 显示选中邮箱的邮件，支持切换文件夹和滚动加载
4. 邮件详情 - 显示选中邮件的完整内容（支持 HTML 渲染）

邮箱列表界面#

全局搜索功能#

导入邮箱账号#

Token 刷新管理#

标签管理功能#

1. 获取 OAuth2 凭证（这一步非必须，买的账号如果是带令牌的可以跳过这一步）#

要使用本工具，您需要获取以下 OAuth2 凭证：

1. Client ID - Microsoft Azure 应用注册的客户端 ID
2. Refresh Token - OAuth2 刷新令牌

步骤 1：注册 Azure 应用（这一步看目前的情况得E3 或者 E5 或者其他的开发者账号才能创建）#

访问 Azure Portal，进入「应用注册」：

步骤 2：创建新应用#

点击「新注册」，填写应用信息：

• 名称：自定义应用名称
• 支持的账户类型：选择「任何组织目录中的账户和个人 Microsoft 账户」
• 重定向 URI：选择「公共客户端/本机」，填写 http://localhost:8080

步骤 3：获取应用程序 ID#

创建完成后，复制「应用程序(客户端) ID」：

步骤 5：获取 Refresh Token#

使用本工具内置的 OAuth2 助手获取 Refresh Token：

1. 在 Web 界面点击「获取 Token」按钮
2. 点击「生成授权链接」
3. 复制链接到浏览器打开，完成授权
4. 复制授权后的完整 URL（处于安全考虑，我没有统一建设授权回调服务，所有授权都在自己部署的服务内完成，不会外泄，所以重定向URI为http://localhost:8080，这个链接肯定是打不开的，所以要复制过来在部署的服务走后半段的换取Refresh Token）
5. 粘贴到「授权后的 URL」输入框
6. 点击「换取 Token」按钮
7. 复制获得的 Refresh Token

2. 导入邮箱账号#

在 Web 界面中点击「导入邮箱」后，可根据邮箱类型选择对应导入格式。

1
邮箱----密码----client_id----refresh_token
2
邮箱----密码----refresh_token----client_id

1
user@outlook.com----password123----24d9a0ed-8787-4584-883c-2fd79308940a----0.AXEA...

1
邮箱----IMAP授权码/应用密码

1
user@gmail.com----app-password
2
user@qq.com----imap-auth-code

1
邮箱----IMAP密码
2
邮箱----IMAP密码----imap_host----imap_port

1
user@example.com----app-password
2
user@example.com----app-password----imap.example.com----993

3. 查看邮件#

1. 从左侧选择分组
2. 选择邮箱账号
3. 点击「获取邮件」按钮
4. 在 Web 界面切换「收件箱」「垃圾邮件」查看邮件
5. 滚动到邮件列表底部自动加载下一页（每页 20 封）
6. 点击邮件查看详情，支持 HTML 渲染与全屏查看
7. 需要查看 deleteditems 或 all 聚合结果时，建议使用对外 API 或内部 API

4. 别名管理#

1. 打开某个邮箱账号的「编辑账号」
2. 在「别名邮箱」中按行填写多个别名
3. 保存后，主邮箱和别名都会指向同一个账号

适合这些场景：

• 同一账号有多个注册邮箱名称
• 某些站点使用了 user+tag@example.com
• 外部邮箱自动转发到本项目管理邮箱后，希望继续用原邮箱名来取信

5. 邮件转发#

邮件转发分成两层控制：

1. 账号级开关 在导入账号或编辑账号时，选择是否为该账号开启转发
2. 全局转发设置 在「设置 -> 邮件转发设置」中配置：
   • 轮询间隔
   • 转发邮件时间范围
   • 是否转发垃圾箱邮件
   • 转发渠道（SMTP / Telegram）
   • SMTP / Telegram 的具体参数

补充说明：

• 转发轮询只处理“账号里已开启转发”的邮箱
• 可以手动触发一次转发检查
• 可以查看最近转发历史和失败记录

6. 对外 API#

通过 API Key 直接获取邮件，无需登录 Web 界面。

当前额外支持：

• 使用主邮箱或别名邮箱取信
• folder=all 一次聚合收件箱和垃圾邮件并按时间排序，top 按每个文件夹分别计算
• 支持按主题、发件人、关键词筛选列表
• 支持特殊字符别名，例如 user+alias@example.com
• 默认 top=1

配置步骤：

1. 点击「⚙️ 设置」→ 在「对外 API Key」处点击「🔑 随机生成」→ 保存

调用示例：

1
curl -H "X-API-Key: your-api-key" \
2
  "http://localhost:5000/api/external/emails?email=user@outlook.com&folder=inbox"
3

4
curl -H "X-API-Key: your-api-key" \
5
  "http://localhost:5000/api/external/emails?email=alias@example.com&folder=all&top=10"
6

7
curl -H "X-API-Key: your-api-key" \
8
  "http://localhost:5000/api/external/emails?email=alias@example.com&folder=all&top=10&subject_contains=verify&from_contains=github&keyword=reset"
9

10
curl -H "X-API-Key: your-api-key" \
11
  "http://localhost:5000/api/external/emails?email=user%2Balias%40example.com"

如果邮箱或别名里带特殊字符：

• @ 可以直接传
• + 建议编码成 %2B
• & 必须编码成 %26

如果你把外部邮箱 B 自动转发到本项目管理的邮箱 A，再把 B 配成 A 的别名，那么后续可以直接用 B 作为 email 参数调用对外 API。

详细文档见 API 文档。

后端技术栈#

• 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+ 内存

Gmail怎么获取应用密码#

开启二验，然后在这里创建应用密码 https://support.google.com/mail/answer/185833?hl=zh-Hans