重要通知：此镜像已被弃用

![linuxserver.io]([***]

LinuxServer.io团队为您带来另一个容器版本，其特点包括：

• 定期及时的应用更新
• 简单的用户映射（PGID、PUID）
• 带有s6覆盖的自定义基础镜像
• 每周基础操作系统更新，整个LinuxServer.io生态系统共享通用层，以最小化空间使用、停机时间和带宽
• 定期安全更新

您可以在以下位置找到我们：

• Blog - 关于容器使用的所有内容，包括操作指南、观点等
• *** - 与社区和团队进行实时支持/聊天
• Discourse - 在我们的社区论坛上发帖
• Fleet - 在线Web界面，显示我们所有维护的镜像
• GitHub - 查看我们所有仓库的源代码
• Open Collective - 请考虑通过***或为我们的预算做出贡献来帮助我们

linuxserver/musicbrainz

![GitHub Stars]([] ![GitHub Release]([] ![GitHub Package Repository]([] ![GitLab Container Registry]([] ![Docker Pulls]([] ![Docker Stars]([] ![Jenkins Build]([***]

MusicBrainz是一个开放的音乐百科全书，收集音乐元数据并向公众开放。

![musicbrainz]([***]

镜像概述和主要用途

MusicBrainz是一个开放的音乐百科全书，旨在收集和提供音乐元数据。本Docker镜像由LinuxServer.io团队构建，提供了一个简单、可靠的方式来部署和运行MusicBrainz服务，无需复杂的系统配置。

核心功能和特性

• 定期及时的应用更新
• 简单的用户权限映射（PGID、PUID）
• 基于s6 overlay的自定义基础镜像
• 每周基础系统更新，优化空间使用和带宽
• 定期安全更新
• 支持多架构部署

支持的架构

我们的镜像支持多种架构，如x86-64、arm64和armhf。我们利用docker manifest实现多平台支持。更多信息可从docker 此处和我们的公告此处获取。

只需拉取ghcr.io/linuxserver/musicbrainz即可获取适合您架构的正确镜像，但您也可以通过标签拉取特定架构的镜像。

此镜像支持的架构：

使用场景和适用范围

本镜像适用于需要搭建个人音乐元数据库的用户，音乐爱好者，以及需要音乐元数据管理的小型组织。特别适合以下场景：

• 个人音乐收藏管理
• 小型音乐图书馆
• 音乐相关应用开发测试环境
• 教育和研究用途

使用方法和配置说明

以下是一些示例代码片段，可帮助您开始创建容器。

docker-compose（推荐）

兼容docker-compose v2架构。

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

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暴露出来，可通过主机IP的8080端口访问。

环境变量从文件读取（Docker secrets）

您可以通过使用特殊的前缀FILE__从文件中设置任何环境变量。

例如：

-e FILE__PASSWORD=/run/secrets/mysecretpassword

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

运行应用的Umask设置

对于我们所有的镜像，您可以使用可选的-e UMASK=022设置来覆盖容器内启动的服务的默认umask设置。 请记住，umask不是chmod，它根据其值减去权限，而不是添加。在请求支持之前，请此处了解相关知识。

用户/组标识符

使用卷（-v标志）时，主机操作系统和容器之间可能会出现权限问题，我们通过允许您指定用户PUID和组PGID来避免此问题。

确保主机上的任何卷目录都归您指定的同一用户所有，任何权限问题都将迎刃而解。

在这个例子中，PUID=1000和PGID=1000，要找到您的PUID和PGID，请使用id user命令：

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

应用程序设置

• 对于所有更新，您应该拉取最新镜像，清除/config和/data中的所有文件和文件夹，并通过（重新）启动docker重新初始化数据库导入。我们不正式支持使用现有数据集就地升级此容器。

• 如果您没有设置WEBADDRESS环境变量，那么在初始化完成后，您需要编辑/config/DBDefs.pm文件中的sub WEB_SERVER { "localhost:5000" }行，将localhost更改为您的主机IP，这是为了允许CSS正确显示

• 您必须在此处注册以获取MusicBrainz代码，以允许您接收数据库更新，这是免费的。在此获取代码。
• 数据库的初始导入和设置可能需要相当长的时间，具体取决于您的下载速度等，请耐心等待，不要在完成之前重新启动容器。
• 似乎unraid系统使用/mnt/user/cache/appdata而不是/mnt/cache/appdata会有问题，请使用/mnt/cache/appdata。

Docker Mods

我们发布了各种Docker Mods，以启用容器内的附加功能。可用于此镜像的Mods列表（如果有）以及可应用于我们任何镜像的通用Mods可通过上面的动态徽章访问。

支持信息

• 容器运行时的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
• 让compose根据需要更新所有容器：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
• 使用上述相同的docker run参数重新创建新容器（如果正确映射到主机文件夹，您的/config文件夹和设置将被保留）
• 您还可以删除旧的悬空镜像：docker image prune

通过Watchtower自动更新器（仅在您不记得原始参数时使用）

• 拉取其标签的最新镜像，并在一次运行中使用相同的环境变量替换它：

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

• 您还可以删除旧的悬空镜像：docker image prune

注意： 我们不认可使用Watchtower作为现有Docker容器自动更新的解决方案。事实上，我们通常不鼓励自动更新。但是，对于您忘记原始参数的容器，这是一个有用的一次性手动更新工具。从长远来看，我们强烈建议使用Docker Compose。

镜像更新通知 - Diun（Docker镜像更新通知器）