官方文档
https://ansgoo.github.io/music-free-site/
安装
MusicFree 仍在快速迭代，部分功能可能调整，生产环境建议固定镜像版本。
services:
music-free:
image: ansgoo/music-free:V1.1.9
container_name: music-free
restart: unless-stopped
ports:
- "4533:4533"
volumes:
- /vol1/docker/music-free:/app/data
- /vol1/music:/app/music
ARM 用户：自本版起 Docker Hub 同时提供 linux/amd64 与 linux/arm64 镜像，树莓派、飞牛等 ARM 设备可直接拉取 ansgoo/music-free:V1.1.8，无需自行交叉编译。
更新特性
音乐去重：三步向导
管理后台 音乐管理 → 音乐去重 改为清晰的三步流程，降低误操作风险：
- 生成指纹 —— 为缺失指纹的曲目批量补算 Chromaprint（已有指纹自动跳过）
- 重复检测 —— 按可配置阈值比对全库，输出重复组与相似度分数
- 去重 —— 组内手动勾选假删除，或 按规则批量清理（同专辑内保留无损 > 码率 > 时长；跨专辑重复默认全部保留）
媒体源扫描与指纹：更快、更稳
- 扫描提速：并发 worker、目录 hash 增量跳过未变更路径；WebDAV 支持部分读取与单次 OpenStream 解析，减少远程 I/O
- 指纹与扫描解耦：入库扫描不再强绑指纹计算；支持定时补指纹任务与管理端异步全库回填
- 指纹引擎：内嵌
chromaprint.wasm + ffmpeg/ffprobe，不再依赖系统 fpcalc；WASM 堆内存可配置上限，大文件 / WebDAV 特殊格式拉取与运行时错误恢复更稳健，大幅降低了docker镜像体积
- 指纹调度：支持任务中断与互斥锁，避免多任务争抢资源
ARM Docker 多架构镜像
CI 构建并推送 amd64 + arm64 双架构镜像，标签与 V1.1.8 一致，ARM NAS / 单板机可直接使用官方镜像。
飞牛 fnOS 原生应用（FPK）
新增 飞牛应用中心 可安装的原生 .fpk 包（非 Docker 模板），支持桌面快捷方式启停与向导配置音乐库路径；Release 流水线同时产出 amd64 / arm64 安装包
其他改进
- WebDAV 媒体源：在开启「允许回写音乐源文件标签」时，清洗 / 刮削 / 元数据编辑可写回远程标签（需 WebDAV PUT 权限）
- 标签清洗：内置
RULE-03 扩展支持标题前导下划线序号（如 _01.）清理
- 远程搜索 / 下载：插件选项展示插件图标，远程曲目列表增加加载骨架屏
- 默认策略：新装默认关闭「回写音频源文件标签」，降低误改 NAS 原文件风险（可在 系统设置 中开启）
飞牛原生应用请下载附件，ARM和x86包都有
附件：musicfree-fpk.zip
升级说明
| 场景 |
建议操作 |
自旧版升级且已开启 fingerprint.enabled |
进入 音乐去重 执行「生成指纹」，或对媒体源全量扫描一次 |
曾配置 fingerprint.fpcalc_path |
该配置已废弃并忽略，无需安装 fpcalc |
| 依赖 Chromaprint 去重 |
确认宿主机已安装 ffmpeg / ffprobe |
| 飞牛用户 |
可选用 Docker 镜像或从 Release 附件安装对应架构 FPK |
升级前请备份 data/music.db
其他修复
- 优化指纹生成任务状态提示与进度展示（支持更细粒度进度）
- 修正部分管理端路由重定向与守卫逻辑
- 依赖与构建脚本小幅更新，提升稳定性
欢迎大家反馈问题
请按规范提交 Issue，便于复现与跟进：
反馈规范
