☁️ 私有云盘：挂载与增量同步全指南
ZZ音乐支持将云端与局域网存储无缝接入为 App 的在线曲库，并首创了带差异预检 (Dry-Run) 的双向增量同步引擎。
🔌 一、支持的存储协议与挂载方法
进入 App 设置 ->「网盘与云存储」，点击「添加连接」：
1. WebDAV 协议挂载
- 适用服务：AList 聚合网盘、群晖 NAS (Synology WebDAV Server)、坚果云、Nextcloud / ownCloud。
- 填写参数：
- 服务器地址：如
http://192.168.1.100:5244/dav（或公网域名） - 账号与密码：对应服务的 WebDAV 凭据
- 挂载根路径：如
/Music（留空默认根目录）
- 服务器地址：如
- 连通性测试：点击「测试连接」，App 会发送标准
PROPFIND指令进行真网络握手校验。
2. 阿里云盘 (Aliyun Drive) 挂载
- 直传与官方 OpenAPI：采用阿里云盘官方开发者接口，支持在线无损串流与超高速直传。
- 挂载方式：
- 扫码授权：点击「阿里云盘」直接生成授权二维码，使用阿里云盘手机 App 扫码即可瞬间完成安全 Token 绑定；
- 免密续期：内置 Refresh Token 自动轮转机制，长期有效无需反复登录。
3. 局域网 SMB / CIFS 共享
- 适用场景：Windows 电脑共享文件夹、路由器外挂移动硬盘、家庭 NAS。
- 填写参数：
- IP 地址：如
192.168.1.50 - 共享文件夹名：如
Music或SharedAudio - 用户名/密码：Windows 登录账号或 NAS 共享用户
- IP 地址：如
⚡ 二、云端在线流式播放与智能缓存
- 即点即播：挂载成功后，网盘内的所有音频文件会以目录树形式展示，点击任意歌曲即可通过分片流式加载在线播放。
- 元数据与歌词秒级匹配：播放云端歌曲时，App 会自动提取 ID3 标签并在线匹配精准滚动歌词。
- 本地无损缓存：听过的云端歌曲会自动缓存至本地私有沙盒存储，下次离线时亦可直接高保真播放。
🔄 三、四大增量同步模式详解
在「网盘同步中心」中，你可以将手机本地的音乐目录与云端指定目录建立自动同步任务：
| 同步模式 | 行为逻辑 | 适用场景 |
|---|---|---|
| 双向同步 (Two-way) | 本地新增上传云端，云端新增下载到本地；两端保持完全一致。 | 手机与家用电脑/NAS 音乐库多端协同。 |
| 设备优先 (Local First) | 本地有更新时单向推送到云端，覆盖云端旧文件。 | 手机作为主曲库，将手机音乐定期备份到云盘。 |
| 云端优先 (Cloud First) | 云端有更新时单向拉取到本地，覆盖本地旧文件。 | NAS 或云盘为主曲库，手机仅单向下载最新专辑。 |
| 镜像删除 (Mirror Delete) | 开启后，若某一端删除了歌曲，另一端对应的歌曲也会被同步清理。 | 严格保持两端曲库文件完全镜像对齐。 |
🛡️ 四、Dry-Run 差异预检与安全防误删
为了避免因误操作造成珍贵的无损音乐丢失，ZZ音乐引入了 Dry-Run 差异预检机制：
- 预检计算：在点击「开始同步」前，引擎首先在内存中比对文件路径、大小与修改时间戳；
- 差异清单展示：弹窗详细列出：
- 🟢 即将下载：
3 首新歌曲 (共 120MB) - 🔵 即将上传：
1 首新歌曲 (共 45MB) - 🔴 即将删除：
0 首 (或列出具体待删文件)
- 🟢 即将下载：
- 用户确认后执行：只有在用户核对无误并点击「确认执行」后，底层任务才会正式写入文件系统。
📲 五、P2P 局域网直传与 10 分钟即焚云端共享
无需数据线，在两台设备之间极速互传音乐：
- 面对面扫码互传：发送方选择歌曲生成专属二维码，接收方打开 App 扫码，双方通过 WiFi 局域网直连，传输速率取决于当时的局域网环境。
- 10 分钟即焚中转站：若两台设备处于不同网络（跨公网），发送方可一键上传至云端中转站生成 6 位提取码。接收方输入提取码下载，10 分钟后或下载完成后云端自动物理粉碎销毁，保护版权与隐私。