697 字
2 分钟
Cloud Mail 邮箱服务部署教程（Cloudflare Workers）
Cloud Mail 邮箱服务部署教程（Cloudflare Workers）
简介
Cloud Mail（SkyMail）是一个基于 Cloudflare 的简约响应式邮箱服务，支持邮件发送、附件收发、数据可视化、管理员 RBAC 权限控制与多号模式。部署到 Cloudflare Workers 可大幅降低服务器成本。
TIP官方文档：https://doc.skymail.ink/ 。邮件发送依赖 Resend，附件使用 R2 对象存储保存。
准备账号
- 注册 Cloudflare 并接入你的域名。
- 准备一个用于收发邮件的域名（如
example.com）。
部署方式一：界面部署
1. 创建 Worker 项目
- Fork 仓库 https://github.com/maillab/cloud-mail 到自己的 GitHub。
- 在 Cloudflare 控制台创建 Worker，选择「从 GitHub 导入」。
- 构建/部署目录设置为
mail-worker。
2. 设置环境变量
| 变量名 | 必需 | 用途 |
|---|---|---|
domain | ✅ | 邮箱域名，多域名用数组，如 ["example.com","example2.com"] |
admin | ✅ | 管理员邮箱地址，如 admin@example.com |
jwt_secret | ✅ | JWT 密钥，任意字符串（不要含特殊字符） |
NOTE部署后在 Worker 的「设置 → 变量」中添加以上变量，并绑定自定义域。
3. 绑定数据库
- 创建 KV 与 D1 数据库。
- 在 Worker 绑定中，变量名必须为
kv（KV 命名空间）与db（D1 数据库）。
4. 初始化并登录
- 浏览器访问
https://你的worker自定义域/api/init/你的jwt_secret初始化数据库。 - 打开自定义域名，注册管理员账号并登录。
部署方式二：GitHub Actions 部署
1. 创建 API 令牌
在 Cloudflare「My Profile → API Tokens」创建令牌，赋予 Edit Cloudflare Workers 与 D1 - Edit 权限，复制令牌与 Account ID。
2. 配置 Action Secrets / Variables
| 变量名 | 必需 | 用途 |
|---|---|---|
CLOUDFLARE_API_TOKEN | ✅ | Cloudflare API 令牌 |
CLOUDFLARE_ACCOUNT_ID | ✅ | Cloudflare 账户 ID |
CUSTOM_DOMAIN | ✅ | 访问网站的自定义域名，如 skymail.ink |
DOMAIN | ✅ | 邮箱域名，多域名用数组 |
ADMIN | ✅ | 管理员邮箱地址 |
JWT_SECRET | ✅ | JWT 密钥 |
NAME | ❌ | Worker 项目名，默认 cloud-mail |
D1_DATABASE_ID | ❌ | D1 数据库 ID |
KV_NAMESPACE_ID | ❌ | KV 命名空间 ID |
3. 开始部署
在仓库的 Actions 页面运行工作流，等待完成后设置邮件转发并登录网站即可。
设置邮件转发
无论是界面部署还是 Actions 部署，都需要在 Cloudflare 的「Email Routing（邮件路由）」中配置转发规则，将发往你域名的邮件路由到 Cloud Mail 对应的处理地址，方可正常收发。
功能与扩展
- 多号模式：开启后单个用户可添加多个邮箱。
- 附件收发：使用 R2 对象存储保存与下载文件。
- 人机验证：集成 Turnstile，防止批量注册。
- 第三方登录 / 开放 API：支持 OAuth2 与开放接口，便于二次开发。
祝你天天开心！
Cloud Mail 邮箱服务部署教程（Cloudflare Workers）
https://blog.sywan.top/posts/cloudmail/ 部分信息可能已经过时