Skip to content

dingdingpw/cloudflaremail

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

3 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

临时邮箱系统

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

本次重构中,保留了 api.php 的收信/取信能力与接口入口不变,重点对项目结构、命名规范、控制器职责、视图分离和后台界面进行了整理与标准化。


一、部署 CF Worker

1. 登录 Cloudflare

登录 Cloudflare 控制台。

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. 第一条变量

  • TypeSecret
  • Variable nameAPI_TOKEN
  • Valueapi.php 里的 API_BEARER_TOKEN

2. 第二条变量

  • TypeText
  • Variable namePHP_API_URL
  • Valuehttps://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. 创建应用

进入:

开发者选项 → 创建应用

填写如下信息:

  • 应用名称:随意
  • 重定向 URIhttps://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
获取信息 Clientidclient_secret

六、注意事项

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

七、演示图片

1. Worker 变量配置示例

新邮件提醒

2. Cloudflare 邮件路由配置示例

用户管理

3. OAuth 应用配置示例

后台


八、更新日志

详细变更请查看:CHANGELOG.md

About

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

Resources

Stars

Watchers

Forks

Packages

 
 
 

Contributors