DoulorCloud README

The project's README from github.com/Doulor/DoulorCloud. As one markdown file: README.md.

Doulor Cloud

Doulor Cloud

一站式云端资源分发平台 —— 二级域名、域名邮箱、直链网盘、个人名片（Bento 空间）与 AI API 中转站

cloud.doulor.cn · GitHub Doulor/DoulorCloud

纯静态前端 + Serverless 后端：前端是构建产物直出的 SPA，后端全部跑在 Cloudflare Workers 上，数据库用 D1（SQLite）、对象存储用 R2，不依赖任何常驻服务器。

目录

界面预览

控制台 AI 中转站
控制台 AI 中转站
积分与商城 私信
积分与商城 私信

截图来自线上实例（cloud.doulor.cn），界面为深色主题，全站中英双语可切换。

功能概览

模块 说明
账号体系 邀请码 / 限时开放注册、邮箱验证、会话（D1 存储 + 多 Cookie 容错）、管理员 / 站长分级、可注销
二级域名 用户自助申请 *.doulor.cn 子域名，走 Cloudflare DNS API 创建与回收；支持自定义域名的自定义记录
域名邮箱 基于 Cloudflare Email Routing：每个用户按用户名获得 用户名@doulor.cn 邮箱，支持转发规则、临时分享箱、网页端收发
直链网盘 R2 对象存储（S3 兼容 API，跨账号），多桶架构 + 每用户配额，支持自定义直链域名与预签名直传
个人名片 / 空间 Bento 网格个人主页（/space/<用户名>、/profile/<slug>），音乐、歌词、图库、链接卡片、自定义配色与自动缩放
社区 帖子 / 评论 / 图片（走 R2）、楼中楼回复、通知与邮件提醒
聊天室 频道式实时聊天（轮询实现，不引常驻连接）、在线状态、未读角标
AI 中转站 自建 NewAPI 网关的账号打通：开通、密码绑定、API Key 代建、额度同步、订阅套餐、渠道捐献自动化
捐献体系 用户捐献上游 AI 渠道 / 反代账号（WorkBuddy、CLI2API 等）换取权限；自动审核 + 人工兜底
积分与成就 注册 / 捐献 / 活动获得积分；成就点独立体系、成就徽章与自定义称号
活动与抽奖 活动报名（认证码 / 抽奖）、奖池分配、到点自动开奖、活动分享页
积分商城 官方与用户商品、5 种交付方式（自动发码 / 人工 / 订阅 / 权限 / 积分）、订单状态机与消息中心联动
内网穿透（frp） frp 节点申请与开通，按节点鉴权方式决定是否需账号密码
代理订阅 订阅链接解析、节点测速与展示
工具箱 20+ 纯浏览器端工具（图片压缩、格式转换、文本处理…），零服务端请求
管理面板 用户 / 权限 / 捐献审核 / 商品订单 / 活动 / 公告 / 邮件通道 / 站点设置 / 额度看板（Cloudflare 用量与费用估算）

国际化：全站中英双语（自研零依赖 i18n，键值点分命名、类型安全）。

架构

                    ┌──────────────────────────────┐
   浏览器  ────────► │  Cloudflare 边缘（WAF / CDN） │
                    └──────────────┬───────────────┘
                                   │
        ┌──────────────────────────┼──────────────────────────┐
        ▼                          ▼                          ▼
┌────────────────┐        ┌────────────────┐        ┌──────────────────┐
│ 前端静态资产    │        │  API Worker    │        │  Email Worker    │
│ (Workers 静态  │        │ (鉴权/权限/业务 │        │ (收信路由 → 入库  │
│  资产 + SPA)   │        │  + CF API 调用) │        │  / 转发 / 回复)   │
└────────────────┘        └───────┬────────┘        └────────┬─────────┘
                                  │                          │
                 ┌────────────────┼────────────────┬─────────┘
                 ▼                ▼                ▼
           ┌──────────┐     ┌──────────┐    ┌────────────────┐
           │   D1     │     │   R2     │    │ Cloudflare API │
           │ (SQLite) │     │ (对象存储)│    │ (DNS/邮件路由)  │
           └──────────┘     └──────────┘    └────────────────┘
                 │
                 ▼
         ┌────────────────┐
         │ 外部 AI 中转站  │  ← 自建 NewAPI 网关（LLM API 聚合与分发）
         │  (NewAPI 集群) │
         └────────────────┘

技术栈

