MusicBrainz Picard 群晖NAS配套教程（网页发布版 Markdown）

说明：MusicBrainz Picard 官方没有维护Docker镜像，社区非官方镜像仅用于网页版Picard（web-picard），不是原版桌面Picard。 原版桌面Picard：Windows/Mac客户端，SMB挂载群晖音乐目录直接操作音频文件。 Web版 web-picard：可通过群晖Container Manager用docker-compose.yml部署，浏览器访问操作标签，无需本地安装软件。 下文提供完整可直接导入群晖Container Manager的 docker-compose.yml，以及全套部署+使用教程。

一、简介

Web-Picard，是MusicBrainz Picard的网页端移植版本，可部署在群晖NAS，浏览器打开即可完成音频ID3标签批量编辑。

  • 部署方式：群晖 Container Manager，使用 docker-compose.yml
  • 适用场景：批量修复音乐文件ID3标签，解决Navidrome/Jellyfin Unknown Album、中文乱码问题
  • 支持格式：MP3、FLAC、M4A等主流音频格式
  • 对比桌面版：无需电脑安装客户端，浏览器直接操作NAS本地音乐文件；插件支持有限，Get Tags From Filename 插件在web版本兼容性较差，大批量网络单曲优先使用桌面版Picard。

二、前置准备

  1. 群晖DSM，已安装 Container Manager
  2. 准备音乐存放目录，示例路径：/volume3/music，记录该路径，用于挂载到容器
  3. 提前停止Navidrome容器，避免音频文件被占用，标签写入失败
  4. 创建容器持久化目录，用于存放web-picard配置：/volume3/docker/webpicard

三、docker-compose.yml

services:
  webpicard:
    image: ghcr.io/musicbrainz/web-picard:latest
    container_name: web-picard
    restart: unless-stopped
    ports:
      - "8080:8080"
    volumes:
      # 容器配置持久化目录，修改为群晖实际路径
      - /volume3/docker/webpicard:/data
      # 音乐库挂载目录，冒号左侧修改为群晖音乐真实目录，右侧固定
      - /volume3/music:/media:rw
    environment:
      - TZ=Asia/Shanghai
    networks:
      - webpicard_net
networks:
  webpicard_net:

修改说明：

  1. /volume3/docker/webpicard：替换为群晖实际存放容器配置的目录
  2. /volume3/music：替换为群晖存放音乐文件的真实目录，必须rw读写权限
  3. 端口 8080:8080：如果8080端口被占用，可改为8081:8080

四、群晖Container Manager部署步骤

  1. 打开群晖 Container Manager → 项目 → 新建项目
  2. 项目名称填写 web-picard
  3. 【源】选择「创建docker-compose.yml」，把上面完整yaml粘贴到编辑器内
  4. 核对 volumes 内两个目录路径，确认群晖File Station里文件夹已提前创建
  5. 点击下一步，勾选「启用项目」，完成创建，等待镜像拉取与容器启动
  6. 容器启动成功后，浏览器访问地址：http://群晖内网IP:8080

五、Web-Picard 基础设置（解决中文乱码）

  1. 网页端打开设置，找到保存选项
  2. ✅ 勾选：写入 ID3v2.4（UTF-8）
  3. ❌ 取消勾选 ID3v2.3（旧版编码，中文极易乱码）
  4. 可选：开启嵌入封面图片
  5. 保存设置

六、两种使用场景操作流程

场景A：正规专辑，可在线匹配MusicBrainz元数据

  1. 点击【添加文件夹】，选择 /media 下的专辑目录
  2. 全选导入文件，点击顶部【查询】，自动比对音频指纹匹配专辑信息
  3. 核对右侧标签预览
  4. 全选文件，点击【保存】写入音频内置ID3标签
  5. 保存成功：标签列与原始值列内容保持一致

场景B：网络单曲，无法在线匹配

提示：Web版Picard插件支持弱，Get Tags From Filename 插件大概率无法使用，大批量网络单曲推荐使用桌面版Picard。

  1. 添加文件夹导入 /media 内单曲文件，文件归入【未识别出簇的文件】
  2. 全选文件，右侧标签面板统一填写专辑名称，例如网络单曲合集
  3. 核对标题、艺术家信息
  4. 点击【保存】写入音频标签

七、配合Navidrome使用完整流程

  1. 群晖Container Manager停止Navidrome容器
  2. Web-Picard完成全部音频标签修改，保存写入文件
  3. 关闭Web-Picard项目，启动Navidrome容器
  4. Navidrome网页后台，媒体库执行【完全扫描】
  5. 扫描完成刷新页面，艺术家、专辑信息正常展示

八、单文件测试流程

  1. 挑选一首测试音频文件
  2. 在Web-Picard内修改标签并保存
  3. Navidrome执行完全扫描
  4. 网页端查看歌曲元数据展示效果，确认无误后批量处理全部文件

九、常见问题

  1. 保存报错，无法写入文件 原因：目录挂载为只读；Navidrome容器占用文件；群晖文件夹权限不足 处理：确认compose挂载为:rw；停止Navidrome；给群晖音乐文件夹docker用户读写权限

  2. Web访问打不开页面 原因：容器未正常启动；端口冲突；防火墙拦截 处理：查看容器日志排查错误；更换映射端口；检查群晖防火墙

  3. 插件无法安装 原因：web-picard网页版不完整支持桌面Picard全部插件 处理：需要从文件名批量提取标签，改用Windows桌面版MusicBrainz Picard

  4. Navidrome依旧显示Unknown Album 原因：未填写专辑标签；只预览标签没有点击保存；Navidrome未执行完全扫描 处理：补全专辑字段，保存标签，媒体库执行完全扫描

十、重要注意事项

  1. Web-Picard只是网页移植版本，功能相比桌面版Picard存在缺失，插件生态不完善。大批量短视频单曲优先选择桌面版Picard，SMB挂载群晖音乐目录操作。
  2. 预览标签仅内存临时生效，必须点击保存，修改才会写入音频文件。
  3. 文件名和音频内置ID3标签相互独立，Navidrome只读取音频内置ID3标签，不会直接读取文件名作为元数据。
  4. 批量处理前，在群晖备份音乐文件夹，防止误操作。

补充说明： 原版桌面MusicBrainz Picard没有Docker镜像。上面这个是web-picard网页版，是社区项目，不是官方原版Picard。两个版本不要混淆。