特点：全程在浏览器网页中点击鼠标操作，无需安装 Node.js/Wrangler 命令行，无需终端配置，100% 免费利用 Cloudflare 官方额度（Workers + R2 + KV）搭建个人云端 Obsidian Web。
📌 部署前准备文件清单
在进行网页操作前，确认本地 `` 目录已包含以下文件：
- Worker 单文件代码：
dist/index.js（已编译打包好，约 100KB）
- 前端静态资源文件夹：
assets/（包含 obsidian/、ui/、shim/、server/）
下载地址：obsidian-works.zip - 蓝奏云
🚀 第一阶段：创建免费存储组件 (R2 与 KV)
步骤 1：创建 R2 存储桶 (存放笔记数据与前端静态资源)
- 浏览器打开 Cloudflare 官方控制台 并登录；
- 在左侧菜单栏展开 **「存储和数据库 (Storage & Databases)」 -> 点击 「R2 对象存储 (R2 Object Storage)」**；
- 点击页面右上角的 **「创建存储桶 (Create bucket)」** 按钮；
- 填写配置：
- 存储桶名称 (Bucket name)：输入
obsidian-vault
- 位置提示 (Location Hint)：选择
自动 (Automatic) 或 亚太地区 (APAC)
- 点击 **「创建存储桶 (Create bucket)」** 完成。
步骤 2：在 R2 存储桶中上传前端静态资源
- 在刚刚创建好的
obsidian-vault 存储桶管理页面中，点击右上角的 「上传 (Upload)」 按钮下拉菜单；
- 选择 **「上传文件夹 (Upload folder)」**；
- 在本地文件选择器中，定位并选中整个
assets 文件夹：
👉 路径：存放路径\assets
- 确认上传。上传完成后，存储桶中应包含
assets/obsidian/...、assets/ui/...、assets/shim/... 等资源。（网页assets中文件过多无法一次上传，可以手动创建文件夹，分批上传，例如创建assets文件夹，再在其中创建obsidian文件夹，再将内部文件分批上传，或者使用cloudfare推荐的工具上传）
步骤 3：创建 KV 命名空间 (存放会话与配置)
- 在左侧菜单栏 **「存储和数据库」 下，点击 「KV」**；
- 点击右上角 「创建命名空间 (Create namespace)」；
- 命名空间名称 (Namespace Name) 输入：
IGNIS_KV；
- 点击 **「添加 (Add)」** 完成创建。
⚡ 第二阶段：创建并部署 Cloudflare Worker
步骤 4：创建 Worker 应用程序
- 在左侧主菜单栏点击 **「Workers 和 Pages」 -> 点击 「概述 (Overview)」**；
- 点击右上角的 **「创建应用程序 (Create Application)」** 按钮；
- 确保选中的是 **「Workers」** 标签页；
- 点击 **「创建 Worker (Create Worker)」**；
- 给 Worker 命名（例如默认的
obsidian-web 或自定义名称）；
- 点击右下角 **「部署 (Deploy)」**（此时会先生成一个默认的 Hello World Worker）。
步骤 5：在线粘贴核心代码
- 部署成功提示页中，点击 **「编辑代码 (Edit code)」** 进入 Cloudflare 网页在线代码编辑器；
- 打开本地文件：
/dist/index.js；
- 使用快捷键 **Ctrl + A（全选）然后 Ctrl + C**（复制）里面的全部代码；
- 切换到 Cloudflare 网页编辑器，清空编辑器中原有的默认代码，按 **Ctrl + V** 粘贴刚才复制的代码；
- 点击页面右上角的 **「部署 (Deploy)」** 按钮保存。
🔗 第三阶段：配置存储绑定与管理员密码
步骤 6：进入 Worker 设置页面
点击网页编辑器左上角的 **「← 返回 (Worker 名称)」，回到 Worker 的管理主面板，然后点击上方导航栏的 「设置 (Settings)」** 标签页。
步骤 7：绑定 R2 存储桶
- 在 **设置 (Settings) 页面向下滚动，找到 「R2 存储桶绑定 (R2 Bucket Bindings)」**；
- 点击 **「添加绑定 (Add binding)」**：
- 变量名称 (Variable name) 必须严格填写：
VAULT_BUCKET
- R2 存储桶 (R2 bucket) 下拉选择：
obsidian-vault
- 点击 **「保存并部署 (Save and deploy)」**。
步骤 8：绑定 KV 命名空间
- 向下滚动找到 **「KV 命名空间绑定 (KV Namespace Bindings)」**；
- 点击 **「添加绑定 (Add binding)」**：
- 变量名称 (Variable name) 必须严格填写：
IGNIS_KV
- KV 命名空间 (KV namespace) 下拉选择：
IGNIS_KV
- 点击 **「保存并部署 (Save and deploy)」**。
步骤 9：配置管理员密码与环境变量
-
向下滚动找到 **「环境变量 (Environment Variables)」**；
-
点击 **「添加变量 (Add variable)」**，依次添加以下三组配置：
| 变量名称 (Variable name) |
值 (Value) |
是否加密 (Encrypt) |
说明 |
DEFAULT_VAULT_ID |
default |
否 |
默认仓库 ID |
DEFAULT_VAULT_NAME |
我的知识库 |
否 |
默认仓库展示名称 |
ADMIN_PASSWORD |
您的管理员密码(例如Obsidian<a class="userat" href="#" onclick="atAdd('2026',this);return false">@</a><a class="userinfo" href="user.info.0.html">2026</a>) |
点击右侧加密小锁 |
登录后台的访问密码 |
-
点击 **「保存并部署 (Save and deploy)」**。
🎉 第四阶段：访问与使用
- 点击回到 Worker 的主页；
- 找到系统为您生成的专属域名（格式为
https://obsidian-web.您的子域.workers.dev）；
- 在浏览器中打开该网址，系统将自动展示登录页面：
- 默认用户名：
admin
- 密码：刚才在环境变量
ADMIN_PASSWORD 中设置的密码
- 登录成功后即可秒级进入 Obsidian 网页版，开始畅快记录笔记！所有笔记将实时持久化存储在您的 Cloudflare R2 中。
💡 进阶：绑定自己的独立域名 (可选)
如果您在 Cloudflare 上托管了自己的域名（例如 yourdomain.com）：
- 在 Worker 的 **设置 (Settings) -> 域和路由 (Domains & Routes)**；
- 点击 **「添加 (Add)」 -> 「自定义域 (Custom Domain)」**；
- 输入二级域名（例如
notes.yourdomain.com），点击添加；
- Cloudflare 会自动配置 DNS 并签发全球免费 SSL 证书。
