stevezzau/plex_generate_vid_previews

Plex预览生成工具

为Plex媒体服务器提供GPU加速的视频预览缩略图生成功能。

问题：Plex内置的预览生成速度极慢。

解决方案：本工具利用GPU加速和并行处理技术，将预览生成速度提升5-10倍。

核心功能与特性

快速开始

bash
docker run -d \
  --name plex-generate-previews \
  --restart unless-stopped \
  -p 8080:8080 \
  --device /dev/dri:/dev/dri \
  -e PUID=1000 \
  -e PGID=1000 \
  -v /path/to/media:/media:ro \
  -v /path/to/plex/config:/plex:rw \
  -v /path/to/app/config:/config:rw \
  stevezzau/plex_generate_vid_previews:latest

然后打开 http://你的IP:8080，从容器日志中获取认证令牌，完成设置向导。

获取认证令牌

bash
docker logs plex-generate-previews | grep "Token:"

或通过 -e WEB_AUTH_TOKEN=你的密码 设置固定令牌。

卷挂载

Docker Compose配置

GPU配置（Intel / AMD / NVIDIA）

yaml
services:
  plex-previews:
    image: stevezzau/plex_generate_vid_previews:latest
    container_name: plex-generate-previews
    restart: unless-stopped
    ports:
      - "8080:8080"
    # Intel / AMD GPU (VAAPI)
    devices:
      - /dev/dri:/dev/dri
    # NVIDIA: 移除上方'devices'配置，取消下方注释
    # deploy:
    #   resources:
    #     reservations:
    #       devices:
    #         - driver: nvidia
    #           count: all
    #           capabilities: [gpu]
    environment:
      # NVIDIA专用（使用NVIDIA时取消注释）:
      # - NVIDIA_VISIBLE_DEVICES=all
      # - NVIDIA_DRIVER_CAPABILITIES=compute,video,utility
      - PUID=1000
      - PGID=1000
    volumes:
      - /path/to/your/media:/media:ro
      - /path/to/plex/config:/plex:rw
      - /path/to/app/config:/config:rw

仅CPU配置

yaml
services:
  plex-previews:
    image: stevezzau/plex_generate_vid_previews:latest
    container_name: plex-generate-previews
    restart: unless-stopped
    ports:
      - "8080:8080"
    environment:
      - GPU_THREADS=0
      - CPU_THREADS=8
      - PUID=1000
      - PGID=1000
    volumes:
      - /path/to/your/media:/media:ro
      - /path/to/plex/config:/plex:rw
      - /path/to/app/config:/config:rw

GPU支持

NVIDIA GPU配置

前提条件：安装NVIDIA驱动和NVIDIA Container Toolkit。

bash
docker run -d \
  --gpus all \
  -e NVIDIA_VISIBLE_DEVICES=all \
  -e NVIDIA_DRIVER_CAPABILITIES=compute,video,utility \
  -p 8080:8080 \
  -v /path/to/media:/media:ro \
  -v /path/to/plex/config:/plex:rw \
  -v /path/to/app/config:/config:rw \
  stevezzau/plex_generate_vid_previews:latest

GPU+CPU Fallback模式

将CPU工作线程设为0，CPU Fallback工作线程设为1（或更高），可使主要处理在GPU上进行，同时允许CPU重试不支持的编解码器。

环境变量

所有设置可在Web界面（设置页面）配置。环境变量为可选覆盖项。

Unraid配置

在Community Applications中搜索"plex-generate-previews"，或手动运行：

bash
docker run -d \
  --name plex-generate-previews \
  --restart unless-stopped \
  -p 8080:8080 \
  --device /dev/dri:/dev/dri \
  -e WEB_AUTH_TOKEN=我的密码 \
  -e PUID=99 \
  -e PGID=100 \
  -v /mnt/user/data/plex:/data/plex:ro \
  -v "/mnt/cache/appdata/plex/Library/Application Support/Plex Media Server":/plex:rw \
  -v /mnt/user/appdata/plex-generate-previews:/config:rw \
  stevezzau/plex_generate_vid_previews:latest

性能调优

可在Web界面的设置中配置。

重要注意事项

• 不要使用init: true：此容器使用s6-overlay，init: true会导致故障。
• 使用主机IP访问Plex：容器无法访问主机的localhost，请使用http://192.168.1.100:32400，而非http://localhost:32400。
• 推荐Plex设置：在Plex设置中将"生成视频预览缩略图"设为从不，本工具将通过GPU加速替代该功能。

文档

完整文档请参见GitHub：

• https://github.com/stevezau/plex_generate_vid_previews/blob/main/docs/getting-started.md — Docker、GPU、Unraid、开发容器配置
• https://github.com/stevezau/plex_generate_vid_previews/blob/main/docs/reference.md — 所有设置和REST API
• https://github.com/stevezau/plex_generate_vid_previews/blob/main/docs/guides.md — Web界面、Webhook、常见问题

支持

• https://github.com/stevezau/plex_generate_vid_previews/issues/new?labels=bug
• https://github.com/stevezau/plex_generate_vid_previews/issues/new?labels=enhancement
• https://github.com/stevezau/plex_generate_vid_previews

许可证

MIT许可证。详情参见https://github.com/stevezau/plex_generate_vid_previews/blob/main/LICENSE%E3%80%82