收件箱
- 请先连接 Gmail 账号
← 点击左侧邮件查看详情
发送新邮件
多个收件人用英文逗号分隔,或使用抄送/密送。发送前会弹出确认框。
批量发送(每人单独一封)
每行一个邮箱,或用逗号/分号分隔。相同内容分别发送给每个收件人(最多 200 人)。
🔄 多账号轮换发送
- 第 1 个账号向 10 个不同邮箱 各发 1 封 → 自动切第 2 个账号
- 第 2 个账号再向 10 个邮箱各发 1 封 → 继续切下一个账号
- 账号用完后从头循环,分散发送量,降低进垃圾箱风险
- 会记住上次发到哪个账号,下次换新邮箱列表时从该位置继续
- 收件人列表支持大批量(单次最多 10 万个,自动去重),后台慢慢发,请勿关闭程序
- 请先用
npm run auth -- --alias 名字授权多个账号
可用账号:加载中…
已登录的账号
- 暂无已登录账号
失效账号(需重新授权)
批量检查后,失效账号会显示在这里。点「重新授权」打开 Google 登录。
- 暂无失效账号
连接新 Gmail 账号
管理员添加的谷歌账号仅管理员可见可用;普通用户只能看到并使用自己添加的账号。
需要先在 Google Cloud 配置 OAuth,并将回调地址设为 http://localhost:3847/auth/callback
OAuth 凭据状态
检查中…
💡 多账号说明
- credentials.json 只需配置一次 — 这是「程序在 Google 的身份证」,不是每个邮箱都要配一个
- 每个 Gmail 只需 OAuth 授权一次 — 令牌保存在
accounts/文件夹,重启程序不用重新授权 - 推荐用命令行添加账号:
npm run auth -- --alias account01(多个账号改名字即可) - 重启后会自动恢复上次使用的账号,无需再去 Google 点允许
- 添加后在「已登录账号」列表点「使用此账号」可手动切换
添加登录用户
在此创建可登录前台的账号。普通用户可使用收件箱、发信、Gmail 账号管理等功能。
已创建用户
- 加载中…
Resend 发信测试
发件邮箱用 xxx@域名.com(如 noreply@域名.com)。send 主机记录是 DNS 配置用,不是发件地址里的域名。
API 配置
发送测试
Resend 完整操作步骤
按顺序完成 Resend 官网配置后,在本站「Resend 测试」页面保存 API Key 并发信测试。
一、注册 Resend
- 打开:https://resend.com
- 注册并登录(邮箱验证)
- 免费版约 每月 3000 封
二、添加并验证域名
1. 添加域名
- 左侧 Domains → Add Domain
- 域名填:
域名.com(根域名,不是mail.域名.com) - Region 选:Tokyo(ap-northeast-1)(亚洲收件人延迟低)
- 点 Add domain
2. 去域名 DNS 面板加 3 条记录
登录买域名的地方(阿里云/腾讯云等)→ DNS 解析,按 Resend 页面原样添加:
| 主机记录(名稱) | 类型 | 记录值(內容) |
|---|---|---|
resend._domainkey |
TXT | Resend 给的 DKIM 整段复制 |
send |
MX | Resend 给的 MX 地址,优先级 10 |
send |
TXT | Resend 给的 SPF(如 v=spf1 include:amazonses.com ~all) |
- Resend 的「名稱」= DNS 的「主机记录」
- Resend 的「內容」= DNS 的「记录值」
- 有的面板会自动加
域名.com后缀,按提示填即可
3. 等待并验证
- 保存后等 5~30 分钟(有时几小时)
- 回 Resend → Verify
- 显示绿色 Verified 即成功
三、创建 API Key
- 左侧 API Keys → Create API Key
- Name:随便填,如
mail-sun-mn - Permission:选 Sending access(只发信)
- 点 Add
- 立刻复制
re_xxxx...(只显示一次) - 不要发到聊天/网上,只保存在自己电脑
四、发件邮箱(重要)
| 写法 | 结果 |
|---|---|
✅ noreply@域名.com |
正确,可发送 |
❌ noreply@send.域名.com |
会报错「domain not verified」 |
send是 DNS 里的主机记录(技术用),不是发件地址里的域名- 发件人名称可填:
Bibian比比昂 {{随机码}}或【Bibian比比昂】
五、在你程序里配置(mail.域名.com)
- Ctrl + F5 刷新
- 管理员 登录
- 左侧 「📨 Resend 测试」
- 填写:
- API Key:粘贴
re_... - 发件邮箱:
noreply@域名.com - 发件人名称:如
Bibian比比昂 {{随机码}}
- API Key:粘贴
- 点 保存配置
- 填收件人、主题、正文 → 发送测试邮件
- 可点 「保存模板(含收件人)」 保存内容
配置保存在:data/resend-config.json(搬服务器时要一起拷)
程序安装与运行说明
服务器环境安装、Gmail 授权、日常启动与迁移备份。
一、需要安装的环境
| 项目 | 要求 |
|---|---|
| 操作系统 | Windows Server / Windows 10+ |
| Node.js | 18 及以上(建议 18.14+ 或 20 LTS) |
| npm | 随 Node.js 自带 |
| 浏览器 | Chrome / Edge(授权 Gmail、访问后台) |
| Caddy(可选) | 项目内已带,用于 https://mail.域名.com |
| 域名 DNS | 用域名访问时,需解析到服务器 IP |
不需要安装 Python、Java、数据库(数据在本地 data/ 文件夹)。
二、首次安装步骤
1. 安装 Node.js
- 打开 https://nodejs.org
- 下载 LTS 版本安装,勾选 Add to PATH
- CMD 验证:
node -v、npm -v
2. 拷贝项目到服务器
例如:C:\Users\Administrator\Documents\Multi-Gmail-MCP-main
3. 安装依赖
cd C:\Users\Administrator\Documents\Multi-Gmail-MCP-main npm install
4. 配置 Google OAuth(Gmail 轮换发送需要)
- Google Cloud 创建 OAuth 客户端(Web 应用)
- 下载 JSON,重命名为
credentials.json,放项目根目录 - 重定向 URI 与访问地址一致,例如:
http://mail.域名.com:3847/auth/callback- 或
https://mail.域名.com/auth/callback
5. 授权 Gmail 账号(每个邮箱一次)
cd C:\Users\Administrator\Documents\Multi-Gmail-MCP-main npm run auth
浏览器选 Gmail → 允许 → 看到 Success! Tokens saved 即成功。加更多账号:
npm run auth -- --alias account02
令牌在 accounts/ 文件夹,重启不用重新授权。
6. 开放防火墙端口
| 端口 | 用途 |
|---|---|
| 3847 | Web 程序 |
| 443 | HTTPS(Caddy) |
| 80 | HTTP 跳转(可选) |
三、日常运行步骤
方式 A:HTTPS 域名访问(推荐)
cd C:\Users\Administrator\Documents\Multi-Gmail-MCP-main start-https.bat
会启动 Gmail-Web(3847)和 Caddy-HTTPS(443)。浏览器打开 https://mail.域名.com,保持两个窗口不要关。
方式 B:只重启 Web 服务
restart-web-https.bat
方式 C:不用域名(本机或 IP 访问)
cd C:\Users\Administrator\Documents\Multi-Gmail-MCP-main set WEB_BASE_URL=http://localhost:3847 npm run web
浏览器打开 http://localhost:3847。不要用 start-https.bat(那是给域名 HTTPS 用的)。
若用服务器 IP 访问,把 localhost 换成你的 IP,例如 set WEB_BASE_URL=http://123.45.67.89:3847。
方式 D:手动启动(域名 / HTTPS)
cd C:\Users\Administrator\Documents\Multi-Gmail-MCP-main set WEB_BASE_URL=https://mail.域名.com set WEB_PORT=3847 npm run web
WEB_BASE_URL 必须和浏览器访问方式一致,否则登录 Cookie 无效。
| 访问方式 | WEB_BASE_URL |
|---|---|
http://localhost:3847 | http://localhost:3847 |
http://IP:3847 | http://IP:3847 |
http://mail.域名.com:3847 | http://mail.域名.com:3847 |
https://mail.域名.com | https://mail.域名.com |
四、登录后台
- 浏览器打开网站
- 若无
data/users.json,默认管理员:admin / admin123 - 登录后可使用:收件箱、写邮件、轮换发送、Resend 测试、用户管理等
五、换服务器要带上的文件
| 文件/文件夹 | 说明 |
|---|---|
| 整个项目代码 | node_modules 可重装 |
credentials.json | Google OAuth |
accounts/ | Gmail 授权令牌 |
data/ | 用户、Resend 配置、模板等 |
caddy/、Caddyfile | HTTPS 配置(若用 Caddy) |
新服务器执行 npm install 后运行 start-https.bat。
六、常见问题
| 问题 | 处理 |
|---|---|
| 打不开网页 | 检查 3847/443 端口、程序是否在跑 |
| 登录无反应 | WEB_BASE_URL 与浏览器地址不一致 |
| Gmail 连接失败 | 检查 credentials.json、OAuth 回调地址 |
| 改代码不生效 | restart-web-https.bat + 浏览器 Ctrl+F5 |
🌐 域名与 HTTPS
换域名时在此填写并申请免费 SSL(Let's Encrypt,由 Caddy 自动签发)。需先将域名 DNS 解析到本服务器。
- 申请成功后,请运行
restart-web-https.bat重启网站程序 - 到 Google Cloud 更新 OAuth 回调地址(下方会显示新地址)
- 若 Nginx 重载失败,请在宝塔面板手动重载 Nginx
邮件签名名称
回复邮件时使用的署名(可选,留空并保存可取消签名)
运行说明
- 将 Google OAuth 的
credentials.json放在项目根目录 - 在 Google Cloud 控制台添加授权回调地址(见上方)
- 连接账号后,在「收件箱」查看和回复邮件
- 安全提示:发送邮件前会弹出确认框,不会自动发送
命令行方式(备选)
npm install npm run web # 启动本 Web 界面 npm run auth # 命令行授权账号 npm start # 启动 MCP 服务