Memos on Cloudflare（GitHub：jkjoy/memos-on-cloudflare，作者 jkjoy，2026-09-09 实测 31 star，MIT 协议）做的事一句话能讲完：把开源笔记应用 Memos 整套搬到 Cloudflare 边缘平台——用 Workers + D1 + R2 顶替原来的 Go 服务器和本地数据库，让你不用买 VPS、不用装 Docker，也能跑一个完全属于自己的碎片笔记站。

一句话定位：把 Memos 装到 Cloudflare 上，零服务器、零运维，你的笔记存在离用户最近的边缘节点，免费额度个人用根本花不完。

一、它到底是啥

如果你用过 Memos（一个开源的「碎片化笔记 + 微微博客」工具），应该知道它原本要跑在一台服务器上：后端是 Go、数据库是本地 SQLite、附件放本地硬盘。Memos on Cloudflare 干的事，就是把这套架构整体平移到 Cloudflare 上——

  • 原来跑在你服务器的 Go 后端 → 换成 Cloudflare Workers（一段跑在边缘节点的代码）；
  • 原来的本地 SQLite → 换成 Cloudflare D1（托管版 SQLite）；
  • 原来的本地附件目录 → 换成 Cloudflare R2（对象存储）；
  • 原来要自己维护的服务器 → 直接没了。

结果就是：你不用再为「笔记存哪儿、服务器别宕机、磁盘别写满」操心，把项目往 Cloudflare 一推，它就在全球边缘节点上跑起来了。

二、能做什么

它复刻了 Memos v0.28 的大部分能力，日常记笔记完全够用。挑重点看：

记笔记

支持 Markdown、标签、代码块、任务清单，还能画 Mermaid 图表；一条笔记就是一段碎片想法。

看得见 / 藏得住

每条笔记可设私有、工作区可见、或公开；还能生成带过期时间的分享链接。

语音也能记

内置录音 + Workers AI 转写，对着手机说一段话就能变成文字笔记。

协作与集成

支持评论、表情反应、Webhook 通知、SSO 单点登录，以及 30+ 语言界面。

附件上传上限是 100MB，图片、音频、文档都能塞。对一个人或一个小团队来说，这套配置已经很能打。

三、背后到底跑了些啥

不用深究架构，一句话记住：这个项目的全部零件都在 Cloudflare 一家，你不用再拼七八个外部服务。

你看到的它背后用的是
打开的网页Worker 跑后端 + 静态资源托管前端
你的笔记内容D1（托管版 SQLite）存结构化数据
上传的图片 / 音频R2 对象存储
语音转文字Workers AI 的 Whisper 模型

对比原版 Memos 还要自己管 Go 进程、SQLite 文件、反向代理，这个项目把「运维」两个字基本抹平了。

四、免费额度够不够

这是大家最关心的。Cloudflare 免费档给的量，对个人完全够用：

资源免费档额度个人够不够
Workers 请求每天 10 万次✅ 远远够
D1 存储5 GB✅ 几万条笔记无压力
R2 存储10 GB + 每月 1000 万次读✅ 日常附件够用
Workers AI 转写按量计费，有免费额度⚠️ 偶尔用用不心疼

注意：免费档单次请求体上限是 100MB，附件上传被硬编码成 100MB 正是卡在这条线。如果你打算传超大文件，得上 Workers 付费档（付费后无此限制）。普通文字 + 普通图片用户完全不用管。

五、怎么把它跑起来

整体就三步，命令贴出来照抄即可。前提是你已有 Cloudflare 账号，并装好 Node.js 18+ 和 Wrangler CLI。

STEP 1 · 拉代码

克隆仓库，安装前端与后端依赖

STEP 2 · 建资源

用 Wrangler 创建 D1 数据库与 R2 存储桶

STEP 3 · 部署

填 database_id，初始化表结构并一键部署

bash 
# 1. 拉代码
git clone https://github.com/jkjoy/memos-on-cloudflare.git
cd memos-on-cloudflare
npm install && cd web && npm install && cd ..

# 2. 在 Cloudflare 建两个资源
wrangler d1 create cfmemos-db
wrangler r2 bucket create cfmemos

# 3. 把上一步拿到的 database_id 填进 wrangler.toml，再初始化并部署
npm run db:migrate:remote
npm run deploy

部署完访问 Worker 分配的域名，第一次打开会进管理员注册页，设好账号就能用。想挂自己的域名，去 Cloudflare 后台给 Worker 加自定义域名即可。

六、部署前必须记住的一件事

这个项目只要配一个密钥就能跑起来：JWT_SECRET。它是用来给登录令牌签名的，务必用一段强随机字符串，别拿 123456 凑数——否则别人能伪造你的登录身份。设置命令就一句：

bash 
wrangler secret put JWT_SECRET

其余像实例名称（INSTANCE_NAME，显示在页面标题上）都是可选的非敏感配置，写在 wrangler.toml 里就行。

七、要花多少钱

和另外两种常见方案摆一起看，这个项目的成本优势非常明显：

方案服务器成本运维负担
Memos on Cloudflare免费档基本 0 元✅ 几乎为零
原版 Memos（自托管）一台 VPS 约几十元 / 月⚠️ 要管进程、备份、升级
商业笔记（如 Notion 等）会员按月收费✅ 不用管，但数据在别人手里

八、新手最容易踩的坑

① 部署后白屏

多半是前端没打包。先跑构建，确认 web/dist 目录存在，再 deploy。

② 访问 /api 变 404

检查 wrangler.toml 的 assets 里有没有把 /api 等路径交给 Worker 优先处理，否则会被当成前端路由。

③ 报 table not found

忘了初始化数据库。执行 npm run db:migrate:remote 把表结构建到远程 D1。

九、适合谁，不适合谁

适合你，如果——

想有个自己的碎片笔记 / 微博客；手头有 Cloudflare 账号；不想为服务器付费和折腾；接受把数据存在 Cloudflare。

先想清楚，如果——

你对数据主权极度敏感、不想依赖任何大厂；或者需要 Memos 的全部高级功能（本项目只复刻到 v0.28 大部分）；或者完全不会用命令行部署。

一句话结论：Memos on Cloudflare 把「自托管笔记」的门槛从「买服务器 + 管运维」降到了「会敲几行命令 + 有个 Cloudflare 账号」。免费额度个人用不完，适合想低调拥有自己小天地的人；代价是功能比原版 Memos 略少，且数据落在 Cloudflare 手里——这点喜不喜欢，看你自己的取舍。

Memos on Cloudflare
开源
MIT
自托管笔记

把开源笔记 Memos 整套搬到 Cloudflare 边缘：零服务器、零运维，笔记存在离你最近的节点，免费额度个人用不完。

★ 31
GitHub Star
⑂ 35
Fork
MIT
开源协议
Workers
D1
R2
Workers AI