1.注册一个 turso 账户,创建数据库,并创建一个emails
表
注册后,系统会提示您创建一个数据库。在这里我将其命名为 vmail
,
然后,创建一个名为 emails
的表。
选择您的数据库,您会看到“编辑表”按钮,点击并进入:
⚠️ 注意:左上角有一个加号按钮,我尝试点击它没有任何提示或效果,所以我使用了 turso 提供的 cli 来初始化表。
Cli 文档:https://docs.turso.tech/cli/introduction
Linux (或 mac/windows) 终端执行:
# 安装(安装后记得重启终端生效)
curl -sSfL https://get.tur.so/install.sh | bash
# 登录账户
turso auth login
# 连接到您的Turso数据库
turso db shell <database-name>
将sql脚本复制到终端运行(packages/database/drizzle/0000_sturdy_arclight.sql)
查看脚本内容
CREATE TABLE `emails` (
`id` text PRIMARY KEY NOT NULL,
`message_from` text NOT NULL,
`message_to` text NOT NULL,
`headers` text NOT NULL,
`from` text NOT NULL,
`sender` text,
`reply_to` text,
`delivered_to` text,
`return_path` text,
`to` text,
`cc` text,
`bcc` text,
`subject` text,
`message_id` text NOT NULL,
`in_reply_to` text,
`references` text,
`date` text,
`html` text,
`text` text,
`created_at` integer NOT NULL,
`updated_at` integer NOT NULL
);
2.部署 email worker
git clone https://github.com/oiov/vmail
cd vmail
# 安装依赖
pnpm install
在 vmail/apps/email-worker/wrangler.toml
文件中填写必要的环境变量。
- TURSO_DB_AUTH_TOKEN(第1步中的turso表信息,点击“Generate Token”)
- TURSO_DB_URL(例如 libsql://db-name.turso.io)
- EMAIL_DOMAIN (域名,如 vmail.dev)
如果您不执行此步骤,可以在Cloudflare的 worker settings 中添加环境变量
然后运行命令:
cd apps/email-worker
# 需要 Node 环境,并且需要安装 wrangler cli 并在本地登录,参考 https://developers.cloudflare.com/workers/wrangler/install-and-update
pnpm run deploy
3.配置电子邮件路由规则
设置“Catch-all”操作为发送到 email worker:
4.在 Vercel 或 fly.io 上部署 Remix 应用程序
确保在部署时准备并填写以下环境变量(.env.example
):
变量名 | 说明 | 示例 |
---|---|---|
COOKIES_SECRET | 必填,cookie加密密钥,随机字符串 | 12345abcde |
TURSO_DB_RO_AUTH_TOKEN | 必填,turso数据库只读凭据 | my-turso-db-ro-auth-token |
TURSO_DB_URL | 必填,turso数据库URL | libsql://db-name.turso.io |
EMAIL_DOMAIN | 必填,域名后缀,支持多个 | vmail.dev,meetu.dev |
EXPIRY_TIME | 可选,邮箱过期时间,单位秒,默认86400 | 86400 |
TURNSTILE_KEY | 可选,网站验证所需的 Turnstile Key | my-turnstile-key |
TURNSTILE_SECRET | 可选,网站验证所需的 Turnstile Secret | my-turnstile-secret |
获取 TURNSTILE_KEY
、TURNSTILE_SECRET
请前往 cloudflare 控制台 https://dash.cloudflare.com/[account-id]/turnstile
Vercel:
推荐使用一键部署按钮(此操作会在你的github账户中自动创建vmail仓库并关联部署到vercel):
或手动将代码推送到你的 Github 仓库,并在 Vercel 面板中创建项目。选择 New project
,然后导入对应的 Github 仓库,填写环境变量,选择 Remix
框架,点击 Deploy
,等待部署完成。
部署完后继续点击 Countinu to Dashboard,进入 Settings -> General,修改下面设置:
然后进入 Deployments 重新部署一次,或向 github 推送代码重新触发部署。
fly.io:
cd vmail/apps/remix
fly launch
5.部署成功后在 cloudflare 添加域名解析(A记录)到对应平台,就可以愉快的玩耍了
vercel 演示如何解析:
以上,完成!