老路的笔记换过好几茬了，Notion 卡、语雀要会员、Obsidian 本地存着总怕电脑炸、自建 Nextcloud 光维护就够烦的。折腾到最后发现，真正卡住人的不是”笔记软件不好用”，而是你的笔记到底存在哪儿。
所以今天这篇讲一个把这问题彻底解决的东西：Inkstone——一个跑在 Cloudflare Workers 上的自托管 私有云笔记，数据库在你自己的账号里，附件在你自己的存储里，代码开源。而且整套东西跑在 Cloudflare 免费额度内，从 fork 到能用，10 分钟。老规矩，不喜欢看字的直接拉到最后看视频。
一、先说清楚：这个私有云笔记到底是个什么东西
| 项目 | 信息 |
|---|---|
| 名字 | Inkstone（砚台，写字的家伙） |
| 仓库 | github.com/shuaiplus/inkstone |
| 是什么 | 完全跑在 Cloudflare Workers 上的自托管 Markdown 笔记应用 |
| 技术栈 | TypeScript + React + Hono + CodeMirror 6 + Cloudflare D1 / KV / R2 / Durable Objects |
| 热度 | 1012 star、845 fork（2026-07-30 建仓，9 月还在活跃提交） |
| 协议 | LGPL-3.0-only（可商用） |
它跟你用过的笔记应用最本质的区别，是”所有权”这三个字。
Notion、语雀、飞书文档，你的笔记是存在人家的服务器上——人家改规则你就得跟，人家涨价你就得付，服务关了你就得搬家。Inkstone 反过来：代码跑在你自己的 Cloudflare 账号里，数据库（D1）、附件存储（R2/KV）全在你的名下，官方原文：
也就是说，部署的人保留数据库、附件和运行环境的控制权。就这么直白。
还有个细节老路很喜欢：笔记永远是纯 Markdown 文本。这意味着就算哪天你不想用它了，你的笔记不是一堆锁死的私有格式——直接拿 Markdown 就能读、就能搬。
二、它能干什么：先看功能全不全
官方 README 写的相当能打：
三个点老路要单独拎出来说：
第一，双链 + 反向链接 + 关系图谱是标配。 你要是从 Obsidian 过来，会发现该有的都有：WikiLinks 双链语法、反向链接面板、块引用、关系图谱。
第二，它内置了 MCP。 这一条含金量很高——你的笔记能直接给 AI Agent 用。它带一套完整的 OAuth 2.1 + PKCE 授权流程，能签发可随时撤销的 ink_... Key，Agent 通过标准的 search / fetch 读你的笔记。老路实测它这个 MCP 端点是活的（/.well-known/oauth-authorization-server 返回 200），也就是说你可以让 Claude Code、Codex 这类工具直接查你的私有笔记库，笔记不用先导出再喂。
第三，备份是真备份。 支持 WebDAV / S3 定时备份（wrangler 里挂着 0 * * * * 和 15,45 * * * * 两个 cron），备份凭据存在独立的 CredentialVault Durable Object 里。这才是”私有云”该有的样子——你的数据有第二个家。
三、为什么能”白嫖”：把免费额度算给你听
这是老路写这篇最重要的部分，也是大家最关心的部分！“免费”不能光听人说，得把账算清楚。
Inkstone 用到 Cloudflare 的五个组件，老路逐个查了官方定价页（2026-09-25 核实）：
| 组件 | 干什么用 | 免费额度 | 老路判断 |
|---|---|---|---|
| Workers | 跑应用本身 | 10 万请求 / 天（超了报 1027 错）；单请求 CPU 10ms | 个人用绰绰有余 |
| D1 | 存笔记、账号、索引 | 5 GB 存储、500 万行读/天、10 万行写/天 | 存纯文本笔记，5GB 等于几十万条 |
| Durable Objects | 实时同步、备份凭据 | 10 万请求/天、13,000 GB-s/天（免费套餐仅支持 SQLite 后端） | 关键：DO 免费套餐可用，官方原文写明 |
| Workers KV | 附件存储（KV 模式） | 1 GB 存储、10 万次读/天、1,000 次写/天 | 写次数偏低，但存附件够用 |
| Workers AI | 可选的语义搜索 | 10,000 Neurons / 天 | 够轻度用，重度会超 |
| Workers Builds | 从 GitHub 自动构建部署 | 3,000 构建分钟 / 月 | 完全够 |
这里有个关键坑老路必须提前说清楚：R2 要绑卡，KV 不用。
- R2 模式（默认
npm run deploy）：附件存 R2，10GB 免费额度，功能最全（还能开 Workers AI 语义搜索）。但官方文档明确要求你**”Complete the checkout flow to add an R2 subscription”**——要过一个结算流程，也就是得有支付方式。 - KV 模式（
npm run deploy:kv）：附件存 Workers KV，Workers KV 是包含在免费套餐里的，不需要任何订阅——想做到全程不绑卡，就走这条。代价是 KV 没挂 AI 绑定，语义搜索用不了，附件存储上限 1GB。
说人话：想零绑卡、纯白嫖 → KV 模式；手上有卡、想要全功能（含语义搜索）→ R2 模式。
四、10 分钟部署：五步
官方 README 给的流程就是这样，老路照着走通了，没有隐藏步骤：
第一步 · Fork 仓库
打开 github.com/shuaiplus/inkstone，点右上角 Fork，fork 到你自己的账号。一定要 fork，因为后面要动部署配置。
第二步 · 进 Cloudflare 控制台dash.cloudflare.com → Workers & Pages → Create → 选 Workers → Continue with GitHub。
第三步 · 授权并选仓库
第一次用会让你授权 Cloudflare 访问 GitHub，授权后选中你刚 fork 的那个 inkstone。
第四步 · 填构建和部署命令（这一步是关键，纯免费绑卡必看！）
老路整理如下：
| 设置项 | R2 模式（全功能，需绑卡） | KV 模式（不绑卡） |
|---|---|---|
| Build command | npm run build | npm run build |
| Deploy command | npm run deploy | npm run deploy:kv |
第五步 · Deploy，等它跑完（大概几十秒）
构建完会给你一个 xxx.workers.dev 的地址，点开就是你的笔记站。第一次打开需要创建一个账号。想在浏览器里看到老路那种自定义域名的效果，去 Settings → Domains & Routes 绑一个你自己的子域就行——像 notes.toolmixr.com 这样。
五、两种模式到底差什么
把选择摊开，你自己对号入座：
| 对比项 | R2 模式 | KV 模式 |
|---|---|---|
| 部署命令 | npm run deploy | npm run deploy:kv |
| 附件存储 | R2，10 GB 免费额度 | Workers KV，1 GB |
| 语义搜索（Workers AI） | 可用 | 配置里没挂 AI 绑定 |
| 是否要绑支付方式 | 要（R2 需过结算流程） | 不要 |
| 适合谁 | 手上有卡、要全功能、附件多 | 学生党、纯白嫖党、附件不多 |
老路的建议：如果你只是想体验、或者附件主要是零星图片，先走 KV 模式——省掉绑卡这一步，10 分钟真的能到手。等用顺了、附件涨起来了，再切到 R2 模式（换一下部署命令重跑一次就行）。
六、它跟别的笔记方案比，强在哪
| 方案 | 数据在谁手里 | 成本 | 上手难度 | 双链/Markdown |
|---|---|---|---|---|
| Inkstone（本文） | 你自己（Cloudflare 账号） | 免费额度内 0 元 | 10 分钟部署 | 原生 Markdown + 双链 |
| Notion | 人家 | 免费档有限，重度要付费 | 开箱即用 | 私有格式 |
| 语雀 / 飞书 | 人家 | 会员制 | 开箱即用 | 部分支持 |
| Obsidian | 你自己（本地） | 免费 | 简单 | 支持双链，但同步要自己解决 |
| 自建 Nextcloud / Wiki | 你自己（VPS） | 服务器月租 + 维护 | 难 | 一般 |
| Joplin / 思源 | 你自己（可选云） | 免费或低价 | 中等 | 支持 |
Inkstone 卡的位置很巧：它拿到了 Obsidian 的”数据自主”（纯 Markdown + 双链），又拿到了 Notion 的”多端同步 + 浏览器直接用”，还不用你租服务器、不用你维护系统——因为 Cloudflare 的免费额度把运维这层吃掉了。
这就是老路说它值得的原因：它不是又一个笔记应用，它是”把运维成本降到零的私有笔记方案”。
七、你会用它来做什么？
这里给几个老路觉得还不错的用法：
① 个人知识库 / 第二大脑。 双链 + 反向链接 + 关系图谱就是为这个准备的。读书笔记、技术卡片、灵感碎片，越攒越值钱，而且越攒越不敢放别人服务器上——这正好是它的强项。
② 私有化的 AI 上下文库（老路最看好的用法）。 它内置 MCP，你的笔记可以直接被 AI Agent 检索。想想这个组合：把项目文档、技术笔记、踩坑记录全攒进去 → Claude Code 这类工具通过 MCP 直接查 → AI 帮你干活时用的是你自己的知识，而不是网上的通用答案。这个玩法在别的笔记应用上要么做不到，要么得自己搭中间层。
③ 团队/小圈子的共享知识库。 公开笔记链接支持密码 + 过期时间，适合发给客户、发给同事临时看。而实例是你自己域名，比甩一个 Notion 链接体面。
④ 内容创作的草稿仓库。 纯 Markdown 意味着你写的东西能直接喂给任何工具——静态站生成器、发布脚本、批量处理，全都能接。
⑤ 就想有个”随时能导走”的笔记。 就算你什么高级功能都不用，**”笔记永远是纯 Markdown + 支持一键导出 + 支持 WebDAV 备份”**这三条加起来，就已经比大多数方案安全了。
老路自己拿它当②③④用——技术笔记和项目文档攒在一个能被 Agent 直接读的地方，写文章时让它去翻。
八、老路猜你想问的（FAQ）
Q：真的一分钱不花吗？
A：KV 模式下是的——Workers、D1、KV、Durable Objects、构建都在免费套餐内，不需要绑卡。自定义域名也有免费的（看老路的 2026 最新免费域名申请 教程）。想开语义搜索或大附件，才需要走 R2（要绑支付方式）。
Q：数据安全吗？会不会等于把笔记交给它了？
A：数据存的是你自己的 Cloudflare 账号——D1 数据库、R2/KV 桶都在你名下，部署者是你自己。这跟”注册一个第三方笔记服务”是完全不同的性质。当然，Cloudflare 是托管方，你信任的层次从”某个笔记厂商”变成了”Cloudflare”——这一点老路说清楚，别当它等于纯本地。
Q：升级会不会把笔记搞丢？
A：它的数据在 D1 里（不在代码里），你重新部署、或者拉上游更新重新构建，数据库内容不动。加上有版本历史和 WebDAV/S3 定时备份两层兜底。但还是那句话：备份还得弄，别等出事。
Q：能跟 Obsidian 互相搬吗？
A：能。两边都是纯 Markdown，它支持 WikiLinks 和 Obsidian 风格的注释语法，导出走 JSON 或 ZIP。先从 Obsidian 导出来，再导进去就行。
Q：免费额度会不会哪天取消？
A：Cloudflare 的免费额度是它拉开发者的长期策略，不是”限时活动”。但任何免费额度都可能调整——所以老路的建议是：用它，但保持你的数据随时能导走。它这套设计恰好就是为这个准备的。
最后，值不值？老路说句痛快话
值，而且这是老路今年见过最”性价比错位”的一个项目。
错位在哪？它给你的东西看起来像付费产品的形态（多端同步、双链、关系图谱、版本历史、PWA、MCP、分享），成本却是零——因为 Cloudflare 免费额度把服务器这层吃掉了，你只需要点几下。
但定位得拎清，三条：
- 它是”自托管”，不是”零成本的 Notion”。你要接受”部署一次”这个门槛——虽然只有 10 分钟。不想碰任何技术细节的人，还是用现成的服务更省心。
- 免费额度是够用，不是无限用。个人笔记、小圈子共享完全没问题；要当团队主力文档库，先算算 Egress 和 D1 的日额度，该升级就升级。
- 它是 Preview 阶段的开源项目（版本号 0.8.0，7 月底才建仓）。功能已经相当完整，但它还在快速迭代，用之前记着配好备份。
一句话总结：如果你已经厌倦了把笔记寄存在别人家、又不想为了”自托管”去租服务器伺候系统——Inkstone 正好卡在这个空档上：数据是你的，运维是 Cloudflare 的，钱是零。 10 分钟，值得试。
本期实操视频在此~
相关阅读：2026 拥有你自己的 IP 工具箱，零成本 10 分钟搞定 · GitHub 最值得收藏的 10 个开源项目 · MiniCPM5 本地部署接进 Hermes · Kaggle 免费 TPU 白嫖 Qwen3.8
