- 项目介绍与功能演示
- 一体化 Worker 部署到 Cloudflare 的详细步骤
- Fork 项目并自定义配置的方法
- 配置 Cloudflare Email 路由
- 设置环境变量与 D1 数据库
ZMAIL 现在采用全新的一体化部署方式,前端和后端整合为一个 Cloudflare Worker,部署更加简单!
我们提供两种部署方式,您可以根据需求选择:
- 部署简单,一键完成
- 无需修改配置文件
- 适合快速体验
- 无法获得后续代码更新
- 需要手动绑定自定义域名
- 点击上方 "Deploy to Cloudflare" 按钮
- 按照页面提示连接您的 GitHub 账户
- 填写应用名称和数据库名称
- 在高级设置 -> 构建变量中设置:
VITE_EMAIL_DOMAIN
: 您的域名列表,使用 ',' 分割 (例如: mdzz.uk,zaunist.com)
- 点击"创建和部署"
- 部署完成后,在 Cloudflare Workers 控制面板中绑定自定义域名
- 配置 Cloudflare Email 路由,将邮件转发到您的 Worker
- 可以获得后续代码更新
- 完全自定义配置
- 更好的版本控制
- 需要手动修改配置文件
- 需要一定的技术基础
- 需要手动创建数据库
- Fork 本项目到您的 GitHub 账户
- 在 Cloudflare Dashboard 中创建一个 D1 数据库,记住数据库的 name 和 id
- 修改根目录下的
wrangler.toml
文件:- 修改
name
为您的应用名称。(可选) - 修改
routes
中的自定义域名。(必须!默认的worker.dev域名在中国大陆无法访问) - 修改
database_name
和database_id
为您的 D1 数据库信息。(必须!) - 修改
VITE_EMAIL_DOMAIN
为您的域名列表。(可选,只是方便网页上复制粘贴邮件地址使用,不设置也不影响接收邮件)
- 修改
- 在 Cloudflare Dashboard 中选择 "Workers & Pages"
- 点击 "Create application" -> "Pages" -> "Connect to Git"
- 选择您 Fork 的仓库
- 配置构建设置(通常会自动检测)
- 点击 "Save and Deploy"
- 配置 Cloudflare Email 路由,将邮件转发到您的 Worker
无论选择哪种部署方式,都需要配置 Cloudflare Email 路由:
- 在 Cloudflare 控制面板中找到您的域名
- 进入 "Email" -> "Email Routing"
- 启用 Email Routing
- 添加路由规则:
- 匹配类型:"Catch-all address"
- 操作:"Send to a Worker"
- 选择您部署的 Worker
- 如果有多个域名,请为每个域名重复上述步骤
# 安装依赖
pnpm install
# 启动前端开发服务器
pnpm dev:frontend
# 启动后端开发服务器
pnpm dev:backend
# 部署
pnpm run deploy
欢迎提交Pull Request或Issue来改进这个项目!