syncthing可实现家庭音乐库与安卓手机的无损文件p2p同步。方案包括：一、局域网直连同步；二、.stignore过滤非音频文件；三、交错式版本控制防误删；四、kodi联动自动扫描；五、跨网段远程同步配置。

如果您已在电脑或NAS上建立家庭音乐库，希望将无损音乐文件实时同步至安卓手机本地存储以便离线播放，则Syncthing可直接在设备间建立加密P2P通道完成同步，无需上传云端。以下是多种可行的同步方案：

一、安卓端直连主设备同步（推荐局域网场景）

该方法利用手机与主设备（如Windows台式机或Linux NAS）处于同一局域网的条件，通过设备ID配对后直接传输，延迟低、带宽占用可控，且所有文件保留在本地。

1、在安卓手机安装Syncthing-Android应用（从Google Play或F-Droid获取）。

2、在主设备运行Syncthing（Windows可通过SyncTrayzor启动，Linux执行syncthing命令），确保Web管理界面（http://127.0.0.1:8384）可访问。

3、主设备Web界面右上角点击“操作”→“显示ID”，记录本机设备ID；安卓端打开应用，点击右上角“+”→“添加设备”，输入该ID或扫描二维码。

4、双方确认连接请求后，在主设备点击“添加文件夹”，路径设为/Music（或实际音乐库路径），同步类型选“发送接收”，勾选安卓设备。

5、安卓端进入“Folders”标签页，找到新添加的文件夹，点击右侧三点菜单→“编辑”，将“路径”设为手机内部存储中指定目录（如/storage/emulated/0/Music），保存并启用。

6、检查状态栏是否显示Up to Date，首次同步可能需数分钟，期间可查看实时传输速率。

二、使用.stignore精准过滤非音频文件

为避免专辑封面缓存、临时文件、日志等干扰手机存储空间及媒体扫描，必须在主设备音乐文件夹根目录创建.stignore文件，由Syncthing自动读取并跳过匹配项。

1、用文本编辑器新建文件，命名为.stignore（注意开头的点号）。

2、写入以下规则：

# 排除系统隐藏文件
**/.DS_Store
**/Thumbs.db
# 排除临时文件
**/*.tmp
**/*.part
**/*.log
# 保留关键元数据
!**/*.jpg
!**/*.png
!**/*.cue
!**/*.m3u
!**/*.m3u8

3、将该文件保存至主设备/Music根目录下，Syncthing将在下次扫描时自动加载规则。

4、验证效果：在安卓端同步完成后，检查目标文件夹内仅存在.flac/.wav/.mp3/.m4a等音频文件及白名单内的.jpg和.m3u文件，无.tmp或.log后缀文件。

三、启用交错式版本控制防误删

该配置可在安卓端误删某张专辑时，从主设备恢复最近30天内的历史版本，避免永久丢失，特别适用于频繁整理音乐库的用户。

1、在主设备Web界面，进入对应音乐文件夹的“编辑”页面。

2、展开“版本控制”选项，类型选择“交错式（Staggered）”。

AI音乐创作

面向创作者的 AI音乐创作工具，支持写歌、歌词成曲、BGM、参考音频改编和结果下载。AI音乐创作适合搜索 AI音乐、AI音乐生成、AI写歌、AI作曲和 ai music creator 的用户。无论只有一句创作想法、已有歌词、需要纯音乐 BGM，还是想参考一段音频继续创作，AI 助手都可以通过本地 Skill 生成作品。

下载

3、设置“保留最大版本数”为30，“清理间隔”设为86400秒（24小时）。

4、保存配置后，Syncthing将在主设备.stversions子目录中按日期归档被替换或删除的文件。

5、若需恢复，登录主设备Web界面，进入该文件夹→“历史版本”，选择目标文件时间点，点击“还原”即可推送回安卓端。

四、Kodi媒体中心联动同步（进阶方案）

当安卓手机已安装Kodi作为本地音乐播放器时，可将Syncthing设为“仅接收”模式，使Kodi自动扫描新增曲目，实现“同步即可见”的无缝体验。

1、在安卓端Syncthing-Android中，长按已配置的音乐文件夹→“编辑”→将同步类型改为仅接收（Receive Only）。

2、确保Kodi设置中启用“库更新”→“在文件变更时扫描媒体”，路径指向Syncthing同步的目标文件夹（如/storage/emulated/0/Music）。

3、在主设备新增一张专辑并保存后，Syncthing自动推送至手机，Kodi将在30秒内自动识别并加入音乐库，无需手动刷新。

4、验证：打开Kodi→“音乐”→“艺术家”，确认新专辑艺人名称已出现，点开后曲目列表完整。

五、跨网段/远程同步配置（含防火墙放行）

当手机处于移动网络或异地Wi-Fi（与主设备不在同一局域网）时，需开放主设备防火墙端口并配置静态IP或DDNS，确保手机可主动发现并连接。

1、主设备Windows系统以管理员身份运行CMD，依次执行以下命令放行Syncthing端口：

netsh advfirewall firewall add rule name="Syncthing-TCP-22000" protocol=TCP dir=in localport=22000 action=allow

netsh advfirewall firewall add rule name="Syncthing-UDP-22000" protocol=UDP dir=in localport=22000 action=allow

netsh advfirewall firewall add rule name="Syncthing-UDP-21027" protocol=UDP dir=in localport=21027 action=allow

2、在主设备Syncthing Web界面“设置”→“连接”中，关闭“仅局域网发现”，启用“全局发现”。

3、安卓端Syncthing-Android进入“设置”→“高级”→开启“全局发现”和“引入者”功能。

4、等待约2分钟，安卓端Devices列表中应出现主设备名称，状态为Up to Date，表示远程连接已就绪。