xanderstrike/goplaxt

Plaxt

概述

注意：由于Trakt现在官方支持Plex Webhooks，该项目不再开发。非Trakt VIP用户仍可使用，会继续合并PR但可能不回复问题。

Plaxt是一个接收Plex webhook并将播放记录同步到Trakt账户的工具。Plex为Plex Pass订阅者和服务器用户提供webhook集成，当用户执行观看电影或剧集等操作时，Plex会发送webhook请求，Plaxt接收这些请求并将播放记录记录到Trakt账户。

该工具是作者之前版本的Go语言重写，支持Docker部署，可在个人基础设施（如Plex服务器）上运行。非Trakt VIP用户可访问plaxt.astandke.com输入Plex用户名开始使用官方实例。

核心功能与特性

• Plex Webhook接收：接收Plex用户操作（如观看电影/剧集）触发的webhook请求
• Trakt同步：将Plex播放记录同步到用户Trakt账户
• 技术栈：Go语言编写，轻量高效
• 部署便捷：Docker容器化，支持在个人Plex服务器上部署

使用场景与适用范围

• 适用用户：非Trakt VIP用户（Trakt官方Plex Scrobbler需VIP）
• 核心需求：希望将Plex观看历史自动、实时同步到Trakt账户的用户
• 部署环境：可部署在个人Plex服务器或其他支持Docker的设备（包括ARM架构设备如树莓派）

部署与使用方法

前提条件

1. 创建Trakt API应用：访问Trakt OAuth应用页面，设置Allowed Hostnames为访问Plaxt的URI加/authorize（如http://10.20.30.40:8000/authorize），确保Plaxt实例可被所有Plex服务器访问

Docker部署

直接运行容器

bash
docker create \
  --name=plaxt \
  --restart always \
  -v <本地配置路径>:/app/keystore \
  -e TRAKT_ID=<trakt应用ID> \
  -e TRAKT_SECRET=<trakt应用密钥> \
  -e ALLOWED_HOSTNAMES=<公共主机名，逗号或空格分隔> \
  -p 8000:8000 \
  xanderstrike/goplaxt:latest

启动容器：

bash
docker start plaxt

ARM架构设备（如树莓派）

使用ARM7镜像：

bash
docker create \
  --name=plaxt \
  --restart always \
  -v <本地配置路径>:/app/keystore \
  -e TRAKT_ID=<trakt应用ID> \
  -e TRAKT_SECRET=<trakt应用密钥> \
  -e ALLOWED_HOSTNAMES=<公共主机名，逗号或空格分隔> \
  -p 8000:8000 \
  xanderstrike/goplaxt:latest-arm7

Docker Compose配置

yaml
version: "3.4"
services:
  plaxt:
    container_name: plaxt
    environment:
    - TRAKT_ID=<trakt应用ID>
    - TRAKT_SECRET=<trakt应用密钥>
    - ALLOWED_HOSTNAMES=<公共主机名，逗号或空格分隔>
    image: xanderstrike/goplaxt
    ports:
    - 8000:8000
    restart: unless-stopped
    volumes:
    - <本地配置路径>:/app/keystore

参数说明

• 卷挂载：-v <本地配置路径>:/app/keystore：存储配置和密钥
• 环境变量：
  • TRAKT_ID：Trakt API应用ID
  • TRAKT_SECRET：Trakt API应用密钥
  • ALLOWED_HOSTNAMES：允许的主机名（逗号或空格分隔）
• 端口映射：-p 8000:8000：Plaxt服务端口

安全说明

使用官方实例时，服务方会永久保留用户Plex用户名和用于添加播放记录的Trakt API密钥，临时记录观看内容日志（电影标题/年份、剧集标题/季数/集数），日志24小时轮换删除。信息不会离开服务器，建议隐私敏感用户自行部署。

许可证

MIT许可