
如果你使用 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团队为您带来另一个容器版本,具有以下特点:
您可以在以下位置找到我们:
是Usenet和BitTorrent用户的PVR工具。它可以监控多个RSS源以获取您喜爱节目的新剧集,并会抓取、排序和重命名这些文件。还可以配置为当更好质量的格式可用时,自动升级已下载文件的质量。
https://raw.githubusercontent.com/linuxserver/docker-templates/master/linuxserver.io/img/sonarr-banner.png]([***]
我们的镜像支持多种架构,如x86-64、arm64和armhf。我们利用Docker清单实现多平台识别。更多信息可从Docker https://github.com/docker/distribution/blob/master/docs/spec/manifest-v2-2.md#manifest-list%E5%92%8C%E6%88%91%E4%BB%AC%E7%9A%84%E5%85%AC%E5%91%8A%E6%AD%A4%E5%A4%84%E8%8E%B7%E5%8F%96%E3%80%82
只需拉取linuxserver/sonarr即可获取适合您架构的正确镜像,但您也可以通过标签拉取特定架构的镜像。
此镜像支持的架构:
| 架构 | 标签 |
|---|---|
| x86-64 | amd64-latest |
| arm64 | arm64v8-latest |
| armhf | arm32v7-latest |
此镜像提供多种版本,可通过标签获取。latest标签通常提供最新稳定版本。其他标签被视为开发版本,使用时需谨慎。
| 标签 | 描述 |
|---|---|
| latest | Sonarr的稳定版本(当前为v2) |
| develop | Sonarr的开发版本(当前为v2) |
| preview | Sonarr的预览版本(当前为v3) |
| 5.14 | Sonarr稳定版本,但运行在Mono 5.14上 |
以下是一些示例代码片段,帮助您开始创建容器。
docker create \ --name=sonarr \ -e PUID=1000 \ -e PGID=1000 \ -e TZ=Europe/London \ -e UMASK_SET=022 `#可选` \ -p 8989:8989 \ -v /path/to/data:/config \ -v /path/to/tvseries:/tv \ -v /path/to/downloadclient-downloads:/downloads \ --restart unless-stopped \ linuxserver/sonarr
兼容docker-compose v2架构。
--- version: "2.1" services: sonarr: image: linuxserver/sonarr container_name: sonarr environment: - PUID=1000 - PGID=1000 - TZ=Europe/London - UMASK_SET=022 #可选 volumes: - /path/to/data:/config - /path/to/tvseries:/tv - /path/to/downloadclient-downloads:/downloads ports: - 8989:8989 restart: unless-stopped
容器镜像通过运行时传递的参数进行配置(如上所示)。这些参数用冒号分隔,表示<外部>:<内部>。例如,-p 8080:80会将容器内的端口80暴露出来,可通过主机IP的8080端口访问。
| 参数 | 功能 |
|---|---|
-p 8989 | Sonarr Web界面的端口 |
-e PUID=1000 | 用户ID - 详见下方说明 |
-e PGID=1000 | 组ID - 详见下方说明 |
-e TZ=Europe/London | 指定使用的时区,例如Europe/London,Sonarr需要此参数 |
-e UMASK_SET=022 | 控制Sonarr创建的文件和目录的权限 |
-v /config | 数据库和Sonarr配置文件 |
-v /tv | 磁盘上电视库的位置(见应用设置中的说明) |
-v /downloads | 下载管理器输出目录的位置(见应用设置中的说明) |
您可以通过使用特殊前缀FILE__从文件设置任何环境变量。
例如:
-e FILE__PASSWORD=/run/secrets/mysecretpassword
将根据/run/secrets/mysecretpassword文件的内容设置环境变量PASSWORD。
对于我们所有的镜像,您可以使用可选的-e UMASK=022设置覆盖容器内启动的服务的默认umask设置。请记住,umask不是chmod,它基于其值减去权限,而不是添加。在请求支持之前,请在此了解更多信息。
使用卷(-v标志)时,主机OS和容器之间可能会出现权限问题,我们通过允许您指定用户PUID和组PGID来避免此问题。
确保主机上的任何卷目录都由您指定的相同用户拥有,任何权限问题都将迎刃而解。
在这种情况下,PUID=1000和PGID=1000,要查找您的ID,请使用id user,如下所示:
$ id username uid=1000(dockeruser) gid=1000(dockergroup) groups=1000(dockergroup)
通过<您的IP>:8989访问Web界面,更多信息请查看Sonarr。
特别说明:按照我们当前的文件夹结构,由于下载目录和电视目录位于不同的卷上,将无法从下载目录硬链接到电视目录。要支持硬链接,只需确保电视和下载数据位于单个卷上。例如,如果您有/mnt/storage/TV和/mnt/storage/downloads/completed/TV,您可以将/mnt/storage:/media作为卷。然后您可以从/media/downloads/completed硬链接到/media/TV。
另一个需要注意的是,在Sonarr中,您应该将 torrent客户端文件夹映射到Sonarr文件夹:设置 -> 下载客户端 -> 高级 -> 远程路径映射。输入下载客户端的主机(与定义的下载客户端匹配),远程路径是/downloads/TV(相对于内部容器路径),本地路径是/media/downloads/completed/TV(假设您有文件夹来分离下载的数据类型)。
https://img.shields.io/badge/dynamic/yaml?color=94398d&labelColor=555555&logoColor=ffffff&style=for-the-badge&label=mods&query=%24.mods%5B%27sonarr%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%9C%A8%E5%AE%B9%E5%99%A8%E5%86%85%E5%90%AF%E7%94%A8%E9%A2%9D%E5%A4%96%E5%8A%9F%E8%83%BD%E3%80%82%E6%AD%A4%E9%95%9C%E5%83%8F%E5%8F%AF%E7%94%A8%E7%9A%84Mods%E5%88%97%E8%A1%A8%EF%BC%88%E5%A6%82%E6%9C%89%EF%BC%89%E5%8F%AF%E9%80%9A%E8%BF%87%E4%B8%8A%E6%96%B9%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 sonarr /bin/bashdocker logs -f sonarrdocker inspect -f '{{ index .Config.Labels "build_version" }}' sonarrdocker inspect -f '{{ index .Config.Labels "build_version" }}' linuxserver/sonarr我们的大多数镜像是静态的、版本化的,需要更新镜像并重新创建容器才能更新内部的应用程序。除了一些例外(如nextcloud、plex),我们不建议或支持在容器内更新应用程序。请参考上方的应用设置部分,了解是否推荐对此镜像进行应用更新。
以下是更新容器的说明:
docker pull linuxserver/sonarrdocker stop sonarrdocker rm sonarr/config文件夹和设置将被保留)docker start sonarrdocker image prunedocker-compose pull
docker-compose pull sonarrdocker-compose up -d
docker-compose up -d sonarrdocker image prunedocker run --rm \ -v /var/run/docker.sock:/var/run/docker.sock \ containrrr/watchtower \ --run-once sonarr
注意: 我们不认可使用Watchtower作为现有Docker容器自动更新的解决方案。事实上,我们通常不鼓励自动更新。但是,对于您忘记原始参数的容器,这是一个有用的一次性手动更新工具。从长远来看,我们强烈建议使用Docker Compose。
docker image prune如果您想对这些镜像进行本地修改以用于开发目的或自定义逻辑:
git clone https://github.com/linuxserver/docker-sonarr.git cd docker-sonarr docker build \ --no-cache \ --pull \ -t linuxserver/sonarr:latest .
ARM变体可以使用multiarch/qemu-user-static在x86_64硬件上构建
docker run --rm --privileged multiarch/qemu-user-static:register --reset
注册后,您可以使用-f Dockerfile.aarch64指定要使用的dockerfile。
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本,请访问 标签列表页面。

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