cloudflaremail

KO | EN

gitlite — search

#hacktoberfest #go #golang #machine-learning #rust #linux #windows #awesome #cli #kubernetes #vue #pytorch #security #open-source

(★ 15)

一个基于 PHP 的临时/长期邮箱管理系统，支持 OAuth 登录、用户邮箱初始化、管理员邮箱分配、实时收件查看，以及通过 api.php 对外读取邮件数据

cloudflaremail Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# 临时邮箱系统
一个基于 PHP 的临时邮箱管理系统，支持 OAuth 登录、用户邮箱初始化、管理员邮箱分配、实时收件查看，以及通过 `api.php` 对外读取邮件数据。
> 本次重构中，**保留了 `api.php` 的收信/取信能力与接口入口不变**，重点对项目结构、命名规范、控制器职责、视图分离和后台界面进行了整理与标准化。
---

## 一、部署 CF Worker

### 1. 登录 Cloudflare
登录 [Cloudflare](https://dash.cloudflare.com/) 控制台。

### 2. 创建 Worker
依次进入：

**Compute → Workers & Pages → Create application → Start with Hello World!**

创建完成后，点击右上角的 **Edit code**。

### 3. 粘贴代码
- 删除编辑器中的原有代码
- 全选粘贴 `worker.js` 的所有代码

### 4. 保存部署
点击 **Deploy** 保存。

---

## 二、配置 Worker 变量

进入该 Worker 的：

**Settings → Variables and Secrets**

添加以下两个变量：

### 1. 第一条变量
- **Type**：`Secret`
- **Variable name**：`API_TOKEN`
- **Value**：`api.php` 里的 `API_BEARER_TOKEN`

### 2. 第二条变量
- **Type**：`Text`
- **Variable name**：`PHP_API_URL`
- **Value**：`https://domain.com/api.php`

> 其中 `domain.com` 替换为你的域名。

---

## 三、将域名邮件转到 CF Worker

点击你的域名，进入：

**Email → Email Routing → Routing rules**

找到 **Catch-all address**

- **Status**：开启

然后点击编辑，设置：

- **Action**：选择 `Send to a Worker`
- **Destination**：选择刚刚创建的 Worker

最后点击 **保存**。

---

## 四、OAuth 配置

### 1. 注册账号
前往：

https://opid.top/

### 2. 创建应用
进入：

**开发者选项 → 创建应用**

填写如下信息：

- **应用名称**：随意
- **重定向 URI**：`https://domain.com/client/callback.php`

> 其中 `domain.com` 替换为你的域名。

### 3. 获取凭据
创建完成后，获取以下信息：

- `Clientid`
- `client_secret`

请妥善保存，后续会用到。

---

## 五、配置汇总

### Worker 变量

| 类型 | 变量名 | 值 |
|------|--------|----|
| Secret | `API_TOKEN` | `api.php` 中的 `API_BEARER_TOKEN` |
| Text | `PHP_API_URL` | `https://domain.com/api.php` |

### OAuth 配置

| 项目 | 内容 |
|------|------|
| 应用名称 | 任意 |
| 重定向 URI | `https://domain.com/client/callback.php` |
| 获取信息 | `Clientid`、`client_secret` |

---

## 六、注意事项
- 网站首个注册的账号自动为管理员
- `domain.com` 需要替换为你自己的真实域名
- `API_TOKEN` 必须与 `api.php` 中的 `API_BEARER_TOKEN` 保持一致
- `PHP_API_URL` 必须填写可正常访问的完整地址
- OAuth 的回调地址必须与应用中填写的重定向 URI 完全一致
- 如果有多个域名，可以分别在各自的 **Email Routing** 中将邮件转发到同一个 Worker

---

## 七、演示图片

### 1. Worker 变量配置示例
![新邮件提醒](https://wmimg.com/i/240/2026/03/69ac5696a5aa1.png)

### 2. Cloudflare 邮件路由配置示例
![用户管理](https://wmimg.com/i/240/2026/03/69ac569780a87.png)

### 3. OAuth 应用配置示例
![后台](https://wmimg.com/i/240/2026/03/69ac569deaa88.png)

---

## 八、更新日志

详细变更请查看：[`CHANGELOG.md`](./CHANGELOG.md)

cloudflaremail

cloudflaremail Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

cloudflaremail

cloudflaremail Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README