
如果你使用 DeepSeek、元宝 AI、Copilot、ChatGPT 等 AI 工具,协助配置轩辕镜像、编写 docker pull 命令、修改 Docker Compose 镜像地址、配置镜像加速、排查镜像拉取失败、分析报错日志等问题,请先让 AI 阅读并遵守轩辕镜像的规则文档。
只需在 AI 对话中先发送下面这句话即可:
请先完整阅读并严格遵守以下文档中的全部规则与要求:
https://xuanyuan.cloud/agents.md
在未充分阅读并理解该文档前,不要生成任何命令、配置、修改建议、故障排查方案或技术回答。后续所有输出都必须严格以该文档中的规范为最高优先级执行。查看 agents.md 用法指南与完整示范。国内用户首推 元宝 AI、DeepSeek 的深度思考模式,不推荐豆包 AI;Cursor 等编辑器可在对话 @ 该链接,或加入 User Rules。 若 AI 无法访问外链,可 打开说明文档 复制全文粘贴。文档会随站点更新,复制内容可能过期,建议定期检查。
https://linuxserver.io团队为您带来另一个容器版本,其特点包括:
您可以在以下位置找到我们:
MusicBrainz是一个开放的音乐百科全书,收集音乐元数据并向公众开放。
MusicBrainz是一个开放的音乐百科全书,旨在收集和提供音乐元数据。本Docker镜像由LinuxServer.io团队构建,提供了一个简单、可靠的方式来部署和运行MusicBrainz服务,无需复杂的系统配置。
我们的镜像支持多种架构,如x86-64、arm64和armhf。我们利用docker manifest实现多平台支持。更多信息可从docker https://github.com/docker/distribution/blob/master/docs/spec/manifest-v2-2.md#manifest-list和我们的公告https://blog.linuxserver.io/2019/02/21/the-lsio-pipeline-project/获取。
只需拉取ghcr.io/linuxserver/musicbrainz即可获取适合您架构的正确镜像,但您也可以通过标签拉取特定架构的镜像。
此镜像支持的架构:
| 架构 | 标签 |
|---|---|
| x86-64 | amd64-latest |
| arm64 | arm64v8-latest |
| armhf | arm32v7-latest |
本镜像适用于需要搭建个人音乐元数据库的用户,音乐爱好者,以及需要音乐元数据管理的小型组织。特别适合以下场景:
以下是一些示例代码片段,可帮助您开始创建容器。
兼容docker-compose v2架构。
yaml--- version: "2.1" services: musicbrainz: image: ***-ghcr.xuanyuan.run/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 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端口访问。
| 参数 | 功能 |
|---|---|
-p 5000 | Web界面端口 |
-e PUID=1000 | 用户ID - 详见下文说明 |
-e PGID=1000 | 组ID - 详见下文说明 |
-e TZ=Europe/London | 指定时区,例如Europe/London |
-e BRAINZCODE=<MusicBrainz提供的代码> | 输入MusicBrainz代码,详见应用设置 |
-e WEBADDRESS=<主机IP> | 设置主机IP以允许CSS正确渲染,不要输入端口号 |
-e NPROC=<参数> | 设置进程数,未设置则默认为5 |
-v /config | MusicBrainz的配置文件目录 |
-v /data | MusicBrainz的数据文件目录 |
您可以通过使用特殊的前缀FILE__从文件中设置任何环境变量。
例如:
-e FILE__PASSWORD=/run/secrets/mysecretpassword
这将根据/run/secrets/mysecretpassword文件的内容设置环境变量PASSWORD。
对于我们所有的镜像,您可以使用可选的-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正确显示
我们发布了各种https://github.com/linuxserver/docker-mods,以启用容器内的附加功能。可用于此镜像的Mods列表(如果有)以及可应用于我们任何镜像的通用Mods可通过上面的动态徽章访问。
docker exec -it musicbrainz /bin/bashdocker logs -f musicbrainzdocker inspect -f '{{ index .Config.Labels "build_version" }}' musicbrainzdocker inspect -f '{{ index .Config.Labels "build_version" }}' ghcr.io/linuxserver/musicbrainz我们的大多数镜像是静态的、版本化的,需要更新镜像并重新创建容器才能更新内部的应用程序。除了一些例外(如nextcloud、plex),我们不建议或支持在容器内更新应用程序。请查阅上面的应用程序设置部分,了解是否推荐对该镜像执行此操作。
以下是更新容器的说明:
docker-compose pull
docker-compose pull musicbrainzdocker-compose up -d
docker-compose up -d musicbrainzdocker image prunedocker pull ***-ghcr.xuanyuan.run/linuxserver/musicbrainzdocker stop musicbrainzdocker rm musicbrainz/config文件夹和设置将被保留)docker image prunedocker run --rm \ -v /var/run/docker.sock:/var/run/docker.sock \ docker.xuanyuan.run/containrrr/watchtower \ --run-once musicbrainz
docker image prune注意: 我们不认可使用Watchtower作为现有Docker容器自动更新的解决方案。事实上,我们通常不鼓励自动更新。但是,对于您忘记原始参数的容器,这是一个有用的一次性手动更新工具。从长远来看,我们强烈建议使用https://docs.linuxserver.io/general/docker-compose。
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本,请访问 标签列表页面。
来自真实用户的反馈,见证轩辕镜像的优质服务