层 选型
前端 Vite（Rolldown）、React、TypeScript、Tailwind CSS、Radix UI / shadcn 风格组件
后端 Cloudflare Workers（ES Modules）、D1、R2（S3 API）、Workers 静态资产
测试 Vitest + @cloudflare/vitest-plugin（miniflare 内跑真实 Worker + D1）、Playwright（真浏览器走查）
质量护栏 自研静态检查：路由↔实现一致性、设置项是否真被服务端读取、死代码、i18n 键完整性
邮件 Cloudflare Email Routing（收）、Brevo / Posta / Cloudflare Send Email（发）
AI 网关 自建 NewAPI（集群部署，多节点共享库）

目录结构

src/                     前端
  components/            业务组件 + ui/（基础组件）
  layouts/               Landing / Dashboard 布局
  pages/                 路由页面（含管理面板各标签页）
  lib/                   工具（i18n、颜色、格式化、工具箱注册表…）
  services/api.ts        统一请求层（自动带 Cookie、错误归一化）
  types/                 共享类型
worker/                  后端（独立 npm 包）
  src/
    index.ts             路由表 + fetch/email/scheduled 三个入口
    handlers/            按业务域拆分的处理器（auth/community/chat/email/storage/newapi/…）
    auth.ts              会话与鉴权（requireUser / 权限解析）
    permissions.ts       权限模型（功能开关 + 角色）
    settings.ts          站点设置（默认值 + 读写；护栏要求每个键都有服务端读取点）
    r2.ts                R2 的 S3 / REST 两种模式与多桶分配
    newapi-client.ts     自建 AI 网关的 API 客户端（含缓存与令牌复用）
    mailer.ts            三级发信通道与模板
  migrations/            D1 迁移（按序执行）
  schema.sql             D1 基线表结构
  test/                  Vitest 用例（在 miniflare 里跑真实 Worker）
  scripts/               一致性护栏脚本（npm run check:*）
site-worker.js           前端站点的 Worker 入口（HTTPS 跳转 + 安全响应头 + 缓存策略）

核心设计

1. 单一 API Worker + 声明式路由

所有接口集中在一张路由表里声明（kind: "exact" | "regex" | "branch"），配合 npm run check:handlers 静态校验「前端调用的路径是否真的存在」「handler 是否真的导出」， 避免「前端在调、后端没有」这类静默失效。

2. 权限模型

3. 会话

4. 直链网盘与 R2

5. AI 中转站集成

自建 NewAPI 网关（LLM API 聚合分发）与本项目深度打通：

6. 准实时一律用轮询

项目刻意不引入 Durable Object / WebSocket：聊天室、收件箱、通知角标都是轮询， 但做了三件事：只在页面可见时轮询（切回标签页立即刷一次）、不同模块用不同间隔、 轮询走独立的「静默路径」并用 ref 校验「结果回来时选中的还是不是同一个对象」。

7. 邮箱

8. 质量护栏（npm run check）

本项目由多个 AI 并行开发同一工作区，因此把「容易静默失效」的约定都变成了静态检查：

护栏 防的是什么
check-handlers 路由声明与 handler 实现/导出不一致
check-settings 管理面板能改、服务端从不读的「假开关」
check-api-paths 前端调用的 API 路径不存在（被 SPA 兜底成 HTML，静默失效）
check-unused-exports 写好了却从未接线的死代码
check:i18n 中文加了 key、英文没加（i18n 键是类型安全的，缺了会编译失败）

另有一条项目特有的 SQL 约束被写成代码规范：D1 的 LIKE 模式最长 50 字符（标准 SQLite 是 50000）， 超长直接报错且本地 miniflare 复现不了 —— 因此所有用户输入进 LIKE 都必须走 src/sql-like.ts 的截断封装。

数据模型

单库 70+ 张表，按域划分（worker/schema.sql 为基线，worker/migrations/ 为增量）：

域 代表表
账号 users sessions invites
邮箱 mailboxes messages forward_rules tempbox
域名 domains dns_records subdomain_requests
网盘 storage_accounts r2_buckets storage_prefixes storage_shares
社区 posts comments feedback
聊天 chat_messages chat_presence
名片 profiles profile_assets
积分商城 user_points point_transactions point_products point_orders
活动 events event_claims
成就 / 称号 achievements user_achievements custom_titles user_titles
中转站 newapi_accounts newapi_admin_credentials
捐献 donations wb2api_bindings cli2api_bindings
运维 app_settings audit_logs rate_limits

安全模型

本地开发

# 前端
npm install
npm run dev          # Vite 开发服务器

