跨端同步总览——桌面版与移动版如何保持收藏一致

同步什么

跨端同步功能可以让你的收藏歌曲列表和歌单在桌面版和移动版之间保持一致。修改一端，另一端可以同步更新。

同步内容

• 「我的列表」中的所有列表（包括试听列表、自定义歌单、已收藏的在线歌单）。
• 每个列表内的歌曲条目。
• 歌曲的收藏状态。

不同步的内容

• 播放历史（正在听哪首歌、播放进度）。
• 下载的本地文件（本地文件不会自动复制到另一台设备）。
• 音源脚本本身（每台设备各自维护自己的音源配置）。
• 设置偏好（主题、快捷键、音质等，不跨设备同步）。

功能性质

⚠️ 官方明确标注同步功能是实验性功能。意味着：

• 功能仍在快速迭代，可能有 Bug。
• 协议和接口可能在后续版本中发生不兼容变更。
• 不保证 100% 可靠。遇到不同步的情况，手动触发重新同步即可。

但截至 v2.12.x 版本，同步功能已经足够稳定供日常使用。

版本要求

同步功能有最低版本要求：

如果你的版本低于要求，请先升级到最新版。

三种同步模式

从 v2.2.0 起，桌面版支持两种模式：

模式一：桌面版做服务端（局域网）

桌面版启动为 HTTP 服务器（默认端口 23332），在局域网内为移动版提供同步服务。适合：

• 你有一台常开机的桌面电脑。
• 桌面电脑和手机在同一个局域网（同一个路由器）。
• 不想额外部署服务。

模式二：桌面版做客户端（连接独立服务）

桌面版作为客户端，连接一个已经运行的同步服务（可以是另一台桌面版，或独立部署的同步服务）。适合：

• 想让两台桌面版都同步收藏。
• 想跨公网同步（需要独立服务部署在有公网 IP 的服务器上）。

模式三：移动版做客户端

移动版只支持客户端模式——连接桌面版服务端或独立同步服务。适合：

• 手机想同步收藏到家里的桌面版。
• 连接到一个独立部署的同步服务。

数据传输安全

⚠️ 危险提示：洛雪音乐的同步传输是明文传输，不加密。这意味着：

• 在局域网内使用相对安全（通常只有你家的设备能访问）。
• 在公网环境或公共 Wi-Fi 上使用极其危险——任何能截获网络包的人都能看到你的歌单数据。
• 如果部署独立同步服务并开放公网访问，必须配置 HTTPS。

官方的建议是：只在受信任的网络下使用同步功能。

同步流程概览

典型场景：桌面版做服务端，手机连接桌面版。

1. 桌面版 → 设置 → 数据同步 → 选择「服务端模式」→ 启用同步。
2. 桌面版显示同步服务地址（如 http://192.168.1.100:23332）和连接码。
3. 手机 → 设置 → 数据同步 → 选择「客户端模式」→ 输入服务地址。
4. 手机输入地址后按回车键确认（部分版本容易忘记这一步）。
5. 点击「启用同步」。
6. 首次同步：如果两端都有歌单，桌面版会弹出对话框，让你选择合并方式（以桌面版为主 / 以移动版为主 / 智能合并）。
7. 后续同步：两端自动根据各自最新状态增量合并。

相关阅读

• 桌面版做服务端 —— 详细步骤和参数说明。
• 移动版连接服务端 —— 手机端的配置步骤。
• 独立部署同步服务 —— 跨公网同步的进阶方案。