开源临时邮箱工具-vmail.dev

vmail.dev是国人开源的临时邮箱工具。借助Cloudflare email worker 实现的临时电子邮件服务。基于TypeScript编写，遵守GPL3.0开源协议。

功能特色：

隐私友好，无需注册，开箱即用

更好的 UI 设计，更加简洁

100% 开源，快速部署，无需服务器

原理：

接收电子邮件（email worker）

显示电子邮件（remix）

邮件存储（sqlite）

worker接收电子邮件 -> 保存到数据库 -> 客户端查询电子邮件

Demo：https://vmail.dev

源码：https://github.com/yesmore/vmail

-------------------------------------------------------------

Open source temporary email tool. 开源临时邮箱工具。

vmail.dev 

English | 简体中文

使用 Cloudflare email worker 实现的临时电子邮件服务

🌈 特点

• 🎯 隐私友好，无需注册，开箱即用
• ✨ 更好的 UI 设计，更加简洁
• 🚀 快速部署，无需服务器

原理：

• Email worker 接收电子邮件
• 前端显示电子邮件（remix）
• 邮件存储（sqlite）

worker接收电子邮件 -> 保存到数据库 -> 客户端查询电子邮件

👋 自部署教程

准备工作

• Cloudflare 账户与托管在 Cloudflare 上的域名
• turso sqlite 数据库（个人免费计划足够）
• Vercel 或 fly.io 账号部署前端用户界面

步骤

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）

查看脚本内容

2.部署 email worker

git clone https://github.com/yesmore/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加密密钥	my-secret-key
TURNSTILE_KEY	必填，网站验证所需的Turnstile Key	my-turnstile-key
TURNSTILE_SECRET	必填，网站验证所需的Turnstile Secret	my-turnstile-secret
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
EXPIRY_TIME	可选，过期时间，单位秒，默认86400	86400

Vercel:

推荐使用一键部署按钮（一步 fork + deploy 此仓库）：

或手动将代码推送到你的 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 演示如何解析：

以上，完成！

🔨 本地运行调试

复制 apps/remix/.env.example 到 apps/remix/.env 并填写必要的环境变量。

cd path-to/vmail/ # 根路径
pnpm install

# 运行 localhost:3000
pnpm run remix:dev

❤️ 交流群

• 加微信 yesmore_cc 拉讨论群 (备注你的职业)
• Discord: https://discord.gg/d68kWCBDEs

🎨 Inspired By

Please check out these previous works that helped inspire the creation of vmail. 🙏

• akazwz/smail
• email.ml

from https://github.com/briteming/vmail