文章摘要
BiuXin - AI

简介

WR.DO 是一个一站式网络工具平台,集成短链服务、临时邮箱、子域名管理和开放API接口。支持自定义链接、密码保护、访问统计;提供无限制临时邮箱收发;管理多域名DNS记录;内置网站截图、元数据提取等实用API。完整的管理后台,支持用户权限控制和服务配置。


🧰 前置准备

  1. 一个 GitHub 账号 👉 https://github.com
  2. 一个 Vercel 账号 👉 https://vercel.com (也可以直接使用 GitHub 直接登录)
  3. .env中的坏境变量

演示站点

⚙️ 坏境变量获取

数据库 DATABASE_URL 环境变量获取

  1. 数据库环境变量,这里我使用的是 Neon

  2. 没有账号的点进去注册好账号后点击 New project 创建一个数据库

Neon数据库

  1. 创建好后点击 Connect 就可以看见连接信息,记得把下面的眼睛打开在复制哦

Neon数据库连接信息

配置身份验证服务

Github 获取认证方式

  1. 点击链接按照以下方式创建

Github认证登录

变量env

1
2
GITHUB_ID = your_secret_client_id;
GITHUB_SECRET = your_secret_client;

Linux.do 获取认证方式

  1. 打开 Linux.do后,点击我的应用接入点击申请新接入,然后保存

Linux.do

1
2
LinuxDo_CLIENT_ID=
LinuxDo_CLIENT_SECRET=

电子邮件验证配置

  1. 创建一个帐户

  2. 如果您没有 Resend 帐户,请在此处注册后按照他们的步骤操作。

  3. 创建好后点击 Domains 右上角的 + ADD Domain ,然后输入你打算做域名邮箱的域名,添加好后解析以下DNS即可

DNS解析

  1. 等解析成功点击左边的的 API keys 创建你的密钥即可

API keys

1
2
RESEND_API_KEY=re_your_resend_api_key;
RESEND_FROM_EMAIL="admin@biu.cc"

添加 GITHUB_TOKEN 环境变量

  1. 通过 https://github.com/settings/tokens 获取您的令牌。创建好后点击就会看到Token了

GITHUB_TOKEN

1
GITHUB_TOKEN=ghp_

CFR2变量获取前提你已开通R2,开通后按照以下步骤获取

  1. 点击CF网站左边的R2对象存储,概述,然后创建存储桶

创建存储桶

  1. 点击设置常规下面的自定义域

自定义域

1
NEXT_PUBLIC_EMAIL_R2_DOMAIN = 你添加的自定义域名

.env文件

环境变量 描述
NEXT_PUBLIC_APP_URL 你的网站URL The URL of the Next.js application.
AUTH_SECRET 222222 The secret used to encrypt tokens and email verification hashes.
AUTH_URL http://localhost:3000 NextAuth.js callback URL。
DATABASE_URL postgres://username:password@host:port/database The path to the database.
GOOGLE_CLIENT_ID 222222 The ID of the Google OAuth client.
GOOGLE_CLIENT_SECRET 222222 The secret of the Google OAuth client.
GITHUB_ID 222222 The ID of the GitHub OAuth client.
GITHUB_SECRET 222222 The secret of the GitHub OAuth client.
RESEND_API_KEY re_ The API key for Resend.
RESEND_FROM_EMAIL "admin@biu.cc" The email address to send emails from.
NEXT_PUBLIC_OPEN_SIGNUP 1 Open signup.
NEXT_PUBLIC_ENABLE_SUBDOMAIN_APPLY 0 Enable subdomain apply.
SCREENSHOTONE_BASE_URL https://api.example.com pending

🚀 一键部署到 Vercel(推荐)

Deploy with Vercel

Vercel变量

你也可以直接去仓库 Fork ,这样更新方便

Fork后填写以下变量

1
2
3
4
5
6
7
8
9
10
11
DATABASE_URL = 数据库URL
AUTH_URL = 主网站URL
NEXT_PUBLIC_APP_URL = 主网站URL
GITHUB_ID = 前面获取的
GITHUB_SECRET = 前面获取的
GITHUB_TOKEN = 前面获取的
AUTH_SECRET = 您可以从 https://generate-secret.vercel.app/32 生成一个
RESEND_API_KEY = 邮件API keys
NEXT_PUBLIC_EMAIL_R2_DOMAIN = CFR2域名或者R2存储桶自定义域名
SKIP_DB_CHECK = false
SKIP_DB_MIGRATION = alse

进入网站设置

  1. 设置系统
  2. 创建第一个帐户并将帐户角色更改为 ADMIN
  3. 请按照以下步骤操作:
  • 通过http://你的网站URL/login使用您的帐户登录。
  • 通过http://你的网站URL/setup,将帐户的角色更改为 ADMIN。
  • 然后按照面板指南配置系统并添加第一个域。

网站设置

网站域名

添加一个域开始使用短链接、电子邮件或子域管理功能

域名设置

  1. 点击网站左边 ADMIN 下的 Domains 点击右边的 + Add Domain

  2. Zone ID 获取,打开Cloudflare官网进入你的域名下,右边的API下面的区域ID就是你的 Zone ID

Zone ID

  1. API Token 获取
  • 点击右上方的配置文件,点击左边的 API令牌,查看你的API密钥

API密钥

  1. Account Email 就是你注册 Cloudflare的邮箱 ,可以在 API令牌上面的设置中看到

这样我们的配置就完成了。需要开启接收邮件我们还需要部署一个 Worker 。


Worker配置的方式。

  1. 打开GitHub 链接Fork到你的 Github下面

  2. 修改 wrangler.jsonc里面的 三个变量

1
2
3
APP_API_URL": "https://你的网站地址/api/v1/email-catcher
ENABLE_ATTACHMENTS": "1" 是否启用保存附件到R2。默认 1 表示启用,0 表示不启用
bucket_name": "你的存储通名称"
  1. 回到 Cloudflare 官网点击 Worker 和pages 点击 创建导入存储库的方式选择Fork的电子邮件项目,点击保存和部署

也可以不用 pnpm install 这个构建命令,直接加好变量部署即可。

Worker部署

  1. 在你的域名下面找到电子邮件启用电子邮件路由,点击跳过指南。点击启动电子邮件路由然后点击下面的添加记录并启用

  2. 找到路由规则点击后面的启用,打开编辑设置

编辑设置

  1. 这是我们搭建好的收到邮件的界面

邮件

  1. 如遇收不到邮件的问题可以在Vercel添加一个别的域名,比如mi.231110.xyz,记得把Worker的URL也改成你这个。

这样邮件设置就完成了

本教程只适用于本版本的搭建和部署,至于后面升级部署的方式请自行探索。谢谢