lsiodev/musicbrainz

linuxserver/musicbrainz

Musicbrainz是一个开放的音乐百科全书，用于收集音乐元数据并向公众开放。LinuxServer.io团队提供的此容器镜像具备定期更新、用户权限映射、自定义基础镜像等特性，简化Musicbrainz的部署与管理。

!https://raw.githubusercontent.com/linuxserver/beta-templates/master/lsiodev/img/musicbrainzgitlogo.jpg

支持的架构

本镜像支持多种架构，包括x86-64、arm64和armhf，通过Docker manifest实现多平台识别。直接拉取ghcr.io/linuxserver/musicbrainz即可获取对应架构的镜像，也可通过标签指定特定架构。

使用方法

以下是启动容器的示例配置。

docker-compose（推荐）

兼容docker-compose v2 schema。

yaml
---
version: "2.1"
services:
  musicbrainz:
    image: ghcr.io/linuxserver/musicbrainz
    container_name: musicbrainz
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=Europe/London
      - BRAINZCODE=<musicbrainz提供的代码>
      - WEBADDRESS=<主机IP>
      - NPROC=<参数> #可选
    volumes:
      - </path/to/appdata/config>:/config
      - </path/to/appdata/config>:/data
    ports:
      - 5000:5000
    restart: unless-stopped

docker cli

bash
docker run -d \
  --name=musicbrainz \
  -e PUID=1000 \
  -e PGID=1000 \
  -e TZ=Europe/London \
  -e BRAINZCODE=<musicbrainz提供的代码> \
  -e WEBADDRESS=<主机IP> \
  -e NPROC=<参数> `#可选` \
  -p 5000:5000 \
  -v </path/to/appdata/config>:/config \
  -v </path/to/appdata/config>:/data \
  --restart unless-stopped \
  ghcr.io/linuxserver/musicbrainz

参数说明

容器通过运行时参数进行配置，格式为<外部>:<内部>。例如-p 8080:80表示将容器内80端口映射到主机8080端口。

从文件设置环境变量（Docker secrets）

可通过特殊前缀FILE__从文件设置环境变量。例如：

bash
-e FILE__PASSWORD=/run/secrets/mysecretpassword

这会将PASSWORD环境变量设置为/run/secrets/mysecretpassword文件的内容。

应用运行的Umask设置

所有镜像支持通过-e UMASK=022覆盖默认umask设置。注意umask是权限减法而非加法，详情参考umask说明。

用户/组标识符

使用卷（-v标志）时，主机与容器可能出现权限问题。通过指定PUID（用户ID）和PGID（组ID）可避免此问题。确保主机卷目录归属于指定用户，权限问题将解决。

通过id user命令获取当前用户的PUID和PGID：

bash
$ id username
  uid=1000(dockeruser) gid=1000(dockergroup) groups=1000(dockergroup)

应用设置

• 所有更新需拉取最新镜像，清除/config和/data中的所有文件及文件夹，重启容器重新初始化数据库导入。不支持现有数据集的原地升级。

• 若未设置WEBADDRESS环境变量，初始化完成后需编辑/config/DBDefs.pm文件中的sub WEB_SERVER { "localhost:5000" }行，将localhost改为主机IP，以确保CSS正确显示。

• 需注册获取Musicbrainz代码以接收数据库更新（免费），获取代码。

• 数据库初始导入和设置耗时较长，取决于下载速度，耐心等待，不要在完成前重启容器。

• Unraid系统需使用/mnt/cache/appdata路径，而非/mnt/user/cache/appdata。

Docker Mods

https://img.shields.io/badge/dynamic/yaml?color=94398d&labelColor=555555&logoColor=ffffff&style=for-the-badge&label=musicbrainz&query=%24.mods%5B%27musicbrainz%27%5D.mod_count&url=https%3A%2F%2Fraw.githubusercontent.com%2Flinuxserver%2Fdocker-mods%2Fmaster%2Fmod-list.yml]([] "查看此容器可用的mods") https://img.shields.io/badge/dynamic/yaml?color=94398d&labelColor=555555&logoColor=ffffff&style=for-the-badge&label=universal&query=%24.mods%5B%27universal%27%5D.mod_count&url=https%3A%2F%2Fraw.githubusercontent.com%2Flinuxserver%2Fdocker-mods%2Fmaster%2Fmod-list.yml]([] "查看通用mods")

我们提供多种https://github.com/linuxserver/docker-mods%E4%BB%A5%E5%A2%9E%E5%BC%BA%E5%AE%B9%E5%99%A8%E5%8A%9F%E8%83%BD%E3%80%82%E4%B8%8A%E8%BF%B0%E5%8A%A8%E6%80%81%E5%BE%BD%E7%AB%A0%E9%93%BE%E6%8E%A5%E5%8F%AF%E8%AE%BF%E9%97%AE%E6%AD%A4%E9%95%9C%E5%83%8F%E4%B8%93%E7%94%A8%E5%8F%8A%E9%80%9A%E7%94%A8mods%E5%88%97%E8%A1%A8%E3%80%82

支持信息

• 容器运行时Shell访问：docker exec -it musicbrainz /bin/bash

