中文 | 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

配置

插件设置中添加账号：

对象存储配置：

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！