
如果你使用 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 无法访问外链,可 打开说明文档 复制全文粘贴。文档会随站点更新,复制内容可能过期,建议定期检查。
Medusa 是一个电视剧集自动视频库管理器,能够监控您喜爱剧集的新集发布,并在发布时自动执行下载等管理操作。
!https://raw.githubusercontent.com/linuxserver/docker-templates/master/linuxserver.io/img/medusa-icon.png
LinuxServer.io团队提供的此容器具有以下特点:
我们利用docker manifest实现多平台支持。只需拉取 lscr.io/linuxserver/medusa:latest 即可获取适合您架构的正确镜像,也可通过标签拉取特定架构的镜像。
支持的架构:
| 架构 | 可用 | 标签 |
|---|---|---|
| x86-64 | ✅ | amd64-<version tag> |
| arm64 | ✅ | arm64v8-<version tag> |
| armhf | ❌ |
Web界面地址为 <您的IP>:8081。
通过Web界面设置下载路径和电视剧集路径,确保与Docker映射路径匹配,更多信息请查看 Medusa官方网站。
您可以使用docker-compose(推荐)或docker cli来创建容器。
yaml--- version: "2.1" services: medusa: image: docker.xuanyuan.run/linuxserver/medusa:latest container_name: medusa environment: - PUID=1000 - PGID=1000 - TZ=Etc/UTC volumes: - /path/to/data:/config - /path/to/downloads:/downloads - /path/to/tv/shows:/tv ports: - 8081:8081 restart: unless-stopped
bashdocker run -d \ --name=medusa \ -e PUID=1000 \ -e PGID=1000 \ -e TZ=Etc/UTC \ -p 8081:8081 \ -v /path/to/data:/config \ -v /path/to/downloads:/downloads \ -v /path/to/tv/shows:/tv \ --restart unless-stopped \ docker.xuanyuan.run/linuxserver/medusa:latest
容器通过运行时传递的参数进行配置,格式为 <外部>:<内部>。
| 参数 | 功能 |
|---|---|
-p 8081 | Medusa Web界面端口 |
-e PUID=1000 | 用户ID - 详见下方说明 |
-e PGID=1000 | 组ID - 详见下方说明 |
-e TZ=Etc/UTC | 指定时区,详见 时区列表 |
-v /config | Medusa配置文件目录 |
-v /downloads | 下载文件存放目录 |
-v /tv | 电视剧集存放目录 |
您可以使用特殊前缀 FILE__ 从文件设置任何环境变量。例如:
bash-e FILE__MYVAR=/run/secrets/mysecretvariable
这将根据 /run/secrets/mysecretvariable 文件的内容设置环境变量 MYVAR。
我们所有的镜像都提供了使用可选参数 -e UMASK=022 覆盖容器内服务默认umask设置的功能。请注意,umask不是chmod,它基于其值减去权限而非添加。请在请求支持前查阅 umask相关资料。
使用卷(-v 标志)时,主机操作系统和容器之间可能会出现权限问题。通过指定用户 PUID 和组 PGID 可以避免此问题。
确保主机上的任何卷目录都由您指定的相同用户拥有,权限问题将迎刃而解。
在此示例中 PUID=1000 和 PGID=1000,要查找您的ID,请使用 id your_user:
bashid your_user
示例输出:
textuid=1000(your_user) gid=1000(your_user) groups=1000(your_user)
https://img.shields.io/badge/dynamic/yaml?color=94398d&labelColor=555555&logoColor=ffffff&style=for-the-badge&label=medusa&query=%24.mods%5B%27medusa%27%5D.mod_count&url=https%3A%2F%2Fraw.githubusercontent.com%2Flinuxserver%2Fdocker-mods%2Fmaster%2Fmod-list.yml](https://mods.linuxserver.io/?mod=medusa "查看此容器可用的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](https://mods.linuxserver.io/?mod=universal "查看可用的通用mods")
我们发布了各种 https://github.com/linuxserver/docker-mods 以启用容器内的附加功能。上述动态徽章可访问此镜像可用的Mods列表(如有)以及可应用于我们任何镜像的通用Mods。
容器运行时的Shell访问:
bashdocker exec -it medusa /bin/bash
实时监控容器日志:
bashdocker logs -f medusa
容器版本号:
bashdocker inspect -f '{{ index .Config.Labels "build_version" }}' medusa
镜像版本号:
bashdocker inspect -f '{{ index .Config.Labels "build_version" }}' lscr.io/linuxserver/medusa:latest
我们的大多数镜像是静态的、版本化的,需要更新镜像并重新创建容器才能更新内部应用。除某些例外(如nextcloud、plex),我们不建议或支持在容器内更新应用。请查阅上述【应用设置】部分,了解是否推荐对此镜像进行应用更新。
以下是更新容器的说明:
更新镜像:
所有镜像:
bashdocker-compose pull
单个镜像:
bashdocker-compose pull medusa
更新容器:
所有容器:
bashdocker-compose up -d
单个容器:
bashdocker-compose up -d medusa
您还可以删除旧的悬空镜像:
bashdocker image prune
更新镜像:
bashdocker pull docker.xuanyuan.run/linuxserver/medusa:latest
停止运行中的容器:
bashdocker stop medusa
删除容器:
bashdocker rm medusa
使用上述相同的docker run参数重新创建新容器(如果正确映射到主机文件夹,您的 /config 文件夹和设置将被保留)
您还可以删除旧的悬空镜像:
bashdocker image prune
拉取最新标签镜像并使用相同的环境变量替换:
bashdocker run --rm \ -v /var/run/docker.sock:/var/run/docker.sock \ docker.xuanyuan.run/containrrr/watchtower \ --run-once medusa
您还可以删除旧的悬空镜像:docker image prune
警告:我们不认可使用Watchtower作为现有Docker容器自动更新的解决方案。事实上,我们通常不鼓励自动更新。但是,对于忘记原始参数的容器,这是一个有用的一次性手动更新工具。长期来看,我们强烈建议使用 https://docs.linuxserver.io/general/docker-compose%E3%80%82
提示:我们推荐 https://crazymax.dev/diun/ 用于更新通知。不推荐或支持其他自动更新容器的工具。
如果您想对这些镜像进行本地修改以用于开发目的或自定义逻辑:
bashgit clone https://github.com/linuxserver/docker-medusa.git cd docker-medusa docker build \ --no-cache \ --pull \ -t lscr.io/linuxserver/medusa:latest .
可以使用 multiarch/qemu-user-static 在x86_64硬件上构建ARM变体:
bashdocker run --rm --privileged docker.xuanyuan.run/multiarch/qemu-user-static:register --reset
注册后,您可以使用 -f Dockerfile.aarch64 指定要使用的dockerfile。
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本,请访问 标签列表页面。
来自真实用户的反馈,见证轩辕镜像的优质服务