• 实时监控容器日志：docker logs -f musicbrainz

• 容器版本号：docker inspect -f '{{ index .Config.Labels "build_version" }}' musicbrainz

• 镜像版本号：docker inspect -f '{{ index .Config.Labels "build_version" }}' ghcr.io/linuxserver/musicbrainz

更新信息

多数镜像为静态版本，需更新镜像并重建容器以更新应用（nextcloud、plex等例外）。更新步骤如下：

通过Docker Compose

• 更新所有镜像：docker-compose pull 或单个镜像：docker-compose pull musicbrainz

• 重建容器：docker-compose up -d 或单个容器：docker-compose up -d musicbrainz

• 清理旧镜像：docker image prune

通过Docker Run

• 更新镜像：docker pull ghcr.io/linuxserver/musicbrainz

• 停止容器：docker stop musicbrainz

• 删除容器：docker rm musicbrainz

• 使用相同参数重建容器（卷映射正确的话，/config目录和设置会保留）

• 清理旧镜像：docker image prune

通过Watchtower自动更新（仅忘记原始参数时使用）

bash
docker run --rm \
-v /var/run/docker.sock:/var/run/docker.sock \
containrrr/watchtower \
--run-once musicbrainz

注意：不推荐使用Watchtower自动更新容器，建议使用Docker Compose。

镜像更新通知 - Diun（Docker Image Update Notifier）

推荐使用Diun接收更新通知，不建议使用自动更新工具。

本地构建

如需本地修改或开发：

bash
git clone https://github.com/linuxserver/docker-musicbrainz.git
cd docker-musicbrainz
docker build \
  --no-cache \
  --pull \
  -t ghcr.io/linuxserver/musicbrainz:latest .

在x86_64硬件上构建ARM变体需使用multiarch/qemu-user-static：

bash
docker run --rm --privileged multiarch/qemu-user-static:register --reset

注册后使用-f Dockerfile.aarch64指定架构Dockerfile。

版本历史

• 03.10.20: 基于alpine 3.12重建，添加gettext并迁移至nodejs-current。
• 17.05.19: 更新DBDefs.pm至schema 25数据库。
• 23.03.19: 切换至新基础镜像，使用arm32v7标签。
• 02.03.19: 回退至alpine 3.8以修复前端构建工具兼容性问题。
• 19.02.19: 支持多架构，添加流水线逻辑，基于Alpine 3.9重建。
• 22.08.18: 升级服务器版本至2018-08-14。
• 30.06.18: 升级服务器版本至2018-06-30。
• 01.06.18: 升级服务器版本至2018-05-30，简化sed并使用yarn替代npm。
• 14.05.18: 升级服务器版本至2018-05-09。
• 26.04.18: 升级服务器版本至2018-04-23。
• 09.02.18: 升级服务器版本至2018-02-09。
• 24.01.18: 升级服务器版本至2018-01-24。
• 10.01.18: 升级服务器版本至2018-01-10。
• 31.11.17: 升级服务器版本至2017-12-21。
• 30.11.17: 添加NPROC变量以设置进程数。
• 30.11.17: 修复代码规范问题。
• 30.11.17: 启动时删除存在的socket（感谢wtf911）参考。
• 24.11.17: 新安装时移除catalyst侧边栏。
• 31.10.17: 升级服务器版本至2017-10-31。
• 20.09.17: 升级服务器版本至2017-09-18。
• 06.09.17: 升级服务器版本至2017-09-04。
• 19.07.17: 升级服务器版本至2017-07-17。
• 21.06.17: 升级服务器版本至2017-06-19。
• 26.05.17: 修复postgres新版本使用/run而非/var/run的问题。
• 26.05.17: 基于alpine 3.6重建。
• 15.05.17: Schema 24更新，建议使用新配置完全重建。
• 15.04.17: 升级服务器版本至2017-04-10。
• 04.04.17: 升级服务器版本至2017-03-27。
• 15.03.17: 升级服务器版本至2017-03-13。
• 04.03.17: 升级服务器版本并使用nginx提供网页服务。
• 06.02.17: 基于alpine 3.5重建。
• 16.12.16: 基于alpine linux重建，几乎完全重写。
• 14.10.16: 添加版本层信息。
• 30.09.16: 修复umask。
• 10.09.16: 添加层徽章至README。
• 28.08.16: 添加徽章至README，迁移至主仓库。
• 20.07.16: 重构Dockerfile以提高清晰度，添加maxworkers变量与starlet配合实现多核并行请求（感谢用户baoshan）。
• 03.06.16: 因schema变更完全重写，基于14.04直接使用S6 overlay。
• 21.03.16: 升级至最新服务器版本。
• 16.03.16: 升级至最新服务器版本。
• 26.02.16: 升级至最新服务器版本。
• 08.02.16: 切换至PPA版本的redis。
• 03.01.16: 移除sitemaps文件下载（最近2个数据库转储中缺失），将数据库/转储获取移至初始化流程早期以方便恢复中断的下载。
• 15.12.15: 根据Musicbrainz最新博客，切换至production分支，最新稳定代码现在位于production分支而非master。
• 10.12.15: 初始发布日期。