nowsci/plex-db-sync

plex-db-sync

镜像概述和主要用途

plex-db-sync是一款用于同步两个Plex服务器数据库观看状态的工具，可同步包括观看时间在内的观看进度信息，适用于系统上的所有用户，且无需额外配置Plex令牌。

核心功能和特性

• 跨服务器同步：同步两个Plex服务器间的观看状态，包括观看时间和进度
• 全用户支持：自动同步系统中所有用户的观看数据，无需逐一配置
• 无令牌需求：无需获取和配置Plex令牌即可实现同步功能
• 服务自动管理：同步过程中自动停止/启动Plex服务，确保数据一致性
• 灵活部署：支持直接脚本运行和Docker容器化部署两种方式
• 定时同步：可通过CRON表达式配置定时执行同步任务

使用场景和适用范围

适用于需要在多个Plex服务器间保持观看进度一致的场景，例如：

• 家庭多Plex服务器环境下的观看状态统一
• 本地与远程Plex服务器间的观看数据同步
• 需要跨设备/服务器保持观看进度的个人或家庭用户

详细使用方法和配置说明

直接使用脚本

1. 环境准备
   安装必要依赖工具：

   bash
   apt-get install sshfs sqlite3
   

2. 挂载远程数据库
   通过sshfs挂载远程Plex服务器的数据库目录至本地：

   bash
   mkdir -p /mnt/sshfs
   sshfs -o allow_other,IdentityFile=/keys/serverkey -p 22 \
     root@hostname.tld:"/var/lib/plexmediaserver/Library/Application Support/Plex Media Server/Plug-in Support/Databases/" \
     /mnt/sshfs
   

3. 执行同步脚本
   下载并运行脚本，指定服务器数据库路径及启停命令：

   bash
   wget https://raw.githubusercontent.com/Fmstrat/plex-db-sync/master/plex-db-sync
   chmod +x plex-db-sync
   ./plex-db-sync \
     --plex-db-1 "/mnt/sshfs/com.plexapp.plugins.library.db" \
     --plex-start-1 "ssh -oStrictHostKeyChecking=no -i /keys/serverkey root@hostname.tld service plexmediaserver start" \
     --plex-stop-1 "ssh -oStrictHostKeyChecking=no -i /keys/serverkey root@hostname.tld service plexmediaserver stop" \
     --plex-db-2 "/data/docker/containers/plex/config/Library/Application Support/Plex Media Server/Plug-in Support/Databases/com.plexapp.plugins.library.db" \
     --plex-start-2 "service plexmediaserver start" \
     --plex-stop-2 "service plexmediaserver stop"
   

注意：脚本会短暂停止并重启Plex服务以应用更新，通常不会影响正在播放的客户端（首次大规模同步可能有短暂影响）。

Docker部署

通过docker-compose实现容器化部署，适用于本地与远程服务器同步场景：

yaml
version: '2'

services:
  plex-db-sync:
    image: nowsci/plex-db-sync
    container_name: plex-db-sync
    volumes:
      - /etc/localtime:/etc/localtime:ro  # 同步系统时区
      - ./plex-db-sync/sshkey:/sshkey      # SSH密钥挂载
      - /docker/plex/Library/Application Support/Plex Media Server/Plug-in Support/Databases/:/mnt/DB2  # 本地数据库路径
    cap_add:
      - SYS_ADMIN  # 允许文件系统挂载
    devices:
      - /dev/fuse   # 提供fuse设备支持
    security_opt:
      - apparmor:unconfined  # 禁用AppArmor限制
    environment:
      - CRON=0 4 * * *  # 每天凌晨4点执行同步
      - S1_SSH_KEY=/sshkey  # 远程服务器SSH密钥路径
      - S1_SSH_USER=root    # 远程服务器SSH用户
      - S1_SSH_HOST=hostname  # 远程服务器主机名/IP
      - S1_SSH_PORT=22       # 远程服务器SSH端口
      - S1_SSH_PATH=/docker/plex/Library/Application Support/Plex Media Server/Plug-in Support/Databases  # 远程数据库路径
      - S1_START=ssh -oStrictHostKeyChecking=no -i /sshkey root@hostname 'cd /docker; docker-compose up -d plex'  # 远程Plex启动命令
      - S1_STOP=ssh -oStrictHostKeyChecking=no -i /sshkey root@hostname 'cd /docker; docker-compose stop plex'   # 远程Plex停止命令
      - S2_DB_PATH=/mnt/DB2  # 本地数据库路径
      - S2_START=cd /docker; docker-compose up -d plex  # 本地Plex启动命令
      - S2_STOP=cd /docker; docker-compose stop plex    # 本地Plex停止命令
    restart: always

配置参数说明