中文 | English

obsidian-cloud-attach

Obsidian 插件，通过 WebDAV 连接 OpenList 等服务以及对象存储（S3），在笔记中直接插入云端文件。释放本地空间。

---

项目背景

• 坚定的 Obsidian 库内 0 附件使用者
• 重度 OpenList 依赖者
• 前电商从业者，0 代码基础
• 全程 🦞 龙虾操作

---

功能特点

• 🌐 WebDAV 协议 — 兼容 OpenList，理论上支持 Alist / 群晖 / 威联通 QNAP 等所有 WebDAV 服务
• 🌐 S3 对象存储 — 兼容 Cloudflare R2，理论上支持 AWS 等大部分对象存储服务
• 📂 侧边栏浏览 — 直接在 Obsidian 侧边栏浏览云端目录
• 📝 一键插入 — 单击插入 Markdown 链接，支持单选/多选同时插入
• ⬆️ 上传附件 — 上传本地附件到服务器并更新引用，节省本地空间
• 🔗 签名链接 — 自动生成带 sign 签名的 URL
• 🖼️ 多媒体预览 — 图片预览、视频/音频播放、文档 iframe 预览
• 📄 PDF.js 预览 — 高级设置中可选择 PDF.js 作为预览工具，自动下载并应用；插入 PDF 时使用 ![]() 语法，像图片一样内联预览
• 🎯 附件自动上传 - 开启后可在笔记插入附件时自动上传到默认服务
• ⚙️ 高级设置 — 可配置 PDF 等格式的不同预览方式，后续将支持更多格式（如 Office 预览）
• 👤 多账号切换 — 同时管理多个 WebDAV/S3 账号

注：对象存储可能无法使用在线预览，取决于各服务商限制。建议先用 OpenList 挂载对象存储，再使用 OpenList 的路径预览。

---

Installation

方式一：下载 ZIP

1. 点击本仓库 Code → Download ZIP
2. 解压后放入 <vault>/.obsidian/plugins/cloud-attach/ 目录

方式二：按版本下载

前往 Releases 下载对应版本。

方式三：插件商店安装（推荐）

Obsidian中打开插件商店，搜索“CloudAttach”安装即可。 传送门：CloudAttach

---

配置

插件设置中添加账号：

字段	说明
服务器地址	OpenList 的 URL
用户名 / 密码	WebDAV 认证信息
WebDAV 路径	通常填 /dav
Token	从 OpenList「设置 → 其他」界面获取

对象存储配置：

---

Usage

1. 点击侧边栏图标打开云端文件面板
2. 浏览目录，单击文件名插入链接
3. 右键有更多操作（预览、复制、重命名、删除）

插入资源到笔记：

上传附件到服务器：

在线PDF预览：

自动上传

快速插入附件

---

PDF.js 预览

CloudAttach 支持使用 PDF.js 内联预览 PDF 文件。启用方法：

1. 打开 CloudAttach 设置 → 高级设置
2. 选择 PDF.js 作为 PDF 预览方式
3. 点击 保存 — 插件将自动下载并应用 PDF.js
4. 通过 CloudAttach 侧边栏插入 PDF 文件
5. PDF 将使用 ![]() 语法插入并在笔记中内联渲染

如需切换回 iframe 预览，在高级设置中改回即可。

---

后续规划

• 对象存储支持（Cloudflare R2 为主）

- [ ] 笔记内搜索服务器文件并插入（暂时没有好的思路，搁置中）

• 手动触发检测并更新失效 sign
• 笔记附件半自动上传
• Cmd/Ctrl+P 命令菜单
• 上架 Obsidian 商店
• 支持文件重命名、删除
• PDF 文件全屏浏览及更多交互

- [ ] 其他文件格式支持（如 Office 预览，待定）

• 附件自动上传（默认路径）

---

更新日志

Releases

---

致谢

• Obsidian
• OpenList

---

欢迎提交 Issue 和 Pull Request！