多云同步完整配置指南

一、选择适合你的同步方式

方式	适合谁	需要准备	远端目录
WebDAV	已有 NAS、坚果云或 WebDAV 服务	服务器地址、用户名、密码	你在 URL 中指定的目录
世纪互联 OneDrive	中国版 Microsoft 365 用户	Client ID、Client Secret、账号授权	/NexaNote
百度网盘	百度网盘个人用户	AppKey、SecretKey、账号授权	/apps/NexaNote/sync-v2

不知道选哪一种：有 NAS 就优先 WebDAV；使用世纪互联企业或学校 OneDrive 就选世纪互联 OneDrive；只有百度网盘账号就选百度网盘。

国际版 OneDrive、个人微软账号和由 Microsoft 全球运营的 Microsoft 365，目前不能使用“世纪互联 OneDrive”通道。

二、开始前的共同准备

1. 确认哪台是 A 机

A 机是当前拥有最完整、最正确笔记的电脑。B 机是准备接收这些笔记的电脑。第一次同步时不要把两台都当作源头。

2. 备份 A 机笔记目录

1. 打开 NexaNote“设置”。
2. 找到“笔记目录”，记下完整路径。
3. 退出 NexaNote。
4. 在资源管理器中复制整个笔记目录，包括 assets 文件夹。
5. 把副本放到另一个磁盘或压缩为 ZIP，并注明日期。

3. 两台电脑使用相同版本

在两台电脑的“关于”或下载页确认 NexaNote 版本一致。版本不同时，先升级旧版本，再配置同步。

4. 第一次不要开启自动监听

先保持“自动监听”关闭，完成一次人工“立即同步”，确认上传、下载和附件都正常后再开启。

三、配置 WebDAV

WebDAV 需要一个支持文件读写、创建目录、列出目录和删除文件的服务。建议使用 HTTPS 地址，不要通过公网使用明文 HTTP。

A. 在服务端准备目录

1. 登录 NAS 或 WebDAV 服务管理页面。
2. 启用 WebDAV 服务，优先启用 HTTPS 端口。
3. 创建专用账号，例如 nexanote-sync，不要使用 NAS 管理员账号。
4. 为该账号创建或分配一个空目录，例如 NexaNote。
5. 授予该账号对此目录的读取、写入、创建、重命名和删除权限。
6. 记下完整 WebDAV URL、用户名和密码。

群晖用户可参考群晖 WebDAV Server 官方页面。其他服务的 URL 格式以其官方说明为准。

B. URL 应该填什么

https://你的服务器地址:端口/远端路径/NexaNote

• 群晖常见形式：https://nas.example.com:5006/NexaNote
• 坚果云等服务：使用服务商提供的 WebDAV 地址，并在末尾指定 NexaNote 目录。
• URL 中不要重复填写用户名和密码；界面已有独立字段。
• 末尾有没有斜杠都可以，NexaNote 会自动处理。

C. 在 NexaNote 中填写

1. 打开左侧边栏底部的“同步”。
2. 点击顶部的“WebDAV”标签。
3. 第一行填写完整 WebDAV URL。
4. 第二行左侧填写用户名，右侧填写密码或应用专用密码。
5. 保持“自动监听”关闭。
6. 点击“立即同步”。
7. 等待按钮恢复，并检查结果中的上传数量和错误提示。
8. 展开“同步日志”，确认远端类型为 WebDAV，文件状态为成功。

如果出现 HTTP 401 或 403，通常是账号、密码或目录权限错误；HTTP 404 多数是 URL 路径错误；PROPFIND 失败表示服务端未正确支持 WebDAV 列目录。

四、配置世纪互联 OneDrive

A. 确认账号类型

• 登录地址属于中国版 Microsoft 365 / 世纪互联运营环境。
• 你的组织管理员允许创建应用，或者愿意为你创建应用。
• 账号拥有 OneDrive 存储空间。

