告别“光秃秃”的本地音乐！一款全平台通用的歌词刮削神器

当你辛辛苦苦收集了几个T的无损音乐，存进 NAS 或者本地硬盘，准备用 Audio Station、Plex、Emby 好好享受时，却发现：

• 没有歌词：听不懂外语歌，或者想跟着哼两句时一脸懵。

• 没有封面：播放界面光秃秃的，或者显示一个默认的灰色图标，不仅丑，找歌也费劲。

• 强迫症发作：看着杂乱无章的音乐库，心里总是痒痒的。

市面上的刮削器（Scraper）要么太复杂，要么就是针对电影电视剧的，专门针对本地音乐文件刮削歌词和封面的好用工具并不多。

作为一个爱折腾的程序员，既然找不到顺手的，那就自己写一个！

今天老宁就给大家介绍一下我自己开发并开源的项目：LyricFlow。它能自动扫描你的音乐库，从各大音乐平台下载歌词和专辑封面，让你的音乐库从此“声色俱全”。

最重要的是，这个项目基于 Docker 开发，不局限于群晖！无论你是用威联通、极空间、绿联，还是飞牛，甚至是一台普通的 Linux 服务器、Windows 电脑，只要能运行 Docker，统统都能用！

项目地址

https://github.com/laoning666/lyricFlow

功能特性

LyricFlow 的设计初衷就是简单、自动化、全平台。

• 🎵 格式全支持：支持扫描 MP3、FLAC、M4A、WAV 等常见音乐格式。

• 📝 自动下歌词：自动搜索并下载歌词，保存为同名的 .lrc 文件，播放器能自动识别。

• 🖼️ 自动下封面：自动下载专辑封面，保存为 cover.jpg，让文件夹视图赏心悦目。

• 🔄 增量处理：智能跳过已经有歌词或封面的文件，不会重复下载，节省资源。

• ⏰ 定时扫描：支持设置定时任务（比如每天扫一次），新加的歌自动处理。

• 🐳 全平台部署：Docker 容器化，支持 X86、ARM 架构，哪里都能跑。

安装部署

为了照顾不同用户的使用习惯，这里提供通用部署和群晖图形化部署两种方式。

方式一：通用 Docker Compose（推荐）

如果你使用的是 Linux 服务器、Mac、威联通（Container Station）、极空间、绿联 或者习惯使用命令行的群晖用户，推荐使用这种方式。

1. 创建一个 docker-compose.yml 文件，内容如下：

version: '3' services: lyricflow: image: ghcr.io/laoning666/lyricflow:latest container_name: lyricflow restart: unless-stopped environment: # 扫描间隔（天），0 = 运行一次退出，1 = 每天运行一次 - SCAN_INTERVAL_DAYS=1 # 是否下载歌词 - DOWNLOAD_LYRICS=true # 是否下载封面 - DOWNLOAD_COVER=true # 是否覆盖已有文件（建议 false） - OVERWRITE_LYRICS=false - OVERWRITE_COVER=false # 音乐搜索平台优先级 - PLATFORMS=netease,kuwo,qq volumes: # 🔴 关键：冒号左边修改为你设备上实际的音乐文件夹路径 - /path/to/your/music:/music

2. 在该文件所在目录下运行启动命令：

docker-compose up -d

方式二：Docker CLI（一行命令快速体验）

如果你不想创建文件，只想快速跑一次试试，可以直接在终端运行以下命令：

docker run --rm -v /你的音乐路径:/music ghcr.io/laoning666/lyricflow:latest

注意：运行完成后容器会自动删除，适合临时整理一次。

方式三：群晖图形化部署（Container Manager）

对于习惯使用图形界面的群晖用户，操作依然简单：

1. 打开【File Station】，在 docker 文件夹下创建 lyricflow 文件夹。

2. 打开【Container Manager】套件，在项目菜单下点击创建。

3. 输入项目名称，路径选择刚才创建的 lyricflow 文件夹。

4. 来源选择创建 docker-compose.yml，并将方式一中的代码复制进去。

5. 重要修改：一定要把 volumes 下的 /path/to/your/music 修改为你群晖实际的音乐路径（例如 /volume1/music/齐秦）。

6. 点击下一步构建并启动即可。

效果展示

部署完成后，LyricFlow 就会默默在后台工作了。

你可以去文件管理器里看看你的音乐文件夹。为了获得最佳效果，老宁建议大家按 歌手/专辑/ 的结构来整理音乐。

工具运行后，你的文件夹里会自动多出 .lrc 歌词文件和 cover.jpg 封面图：

/music/ ├── 周杰伦/ │ ├── 七里香/ │ │ ├── 七里香.mp3 │ │ ├── 七里香.lrc ← 自动生成的歌词 │ │ ├── 止战之殇.flac │ │ ├── 止战之殇.lrc ← 自动生成的歌词 │ │ └── cover.jpg ← 自动生成的专辑封面

这时候，你再用 Audio Station、Plex、Emby、Jellyfin 或者任何支持挂载本地目录的播放器听歌，歌词和封面就都能完美显示了！

进阶配置：多文件夹挂载

很多朋友的音乐可能分散在不同的硬盘或文件夹里，比如一部分在“下载盘”，一部分在“仓库盘”。LyricFlow 支持同时扫描多个目录。

只需要修改 docker-compose.yml 中的 volumes 部分，将它们映射到容器内的不同子目录即可：

volumes: # 映射第一个音乐目录 - /share/music_downloads:/music/downloads # 映射第二个音乐目录 - /share/lossless_storage:/music/lossless

这样，LyricFlow 就会同时扫描这两个文件夹下的所有音乐。

后记

开发 LyricFlow 的初衷是为了解决我自己音乐库管理的痛点，作为一个强迫症患者，看到音乐文件只有光秃秃的文件名实在是忍不了。

虽然教程里经常提到群晖，但 Docker 的魅力就在于它的通用性。无论你用什么设备，只要想整理本地音乐，这个小工具都能帮上忙。项目完全免费，也不需要复杂的 API Key 配置，希望能帮大家省下找歌词找封面的时间，把时间留给欣赏音乐本身。

如果你觉得这个小工具好用，欢迎去 GitHub 给老宁点个 Star 🌟，或者在评论区反馈你的使用体验！

我是老宁

一个热爱技术的程序员和极客，NAS深度玩家！

专注NAS相关技术分享，原创！干货！

觉得老宁的文章对你有帮助，记得点赞、收藏、加关注！