73bbe44fbc
feat(email): 提取邮箱验证逻辑到共享模块并增强验证 docs: 更新文档移除不再使用的ALLOW_ORIGIN配置 style(admin): 为设置页面添加加载状态和样式优化 fix(comments): 在邮件发送前增加邮箱格式验证
109 lines
4.0 KiB
Markdown
109 lines
4.0 KiB
Markdown
# 后端配置
|
||
|
||
## 部署条件
|
||
|
||
* 拥有一个 Cloudflare 账号（使用邮箱即可注册，[官网地址](https://www.cloudflare.com/)）
|
||
* 拥有一个 Node.js 运行环境，版本 >= 22（本地部署需要）
|
||
* 拥有一个域名并托管在 Cloudflare 上（这个不是必须项，但可以提高国内访问速度，也更方便）
|
||
|
||
## 部署
|
||
|
||
**以下部署指令均在该目录下执行，不在根目录下**
|
||
|
||
```
|
||
cd cwd-comments-api
|
||
```
|
||
|
||
### 本地部署
|
||
|
||
#### 1. 下载代码，安装依赖
|
||
|
||
可以直接克隆仓库代码
|
||
|
||
```
|
||
npm install
|
||
```
|
||
|
||
#### 2. 配置 Cloudflare Workers
|
||
|
||
对于 D1 和 KV 配置，有两种方法，第一种是直接使用命令行配置，第二种是使用网页面板创建后填写配置文件，这里推荐使用第一种方法。如果想要使用之前 Cloudflare 上面已经创建的数据库，可以选择自行配置 `wrangler.jsonc` 文件。
|
||
|
||
下面介绍第一种方法。
|
||
|
||
* **登录到 Cloudflare**
|
||
```bash
|
||
npx wrangler login
|
||
```
|
||
* **创建数据库和数据库表**，如果遇到提示，请按回车继续
|
||
```bash
|
||
npx wrangler d1 create CWD_DB
|
||
npx wrangler d1 execute CWD_DB --remote --file=./schemas/comment.sql
|
||
```
|
||
运行完成后可以确认一下 `wrangler.jsonc` 中是否有如下配置
|
||
```jsonc
|
||
"d1_databases": [
|
||
{
|
||
"binding": "CWD_DB",
|
||
"database_name": "CWD_DB",
|
||
"database_id": "xxxxxx" // D1 数据库 ID
|
||
}
|
||
]
|
||
```
|
||
如果`binding`字段不是`CWD_DB`，请修改为`CWD_DB`
|
||
|
||
* **创建 KV 存储**，如果遇到提示，按回车继续
|
||
```bash
|
||
npx wrangler kv namespace create CWD_AUTH_KV
|
||
```
|
||
运行完成后可以确认一下 `wrangler.jsonc` 中是否有如下配置
|
||
```jsonc
|
||
"kv_namespaces": [
|
||
{
|
||
"binding": "CWD_AUTH_KV",
|
||
"id": "xxxxxxx" // KV 存储 ID
|
||
}
|
||
]
|
||
```
|
||
* **部署上线**
|
||
```bash
|
||
npm run deploy
|
||
```
|
||
|
||
没有异常报错后，可以进入Cloudflare Workers 面板查看是否部署成功，若显示存在一个名称为 `cwd-backend-worker` 的项目即推送成功。
|
||
|
||
#### 3. 配置环境变量
|
||
|
||
* 登录 Worker 面板，点击项目右侧的 Settings (设置) 选项卡，选择`查看设置`
|
||
* 点击变量和机密右侧的添加按钮，给项目添加环境变量，环境变量[参考](#环境变量)
|
||
* 部署生效：点击底部的 Save and deploy (保存并部署)。
|
||
|
||
#### 4. 检测部署情况
|
||
|
||
部署成功后回得到一个域名，即为后端的域名（格式一般为`https://cwd-backend-worker.xxx.workers.dev`。访问该域名，如果显示后端管理页面并可以正常登录则部署成功，将此域名填写到博客的配置文件中即可使用评论功能。
|
||
|
||
当然也可以使用自定义域名，注意不要使用三级域名，即`*.*.example.com`。
|
||
|
||
## 环境变量
|
||
|
||
所需环境变量如下表所示，请参考源码中 `.dev.vars.example` 文件
|
||
|
||
| 变量名 | 描述 |
|
||
| -------------------- | ------------------------------------------------------------------------------------ |
|
||
| `CF_FROM_EMAIL` | 作为发件人显示的邮箱地址（需在 Cloudflare Email 路由中预先配置） |
|
||
| `EMAIL_ADDRESS` | 管理员接收通知邮件的默认邮箱（可在后台设置中覆盖） |
|
||
| `ADMIN_NAME` | 管理员登录名称，默认为 admin |
|
||
| `ADMIN_PASSWORD` | 管理员登录密码，默认密码为 password |
|
||
|
||
**注:** 需要在 Cloudflare 控制面板中为 Email 路由开启发送权限并配置发件人域和地址，并在 `wrangler.jsonc` 中为 Worker 添加 `send_email` 绑定，以便在代码中通过 `env.SEND_EMAIL.send()` 直接发信。
|
||
|
||
|
||
## 本地测试
|
||
|
||
如果需要本地测试，环境变量可以使用 `.dev.vars` 文件来设置
|
||
|
||
```bash
|
||
cp .dev.vars.example .dev.vars
|
||
# 编辑 .dev.vars 文件
|
||
npm run dev
|
||
```
|