PlexTraktSync项目中使用Ofelia调度器的最佳实践

背景介绍

PlexTraktSync是一个用于同步Plex媒体库与Trakt.tv服务的工具。在实际部署中，用户经常需要设置定时任务来自动执行同步操作。Ofelia是一个基于Docker的作业调度工具，常被用来管理PlexTraktSync的定时任务。

常见配置问题分析

在配置Ofelia调度器与PlexTraktSync协同工作时，开发者经常会遇到"找不到容器"的错误。这通常是由于Docker Compose配置中的一些细节处理不当导致的。

典型错误表现

当查看Ofelia调度器的日志时，可能会看到如下错误信息：

ERROR [Job "plextraktsync"] Finished in "963.091µs", failed: true, skipped: false, error: No such container: plextraktsync

问题根源

这种错误通常源于以下几个配置问题：

1. Docker Compose Profile使用不当：如果在PlexTraktSync服务配置中启用了profile功能但未正确激活，会导致容器无法被Ofelia发现。

2. 容器命名不一致：Ofelia配置中指定的容器名称必须与Docker Compose中定义的服务名称完全匹配。

3. 容器生命周期管理：Ofelia只能调度当前正在运行的容器，如果目标容器未运行或已停止，调度将失败。

解决方案与最佳实践

1. 简化配置方案

对于大多数用户，最简单的解决方案是移除profile配置，确保容器始终可用：

plextraktsync:
    image: ghcr.io/taxel/plextraktsync
    command: sync
    container_name: plextraktsync
    volumes:
      - /configs/mediarr/plextraktsync:/app/config
    environment:
      - PUID=1000
      - PGID=1000
    depends_on:
      - plex

2. 正确使用Profile功能

如果确实需要使用profile功能，必须确保在启动服务时显式激活对应的profile：

docker-compose --profile schedule up -d

3. Ofelia配置优化

建议为Ofelia指定具体版本而非latest标签，避免因版本更新导致兼容性问题：

scheduler:
    image: mcuadros/ofelia:0.3.4
    container_name: scheduler
    command: daemon --docker
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock:ro

多服务器同步配置示例

以下是一个支持多服务器同步的完整配置示例：

version: '3'

services:
  plextraktsync:
    image: ghcr.io/taxel/plextraktsync
    container_name: plextraktsync
    volumes:
      - ./config:/app/config
    environment:
      - PUID=1000
      - PGID=1000

  scheduler:
    image: mcuadros/ofelia:0.3.4
    container_name: scheduler
    command: daemon --docker
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock:ro
    labels:
      ofelia.job-run.movies.schedule: "0 6,18 * * *"
      ofelia.job-run.movies.container: "plextraktsync"
      ofelia.job-run.movies.command: "--server '电影服务器' sync"
      ofelia.job-run.tvshows.schedule: "0 12,0 * * *"
      ofelia.job-run.tvshows.container: "plextraktsync"
      ofelia.job-run.tvshows.command: "--server '电视剧服务器' sync"

实施建议

1. 版本控制：为所有Docker镜像指定具体版本号，避免使用latest标签。

2. 日志监控：设置日志监控机制，确保能及时发现调度失败的情况。

3. 权限管理：确保Ofelia容器有足够的权限访问Docker守护进程。

4. 测试验证：在正式部署前，先使用较短的调度间隔进行测试验证。

通过遵循这些最佳实践，可以确保PlexTraktSync与Ofelia调度器的稳定协同工作，实现自动化媒体库同步。