零成本打造私有云笔记：基于 Cloudflare Workers 的 Inkstone 部署教程

对于习惯自己折腾服务器和域名的开发者来说，寻找一款轻量、数据完全受控且支持多端同步的 Markdown 笔记应用一直是个痛点。今天向大家介绍一款名为 Inkstone 的开源项目。

Inkstone 是一款完全运行在 Cloudflare Workers 上的自托管 Markdown 笔记应用。它不仅保留了纯文本的简单性，还利用了 Cloudflare 的全球边缘网络优势，为你提供极速、免费的私人笔记体验。

为什么选择 Inkstone？

• 完全自托管与数据掌控：无需购买额外的云服务器，数据库（Cloudflare D1）和附件（R2 或 Workers KV）都存储在你自己的 Cloudflare 账号下。

• 功能强大的编辑器：基于 CodeMirror 6，支持双链（WikiLinks）、实时预览、离线 PWA 访问，以及 Mermaid 图表和代码高亮。

• 私有 AI 与全文搜索：内置 D1 数据库的全文检索（支持中文），并可选接入 Workers AI 实现私有化语义搜索。

• 多端同步与备份：支持 WebDAV 或 S3 兼容存储的自动备份，数据支持导出为易读的 JSON 或 ZIP 格式。

部署前准备

由于 Inkstone 是基于 Cloudflare 生态构建的，在开始部署前，你需要准备以下内容：

1. 一个 GitHub 账号。

2. 一个注册好的 Cloudflare 账号。

详细部署步骤

Inkstone 的部署流程非常现代化且自动化，全程不需要手动配置复杂的 Nginx 或 PHP 环境。

第一步：复刻（Fork）代码仓库

首先，访问 Inkstone 的 GitHub 仓库，点击页面右上角的 "Fork" 按钮，将项目代码复刻到你自己的 GitHub 账号下。

第二步：连接 Cloudflare Workers & Pages

1. 登录你的 Cloudflare 控制台，在左侧导航栏找到并进入 Workers & Pages。

2. 点击创建新应用，选择 Pages 选项卡。

3. 选择 Connect to Git（连接到 Git），然后授权 Cloudflare 访问你的 GitHub 账号。

4. 在仓库列表中，选择你刚刚 Fork 下来的 inkstone 仓库，点击开始设置。

第三步：配置构建命令

在构建设置页面，你需要根据自己的存储偏好配置部署命令。Inkstone 支持两种附件存储模式：

选项 A：使用 R2 存储（推荐） 如果你打算使用 Cloudflare R2 来存储笔记中的图片和附件：

• 构建命令 (Build command): npm run build

• 部署命令 (Deploy command): npm run deploy

选项 B：使用 KV 存储 如果你倾向于使用 Workers KV 作为附件存储：

• 部署命令 (Deploy command): 改为 npm run deploy:kv

配置完成后，点击 保存并部署。Cloudflare 会自动拉取代码并开始构建你的专属笔记应用。

第四步：初始化与域名绑定

等待几分钟，部署完成后，Cloudflare 会为你生成一个以 .pages.dev 结尾的专属 URL。点击该链接即可访问并初始化你的 Inkstone 笔记。

对于熟悉 DNS 配置的站长，可以在 Cloudflare 项目的 "Custom Domains" 选项卡中，为你刚刚部署好的 Inkstone 绑定一个专属域名。Cloudflare 会自动为你处理 DNS 解析和 SSL 证书的签发，整个过程无缝衔接。

总结

Inkstone 巧妙地利用了 Cloudflare D1、R2 和 Workers 的免费额度，为个人用户提供了一个近乎零成本的云端知识库解决方案。无论是后端的版本控制，还是前端的离线读写体验，都表现得非常成熟。如果你正在寻找一个轻量级、无需操心服务器运维的笔记工具，Inkstone 绝对值得一试。