本项目已包含一个预先配置好的 GitHub Action 工作流文件 (.github/workflows/deploy.yml),可以帮助您自动将 Vmail 应用部署到 Cloudflare Workers。
在开始之前,请确保您已经完成了 接收邮件部署教程 中的所有步骤,特别是 Cloudflare 和 Turso 的配置。
为了让 GitHub Actions 能够安全地访问您的 Cloudflare 和数据库账户,您需要将以下敏感信息配置为 GitHub 仓库的 Secrets。
前往您的 GitHub 仓库页面,点击 Settings -> Secrets and variables -> Actions,然后添加以下 Repository secrets:
| Secret Name | 说明 | 示例值 |
|---|---|---|
CF_API_TOKEN |
Cloudflare API Token,用于授权 Wrangler 操作。请确保该 Token 具有编辑 Workers 和 D1 数据库的权限。 | xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx |
CF_ACCOUNT_ID |
您的 Cloudflare 账户 ID,可以在 Cloudflare 控制台主页的右侧找到。 | xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx |
D1_DATABASE_ID |
您的 D1 数据库 ID。 | xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx |
D1_DATABASE_NAME |
您的 D1 数据库名称。 | vmail |
EMAIL_DOMAIN |
您的邮箱域名,如果多个域名请用逗号隔开。 | vmail.dev,example.com |
COOKIES_SECRET |
用于加密 Cookie 的密钥,请设置为一个随机且足够复杂的字符串。 | a-very-strong-and-random-secret |
TURNSTILE_KEY |
Cloudflare Turnstile 网站密钥 (Site Key)。 | xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx |
TURNSTILE_SECRET |
Cloudflare Turnstile 密钥 (Secret Key)。 | xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx |
配置好以上 Secrets 后,每当您向 main 分支推送(push)代码时,GitHub Action 都会自动触发,执行以下步骤:
- 检查凭据:确认
CF_API_TOKEN和CF_ACCOUNT_ID是否已设置。 - 安装与构建:安装 pnpm 依赖并构建前端和 Worker 应用。
- 数据库迁移:自动应用
worker/drizzle目录下的数据库迁移脚本到您的 D1 数据库。 - 部署应用:将构建好的应用部署到 Cloudflare。
您也可以在 GitHub 仓库的 Actions 标签页手动触发部署。
- 工作流文件 (
.github/workflows/deploy.yml) 会自动从您的 Secrets 中读取配置并应用到wrangler.toml文件中,请勿直接将敏感信息写入wrangler.toml文件。 - 如果您的数据库结构有变更(例如,修改了
worker/src/database/schema.ts),请记得生成新的迁移文件并提交到代码库中,GitHub Action 会自动帮您应用更新。