酷我音乐下载到NAS流水线

本项目把 K50 手机上「酷我音乐 Ver.12.2.2.4」下载的歌曲，自动汇入 NAS 音乐库。酷我登录后可会员解锁并下载无损 FLAC（质量码 2000），文件默认落在 /sdcard/Download/KuwoMusic/music/，命名为 <歌名>-<歌手>-<rid>-<质量码>.<ext>。

部署在 .164 xiejun-web 的流水线由 /root/kuwo_pull.py 和 systemd timer 组成，每 2 分钟拉取一次，把文件导入 /nas/音乐，按 rid 去重，从 lrclib.net 获取歌词并写成同名 .lrc，随后删除设备副本，最后由 Navidrome 自动扫描入库。

这样解决的是手动拷贝、重复导入、歌词缺失和手机空间占用等问题。现状是服务已部署，实测两首无损 FLAC 均已入库并带歌词，设备目录已清空。注意 MIUI 可能杀酷我后台，下载时需保持 App 在前台；大批量下载仍建议使用 API 直连工具。

功能

• 每 2 分钟自动从设备下载目录拉取到 /nas/音乐
• 支持酷我会员解锁后的无损 FLAC 下载，质量码 2000
• 按 rid 去重，已入库歌曲跳过并清理设备副本
• 从 lrclib.net 自动获取歌词，优先同步歌词并回落纯文本，生成同名 .lrc
• 默认导入后删除设备副本，缓解手机存储压力
• 对接 Navidrome，定时扫描或重启触发入库

技术栈

使用 / 部署教程

以下步骤基于现有部署记录整理，设备连接方式与路径若不同，请按实际环境调整。

1. 准备手机端：在 K50 安装酷我音乐 Ver.12.2.2.4，登录账号解锁会员；保持默认下载目录 /sdcard/Download/KuwoMusic/music/。下载过程中让 App 保持前台，避免 MIUI 杀后台导致中断。
2. 确认 NAS 脚本：在 .164 xiejun-web 上确认 /root/kuwo_pull.py 存在，并具备读取手机下载目录、写入 /nas/音乐 的权限；按需检查脚本中的来源与目标路径。
3. 启用定时任务：确认 /etc/systemd/system/kuwo-pull.service 与 kuwo-pull.timer 已就位，timer 每 2 分钟触发，flock 防重入。执行 systemctl daemon-reload，再执行 systemctl enable --now kuwo-pull.timer。
4. 查看运行状态：用 journalctl -u kuwo-pull.service -n 50 查看日志；也可手动执行 python3 /root/kuwo_pull.py 立即拉取。需要保留设备副本时加 --keep，不抓歌词时加 --no-lyric。
5. 验证入库：检查 /nas/音乐 是否出现 FLAC 与同名 .lrc，设备目录是否已清空；Navidrome 默认每 1 小时扫描，若要立即生效可执行 docker restart navidrome 触发启动扫描。
6. 批量下载：酷我 App 只能逐首或逐歌单下载，大批量建议使用 tools/kuwo_batch_dl.py 直连 API。

常见问题