如果学校或单位禁止注册应用，需要联系 Microsoft 365 管理员；普通用户无法绕过组织策略。

B. 创建应用并取得两个字段

1. 打开世纪互联 Azure 门户并登录。
2. 进入“Microsoft Entra ID”或“Azure Active Directory”。
3. 打开“应用注册”，点击“新注册”。
4. 名称可填写 NexaNote Sync。
5. 支持的账户类型选择符合你组织要求的类型；不确定时请咨询管理员。
6. 完成注册后，在应用“概述”页复制“应用程序（客户端）ID”，这就是 NexaNote 的 Client ID。
7. 进入“证书和密码”，新建客户端密码。
8. 创建后立即复制“值”，这就是 Client Secret；离开页面后通常无法再次查看。
9. 进入“API 权限”，确认 Microsoft Graph 至少允许文件读写、用户读取和离线访问。NexaNote 请求范围为 Files.ReadWrite.All、User.Read、offline_access。
10. 如果页面提示需要管理员同意，请让组织管理员完成授权。

Client Secret 相当于密码，不要写进笔记、聊天记录或公开截图。

C. 在 NexaNote 中登录

1. 打开“同步”，选择“世纪互联 OneDrive”。
2. 在“应用客户端 ID”中粘贴 Client ID。
3. 在“客户端密钥”中粘贴 Client Secret。
4. 点击“登录 OneDrive”。
5. NexaNote 会显示一个用户码和验证网址。
6. 在浏览器打开该网址，登录同一个世纪互联账号。
7. 输入用户码并同意访问。
8. 回到 NexaNote，等待状态变为“已登录”。
9. 保持自动监听关闭，点击“立即同步”。
10. 首次成功后，OneDrive 根目录会出现 NexaNote 文件夹。

如果始终停留在“等待授权”，检查用户码是否过期、登录的是否为世纪互联账号，以及应用权限是否获批。退出后可以重新点击登录生成新用户码。

五、配置百度网盘

A. 创建百度网盘应用

1. 打开百度网盘开放平台并登录百度账号。
2. 按照平台提示完成开发者身份认证。
3. 进入控制台或应用管理，创建一个新应用。
4. 应用名称可填写 NexaNote Sync，类型和能力选择应包含网盘文件访问。
5. 根据平台要求填写应用说明、回调信息或其他资料并提交。
6. 在应用详情中找到 AppKey，也可能显示为 API Key 或 Client ID。
7. 找到 SecretKey，也可能显示为 Secret Key 或 Client Secret。
8. 确认应用拥有百度网盘基础信息和文件读写相关权限。

百度开放平台界面和审核要求可能调整。如果没有看到网盘权限或应用无法授权，应以开放平台当前提示为准。

B. 在 NexaNote 中授权

1. 打开“同步”，选择“百度网盘”。
2. 在“百度网盘 AppKey”中粘贴 AppKey。
3. 在“SecretKey”中粘贴 SecretKey。
4. 点击“登录百度网盘”。
5. NexaNote 会显示用户码和验证网址。
6. 在浏览器打开验证网址，登录准备存放笔记的百度账号。
7. 输入用户码并确认授权。
8. 回到 NexaNote，等待状态显示“已登录”。
9. 保持自动监听关闭，点击“立即同步”。
10. 首次成功后，文件保存在百度网盘应用数据目录 /apps/NexaNote/sync-v2。

应用数据目录可能不会像普通文件夹一样出现在所有百度网盘客户端视图中，这是百度网盘开放接口的目录规则，不代表文件没有上传。

六、A 机和 B 机的正确顺序

A 机：上传完整笔记

1. 确认 A 机笔记最完整，并已完成本地备份。
2. 配置选定的同步方式。
3. 关闭自动监听，点击“立即同步”。
4. 等待同步结束，不要关闭软件。
5. 查看结果：上传数应大于零，错误数应为零。
6. 展开同步日志，抽查 Markdown 文件和 assets 附件是否成功。
7. 再点击一次“立即同步”。第二次通常应以跳过为主，说明两端已一致。

