mdhiggins/plexautoskip-docker

PlexAutoSkip Docker容器

概述

PlexAutoSkip是一个专为Plex媒体服务器设计的Docker容器，旨在通过自动检测和跳过媒体内容中的不需要部分（如片头、片尾和广告）来增强用户的媒体观看体验。该容器可以无缝集成到现有的Plex生态系统中，无需修改Plex服务器本身即可提供自动跳过功能。

核心功能与特性

• 自动内容识别：智能检测电视节目和电影中的片头、片尾段落
• 广告跳过：自动识别并跳过视频内容中的广告片段
• 自定义跳过规则：允许用户根据个人偏好配置跳过规则
• Plex集成：与Plex媒体服务器API无缝对接
• 轻量级设计：资源占用低，不影响Plex服务器性能
• 无侵入式安装：无需修改Plex服务器核心文件或配置
• 跨平台支持：可在任何支持Docker的操作系统上运行

适用场景

• 希望提升Plex媒体观看体验的家庭用户
• 经常观看电视连续剧，希望自动跳过片头片尾的用户
• 拥有包含广告内容的媒体库，希望自动去除广告的用户
• Plex服务器管理员希望为用户提供增值功能而不增加服务器负担

安装与使用

前提条件

• 运行中的Plex媒体服务器
• Docker引擎 (18.06.0+ 或更高版本)
• Docker Compose (可选，用于简化部署)
• 网络连接（用于获取容器镜像和更新）

基本部署 (Docker Run)

bash
docker run -d \
  --name=plexautoskip \
  -e PLEX_URL=http://your-plex-server-ip:32400 \
  -e PLEX_TOKEN=your-plex-token \
  -e SKIP_INTRO=true \
  -e SKIP_OUTRO=true \
  -e SKIP_ADS=true \
  -v /path/to/config:/config \
  --restart unless-stopped \
  plexautoskip/plexautoskip:latest

Docker Compose 部署

创建docker-compose.yml文件：

yaml
version: '3'
services:
  plexautoskip:
    image: plexautoskip/plexautoskip:latest
    container_name: plexautoskip
    environment:
      - PLEX_URL=http://your-plex-server-ip:32400
      - PLEX_TOKEN=your-plex-token
      - SKIP_INTRO=true
      - SKIP_OUTRO=true
      - SKIP_ADS=true
      - LOG_LEVEL=info
    volumes:
      - /path/to/your/config:/config
    restart: unless-stopped

启动服务：

bash
docker-compose up -d

配置参数

环境变量

卷挂载

获取Plex访问令牌

要使用PlexAutoSkip，您需要获取Plex服务器的访问令牌：

1. 登录到您的Plex账户
2. 访问 [***]
3. 打开浏览器开发者工具 (F12)
4. 切换到"网络"标签
5. 在Plex界面中执行某个操作（如播放媒体）
6. 在网络请求中找到包含"X-Plex-Token"参数的请求
7. 复制该参数的值作为您的PLEX_TOKEN

故障排除

容器无法连接到Plex服务器

• 确保PLEX_URL参数正确，包括正确的IP地址和端口
• 验证Plex服务器是否正在运行且可从容器网络访问
• 检查Plex服务器的网络设置，确保允许来自容器IP的连接

跳过功能不工作

• 检查日志文件以获取详细错误信息
• 验证PLEX_TOKEN是否有效且具有适当权限
• 确认媒体文件已被Plex正确识别和元数据匹配
• 尝试更新到最新版本的PlexAutoSkip容器

更新

要更新PlexAutoSkip容器，请执行以下命令：

bash
# 停止并删除现有容器
docker stop plexautoskip
docker rm plexautoskip

# 拉取最新镜像
docker pull plexautoskip/plexautoskip:latest

# 使用原始命令重新启动容器
docker run -d [your-options] plexautoskip/plexautoskip:latest

对于Docker Compose部署：

bash
docker-compose pull
docker-compose up -d