Baidu Netdisk Sync

approved

by owl234

Cross-platform bi-directional synchronization with Baidu Netdisk for your vaults. - This plugin has not been manually reviewed by Obsidian staff.

★ 1 stars↓ 80 downloadsUpdated 3d agoMIT
Install in ObsidianView on GitHub

Baidu Netdisk Sync (百度网盘多端同步)

Obsidian Plugin Cost Platforms License: MIT

A 100% free, cross-platform bi-directional synchronization plugin for Obsidian via Baidu Netdisk, seamlessly connecting your vaults across iOS, Android, macOS, Windows, and Linux.

专为 Obsidian 打造的 100% 免费、全平台多设备双向同步插件。依托百度网盘超大容量与国内高速直连，无缝打通 iOS、Android、macOS、Windows 与 Linux。

English | 中文说明

中文说明

💡 为什么选择百度网盘同步？

  1. 💰 100% 免费，零服务器与流量成本
    • 告别高昂的商业同步按月/按年订阅费用。
    • 无需租用 VPS、无需自建 NAS、无需采购对象存储（S3/OSS/COS）及承担流出流量费。普通百度网盘账号即可坐拥数百 GB 至数 TB 免费空间。
  2. 📱 真正的全平台覆盖与移动端友好
    • 完美适配 iOS (iPhone/iPad)、Android 手机/平板、macOS、Windows 和 Linux。
    • 彻底摆脱第三方海外 WebDAV 线路受阻、网络抖动、单月上传流量限额以及移动端 Git 操作门槛高的难题。
  3. ⚡ 独创一键跨端配置迁移 (Multi-Device Fast Pairing)
    • 仅需在电脑端完成一次百度网盘授权，点击即可生成受 AES-256-GCM 密码保护的配对码。
    • 手机/平板端一键粘贴导入，无需在移动端重复申请开发者账号或跳转浏览器授权，秒级完成多端组网。
  4. 🔒 工业级端到端加密 (E2EE)
    • 具备可选的零知识加密机制（AES-256-GCM + PBKDF2）。文件在离开本地前完成加密，网盘端仅存放密文，兼顾网盘便捷性与笔记隐私安全。

🌟 核心特性

  • 📱 全平台兼容 (Cross-Platform)：纯 TypeScript + Obsidian 官方跨平台 API 打造，无 Node.js 底层依赖，桌面与移动端体验丝滑如一。
  • ⚡ 智能切片与极速秒传：严格遵循百度 PCS 规范，大文件 4MB 动态切片断点续传；命中网盘云端指纹时瞬间完成极速秒传。
  • ⏱️ LWW 冲突仲裁 (Last-Write-Wins)：内置 3-Way 差异规划引擎，多设备并发编辑冲突时自动依据最新时间戳收敛一致，并保留历史安全底线。
  • 🛡️ 双向防误删保护 (Dual Trash)：本地删除同步进入 Obsidian 知识库回收站 (.trash)，云端删除进入百度网盘回收站，杜绝误操作丢失资产。
  • 🧩 选择性配置同步：支持自由选择同步 .obsidian/ 下的插件与主题外观，默认精准排除 workspace*.json 等设备专用缓存。
  • 🚀 多样触发矩阵：支持侧边栏图标、状态栏、快捷命令、启动自动同步、定时后台轮询以及编辑保存防抖自动同步。

📲 多设备快速同步配置指南 (推荐姿势)

只需在首台设备（如电脑）配置一次，后续所有设备（手机/平板/办公电脑）均可 10 秒导入！

步骤一：主设备（电脑端）完成基础绑定

  1. 在 Obsidian 社区插件市场搜索并安装 Baidu Netdisk Sync；
  2. 登录 百度网盘开放平台 (pan.baidu.com/union)，在管理中心创建个人应用（获取 AppKey 与 AppSecret）；
  3. 在插件设置中填入 Key 与 Secret，点击打开授权页换取 Token。

步骤二：一键迁移到手机 / 平板 / 第二台设备

  1. 在电脑端插件设置中，找到 “2. 多设备快速配对与配置迁移”；
  2. 点击 “📤 导出配置至其他设备”，输入临时配对密码，点击生成并复制加密配对码；
  3. 打开手机/平板上的 Obsidian，在社区插件市场安装并启用本插件；
  4. 进入插件设置，点击 “📥 导入外部设备配置”，粘贴配对码并输入密码，点击应用；
  5. 搞定！ 移动端立即连接成功，无需在手机上重复申请应用或登录授权。

