phueber/prefetcharr

Prefetcharr 镜像文档

概述和主要用途

Prefetcharr 是一款连接 Sonarr 与媒体服务器（Jellyfin/Emby/Plex）的工具镜像，旨在自动检测用户正在观看的剧集，触发 Sonarr 提前获取下一季内容，确保无缝的媒体观看体验，避免因内容缺失导致的观看中断。

核心功能和特性

• 媒体服务器集成：支持与 Jellyfin、Emby、Plex 主流媒体服务器对接，实时监控用户观看状态
• Sonarr 联动：通过 Sonarr API 自动发起下一季内容的搜索与下载请求
• 自动化流程：无需手动干预，全程自动检测观看进度并触发后续操作
• 兼容性广泛：适配主流媒体管理与播放生态，满足多平台用户需求

使用场景和适用范围

适用用户

• 使用 Sonarr 管理剧集资源的个人用户或家庭媒体中心管理员
• 通过 Jellyfin/Emby/Plex 构建私人媒体库的用户

典型场景

• 家庭媒体中心用户观看连续剧时，自动确保下一季内容在当前季结束前就绪
• 媒体服务器管理员减少手动管理剧集更新的工作量，提升用户体验

使用方法和配置说明

前提条件

• 已部署并运行 Sonarr 实例，且已配置 API 访问权限
• 已部署 Jellyfin/Emby/Plex 媒体服务器，且启用 API 服务
• 具备 Docker 运行环境（Docker Engine 20.10+ 或兼容容器平台）

Docker 部署示例

Docker Run 命令

bash
docker run -d \
  --name prefetcharr \
  -e SONARR_URL="http://your-sonarr-ip:8989" \
  -e SONARR_API_KEY="your-sonarr-api-key" \
  -e MEDIA_SERVER_TYPE="plex" \  # 可选值: plex/jellyfin/emby
  -e MEDIA_SERVER_URL="http://your-media-server-ip:32400" \  # 根据服务器类型调整端口
  -e MEDIA_SERVER_API_KEY="your-media-server-api-key" \
  -e CHECK_INTERVAL=3600 \  # 状态检查间隔（秒），默认3600
  p-hueber/prefetcharr

Docker Compose 配置

yaml
version: '3.8'
services:
  prefetcharr:
    image: docker.xuanyuan.run/p-hueber/prefetcharr
    container_name: prefetcharr
    environment:
      - SONARR_URL=http://sonarr:8989  # 若与Sonarr同网络可使用服务名
      - SONARR_API_KEY=your_sonarr_api_key_here
      - MEDIA_SERVER_TYPE=jellyfin
      - MEDIA_SERVER_URL=http://jellyfin:8096
      - MEDIA_SERVER_API_KEY=your_jellyfin_api_key_here
      - CHECK_INTERVAL=1800  # 30分钟检查一次
    restart: unless-stopped
    network_mode: "bridge"  # 或与媒体服务共用网络

核心配置参数说明

注意事项

• 确保 Sonarr 与媒体服务器的 API 路径可访问，防火墙需开放对应端口
• API 密钥需具有足够权限（Sonarr需允许添加/编辑系列，媒体服务器需允许读取播放状态）
• 网络延迟较高时建议适当延长检查间隔，避免无效请求
• 高级配置（如过滤器规则、通知设置等）请参考 https://github.com/p-hueber/prefetcharr 获取详细说明