优雅听歌，给自己配个音乐小秘书～一键部署Metadata Remote

更新时间：2025-07-28 23:10  浏览量：1

对于很多 NAS 用户来说，管理本地音乐资料库时，常常会遇到这样的烦恼：

音轨信息不完整、专辑封面丢失、文件名杂乱，甚至不同格式的音乐文件混在一起，导致 Plex 或 Jellyfin 无法正确识别。而传统的元数据编辑器往往只适用于 Windows 或 macOS，不支持 NAS 这种“无图形界面”的环境。

Metadata Remote 正是为了解决这个痛点而设计的。

它是一款专为 NAS、VPS、树莓派等“无头设备”开发的音乐元数据编辑器，无需安装复杂的音乐库系统，也不需要动用命令行或手动复制文件。你只需通过 Docker 启动它，然后用浏览器打开，就可以轻松编辑音乐文件的标题、艺术家、专辑、封面等信息。

简单来说：

只要你会用浏览器，就能用 Metadata Remote 整理你的音乐资料库。

PS：当初在部署Navidrome中顺带介绍过Music Tag Web，近期也打算重新单独再出一篇正式介绍。

项目特征

支持无头服务器：适用于 威联通（QNAP）、群晖（Synology）、TrueNAS、Unraid 等无图形界面的设备，无需显示器、远程桌面或 VNC。

快速部署，零配置：基于 Docker，几乎“开箱即用”，从拉取镜像到使用通常不超过 1 分钟。

智能元数据建议：通过分析文件名和文件夹结构，自动推荐合适的曲目信息，例如精选集、合辑等复杂情况。

编辑历史可追溯：所有操作都支持完整的撤销与重做，最多记录 1000 步，误操作也能轻松恢复。

强大批量处理能力：可以一键批量修改整文件夹的标签或封面图，大幅提升资料整理效率。

简洁现代的界面：支持拖放操作、实时搜索过滤、本地音乐预览播放、黑暗模式等功能，用户体验优秀。

多平台兼容：提供 x86_64、ARM64、ARMv7 多架构 Docker 镜像，兼容主流硬件与微型服务器（如树莓派）。

支持MP3、FLAC、OGG、OPUS、WMA、WAV、WavPack (WV)、M4A 和 M4B。

部署流程

以威联通NAS为例，通过Docker Compose的方式进行部署：

部署代码如下

version: '3.8' # 最新版删除该行services: metadata-remote: image: ghcr.io/wow-signal-dev/metadata-remote:latest container_name: metadata-remote ports: - "8338:8338" # 冒号左侧端口自定义 volumes: - /share/Media/music:/music # 你的音乐库 # 如果你有多个音乐文件夹，也可以这样挂载它们： # - /path/to/music1:/music/Library1 # - /path/to/music2:/music/Library2 environment: - PUID=${UID:-1000} # 自动识别当前用户id，也可用id命令查询固定 - PGID=${GID:-1000} restart: always

当然你也可以进一步区分挂载目录，例如：

- /share/Media/Music:/music # 替换为你的主音乐目录 - /share/Media/HiRes:/music/HiRes # 可选，Hi-Res高解析度音乐 - /share/Media/Concerts:/music/LiveConcerts # 可选，现场音乐或录音

打开Container Station，创建新的应用程序。

等待部署完毕即可。

使用展示

我这里为了演示方便，直接库1和库2都用的一个目录～当然每个库下也都支持子文件夹识别，大家如果有预先按照歌手、专辑之类的做细分，也都能在这边显示。

选中歌曲即可进行源数据编辑。曲名、歌手、专辑、封面、歌词等等。还可添加新的自定义元数据字段，这个根据需求来即可。

支持页面试听，还支持历史修改追溯，支持数据重置等操作。

支持键盘快捷操作。

最后

完整项目名：wow-signal-dev/metadata-remote

项目发布（6月20日）到现在（7月28日）已有一个多月的时间。

除了暂无汉化外，整体可用性不错，大家有什么功能性建议或BUG可至项目界面反馈提出。

感谢观看，本文完～