B 机：下载远端笔记

1. 安装与 A 机相同版本的 NexaNote。
2. 选择一个空的或专门用于 NexaNote 的本地笔记目录。
3. 配置与 A 机完全相同的同步方式和账号。
4. WebDAV 必须填写完全相同的 URL；OneDrive 和百度网盘必须登录同一个云账号。
5. 关闭自动监听，点击“立即同步”。
6. 等待下载结束，检查左侧笔记列表、图片和附件。
7. 如果列表没有立即刷新，切换一次页面或重启 NexaNote。
8. 确认内容正确后，再开启自动监听。

不要这样做：不要先在 B 机建立一批同名测试笔记再同步；首次同步时同路径但内容不同会产生冲突，需要手工选择。

七、自动监听和检查间隔

“自动监听”会观察本地文件变化，并按设定间隔检查远端。它接近自动同步，但不是 OneNote 那种多人实时协同编辑。

间隔	建议用途
5–15 秒	测试或希望设备较快看到变化；网络请求较频繁。
30 秒–1 分钟	日常使用的推荐范围。
5 分钟	网络较慢、笔记量较大或希望减少请求。
不检查	只监听本地变化，不主动定期拉取远端；跨设备使用时不建议。

• A 机编辑结束后，等待同步完成再关闭电脑。
• 到 B 机后，先等待自动检查或手动点击“立即同步”，再开始编辑。
• 网络不稳定时先关闭自动监听，恢复后手动同步并检查日志。

八、同步冲突怎么处理

当同一文件在本地和远端都发生变化，NexaNote 不会静默覆盖，而是记录冲突。点击同步面板中的“查看冲突”。

• 保留本地：当前电脑内容正确，用本地版本覆盖远端。
• 保留远端：另一台电脑或云端内容正确，下载远端版本覆盖本地。
• 不确定：先复制两份内容到新笔记，人工合并后再选择。

冲突解决后再次点击“立即同步”，确认错误和冲突数量归零。

九、重置同步状态和更换电脑

“重置同步状态”会清空当前电脑保存的同步记录和删除标记，不会删除笔记文件。它不是普通的“重试”按钮。

只有这些情况才使用

• 云端和所有设备已经清空，但新笔记仍无法下载。
• 你明确要把当前电脑作为新的同步起点。
• 在完成备份后，技术支持建议你重置。

更换电脑

1. 在旧电脑点击“立即同步”，确认无错误。
2. 备份旧电脑笔记目录。
3. 在新电脑安装相同或更新版本。
4. 选择空的本地目录。
5. 配置同一云端账号并立即同步。
6. 检查内容完整后，再停用旧电脑。

十、常见错误与检查顺序

读取远端 manifest 失败，已中止同步

这是保护机制，NexaNote 不会用不完整的本地清单覆盖云端。先检查网络、账号授权、远端目录和同步日志，不要反复重置或删除云端文件。

WebDAV 返回 401、403 或 404

401：用户名或密码错误；403：账号没有写入或删除权限；404：URL 或远端路径错误。先用服务商客户端或浏览器验证同一账号能否访问目录。

OneDrive 或百度网盘登录按钮不可用

Client ID / AppKey 为空时按钮会禁用。完整填写 ID 后才能开始授权；Secret 为空则授权请求或 Token 刷新会失败。

授权完成后仍显示未登录

等待几秒；如果用户码已过期，退出当前授权并重新生成。确认浏览器登录的账号和准备同步的云账号一致。

B 机没有出现新笔记

先确认 A 机日志显示上传成功，再在 B 机手动点击“立即同步”。如果云端和两台设备曾被清空，备份后可在 B 机使用“重置同步状态”，再重新同步。

笔记有了，但图片或附件没有显示

检查同步日志中 assets 路径是否上传和下载成功，确认笔记目录中的 assets 子目录存在。不要只检查 Markdown 文件。