玩转Cloudflare-17:0元自建云笔记:手机电脑自动同步,AI 还能直接读写你的笔记

导读:这篇讲我怎么把笔记从"别人的服务器"搬回自己账号里。用 Cloudflare 免费档跑一套开源云笔记,纯 Markdown、手机电脑自动同步、断网能写,还能让 AI 直接检索和写入。全程三步部署、0 元。

我六年的笔记,长这样。

从那天起我就认了个死理:笔记的格式必须是纯文本,服务器必须在我自己账号里。 不然你以为自己在积累,其实是在帮别人攒数据。

所以看到 inkstone 这个项目,我盯了很久。

 inkstone简介
打开网易新闻 查看精彩图片
inkstone简介

inkstone,一个跑在 Cloudflare Workers 上的自托管网页笔记。

仓库 7 月 30 号才建,到现在三个月,1144 个 Star,1039 个 Fork。

正常开源项目,Fork 数一般是 Star 的十分之一。它俩几乎 1:1。

为什么?因为它的部署流程第一步就是 Fork。

你得把它复刻到自己的 GitHub 仓库,再让 Cloudflare 从你的仓库拉代码构建。

也就是说,这一千多个 Fork 里,很大一部分是真动手部署了的人。不是"收藏一下改天再看",是"我已经跑起来了"。

这个比例,比 Star 数诚实得多。

 inkstone优点
打开网易新闻 查看精彩图片
inkstone优点

我其实不太需要 Obsidian 那套插件生态——两百多个插件,我常年用的就三个。我要的是:能写、能找、能同步、能带走。

它给的比这个多。

写。 编辑器是 CodeMirror 6,可以把两篇笔记拆成左右两组并排写——一边查资料一边记,不用来回切窗口。还有专注模式、打字机模式、大纲导航、自动保存,每次改动都留版本历史。

语法。 Obsidian 那套基本都认:WikiLinks、块引用、笔记嵌入、Callout 提示块、折叠块、标签页、数学公式、Mermaid 图表、Front Matter。你以前的 Markdown 搬过来不用改。

找。 全文搜索走 D1 的 FTS5 索引,官方说对中文做了分词优化。另外可以开一层基于 Workers AI 的语义搜索——搜"上次那个关于备份的想法",也能翻出来。

离线。 能装成 PWA,断网照样打开。离线期间的改动会进一个待写队列,联网自动补交。它还做了乐观并发和冲突副本,两台设备同时改一篇不会直接互相覆盖。

带走。 JSON 和 ZIP 两种导出,附件能单独导,还能配 WebDAV 或 S3 定时异地备份。

最后这条是我最看重的。一个笔记工具敢不敢让你随时打包走人,基本能看出它的底气。

inkstone的MCP

这部分是我觉得它跟同类产品拉开差距的地方,值得单独讲。

它内置了一个远程 MCP 服务。授权走 OAuth 2.1(PKCE),你也可以给账号签一个 ink_ 开头的 API Key,随时能撤销。

这意味着什么?

你手机里、电脑里那个 AI 助手,可以直接检索和读写你的笔记库。

不是"复制一段笔记粘贴给 AI",是 AI 自己去你库里搜。你问"我上个月记的那个 Nginx 配置怎么写的",它去翻,翻到了直接给你。

而且它的权限切得挺细:读取有范围限制、写入带版本校验(防止 AI 把你刚改的内容盖掉)、回收站是单独一个权限、每个账号的授权可以单独管。

我见过太多"AI + 笔记"的方案,最后都停在"把内容复制出来喂给模型"这一步。

能原生接进去的,是另一个量级的体验。

动手安装inkstone

我把官方流程捋一遍,你照着点就行。

第一步,Fork。

打开 github.com/shuaiplus/inkstone,右上角 Fork 到你自己的仓库。

 第二步,Cloudflare 里连仓库。
打开网易新闻 查看精彩图片
第二步,Cloudflare 里连仓库。

登录 Cloudflare,左侧「计算 → Workers 和 Pages」→ 创建应用程序 → 继续使用 GitHub → 授权后选中你刚 Fork 的 inkstone。

打开网易新闻 查看精彩图片
打开网易新闻 查看精彩图片

构建命令和部署命令按你选的存储模式填:

使用 R2 时,

构建命令填 npm run build

部署命令填 npm run deploy

如果你打算用 KV 模式,把部署命令改成 npm run deploy:kv

npm run build      # 构建,两种模式都一样
npm run deploy # R2 模式
npm run deploy:kv # KV 模式
打开网易新闻 查看精彩图片

等它跑完,页面出现 Success 就成了。

 第三步,绑自己的域名。
打开网易新闻 查看精彩图片
第三步,绑自己的域名。

这一步别省,原因下面讲。

部署完 Cloudflare 会送你一个 xxx.workers.dev 的域名。这个后缀在国内的连通性一直不怎么样,很多人是打不开的。

点「添加域名」,选你自己已经托管在 Cloudflare 的域名,前缀随便起(比如 ink),加完就能用自己的地址访问了。

