如果你使用 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://raw.githubusercontent.com/linuxserver/docker-templates/master/linuxserver.io/img/linuxserver_medium.png]([***]
LinuxServer.io团队为您带来另一个容器版本,其特点包括:
您可以在以下位置找到我们:
。这些参数用冒号分隔,表示<外部>:<内部>。例如,-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://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%EF%BC%8C%E4%BB%A5%E5%90%AF%E7%94%A8%E5%AE%B9%E5%99%A8%E5%86%85%E7%9A%84%E9%99%84%E5%8A%A0%E5%8A%9F%E8%83%BD%E3%80%82%E5%8F%AF%E7%94%A8%E4%BA%8E%E6%AD%A4%E9%95%9C%E5%83%8F%E7%9A%84Mods%E5%88%97%E8%A1%A8%EF%BC%88%E5%A6%82%E6%9E%9C%E6%9C%89%EF%BC%89%E4%BB%A5%E5%8F%8A%E5%8F%AF%E5%BA%94%E7%94%A8%E4%BA%8E%E6%88%91%E4%BB%AC%E4%BB%BB%E4%BD%95%E9%95%9C%E5%83%8F%E7%9A%84%E9%80%9A%E7%94%A8Mods%E5%8F%AF%E9%80%9A%E8%BF%87%E4%B8%8A%E9%9D%A2%E7%9A%84%E5%8A%A8%E6%80%81%E5%BE%BD%E7%AB%A0%E8%AE%BF%E9%97%AE%E3%80%82
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.io/linuxserver/musicbrainzdocker stop musicbrainzdocker rm musicbrainz/config文件夹和设置将被保留)docker image prunedocker run --rm \ -v /var/run/docker.sock:/var/run/docker.sock \ containrrr/watchtower \ --run-once musicbrainz
docker image prune注意: 我们不认可使用Watchtower作为现有Docker容器自动更新的解决方案。事实上,我们通常不鼓励自动更新。但是,对于您忘记原始参数的容器,这是一个有用的一次性手动更新工具。从长远来看,我们强烈建议使用Docker Compose。
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本,请访问 标签列表页面。




来自真实用户的反馈,见证轩辕镜像的优质服务