🛠️ 安装方式

方式 1：Obsidian 官方社区插件市场（推荐）

  1. 打开 Obsidian -> 设置 -> 第三方插件 -> 关闭“受限模式”；
  2. 点击 社区插件浏览，在搜索栏输入 Baidu Netdisk Sync 或 百度网盘；
  3. 点击 安装 (Install)，安装完成后点击 启用 (Enable)。

方式 2：GitHub 手动安装

  1. 从 Latest Releases 下载 main.js、manifest.json、styles.css；
  2. 将文件存入知识库的 .obsidian/plugins/baidu-netdisk-sync/ 目录下；
  3. 在 Obsidian 设置中刷新并启用插件。

💻 本地构建与测试

# 安装依赖
npm install

# 运行全套自动化测试（包含 MD5、过滤引擎、LWW仲裁器、多设备加解密迁移）
npm test

# 生产环境编译打包
npm run build

English

💡 Why Baidu Netdisk Sync?

  1. 💰 100% Free, Zero Infrastructure Cost
    • Say goodbye to expensive cloud sync subscriptions ($4–$10/month).
    • No need to manage rented VPS servers, complex S3 bucket egress fees, or NAS port forwarding. Standard personal Baidu accounts provide massive storage (up to 2TB) at zero monetary cost.
  2. 📱 True Cross-Platform, Mobile-First Design
    • Seamlessly supports iOS (iPhone/iPad), Android, macOS, Windows, and Linux.
    • No network throttling or complex mobile Git requirements. Enjoy dependable connectivity and high-speed domestic transfers.
  3. ⚡ One-Click Multi-Device Pairing
    • Authorize once on your PC, then click Export Configuration to generate an AES-256-GCM encrypted pairing code.
    • Paste into your phone or tablet to link devices in seconds without repeated OAuth log-ins on mobile screens.
  4. 🔒 End-to-End Encryption (E2EE)
    • Optional client-side AES-256-GCM encryption with PBKDF2 key derivation. Your notes and attachments are encrypted before leaving your hardware.

🌟 Key Features

  • 📱 Cross-Platform: Developed strictly with pure TypeScript and Obsidian cross-platform APIs (app.vault.adapter and requestUrl), running smoothly across iOS, Android, and Desktop.
  • ⚡ Chunked Resumable Uploads & Instant Cloud Deduplication: Implements official Baidu PCS specifications with 4MB slicing and cloud hashing for instant transfer.
  • ⏱️ LWW 3-Way Conflict Arbiter: Last-Write-Wins logic resolves concurrent edits deterministically across multiple devices.
  • 🛡️ Dual Trash Protection: Deletions are safeguarded into Obsidian's local .trash and Baidu cloud's Recycle Bin.
  • 🧩 Granular Config Sync: Sync your plugins and CSS themes while excluding transient workspace caches.
  • 🚀 Rich Trigger Options: Manual icon click, status bar, quick command palette, startup auto-sync, interval polling, and debounced save sync.

📲 Quick Multi-Device Setup Guide

  1. Primary Device (e.g. Desktop):
    • Configure your personal developer AppKey/Secret and complete OAuth in plugin settings.
    • Go to Section 2: Multi-Device Quick Pairing, click Export Configuration, set a temporary PIN, and copy the pairing code.
  2. Secondary Device (e.g. iPhone, iPad, Android):
    • Install Baidu Netdisk Sync from the Obsidian Community Store.
    • Open plugin settings -> click Import Configuration, paste the code, enter your PIN, and submit.
    • You're instantly connected and ready to sync across all devices!

🛠️ Installation

Option 1: Obsidian Community Plugin Directory (Recommended)

  1. Open Obsidian -> Settings -> Community plugins -> Turn off Restricted mode.
  2. Click Browse and search for Baidu Netdisk Sync.
  3. Click Install, then Enable.

Option 2: Manual Installation

  1. Download main.js, manifest.json, and styles.css from Latest Releases.
  2. Extract them into your vault at .obsidian/plugins/baidu-netdisk-sync/.
  3. Reload community plugins and enable Baidu Netdisk Sync.

📄 License

MIT License

For plugin developers

Search results and similarity scores are powered by semantic analysis of your plugin's README. If your plugin isn't appearing for searches you'd expect, try updating your README to clearly describe your plugin's purpose, features, and use cases.