README file from
Github中文 | 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
- 点击本仓库 Code → Download ZIP
- 解压后放入
<vault>/.obsidian/plugins/cloud-attach/目录
方式二：按版本下载
前往 Releases 下载对应版本。
方式三：按版本下载（推荐）
Obsidian中打开插件商店，搜索“CloudAttach”安装即可。 传送门：CloudAttach
配置
插件设置中添加账号：
| 字段 | 说明 |
|---|---|
| 服务器地址 | OpenList 的 URL |
| 用户名 / 密码 | WebDAV 认证信息 |
| WebDAV 路径 | 通常填 /dav |
| Token | 从 OpenList「设置 → 其他」界面获取 |
对象存储配置：
Usage
- 点击侧边栏图标打开云端文件面板
- 浏览目录，单击文件名插入链接
- 右键有更多操作（预览、复制、重命名、删除）
插入资源到笔记：
上传附件到服务器：
在线PDF预览：
自动上传
快速插入附件
PDF.js 预览
CloudAttach 支持使用 PDF.js 内联预览 PDF 文件。启用方法：
- 打开 CloudAttach 设置 → 高级设置
- 选择 PDF.js 作为 PDF 预览方式
- 点击 保存 — 插件将自动下载并应用 PDF.js
- 通过 CloudAttach 侧边栏插入 PDF 文件
- PDF 将使用
![]()语法插入并在笔记中内联渲染
如需切换回 iframe 预览，在高级设置中改回即可。
后续规划
- 对象存储支持（Cloudflare R2 为主）
- [ ] 笔记内搜索服务器文件并插入（暂时没有好的思路，搁置中）
- 手动触发检测并更新失效 sign
- 笔记附件半自动上传
- Cmd/Ctrl+P 命令菜单
- 上架 Obsidian 商店
- 支持文件重命名、删除
- PDF 文件全屏浏览及更多交互
- [ ] 其他文件格式支持（如 Office 预览，待定）
- 附件自动上传（默认路径）
更新日志
致谢
欢迎提交 Issue 和 Pull Request！