# 后端
cd worker
npm install
cp .dev.vars.example .dev.vars   # 填入本地用值（不要提交）
npm run dev                      # wrangler dev

# 质量护栏 + 类型 + 测试
npm run check                    # 全部静态护栏 + tsc
npm test                         # Vitest（在 miniflare 里跑真实 Worker + D1）

本仓库只包含源码。线上环境配置、部署方式与运维脚本不在开源范围内。

发展历程

项目从 2026 年 9 月下旬起，以「每天一个可用增量」的节奏快速演进：

期间项目一直由多个 AI 并行开发，因此形成了「静态护栏 + 真浏览器走查 + 临时会话读线上库验证」这套 工程实践 —— 见上文「质量护栏」。

Star History

Star History Chart

点一个 star 就是对这个项目最好的支持，也会让更多需要的人看到它。

许可

暂未指定开源许可证。在补充 LICENSE 之前，默认保留所有权利（All rights reserved）。

DoulorCloud (Doulor/DoulorCloud)

Searching Database…

238 ·GitHub
DoulorCloud
Что это такое?Doulor Cloud — самоместная универсальная платформа раздачи облачных ресурсов: каждый пользователь получает поддомен, почтовый адрес на домене, файловое хранилище с прямыми ссылками на базе R2, личную страницу профиля в стиле Bento и доступ к общему ИИ-API-релею; всё это работает на статическом фронтенде плюс Cloudflare Workers без постоянного сервера.
Это библиотека для импорта или платформа, которую я разворачиваю сам?Это полноценная самоместная веб-платформа, а не библиотека или CLI-инструмент: статический фронтенд на Vite/React, раздаваемый как статические ассеты Workers, со всей серверной логикой в одном Cloudflare Worker на базе D1 (SQLite) и хранилища R2.
Как запустить это самому?В репозитории только исходный код; README прямо говорит, что конфигурация живого развёртывания, настройка хостинга и скрипты эксплуатации не входят в опенсорсный релиз, так что придётся с нуля подключить собственный проект Cloudflare Workers, базу данных D1 и бакеты R2.
Какие сервисы Cloudflare нужны перед запуском?Нужны Cloudflare Workers (API + статический хостинг), D1 под схему из 70+ таблиц, бакеты R2 (доступ через самостоятельно реализованную подпись S3 SigV4, так что они могут даже жить на другом аккаунте Cloudflare) и Email Routing для функции почтового ящика; функции ИИ-релея дополнительно нужен самоместный шлюз NewAPI.
Есть ли подводные камни, прежде чем на это полагаться?Чат, входящие и уведомления сделаны поллингом вместо WebSockets/Durable Objects намеренно, а D1 ограничивает длину паттерна LIKE 50 символами (против обычных 50000 в SQLite), так что каждый поиск по пользовательскому вводу должен идти через специальную обёртку с усечением.
Что именно такое станция ИИ-релея (AI 中转站)?Она интегрируется с самоместным шлюзом NewAPI: пользователь может в один клик активировать аккаунт шлюза, получить автогенерированный API-ключ, синхронизировать квоты и подписки и даже подарить апстримные ИИ-каналы или прокси-аккаунты (например, WorkBuddy, CLI2API), чтобы открыть дополнительные привилегии.
Почему чат использует поллинг вместо WebSockets?Автор сознательно избегал Durable Objects/WebSockets; чат, входящие и бейджи уведомлений поллят на разных интервалах, только пока вкладка видима, через «тихий путь», отбрасывающий устаревшие ответы.
Какие встроенные инструменты есть в платформе?Набор из 20+ чисто браузерных утилит (сжатие изображений, конвертация форматов, обработка текста и т.д.), которые работают полностью на клиенте без единого запроса к серверу.
Как проект держит единое качество при параллельной сборке несколькими ИИ?Он содержит набор собственных статических проверок (check-handlers, check-settings, check-api-paths, check-unused-exports, check:i18n), которые сверяют соответствие маршрутов обработчикам, ловят настройки, которые бэкенд на самом деле не читает, находят мёртвый код и требуют полных двуязычных ключей i18n.
What are similar projects?cloudflare_temp_email, manychat-lite-cloudflare, mail2telegram, agentic-inbox, mailflare, nodewarden, open-compute, rankme.fast
Which topics is it in?domain, cloudflare-r2, cloudflare-d1, ai-gateway, api-gateway, tunnel, cloudflare-workers, s3, admin-dashboard, serverless, storage, email
Creator
Doulor
Size
12.5 MB
Stars
238
Updated
CommitOct 17
Age
26d
Commits · 90 Days