1. 为什么我把 Obsidian 双端同步押注在坚果云上1.1 Obsidian 的本地优先逻辑与多端需求之间的矛盾Obsidian 这个软件用过的人都懂一个点所有笔记都存在本地 Markdown 文件里没有账号体系、没有自动云同步。它的优势也恰恰是这个地方——文件是自己的隐私可控随便备份配合 Git 还能做版本管理。但反过来一旦你想在电脑上写完笔记通勤时用安卓手机翻一翻、补充两句就立刻撞上“多端同步”这堵墙。官方同步服务 Obsidian Sync 一个月要付费而且需要注册账号国内访问和支付都不算省心iCloud 仅限苹果生态Syncthing 需要两端都保持在线、折腾内网穿透和 NAT 类型对普通用户来说有点劝退。在安卓手机上Obsidian 本身是支持“打开本地文件夹作为仓库”的但它不会主动帮你把数据从云端拉下来。所以同步这件事本质上不是 Obsidian 的活而是操作系统层面的活把电脑上的笔记文件夹和手机上的笔记文件夹连起来让两边保持一致。这个需求用坚果云来做是我实测下来最顺手的方案之一。坚果云的同步文件夹可以通过 WebDAV 协议访问再加上安卓端有成熟的 WebDAV 同步工具整个链路就通了。1.2 对比官方同步、iCloud、Syncthing 之后的选择我先说我踩过的对比过程。最早用的是官方 Obsidian Sync体验确实流畅但费用不低而且同步的数据需要端到端加密解密过程要消耗一定性能更关键的是同步服务器部署在境外对国内网络环境并不友好高峰期经常同步失败或延迟。后来试过 iCloud电脑端 Windows 上体验一般安卓端就更别说了——iCloud 官方没有 WebDAV 这样的通用接口安卓上要绕开它几乎做不到。Syncthing 我也跑过一段时间局域网内同步非常快但如果两台设备不在同一网络就需要中继服务器或自己搭穿透对网络知识的门槛有点儿高。最后回到坚果云。它的优势很明确国内服务器速度快同步文件夹机制简洁电脑端装个客户端就能把一个文件夹变成“云同步文件夹”同时对外提供 WebDAV 接口安卓端可以用第三方工具连上来做双向同步。个人免费版每月 1GB 上传、3GB 下载流量对以文字为主的 Obsidian 库来说只要不夹带大量视频、高清图片基本够用。更重要的是这套方案不绑定 Obsidian 的账号体系换一个笔记软件或者干脆直接管理 Markdown 文件也能继续用完全是数据自主的路子。2. 环境准备账号、软件与路径规划2.1 注册坚果云并创建应用密码这套方案的第一步是准备好坚果云账号。注册地址我不用多啰嗦官网注册即可。关键是拿 WebDAV 配置信息的方式登录网页端后进入“账户信息”-“安全选项”找到“第三方应用管理”这一栏点击“添加应用密码”。坚果云出于安全考虑不允许第三方应用直接使用账号密码访问 WebDAV而是要求生成一个独立的“应用密码”这个密码只对 WebDAV 服务生效即便泄露了也不能登录网页端权限被限定在文件访问这一层。创建应用密码的时候会要求填一个名称比如“obsidian-sync”然后系统会给出一串随机密码。这里有两个细节要记住一是服务器地址固定是https://dav.jianguoyun.com/dav/所有 WebDAV 客户端都填这个二是应用密码只显示一次建议立即粘贴到某个本地密码管理器里别直接存在坚果云同步的文件中不然就循环依赖了。然后回到坚果云网页端新建一个同步文件夹名字随意比如/Obsidian这个目录就是日后所有笔记文件存放的地方。电脑端与手机端的同步都是围绕这一整个目录展开的。2.2 电脑端 Obsidian 的安装与初始化电脑端去 Obsidian 官网下载 Windows 版本即可。安装过程很干净没有捆绑打开后选择“Create new vault”创建新库填一个名字比如MyNotes然后设置存放路径。我建议把库放在一个路径简单、没有空格和中文的目录下比如D:\MyNotes。原因不是 Obsidian 不支持中文路径而是在后续坚果云客户端同步、命令行操作、Git 版本管理时中文或特殊字符偶尔会带来一些不可预料的麻烦没必要用踩坑换个性。库创建好之后Obsidian 会生成三个隐藏项.obsidian配置文件目录存放主题、插件、快捷键等、.trash回收站、以及你新建的笔记文件。这里记住一个关键概念整个“仓库文件夹”就是 Obsidian 的全部同步时把整个文件夹原样搬过去任何一端看到的笔记结构就会完全一致。.obsidian目录要不要同步是个值得琢磨的问题——我建议在第一次搭建时先同步这样主题和常用插件可以一并搬过去后面如果出现移动端插件加载异常再调整策略后面第 5 章我会细讲。2.3 安卓端 Obsidian 的安装与前期准备安卓端在 Google Play 或者 Obsidian 官网直接下载 APK 都行国内网络访问官网下载一般没问题如果感觉下载太慢可以换 Play 商店。安装完成后先不要着急建库。关键问题在于手机上 Obsidian 打开的“库”必须是一个已经存在于本地存储的文件夹。而这个文件夹需要被安卓端的同步工具接管如果 Obsidian 自动在应用私有目录Android/data/md.obsidian...里建了库同步工具反而访问不到。所以我先推荐一个稳妥路径在手机内部存储的Documents目录下手动新建一个ObsidianVault文件夹然后把它指定为 Obsidian 的库。这个目录在绝大多数文件管理器里可见Folder Sync 之类的同步工具也能正常读写不会撞上 Android 11 之后的存储权限限制。安卓端 Obsidian 安装后首次启动会让你选择“打开文件夹作为仓库”或“创建新库”。此时选择打开文件夹然后导航到前面建好的Documents/ObsidianVault即可。由于这个文件夹现在是空的Obsidian 会提示这不是一个有效仓库但你仍然可以打开等同步完成之后笔记自然会出现。为了让你心里有底可以把电脑上那个库的.obsidian配置文件夹先复制过来就能提前把主题和插件配置在手机上加载好。3. 电脑端配置坚果云同步3.1 下载坚果云客户端并同步本地库电脑端需要安装坚果云客户端官网下载对应 Windows 版本即可。安装时它会让你选择要同步的文件夹要么在安装向导里直接勾选坚果云云端已有的目录要么安装完成后在客户端“同步文件夹”中添加。把前面在第 2.1 节创建好的/Obsidian同步文件夹绑定到一个本地磁盘路径比如D:\Jianguoyun\Obsidian。这个本地路径就是桌面端坚果云客户端的“工作副本”每次修改文件后客户端会自动把它上传到云端。接下来要做的一步是把 Obsidian 的库移动到这个同步目录里。做法很简单在 Obsidian 里关闭当前库左上角“库”图标或菜单栏的“Open another vault”然后用文件管理器把整个D:\MyNotes剪切到D:\Jianguoyun\Obsidian下再在 Obsidian 里打开新路径的库。这样你的库文件夹就和坚果云同步文件夹合二为一了。为什么要这样操作而不是直接新建库因为直接新建会丢失已有的.obsidian配置和笔记历史。移动完成后坚果云客户端会自动开始上传文件到云端。这里要特别提醒同一时间只开一个端点写同一份库。坚果云客户端的双向同步机制并不擅长处理“电脑端和手机端同时修改同一个文件”的场景它会产生冲突副本。Obsidian 的库结构对文件级的冲突其实很敏感尤其是.obsidian配置文件如果两台设备同时改最终结果可能是一份混乱的配置。所以我的习惯是在手机上写笔记写完等同步完成再关掉回到电脑前先等坚果云拉取完成再开始编辑。听起来麻烦养成习惯后其实很自然。3.2 选择同步文件夹的注意事项坚果云有一个机制你在客户端里可以选择“只同步部分子文件夹”而不是整棵目录树都本地化。这在 Obsidian 场景下很实用。比如你有一个assets文件夹专门放笔记里的图片另有一个archive文件夹放历史归档这两个目录如果体积很大、又不常看可以在坚果云客户端里右键对应文件夹选择“不同步到这台电脑”。这样电脑端节省存储空间云端和安卓端仍然保留完整数据。但是要小心如果某个文件夹不同步到电脑而 Obsidian 库的位置恰好在坚果云同步目录下Obsidian 依然能看到那个文件夹的“占位标记”坚果云有虚拟占位功能也就是文件列表可见但内容未下载。理论上 Obsidian 打开这样的笔记会出现链接缺失或图片无法显示因为底层文件并没有被完整下载。实际使用中我建议还是保持整棵仓库树都在本地同步除非你非常确定某个区域涉及超大附件比如几百 MB 的 PDF、多媒体素材否则没有必要为压缩存储而牺牲 Obsidian 的完整性。另外坚果云客户端的默认设置是“自动同步打开的文件”但有时候文件被 Obsidian 频繁写入每次按 CtrlS 都会触发可能在短暂瞬间产生重复上传。我实测下来没出现过大问题不过建议把坚果云客户端的“实时同步”选项开着不要手动暂停同步。如果发现某次同步卡住先看右下角坚果云图标是否显示“正在等待”大概率是在排队或遇到文件占用。3.3 坚果云客户端的回收站与历史版本坚果云同步文件夹有一个容易被忽略但很实用的功能历史版本和误删恢复。右键同步文件夹中的任意文件选择“历史版本”可以看到它在不同时间点的版本并能一键恢复。这对 Obsidian 用户来说相当于一个轻量的笔记版本管理不需要依赖 Git 也能找回一两天前的误改内容。回收站同样重要删除文件后坚果云并不会立刻在云端删除而是保留一段时间期间你可以从网页端或客户端找回。这跟 Git 的git checkout有些类似但粒度更粗只适用于救急。要注意的是坚果云的历史版本恢复是在文件级生效不是目录级。也就是说如果你误删了整个文件夹需要先通过回收站找回文件夹再对单个文件做版本回滚。实际操作中我在几次误删笔记后都是靠这个功能救回来的但也正因为如此它不能替代正式的版本管理工具关键的长期笔记项目建议还是定期用 Git 或导出为 ZIP 做一次完整备份。4. 安卓端接入与同步打通4.1 安卓端同步工具的选型为什么推荐 Folder Sync 或 Dropsync安卓端的同步工具我试过几类。一类是坚果云官方 App它主打的是“备份”和“查看”不是“双向同步”你可以在手机上打开坚果云 App手动选择文件下载但不能实现后台自动把本地文件夹与云端文件夹保持一致。另一类是通用文件管理器自带的 WebDAV 支持比如 CX 文件管理器这种能浏览也能上传下载但同步逻辑很弱无法处理双向差异。真正干这个活儿的工具是专门的同步型软件其中 Folder Sync 和 Dropsync 是主流。Folder Sync 的全称是 “FolderSync”支持 WebDAV、SFTP、S3、OneDrive、Google Drive 等多种协议免费版能配置一个同步任务够用想要多个任务、定时同步等高级功能可以付费解锁。Dropsync 最早是给 Dropbox 做的后来也支持了 WebDAV稳是稳但免费版限制更严格。我个人的推荐是 Folder Sync配置清晰、同步规则细、出错提示明确中文界面也做得不错适合教程中的操作说明。如果你偏好极简Dropsync 也完全可以核心配置逻辑大同小异。4.2 Folder Sync 配置 WebDAV 与同步策略打开 Folder Sync第一步是添加账户。点击“账户”-“添加账户”类型选择WebDAV。服务器地址填https://dav.jianguoyun.com/dav/用户名填你的坚果云邮箱或用户名密码填前面创建的应用密码不是网页登录密码勾选“使用 SSL”或默认即可。测试连接一般会显示成功如果失败优先检查是否把账号密码误填成了登录密码、服务器地址是否多写了子路径这两个是最常见的连不上的原因。第二步是创建同步任务。在“同步文件夹”标签页添加新任务选择“本地文件夹”指向手机上 Obsidian 库所在的路径比如/storage/emulated/0/Documents/ObsidianVault选择“远程文件夹”指向坚果云里的/Obsidian如果服务器地址已经带有/dav/那么远程路径应该写Obsidian或者dav/Obsidian具体看 Folder Sync 对路径的拼装方式我习惯在账户地址里只写根目录然后在任务的远程路径里填具体文件夹名。同步类型选择“双向同步”即Two-way。第三步是设置触发方式。Folder Sync 支持手动、定时、插电、开机启动等多种触发条件。我的建议是设置一个“定时”任务比如每 15 分钟或者每 1 小时自动同步一次同时打开“在连接电源时允许同步”和“仅在 Wi-Fi 下同步”选项避免用手机流量跑大库。另外打开“自动同步”开关后Folder Sync 会在后台监听本地文件夹变化并自动上传。需要注意安卓系统的省电策略可能会杀掉后台进程所以还要在系统设置里允许 Folder Sync 后台运行、关闭电池优化否则同步会莫名其妙地不触发。4.3 首次同步的坑冲突、端口与路径第一次把整个库从电脑同步到手机上可能遇到三个高频问题。第一是首次同步时间很长如果库里有几千个文件手机上可能要下载很久。你可以在 Folder Sync 里看到进度条耐心等它完成不要在同步过程中打开 Obsidian 去编辑否则会在上传阶段制造冲突。第二是路径写错导致点击“测试”成功但同步却失败——因为 WebDAV 服务器地址和远程根目录拼接后指向了不存在的目录。解决办法是先不指定远程文件夹只配置账户然后在同步任务里手动填写远程路径多试几次。第三个坑是坚果云的流量限制。第一次把整个库从云端拉到手机会把当月的下载流量一次性吃掉不少如果库里有较多图片1GB 下载额度很快见底。不少人第一次同步完当月的流量就报警了。我的建议是首次同步尽量放在月初或者第一时间观察库的体积。如果确认库的总大小超过几百 MB甚至建议先精简附件把大文件单独放一个不同步目录后面再按需获取。另外坚果云的免费版流量是“上传 1GB/月、下载 3GB/月”超出后会暂停同步直到下个月重置。这不是故障是配额用完了别白排查半天。5. 实现双端一致仓库结构、附件与插件的跨端配置5.1 附件路径设置从根源上避免“图片加载不出来”Obsidian 默认会把粘贴进来的图片放在与当前笔记同级的目录下这种做法在单机环境没问题但一旦同步到多端如果笔记位于不同文件夹图片分散在全库的各处时间一长仓库结构会变得凌乱也不好针对大附件做同步策略。所以我的建议是尽早把附件路径统一。在 Obsidian 设置 -“文件与链接”里将“默认新附件位置”改为“仓库根目录下指定文件夹”比如assets。这样所有图片、PDF 等附件都会自动归集到一个assets目录同步和管理都省心。另一个值得注意的是 Obsidian 内部链接的写法。Obsidian 使用类似[[笔记名]]的 Wiki 链接只要库内文件名不重复搬家到哪都能解析。但如果你的笔记名含有空格或特殊字符在某些同步场景下路径解析会出小问题。我习惯在笔记命名时只用字母、数字、下划线、短横线虽然 Obsidian 本身没问题但坚果云或者 Folder Sync 在极少数情况下遇到中文特殊字符时可能别扭。这个习惯养成后库的跨端表现会稳定很多。5.2 插件与主题的同步策略.obsidian文件夹里存放了插件、主题、快捷键等全部配置。因为它是仓库的一部分所以一旦整个库同步配置也会跟着同步。好处是主题和常用插件在手机端也自动可用坏处是某些桌面端插件在移动端并不支持Obsidian 移动版加载不支持的插件时要么报错要么在设置里出现无法应用的选项。我踩过几次坑后总结出的做法是桌面端只安装“两端都能用”的插件尽量不装与桌面环境强相关的插件。比如核心插件中的“日记”、“大纲”、“关系图谱”在移动端都能用而一些系统集成型插件比如需要调用桌面浏览器的插件、依赖 Node.js 环境的插件在移动端可能直接失效。如果你确实需要在桌面端用这类插件又不想它干扰移动端可以在同步前把该插件的.obsidian/plugins/插件名/main.js从同步目录中删除或者用 Obsidian 的“已安装插件”列表在移动端手动关闭。手动关闭后配置会被写回.obsidian从而同步回桌面端所以最好只对“移动端也没有必要使用”的插件做禁用操作。主题方面则相对安全只要主题版本兼容移动端基本能渲染。如果某次同步后手机端 Obsidian 界面异常大概率是主题文件不完整或版本不兼容把整个.obsidian文件夹在手机上删掉重新从云端拉取一次就好。5.3 跨平台快捷键与命令面板差异Obsidian 在电脑端有许多快捷键比如CtrlO快速打开文件、CtrlP打开命令面板。到了安卓端快捷键没有实体键盘就完全用不上但 Obsidian 移动端提供了“上下滑动切换标签页”之类的手势操作以及编辑器底部工具栏的快捷按钮。如果你的使用习惯是从电脑切换过来刚开始会不太适应但核心的编辑能力在两端完全一致。我通常的做法是电脑端用快捷键和命令面板手机端用 Obsidian 的移动端工具栏按钮再加上手机输入法的剪贴板配合效率其实不差。命令面板在各端都一样唯一需要注意的是自定义命令和插件命令的 ID 在不同端可能因为插件未加载而缺失。也就是说如果你在电脑端设置了一个工作流依赖某个插件提供的命令在手机端该插件被禁用或不可用时命令面板里那条命令会消失。这在设计跨端工作流时要提前考虑尽量用 Obsidian 核心功能实现把插件命令限制在单端。6. 常见问题与排查技巧实录6.1 同步失败或冲突现象原因解决方法Folder Sync 提示“连接失败”账号或密码填错或 WebDAV 地址不正确确认账号为坚果云邮箱/用户名密码为应用密码检查地址是否为https://dav.jianguoyun.com/dav/同步中途卡住网络波动或文件被占用在 Folder Sync 中重置同步状态查看坚果云客户端是否正在上传等待片刻出现“conflicted copy”文件两端同时修改了同一个文件把冲突文件副本用文本对比工具比如 Obsidian 设置里的“比较文件”功能手动合并删掉多余副本Obsidian 里图片或附件缺失附件路径不一致或附件未同步检查附件是否统一放在assets目录确认 Folder Sync 任务涵盖了整个库目录冲突是双向同步绕不开的话题。Folder Sync 处理冲突的策略是如果本地和远程文件都有改动它会生成一个副本文件名加(conflicted copy)后缀而不是自动决定谁覆盖谁。这个策略是安全的但需要人工清理。我建议定期在 Obsidian 的搜索里搜conflicted把残留的冲突副本逐个检查后删除避免仓库里堆积无用的垃圾文件。6.2 手机端无法打开仓库这个问题的典型表现Obsidian 安卓版启动后选择打开库但提示“不是有效的仓库”或“找不到库”。原因多半是同步工具还没把.obsidian和相关文件下载到本地或者存储权限没给足。Obsidian 对仓库的判定逻辑是打开一个文件夹时必须能看到.obsidian配置目录或者文件夹内有至少一个.md文件否则就会认为是无效仓库。解决方法很简单先确保 Folder Sync 完成了首次全量同步再打开 Obsidian。如果 Folder Sync 已经显示同步完成但 Obsidian 仍不认检查一下文件管理器中Documents/ObsidianVault下是否真的存在.obsidian目录。注意某些安卓文件管理器默认隐藏点开头的文件需要在设置里打开“显示隐藏文件”。另外从 Obsidian 的库选择界面点右上角的“打开文件夹作为仓库”然后从左侧目录导航到准确路径不要选错层级比如选了Documents而不是Documents/ObsidianVault。6.3 坚果云流量限制坚果云免费版每月上传 1GB、下载 3GB。如果你的库全是 Markdown 文字根本用不完但如果插入了大量图片或者扫描版 PDF每个文件动辄几 MB一个月下来就要小心了。超流量后坚果云会暂停同步客户端上会提示“流量超限”这时候只能等配额重置或者升级付费版。我的规避思路有三层。第一层是控制附件体积图片尽量压缩后放入库别直接粘贴原始截图大型 PDF 不放在 Obsidian 库内而是放在另一个坚果云同步文件夹笔记里用外链或路径引用。第二层是针对assets目录单独设计同步策略如果附件多可以做一个 Folder Sync 任务只同步assets而不实时同步笔记减少频繁上传的流量消耗。第三层是把坚果云网页端的“回收站”清理干净因为回收站里的文件也会占用流量配额删除文件后的保留版本依然会上传。定期清空回收站能省下不少隐蔽流量。7. 实操总结与个人体会7.1 长期稳定运行的几个习惯这套 Obsidian 坚果云的双端同步方案我实际用了大半年。它最吸引我的一点是数据始终以 Markdown 文件的形式存在于本地云端只是一个“同步中转站”而不是唯一的数据源。这意味着就算哪天坚果云服务出问题或者我决定换一种同步方式笔记文件都还在我手里没有任何迁移成本。我在实际使用中还养成了几个小习惯现在分享出来。一是在 Obsidian 里打开“自动保存”因为坚果云同步依赖文件落盘如果 Obsidian 崩溃或直接断电未保存的内容自然不会同步二是设置里把“使用安全模式”Safe mode关闭让第三方插件在两端都能生效但前提是只装兼容的插件三是每个月固定检查一次.obsidian配置目录的体积如果发现里面有异常增大的日志或缓存文件及时清理。稳定性方面目前这套方案用下来没有丢过数据偶尔的冲突副本也能快速解决。7.2 这套方案的边界在哪里这套方案不是万能的。如果笔记库达到上万文件级别Folder Sync 每次全量扫描会比较耗时同步速度也会下降如果你需要多人实时协作编辑坚果云本地文件夹模式并不适合它本质上是个人数据同步而不是团队协作平台。另外免费版流量始终是硬约束大文件多的时候就该考虑升级或者切换数据层方案。但如果你和我一样主要用 Obsidian 做个人知识管理笔记以文字为主偶尔插入几张图片那么坚果云Folder Sync 这个组合完全够用而且不花一分钱就能把电脑和安卓手机两端的库保持在同一个状态。
Obsidian双端同步实战：坚果云WebDAV与Folder Sync配置指南
1. 为什么我把 Obsidian 双端同步押注在坚果云上1.1 Obsidian 的本地优先逻辑与多端需求之间的矛盾Obsidian 这个软件用过的人都懂一个点所有笔记都存在本地 Markdown 文件里没有账号体系、没有自动云同步。它的优势也恰恰是这个地方——文件是自己的隐私可控随便备份配合 Git 还能做版本管理。但反过来一旦你想在电脑上写完笔记通勤时用安卓手机翻一翻、补充两句就立刻撞上“多端同步”这堵墙。官方同步服务 Obsidian Sync 一个月要付费而且需要注册账号国内访问和支付都不算省心iCloud 仅限苹果生态Syncthing 需要两端都保持在线、折腾内网穿透和 NAT 类型对普通用户来说有点劝退。在安卓手机上Obsidian 本身是支持“打开本地文件夹作为仓库”的但它不会主动帮你把数据从云端拉下来。所以同步这件事本质上不是 Obsidian 的活而是操作系统层面的活把电脑上的笔记文件夹和手机上的笔记文件夹连起来让两边保持一致。这个需求用坚果云来做是我实测下来最顺手的方案之一。坚果云的同步文件夹可以通过 WebDAV 协议访问再加上安卓端有成熟的 WebDAV 同步工具整个链路就通了。1.2 对比官方同步、iCloud、Syncthing 之后的选择我先说我踩过的对比过程。最早用的是官方 Obsidian Sync体验确实流畅但费用不低而且同步的数据需要端到端加密解密过程要消耗一定性能更关键的是同步服务器部署在境外对国内网络环境并不友好高峰期经常同步失败或延迟。后来试过 iCloud电脑端 Windows 上体验一般安卓端就更别说了——iCloud 官方没有 WebDAV 这样的通用接口安卓上要绕开它几乎做不到。Syncthing 我也跑过一段时间局域网内同步非常快但如果两台设备不在同一网络就需要中继服务器或自己搭穿透对网络知识的门槛有点儿高。最后回到坚果云。它的优势很明确国内服务器速度快同步文件夹机制简洁电脑端装个客户端就能把一个文件夹变成“云同步文件夹”同时对外提供 WebDAV 接口安卓端可以用第三方工具连上来做双向同步。个人免费版每月 1GB 上传、3GB 下载流量对以文字为主的 Obsidian 库来说只要不夹带大量视频、高清图片基本够用。更重要的是这套方案不绑定 Obsidian 的账号体系换一个笔记软件或者干脆直接管理 Markdown 文件也能继续用完全是数据自主的路子。2. 环境准备账号、软件与路径规划2.1 注册坚果云并创建应用密码这套方案的第一步是准备好坚果云账号。注册地址我不用多啰嗦官网注册即可。关键是拿 WebDAV 配置信息的方式登录网页端后进入“账户信息”-“安全选项”找到“第三方应用管理”这一栏点击“添加应用密码”。坚果云出于安全考虑不允许第三方应用直接使用账号密码访问 WebDAV而是要求生成一个独立的“应用密码”这个密码只对 WebDAV 服务生效即便泄露了也不能登录网页端权限被限定在文件访问这一层。创建应用密码的时候会要求填一个名称比如“obsidian-sync”然后系统会给出一串随机密码。这里有两个细节要记住一是服务器地址固定是https://dav.jianguoyun.com/dav/所有 WebDAV 客户端都填这个二是应用密码只显示一次建议立即粘贴到某个本地密码管理器里别直接存在坚果云同步的文件中不然就循环依赖了。然后回到坚果云网页端新建一个同步文件夹名字随意比如/Obsidian这个目录就是日后所有笔记文件存放的地方。电脑端与手机端的同步都是围绕这一整个目录展开的。2.2 电脑端 Obsidian 的安装与初始化电脑端去 Obsidian 官网下载 Windows 版本即可。安装过程很干净没有捆绑打开后选择“Create new vault”创建新库填一个名字比如MyNotes然后设置存放路径。我建议把库放在一个路径简单、没有空格和中文的目录下比如D:\MyNotes。原因不是 Obsidian 不支持中文路径而是在后续坚果云客户端同步、命令行操作、Git 版本管理时中文或特殊字符偶尔会带来一些不可预料的麻烦没必要用踩坑换个性。库创建好之后Obsidian 会生成三个隐藏项.obsidian配置文件目录存放主题、插件、快捷键等、.trash回收站、以及你新建的笔记文件。这里记住一个关键概念整个“仓库文件夹”就是 Obsidian 的全部同步时把整个文件夹原样搬过去任何一端看到的笔记结构就会完全一致。.obsidian目录要不要同步是个值得琢磨的问题——我建议在第一次搭建时先同步这样主题和常用插件可以一并搬过去后面如果出现移动端插件加载异常再调整策略后面第 5 章我会细讲。2.3 安卓端 Obsidian 的安装与前期准备安卓端在 Google Play 或者 Obsidian 官网直接下载 APK 都行国内网络访问官网下载一般没问题如果感觉下载太慢可以换 Play 商店。安装完成后先不要着急建库。关键问题在于手机上 Obsidian 打开的“库”必须是一个已经存在于本地存储的文件夹。而这个文件夹需要被安卓端的同步工具接管如果 Obsidian 自动在应用私有目录Android/data/md.obsidian...里建了库同步工具反而访问不到。所以我先推荐一个稳妥路径在手机内部存储的Documents目录下手动新建一个ObsidianVault文件夹然后把它指定为 Obsidian 的库。这个目录在绝大多数文件管理器里可见Folder Sync 之类的同步工具也能正常读写不会撞上 Android 11 之后的存储权限限制。安卓端 Obsidian 安装后首次启动会让你选择“打开文件夹作为仓库”或“创建新库”。此时选择打开文件夹然后导航到前面建好的Documents/ObsidianVault即可。由于这个文件夹现在是空的Obsidian 会提示这不是一个有效仓库但你仍然可以打开等同步完成之后笔记自然会出现。为了让你心里有底可以把电脑上那个库的.obsidian配置文件夹先复制过来就能提前把主题和插件配置在手机上加载好。3. 电脑端配置坚果云同步3.1 下载坚果云客户端并同步本地库电脑端需要安装坚果云客户端官网下载对应 Windows 版本即可。安装时它会让你选择要同步的文件夹要么在安装向导里直接勾选坚果云云端已有的目录要么安装完成后在客户端“同步文件夹”中添加。把前面在第 2.1 节创建好的/Obsidian同步文件夹绑定到一个本地磁盘路径比如D:\Jianguoyun\Obsidian。这个本地路径就是桌面端坚果云客户端的“工作副本”每次修改文件后客户端会自动把它上传到云端。接下来要做的一步是把 Obsidian 的库移动到这个同步目录里。做法很简单在 Obsidian 里关闭当前库左上角“库”图标或菜单栏的“Open another vault”然后用文件管理器把整个D:\MyNotes剪切到D:\Jianguoyun\Obsidian下再在 Obsidian 里打开新路径的库。这样你的库文件夹就和坚果云同步文件夹合二为一了。为什么要这样操作而不是直接新建库因为直接新建会丢失已有的.obsidian配置和笔记历史。移动完成后坚果云客户端会自动开始上传文件到云端。这里要特别提醒同一时间只开一个端点写同一份库。坚果云客户端的双向同步机制并不擅长处理“电脑端和手机端同时修改同一个文件”的场景它会产生冲突副本。Obsidian 的库结构对文件级的冲突其实很敏感尤其是.obsidian配置文件如果两台设备同时改最终结果可能是一份混乱的配置。所以我的习惯是在手机上写笔记写完等同步完成再关掉回到电脑前先等坚果云拉取完成再开始编辑。听起来麻烦养成习惯后其实很自然。3.2 选择同步文件夹的注意事项坚果云有一个机制你在客户端里可以选择“只同步部分子文件夹”而不是整棵目录树都本地化。这在 Obsidian 场景下很实用。比如你有一个assets文件夹专门放笔记里的图片另有一个archive文件夹放历史归档这两个目录如果体积很大、又不常看可以在坚果云客户端里右键对应文件夹选择“不同步到这台电脑”。这样电脑端节省存储空间云端和安卓端仍然保留完整数据。但是要小心如果某个文件夹不同步到电脑而 Obsidian 库的位置恰好在坚果云同步目录下Obsidian 依然能看到那个文件夹的“占位标记”坚果云有虚拟占位功能也就是文件列表可见但内容未下载。理论上 Obsidian 打开这样的笔记会出现链接缺失或图片无法显示因为底层文件并没有被完整下载。实际使用中我建议还是保持整棵仓库树都在本地同步除非你非常确定某个区域涉及超大附件比如几百 MB 的 PDF、多媒体素材否则没有必要为压缩存储而牺牲 Obsidian 的完整性。另外坚果云客户端的默认设置是“自动同步打开的文件”但有时候文件被 Obsidian 频繁写入每次按 CtrlS 都会触发可能在短暂瞬间产生重复上传。我实测下来没出现过大问题不过建议把坚果云客户端的“实时同步”选项开着不要手动暂停同步。如果发现某次同步卡住先看右下角坚果云图标是否显示“正在等待”大概率是在排队或遇到文件占用。3.3 坚果云客户端的回收站与历史版本坚果云同步文件夹有一个容易被忽略但很实用的功能历史版本和误删恢复。右键同步文件夹中的任意文件选择“历史版本”可以看到它在不同时间点的版本并能一键恢复。这对 Obsidian 用户来说相当于一个轻量的笔记版本管理不需要依赖 Git 也能找回一两天前的误改内容。回收站同样重要删除文件后坚果云并不会立刻在云端删除而是保留一段时间期间你可以从网页端或客户端找回。这跟 Git 的git checkout有些类似但粒度更粗只适用于救急。要注意的是坚果云的历史版本恢复是在文件级生效不是目录级。也就是说如果你误删了整个文件夹需要先通过回收站找回文件夹再对单个文件做版本回滚。实际操作中我在几次误删笔记后都是靠这个功能救回来的但也正因为如此它不能替代正式的版本管理工具关键的长期笔记项目建议还是定期用 Git 或导出为 ZIP 做一次完整备份。4. 安卓端接入与同步打通4.1 安卓端同步工具的选型为什么推荐 Folder Sync 或 Dropsync安卓端的同步工具我试过几类。一类是坚果云官方 App它主打的是“备份”和“查看”不是“双向同步”你可以在手机上打开坚果云 App手动选择文件下载但不能实现后台自动把本地文件夹与云端文件夹保持一致。另一类是通用文件管理器自带的 WebDAV 支持比如 CX 文件管理器这种能浏览也能上传下载但同步逻辑很弱无法处理双向差异。真正干这个活儿的工具是专门的同步型软件其中 Folder Sync 和 Dropsync 是主流。Folder Sync 的全称是 “FolderSync”支持 WebDAV、SFTP、S3、OneDrive、Google Drive 等多种协议免费版能配置一个同步任务够用想要多个任务、定时同步等高级功能可以付费解锁。Dropsync 最早是给 Dropbox 做的后来也支持了 WebDAV稳是稳但免费版限制更严格。我个人的推荐是 Folder Sync配置清晰、同步规则细、出错提示明确中文界面也做得不错适合教程中的操作说明。如果你偏好极简Dropsync 也完全可以核心配置逻辑大同小异。4.2 Folder Sync 配置 WebDAV 与同步策略打开 Folder Sync第一步是添加账户。点击“账户”-“添加账户”类型选择WebDAV。服务器地址填https://dav.jianguoyun.com/dav/用户名填你的坚果云邮箱或用户名密码填前面创建的应用密码不是网页登录密码勾选“使用 SSL”或默认即可。测试连接一般会显示成功如果失败优先检查是否把账号密码误填成了登录密码、服务器地址是否多写了子路径这两个是最常见的连不上的原因。第二步是创建同步任务。在“同步文件夹”标签页添加新任务选择“本地文件夹”指向手机上 Obsidian 库所在的路径比如/storage/emulated/0/Documents/ObsidianVault选择“远程文件夹”指向坚果云里的/Obsidian如果服务器地址已经带有/dav/那么远程路径应该写Obsidian或者dav/Obsidian具体看 Folder Sync 对路径的拼装方式我习惯在账户地址里只写根目录然后在任务的远程路径里填具体文件夹名。同步类型选择“双向同步”即Two-way。第三步是设置触发方式。Folder Sync 支持手动、定时、插电、开机启动等多种触发条件。我的建议是设置一个“定时”任务比如每 15 分钟或者每 1 小时自动同步一次同时打开“在连接电源时允许同步”和“仅在 Wi-Fi 下同步”选项避免用手机流量跑大库。另外打开“自动同步”开关后Folder Sync 会在后台监听本地文件夹变化并自动上传。需要注意安卓系统的省电策略可能会杀掉后台进程所以还要在系统设置里允许 Folder Sync 后台运行、关闭电池优化否则同步会莫名其妙地不触发。4.3 首次同步的坑冲突、端口与路径第一次把整个库从电脑同步到手机上可能遇到三个高频问题。第一是首次同步时间很长如果库里有几千个文件手机上可能要下载很久。你可以在 Folder Sync 里看到进度条耐心等它完成不要在同步过程中打开 Obsidian 去编辑否则会在上传阶段制造冲突。第二是路径写错导致点击“测试”成功但同步却失败——因为 WebDAV 服务器地址和远程根目录拼接后指向了不存在的目录。解决办法是先不指定远程文件夹只配置账户然后在同步任务里手动填写远程路径多试几次。第三个坑是坚果云的流量限制。第一次把整个库从云端拉到手机会把当月的下载流量一次性吃掉不少如果库里有较多图片1GB 下载额度很快见底。不少人第一次同步完当月的流量就报警了。我的建议是首次同步尽量放在月初或者第一时间观察库的体积。如果确认库的总大小超过几百 MB甚至建议先精简附件把大文件单独放一个不同步目录后面再按需获取。另外坚果云的免费版流量是“上传 1GB/月、下载 3GB/月”超出后会暂停同步直到下个月重置。这不是故障是配额用完了别白排查半天。5. 实现双端一致仓库结构、附件与插件的跨端配置5.1 附件路径设置从根源上避免“图片加载不出来”Obsidian 默认会把粘贴进来的图片放在与当前笔记同级的目录下这种做法在单机环境没问题但一旦同步到多端如果笔记位于不同文件夹图片分散在全库的各处时间一长仓库结构会变得凌乱也不好针对大附件做同步策略。所以我的建议是尽早把附件路径统一。在 Obsidian 设置 -“文件与链接”里将“默认新附件位置”改为“仓库根目录下指定文件夹”比如assets。这样所有图片、PDF 等附件都会自动归集到一个assets目录同步和管理都省心。另一个值得注意的是 Obsidian 内部链接的写法。Obsidian 使用类似[[笔记名]]的 Wiki 链接只要库内文件名不重复搬家到哪都能解析。但如果你的笔记名含有空格或特殊字符在某些同步场景下路径解析会出小问题。我习惯在笔记命名时只用字母、数字、下划线、短横线虽然 Obsidian 本身没问题但坚果云或者 Folder Sync 在极少数情况下遇到中文特殊字符时可能别扭。这个习惯养成后库的跨端表现会稳定很多。5.2 插件与主题的同步策略.obsidian文件夹里存放了插件、主题、快捷键等全部配置。因为它是仓库的一部分所以一旦整个库同步配置也会跟着同步。好处是主题和常用插件在手机端也自动可用坏处是某些桌面端插件在移动端并不支持Obsidian 移动版加载不支持的插件时要么报错要么在设置里出现无法应用的选项。我踩过几次坑后总结出的做法是桌面端只安装“两端都能用”的插件尽量不装与桌面环境强相关的插件。比如核心插件中的“日记”、“大纲”、“关系图谱”在移动端都能用而一些系统集成型插件比如需要调用桌面浏览器的插件、依赖 Node.js 环境的插件在移动端可能直接失效。如果你确实需要在桌面端用这类插件又不想它干扰移动端可以在同步前把该插件的.obsidian/plugins/插件名/main.js从同步目录中删除或者用 Obsidian 的“已安装插件”列表在移动端手动关闭。手动关闭后配置会被写回.obsidian从而同步回桌面端所以最好只对“移动端也没有必要使用”的插件做禁用操作。主题方面则相对安全只要主题版本兼容移动端基本能渲染。如果某次同步后手机端 Obsidian 界面异常大概率是主题文件不完整或版本不兼容把整个.obsidian文件夹在手机上删掉重新从云端拉取一次就好。5.3 跨平台快捷键与命令面板差异Obsidian 在电脑端有许多快捷键比如CtrlO快速打开文件、CtrlP打开命令面板。到了安卓端快捷键没有实体键盘就完全用不上但 Obsidian 移动端提供了“上下滑动切换标签页”之类的手势操作以及编辑器底部工具栏的快捷按钮。如果你的使用习惯是从电脑切换过来刚开始会不太适应但核心的编辑能力在两端完全一致。我通常的做法是电脑端用快捷键和命令面板手机端用 Obsidian 的移动端工具栏按钮再加上手机输入法的剪贴板配合效率其实不差。命令面板在各端都一样唯一需要注意的是自定义命令和插件命令的 ID 在不同端可能因为插件未加载而缺失。也就是说如果你在电脑端设置了一个工作流依赖某个插件提供的命令在手机端该插件被禁用或不可用时命令面板里那条命令会消失。这在设计跨端工作流时要提前考虑尽量用 Obsidian 核心功能实现把插件命令限制在单端。6. 常见问题与排查技巧实录6.1 同步失败或冲突现象原因解决方法Folder Sync 提示“连接失败”账号或密码填错或 WebDAV 地址不正确确认账号为坚果云邮箱/用户名密码为应用密码检查地址是否为https://dav.jianguoyun.com/dav/同步中途卡住网络波动或文件被占用在 Folder Sync 中重置同步状态查看坚果云客户端是否正在上传等待片刻出现“conflicted copy”文件两端同时修改了同一个文件把冲突文件副本用文本对比工具比如 Obsidian 设置里的“比较文件”功能手动合并删掉多余副本Obsidian 里图片或附件缺失附件路径不一致或附件未同步检查附件是否统一放在assets目录确认 Folder Sync 任务涵盖了整个库目录冲突是双向同步绕不开的话题。Folder Sync 处理冲突的策略是如果本地和远程文件都有改动它会生成一个副本文件名加(conflicted copy)后缀而不是自动决定谁覆盖谁。这个策略是安全的但需要人工清理。我建议定期在 Obsidian 的搜索里搜conflicted把残留的冲突副本逐个检查后删除避免仓库里堆积无用的垃圾文件。6.2 手机端无法打开仓库这个问题的典型表现Obsidian 安卓版启动后选择打开库但提示“不是有效的仓库”或“找不到库”。原因多半是同步工具还没把.obsidian和相关文件下载到本地或者存储权限没给足。Obsidian 对仓库的判定逻辑是打开一个文件夹时必须能看到.obsidian配置目录或者文件夹内有至少一个.md文件否则就会认为是无效仓库。解决方法很简单先确保 Folder Sync 完成了首次全量同步再打开 Obsidian。如果 Folder Sync 已经显示同步完成但 Obsidian 仍不认检查一下文件管理器中Documents/ObsidianVault下是否真的存在.obsidian目录。注意某些安卓文件管理器默认隐藏点开头的文件需要在设置里打开“显示隐藏文件”。另外从 Obsidian 的库选择界面点右上角的“打开文件夹作为仓库”然后从左侧目录导航到准确路径不要选错层级比如选了Documents而不是Documents/ObsidianVault。6.3 坚果云流量限制坚果云免费版每月上传 1GB、下载 3GB。如果你的库全是 Markdown 文字根本用不完但如果插入了大量图片或者扫描版 PDF每个文件动辄几 MB一个月下来就要小心了。超流量后坚果云会暂停同步客户端上会提示“流量超限”这时候只能等配额重置或者升级付费版。我的规避思路有三层。第一层是控制附件体积图片尽量压缩后放入库别直接粘贴原始截图大型 PDF 不放在 Obsidian 库内而是放在另一个坚果云同步文件夹笔记里用外链或路径引用。第二层是针对assets目录单独设计同步策略如果附件多可以做一个 Folder Sync 任务只同步assets而不实时同步笔记减少频繁上传的流量消耗。第三层是把坚果云网页端的“回收站”清理干净因为回收站里的文件也会占用流量配额删除文件后的保留版本依然会上传。定期清空回收站能省下不少隐蔽流量。7. 实操总结与个人体会7.1 长期稳定运行的几个习惯这套 Obsidian 坚果云的双端同步方案我实际用了大半年。它最吸引我的一点是数据始终以 Markdown 文件的形式存在于本地云端只是一个“同步中转站”而不是唯一的数据源。这意味着就算哪天坚果云服务出问题或者我决定换一种同步方式笔记文件都还在我手里没有任何迁移成本。我在实际使用中还养成了几个小习惯现在分享出来。一是在 Obsidian 里打开“自动保存”因为坚果云同步依赖文件落盘如果 Obsidian 崩溃或直接断电未保存的内容自然不会同步二是设置里把“使用安全模式”Safe mode关闭让第三方插件在两端都能生效但前提是只装兼容的插件三是每个月固定检查一次.obsidian配置目录的体积如果发现里面有异常增大的日志或缓存文件及时清理。稳定性方面目前这套方案用下来没有丢过数据偶尔的冲突副本也能快速解决。7.2 这套方案的边界在哪里这套方案不是万能的。如果笔记库达到上万文件级别Folder Sync 每次全量扫描会比较耗时同步速度也会下降如果你需要多人实时协作编辑坚果云本地文件夹模式并不适合它本质上是个人数据同步而不是团队协作平台。另外免费版流量始终是硬约束大文件多的时候就该考虑升级或者切换数据层方案。但如果你和我一样主要用 Obsidian 做个人知识管理笔记以文字为主偶尔插入几张图片那么坚果云Folder Sync 这个组合完全够用而且不花一分钱就能把电脑和安卓手机两端的库保持在同一个状态。
