Home

Monolith Wiki

运行在 Cloudflare 边缘网络的全栈博客系统 — React 19 + Hono + D1/R2

在线 Demo: monolith-client.pages.dev · 仓库: one-ea/Monolith

---

我是新人，从哪里开始？

角色	推荐路径
想本地跑起来	快速开始 → 部署指南
想了解架构	架构概览 → 存储适配器
想二次开发	前端指南 · 后端指南 → API 参考
想配置站点	控制台配置 — 主题、防护、通知、注入、SEO 全在后台
想贡献代码	分支策略 → 安全设计

---

文档目录

入门

• 快速开始 — 本地开发环境一站式搭建
• 部署指南 — 一键脚本 + 手动逐步两套方案

架构

• 架构概览 — 系统拓扑、模块划分、关键决策
• 存储适配器 — D1/Turso/PostgreSQL · R2/S3 切换矩阵

开发

• 前端指南 — Vite + React SPA 结构与扩展点
• 后端指南 — Hono Workers 路由与 Drizzle ORM
• API 参考 — 所有公开/管理端点详细签名

运维

• 控制台配置 — 八大配置面 + 设置键参考 + secret 边界
• 安全设计 — 认证、防注入、密钥管理、登录防护（Turnstile / 限速可调）
• 分支策略 — Conventional Commits + Squash Merge

---

核心特性速览

• 零冷启动 — 全球 200+ PoP，平均响应 <50ms
• 无锁定 — 数据库/对象存储双层适配器，可整套迁移
• 批量导入 — WordPress / Ghost / Hexo / Hugo / Jekyll / Halo 6 平台无损迁入
• 极致体积 — 客户端首屏 <100KB gzip · Worker bundle <500KB
• 安全合规 — JWT + 限流 + DOMPurify + SSRF 防护 + GDPR Cookie 同意

---

反馈与贡献

• Bug 报告: GitHub Issues
• 安全漏洞: SECURITY.md
• 代码贡献: 阅读 分支策略 后通过 PR 提交

法则: 文档以仓库 main 分支为唯一事实来源；当 wiki 与代码冲突，以代码为准。