Obsidian
电脑上的知识管理应用。笔记以普通本地文件保存在 vault 文件夹里，Obsidian 本身不是服务器。
Modow 3.0 / 同步入门 / Sync Onboarding
从零开始，同步你的知识库
先看懂四个角色，再照步骤填四个字段。 这份指南先讲清 Obsidian、LiveSync、CouchDB 与墨斗的关系，再带你完成安装、配置和第一次同步。
快速开始 / Quick start：你现在需要什么？
先看懂它们的关系Obsidian、LiveSync、CouchDB、墨斗→
再帮我选择方案LiveSync 还是 WebDAV→
我还没有 CouchDB使用一键安装器部署→
我已有 Obsidian LiveSync直接配置四个字段→
两台设备，
一座数据库。
电脑上的 Obsidian 通过 Self-hosted LiveSync 插件，把笔记变更写入你自建的 CouchDB 同步数据库；鸿蒙手机上的墨斗连接同一个数据库。两端各自保存本地资料，远端数据库负责在两台设备之间接力变更——没网也能照常写，联网后再同步。
LiveSync 拓扑 / 数据如何走● 本地优先节点在线
Self-hosted LiveSync
安装在 Obsidian 里的同步插件，负责收发 vault 的变更。它是兼容协议层，不是服务器，也不是数据库。
CouchDB 数据库
部署在 NAS、家用主机或云服务器上。电脑和手机共同连接它，用它交换变更，它不是任何一端的本地文件夹。
墨斗 Modow
为 HarmonyOS 独立开发的本地优先应用，不是 Obsidian 的鸿蒙版。它兼容 LiveSync，直接连接同一个 CouchDB。
唯一原则 / THE ONE RULE电脑端插件和手机墨斗必须填写同一组 CouchDB 根地址、数据库名、用户名和密码。连上同一个同步数据库，两端的资料才能碰头。
数据库名 ≠ vault 文件夹名
CouchDB 数据库名是远端同步库的名字，可以和 vault 同名，也可以完全不同；两端要填的是数据库名。
墨斗不是 Obsidian 鸿蒙版
墨斗是独立的 HarmonyOS 应用。它与 Obsidian 没有隶属关系，只因兼容同一同步协议而能共用数据库。
LiveSync 插件不是服务器
插件只装在 Obsidian 里负责收发变更；真正承接同步数据的，是你自己部署的 CouchDB。
开始之前
先确认设备和资料都已就绪。不要拿唯一一份重要知识库直接做第一次同步。
安装或更新墨斗 3.0
需要 HarmonyOS NEXT，兼容 API 14+，支持手机、平板和折叠屏。目前没有网页公开下载的 HAP / APP 包，请只通过墨斗官方发布渠道安装。
先做一份备份
复制电脑 vault 或远端目录留底。先用一个小型测试知识库跑通上传、下载、改名和删除，再接正式资料。
- 墨斗已安装或更新到 3.0，进入“设置 → 同步”能看到 LiveSync 与 WebDAV。
- 电脑端 Obsidian 和手机端使用同一个同步数据库或远端目录。
- 准备一个测试 Markdown 文件，用来确认第一次同步的方向。
- 公网访问必须使用 HTTPS、VPN 或安全隧道，绝不直接把 CouchDB 5984 暴露到公网。
先选择同步路线
两种方式都能把资料带到手机，区别在于连接的后端。一个 vault 只选一种，不要多种同步工具同时写入。
选择 LiveSync
你已经在用 Obsidian Self-hosted LiveSync，或愿意部署 CouchDB。它连接同步数据库，电脑和手机填同一套四个字段。
选择 WebDAV
你有坚果云、群晖、绿联、QNAP、Nextcloud、AList 或其他标准 WebDAV 服务。它连接远端文件夹。
不要让 iCloud、Syncthing、Obsidian Sync、LiveSync 和 WebDAV 同时写同一个 vault。先停用旧的同步方式，再启用新路线。
没有 CouchDB？
一键部署。
安装器会创建独立的 CouchDB、日常同步账号和 LiveSync 数据库。请把它跑在长期在线的 NAS、家用小主机或云服务器上。
运行前先安装并启动 Docker。电脑关机后手机就同步不了；只配了局域网地址时，离开家中网络也同步不了。
打开终端，下载安装器与校验文件，校验通过后运行：
curl -fsSL https://modow.vip/couchdb/install.sh -o install.sh
curl -fsSL https://modow.vip/couchdb/checksums.txt -o checksums.txt
grep ' install.sh$' checksums.txt | shasum -a 256 -c -
bash install.sh
只检查环境、不安装：bash install.sh --doctor
启动 Docker Desktop，然后以 PowerShell 运行：
Invoke-WebRequest https://modow.vip/couchdb/install.ps1 -OutFile install.ps1
Invoke-WebRequest https://modow.vip/couchdb/checksums.txt -OutFile checksums.txt
(Get-FileHash .\install.ps1 -Algorithm SHA256).Hash
Get-Content .\checksums.txt
Set-ExecutionPolicy -Scope Process Bypass
.\install.ps1
确认 SHA256 与 checksums.txt 一致。只检查环境：.\install.ps1 -Doctor
安装器会询问什么
管理员与同步账号
管理员只用于部署和建库；日常同步使用权限更小的独立账号。
数据库与端口
建议每个 vault 一个独立数据库，名称只用小写字母、数字和下划线。
访问范围
选择仅本机或允许局域网访问。HTTP 只用于受信任的内网，公网必须使用 HTTPS。
保存连接信息
安装完成后会显示服务地址、数据库名和同步用户名。保存好，下一节要用。
安装器可重复运行，不会删除或清空已有数据库。配置默认在
~/modou-couchdb；其中的 .env 含密码，不要上传、截图或分享。配置 LiveSync
真正需要动手的只有两处：Obsidian 里 LiveSync 插件的设置页，以及墨斗的同步设置。两端要填同一组四个字段——CouchDB 根地址、数据库名、日常同步用户名和密码。
已获得官方同步账号？
电脑端 Obsidian 和手机端墨斗的服务地址都填写
电脑端 Obsidian 和手机端墨斗的服务地址都填写
https://sync.modow.vip，关闭“允许 HTTP”；用户名、密码和数据库名按你获得的账号信息填写。不要加 :5984，不要加 /_utils。https://sync.modow.net 是兼容别名，推荐优先使用 .vip。| 墨斗字段 | Obsidian Self-hosted LiveSync | 示例 |
|---|---|---|
| 服务地址 | URL / URI | http://192.168.1.10:5984 |
| 数据库 | Database name | modou_livesync_test |
| 用户名 | Username | modou_sync |
| 密码 | Password | 你的日常同步密码 |
服务地址填 CouchDB 根地址，不带
/_utils。官方账号填 https://sync.modow.vip；受信任的局域网自建服务可填 http://局域网IP:5984；公网自建服务必须通过 HTTPS 反向代理，填写 https://你的域名。HTTPS 默认端口 443 不用写，只有使用非默认端口时才需要显式填写。不要把 CouchDB 的 5984 端口直接暴露到公网。官方服务的 5984 只在服务器本机监听，公网客户端统一通过 HTTPS 443 连接。管理面板地址是
https://sync.modow.vip/_utils/，它只供浏览器管理，不能作为客户端服务地址。第一步：创建并初始化数据库
三种方式任选一种，最省事的是让墨斗直接创建。
墨斗创建（推荐）
进入“设置 → 同步 → LiveSync”，填好新数据库名和账号后保存，点“测试连接”。数据库不存在时，选择“创建并初始化数据库”。
Obsidian 插件创建
在 Self-hosted LiveSync 中选择 CouchDB，填好四个字段，然后运行
Create new database、Setup或Check and fix database。CouchDB 管理页创建
官方账号打开
https://sync.modow.vip/_utils/；局域网自建服务打开http://服务器IP:5984/_utils。在 Databases 里创建空库后，回到墨斗测试连接，再点“初始化为 LiveSync 数据库”。
墨斗可以尝试建库，但普通同步账号不一定有建库权限。如果提示“没有创建数据库的权限”，临时用管理员账号建库，或让管理员建好并授权后，再切回日常同步账号。
第二步：配置电脑 Obsidian
安装 Self-hosted LiveSync
打开 Obsidian 设置的第三方插件页，安装 Self-hosted LiveSync 并进入其设置。
选择手动配置与 CouchDB
如果询问设置方式，选择手动输入服务器信息；服务器类型选 CouchDB。
填写四个字段并检查数据库
服务地址、数据库名、用户名、密码与墨斗完全一致，然后运行一次 Check and Fix database configuration。
先同步一个测试文件
确认 Obsidian 已把测试 Markdown 写入 CouchDB，再回头配置手机。
第三步：配置手机墨斗
选择 LiveSync
打开墨斗“设置 → 同步”，同步方式选 LiveSync。
填写并保存
服务地址必须带
http://或https://。局域网直连通常要写:5984；HTTPS 默认端口 443 不用写。仅局域网 HTTP 才打开“允许 HTTP”，使用 HTTPS 时必须关闭。先测试连接
确认连接正常、数据库已初始化，再开始同步。
立即同步
根据电脑、手机和远端现有内容选择第一次同步方向，不要盲目双向合并。
墨斗 3.0 当前只支持未加密、关闭路径混淆的 Self-hosted LiveSync 数据库（DB12 / P2）。遇到加密或开启路径混淆的配置会安全停止，不要尝试绕过。
配置 WebDAV
WebDAV 同步的是文件和目录，一共四项配置：服务地址、根目录、用户名、密码。电脑 Obsidian 需安装 Remotely Save、WebDAV Sync 等社区插件，并与墨斗指向同一个远端目录。
| 墨斗字段 | Obsidian WebDAV 插件 | 规则 |
|---|---|---|
| 服务地址 | URL / Server / Endpoint | 必须带协议，必要时带端口与 /dav/ |
| 根目录 | Remote base directory / path | 双方填写同一 vault 目录 |
| 用户名 | Username | 必须对目标目录有读写权限 |
| 密码 | Password | 网页登录密码或应用密码 |
坚果云
在“账户信息 → 安全选项 → 第三方应用管理”里生成应用密码，不要填登录密码。
服务地址：https://dav.jianguoyun.com/dav/
根目录：ModowVault
用户名：坚果云账号邮箱
密码：坚果云应用密码
允许 HTTP：关闭
群晖 Synology
先安装 WebDAV Server 并启用 HTTPS，默认 HTTPS 端口通常是 5006。
服务地址：https://NAS地址:5006/notes
根目录：ModowVault
用户名：有 notes 读写权限的 DSM 用户
密码：DSM 用户密码
绿联 NAS / QNAP
先启用 WebDAV，并确认账号对共享文件夹有读写权限。
服务地址：https://NAS地址:端口/共享文件夹
根目录：ModowVault
用户名：NAS 用户名
密码：NAS 用户密码
Nextcloud
常见服务地址包含用户路径，推荐使用应用密码。
服务地址：https://你的域名/remote.php/dav/files/用户名/
根目录：ModowVault
用户名：Nextcloud 用户名
密码：密码或应用密码
AList / 百度网盘 / 夸克网盘
网盘网址不能直接填进墨斗，要先经 AList 转成 WebDAV，并使用有写入权限的 AList 账号。
服务地址：https://alist.example.com/dav/
根目录：ModowVault 或 网盘/ModowVault
用户名：AList 用户名
密码：AList 密码
其他标准 WebDAV
服务地址与根目录最终会拼成同步位置。若服务地址已经指向 vault 目录，根目录留空或填写
/，不要重复路径。电脑与手机配置顺序
准备独立远端目录
为每个 vault 建立独立目录，例如
ModowVault。配置电脑 Obsidian
安装支持 WebDAV 的社区插件，填写服务地址、远端目录、用户名与密码。
先上传测试文件
确认远端目录中真的出现测试 Markdown，再继续手机配置。
配置手机墨斗
进入“设置 → 同步 → WebDAV”，填写相同信息，先保存，再测试连接。
第一次先关闭同步删除
待上传、下载、改名都验证正常后，再决定是否打开删除传播。
测试连接通过但同步后没有内容，最常见原因是“服务地址 + 根目录”多写或少写一层。先到服务端确认测试文件的真实路径。
第一次同步，
先确认方向。
第一次同步决定哪一端是资料源。做完备份后，按照你的实际状态选择。
电脑已有内容，手机为空
先让 Obsidian 成功同步到 CouchDB 或 WebDAV，再让墨斗拉取远端。
手机已有内容，远端为空
确认数据库或远端目录是全新的，再让墨斗上传本地。
电脑和手机都有内容
先备份两端。不要直接指向同一个新后端；先在测试副本中验证合并结果。
- 先同步一个小型 Markdown 测试文件，不要从整个知识库开始。
- 确认手机端能打开、编辑并同步回电脑。
- 再测试改名；WebDAV 用户最后再测试删除。
- 全部通过后，才把正式 vault 接入同一套配置。
没有同步成功？
先看错误属于网络、账号、路径还是数据库。按下面顺序排查，通常能很快定位。
LiveSync 显示完成，但手机没有内容
确认 Obsidian 已成功同步；两端数据库名完全一致；CouchDB 中存在目标数据库；日常账号有读写权限；数据库内已有 Self-hosted LiveSync 写入的数据。
提示数据库不存在或无法初始化
普通账号可能只能读写已有库。使用管理员账号创建并初始化，或让管理员创建同名数据库并给日常同步账号授权。
服务地址打不开
检查是否缺少
http://、https:// 或端口；手机是否在同一局域网；防火墙或安全组是否放行；内网服务离家后是否仍可访问。WebDAV 连接成功但目录为空
核对墨斗根目录与 Obsidian 插件远端路径是否一致；检查服务地址是否已经包含共享文件夹或 vault，避免重复填写。
坚果云密码错误
坚果云需要在第三方应用管理中生成应用密码，不能直接使用网页登录密码。
家里能同步，出门不能同步
这是网络访问范围问题。可以只在家中 Wi-Fi 同步，或配置 VPN、Tailscale、ZeroTier、内网穿透或公网 HTTPS 域名。不要直接把 5984 暴露到公网。