之前使用QQ邮箱APP，但是经常有延迟，不提醒，经过各位的提醒发现直接谷歌转QQ邮箱然后设置微信提醒确实很及时，不过需要在APP里面把新邮件提醒关闭，因为QQ邮件服务器是按照APP的设置来提醒的，而不是按照微信提醒的设置来提醒的。

本项目在即时接受邮件上确实不方便，但是还是有一定可取之处，适合多邮箱或者不想将gmail内容暴露给QQ邮箱，需要定时检查邮箱的用户。

邮件转发微信机器人

一个自动将Gmail、QQ邮箱和Outlook的新邮件转发到企业微信群的服务。支持多邮箱配置，部署在Vercel上，无需自己的服务器。

功能特点

• 支持多个Gmail、QQ邮箱和Outlook的IMAP监控
• 每个邮箱类型使用不同图标，方便识别
• 实时转发新邮件到企业微信群机器人
• 显示北京时间的邮件接收时间
• 自动@所有人提醒
• 部署在Vercel上，免费且无需维护
• 使用cron-job.org进行定时触发
• 支持手动触发检查

配置步骤

1. 邮箱配置

Gmail配置

1. 登录Gmail账号
2. 开启两步验证访问 Google账号安全设置
3. 生成应用专用密码：
   • 访问 应用专用密码设置
   • 选择"其他"，输入名称（如"Mail-Trans"）
   • 复制生成的16位密码

QQ邮箱配置

1. 登录QQ邮箱
2. 开启IMAP服务：
   • 设置 -> 账户 -> POP3/IMAP/SMTP/Exchange/CardDAV/CalDAV服务
   • 开启"IMAP/SMTP服务"
3. 生成授权码（将作为密码使用）

Outlook配置

1. 确保使用Microsoft 365账户
2. 开启IMAP访问：
   • 登录Outlook网页版
   • 设置 -> 查看所有Outlook设置 -> 邮件 -> POP和IMAP
   • 确保IMAP已启用
3. 如果开启了双重认证：
   • 访问 安全信息
   • 生成应用密码并使用它代替普通密码

2. 企业微信配置

1. 在企业微信群中添加机器人
2. 复制机器人的Webhook地址

3. 环境变量配置

有两种方式配置环境变量：

方式一：本地开发使用 .env 文件

创建 .env 文件，填入以下信息：

# Gmail配置 (多个账号用逗号分隔)
[email protected],[email protected]
GMAIL_PASSWORDS=password1,password2

# QQ邮箱配置 (多个账号用逗号分隔)
[email protected],[email protected]
QQ_PASSWORDS=password1,password2

# Outlook邮箱配置 (多个账号用逗号分隔)
[email protected],[email protected]
OUTLOOK_PASSWORDS=password1,password2

# 微信机器人配置
WEIXIN_WEBHOOK=企业微信机器人的Webhook地址

# 安全配置
API_KEY=自定义的API密钥（用于手动触发检查）

方式二：Vercel部署使用环境变量（推荐）

在Vercel部署时，建议使用Vercel的环境变量功能：

1. 在Vercel项目设置中找到"Environment Variables"
2. 添加上述相同的环境变量
3. 可以为不同环境（Production/Preview/Development）设置不同的值
4. 环境变量会被加密存储，更安全

环境变量说明

1. 邮箱配置格式：

   • 多个邮箱地址用英文逗号分隔
   • 密码顺序要与邮箱地址一一对应
   • 示例：[email protected],[email protected]

2. 密码说明：

   • Gmail：使用应用专用密码
   • QQ邮箱：使用授权码
   • Outlook：使用应用密码或账户密码

3. 安全建议：

   • 不要将 .env 文件提交到代码仓库
   • 在生产环境使用Vercel的环境变量
   • 定期更换API_KEY
   • 建议对每个邮箱使用单独的应用密码

4. 可选配置：

   # 检查间隔（分钟，默认5）
   CHECK_INTERVAL=5
   
   # 是否启用特定邮箱服务
   ENABLE_GMAIL=true
   ENABLE_QQ=true
   ENABLE_OUTLOOK=true
   
   # 调试模式
   DEBUG=false
   

4. Vercel部署

1. 安装Vercel CLI：

npm i -g vercel

2. 登录Vercel：

vercel login

3. 部署项目：

vercel

5. 定时任务配置

使用 cron-job.org 设置定时触发：

1. 注册并登录cron-job.org
2. 创建新的定时任务：
   • URL：https://你的vercel域名/wake
   • 执行频率：建议每5分钟一次
   • 超时时间：默认值即可
   • 失败重试：建议开启，最多重试2次

关于检查频率的说明：

• 建议设置为5分钟，这样每月约8,640次请求
• Vercel免费版每月限制100,000次请求
• 设置过短的间隔（如1分钟）会快速消耗免费额度
• 过于频繁的请求可能触发邮箱服务器的限制

6. Vercel免费额度说明

Vercel的免费计划（Hobby Plan）包含：

• 每月100,000次函数调用
• 每个函数最长执行时间10秒
• 每月100GB带宽

以5分钟检查一次计算：

• 每小时12次请求
• 每天288次请求
• 每月约8,640次请求
• 占用免费额度约8.6%

API接口说明

1. /wake：触发邮件检查（用于定时任务）

   • 无需认证
   • 立即返回，后台执行检查

2. /check：手动触发检查（需要API密钥）

   • 需要在请求头中加入 X-API-Key

   curl -H "X-API-Key: 你的API密钥" https://你的域名/check

3. /status：查看服务状态

   • 显示最后检查时间和状态
   • 显示错误统计
   • 显示当前是否正在检查

4. /test：测试微信机器人连接

   • 发送测试消息到企业微信群
   • 验证配置是否正确

注意事项

1. 多邮箱配置注意事项：

   • 确保邮箱地址和密码的数量匹配
   • 不同邮箱使用不同图标便于区分
   • 每个邮箱独立检查，互不影响

2. Gmail注意事项：

   • 需要开启两步验证
   • 使用应用专用密码而不是账号密码
   • 需要允许不够安全的应用访问

3. QQ邮箱注意事项：

   • 必须开启IMAP服务
   • 使用授权码而不是QQ密码
   • 确保邮箱已绑定手机号

4. Outlook注意事项：

   • 推荐使用Microsoft 365账户
   • 确保IMAP访问已启用
   • 双重认证用户需使用应用密码

5. 企业微信机器人：

   • Webhook地址要保密
   • 消息会自动@所有人
   • 邮件内容限制在500字以内

6. 定时任务：

   • 使用cron-job.org确保服务持续运行
   • 建议每5分钟触发一次
   • 重复的检查会自动跳过

故障排查

1. 邮件没有转发：

   • 检查各个邮箱配是否正确
   • 访问 /status 查看服务状态
   • 使用 /test 测试机器人连接
   • 手动触发 /check 测试

2. 服务不稳定：

   • 确认cron-job.org定时任务正常运行
   • 检查Vercel部署日志
   • 查看 /status 接口的错误统计

3. 特定邮箱不工作：

   • 检查该邮箱的IMAP设置
   • 确认密码/授权码是否正确
   • 查看日志中的具体错误信息

开发说明

• 使用Python FastAPI框架
• 支持异步处理和后台任务
• 使用exchangelib处理Outlook邮箱
• 使用imapclient处理Gmail和QQ邮箱
• 所有时间均已转换为北京时间
• 包含完整的错误处理和日志记录

许可证

MIT License