关于 KV 和 R2 怎么选,官方文档写得很直白:

  • • 笔记正文永远存在 D1 里 ,跟你选哪个无关

  • • KV 和 R2 只决定附件和头像这类二进制文件放哪

  • • R2 要绑信用卡才能开通;KV 不用绑卡,但单个文件有体积限制

所以上手阶段直接 KV,等附件攒多了再迁 R2,完全来得及。

 数据在哪里
打开网易新闻 查看精彩图片
数据在哪里

自托管最该问的就是这句。

它把存储拆成了这几块:

组件

存什么

Cloudflare D1

账号、笔记、文件夹、标签、设置、版本历史、分享记录、全文索引

R2 或 Workers KV

附件、上传的头像

Workers KV(OAUTH_KV)

OAuth 授权码和 Token, 不存笔记正文

Workers AI

可选的语义搜索向量

浏览器 IndexedDB

本地缓存、离线待写队列

WebDAV / S3

你自己配的异地备份

翻译成人话:数据库在你账号里,附件在你账号里,运行环境也在你账号里。 作者看不到你的内容,因为他压根没有你的实例。

这跟"某个团队在海外机房替你保管"是两件事。前者是租房子,后者是借住。

Cloudflare免费额度

这部分我特意去核了官方定价页,2026 年 10 月的口径。

Cloudflare 免费档给它提供的底座,额度是这些:

资源

免费额度

用它干嘛

Workers

10 万次请求/天

整个应用跑在这上面

D1

读 500 万行/天、写 10 万行/天、5GB 存储

笔记正文 + 索引

KV

读 10 万次/天、写 1000 次/天、1GB

附件(KV 模式)

R2

10GB 存储、100 万写 / 1000 万读每月、出口流量免费

附件(R2 模式)

Workers AI

1 万 Neurons/天

语义搜索向量化

数字看着抽象,换成具体量你就知道松紧:

D1 那 5GB。 两千字的中文笔记,存成 Markdown 大约 6KB。5GB 能装八十多万篇。就算版本历史再叠两三倍,你写一辈子也碰不到顶。

D1 那 10 万行写入。 每保存一次笔记算一行,加版本历史可能两三行。也就是说一天存几万次都够。个人用户根本摸不到这条线。

KV 那 1000 次写。 这个数字看着紧,但别忘了正文在 D1。KV 只管附件——一天传一千张图才会爆。真正会踩到这个限制的,是拿 KV 当缓存或计数器用的玩法,不是笔记。

Workers AI 那 1 万 Neurons。 官方口径,1 万 Neurons 大约等于 1500 到 15000 次向量化,看模型大小。也就是说一天给一两千篇笔记建索引,是够的。

结论很清楚:自己用,这套额度是用不完的。 但如果是三五个人拿它当团队 wiki,版本历史、全文索引、附件会一起往上叠,那就得盯着 D1 的写入量了。

顺便说一句,既然能配 WebDAV/S3 异地备份,我建议真配一个。备份这事最怕"只有一个副本还放在别人家"——笔记这套东西,异地一份是底线。

需要注意的点

夸完了,说点不好听的。这三点我建议你在点 Fork 之前先想清楚。

第一,域名必须绑,别偷懒。

workers.dev 在国内的连通性常年不稳,你自己电脑上能开,手机 4G 上可能就转圈。这跟你笔记写得好不好没关系,纯粹是网络路径的问题。花两分钟绑个自己的域名,能省掉以后无数次"怎么打不开"。

第二,项目才三个月。

7 月底建仓,两个多月发了 7 个版本,最新 v0.8.0。这个迭代速度很猛,但也说明:它还在长身体。

作者是一个人。数据库升级靠带版本号的迁移脚本自动跑,官方自己也提醒——升级前先导出一份完整备份。

这句话你得当真。自托管应用的备份,不是"有空再做",是"升级之前必须做"。

第三,LGPL-3.0 不是"随便用"。

自己部署自己用,没任何问题。但如果你打算改一改再对外分发,那得按协议来。开源不等于没规矩。

跟 Obsidian、Notion 怎么选

我不觉得它能替掉 Obsidian。

插件生态、本地文件、社区主题,这三样短期内没人能打。

打开网易新闻 查看精彩图片

它擅长的是另一个位置:

inkstone

Obsidian

Notion

数据在哪

你自己的 Cloudflare

你自己的硬盘

它的服务器

多设备同步

自带,0 元

要额外方案

自带,历史版本要付费

打开方式

浏览器 / PWA

桌面客户端

浏览器

AI 接进来

原生 MCP

靠插件

官方 AI

折腾成本

部署 10 分钟

插件配一天

几乎为零

一句话概括:想要"数据在我手里 + 手机电脑无缝 + 不花钱",选它;想要插件生态和完全离线,还是 Obsidian。

我自己的判断是,它更接近"一个能自己掌控的 Notion",而不是"Obsidian 的替代品"。

最后

我越来越觉得,工具选型这件事,核心就一个问题:

十年后,你今天的笔记还在不在,还能不能打开?

答案不取决于哪家的功能更多,取决于两件事——格式是不是公开的,副本在不在你手里。

inkstone 这两条都做到了,代价是你要花十分钟部署一次,并且记得备份。

这个交换,我觉得划算。