Plex Rewind 安装与配置指南
项目基础介绍
Plex Rewind 是一个开源项目,它能够以美丽和组织的方式展示 Plex 用户的使用统计数据和习惯。这个项目受到了 Spotify Wrapped 和 Tautulli 的启发,使用 Next.js 和 Tailwind.css 构建了一个基于 Web 的应用程序。它利用了 Tautulli、Overseerr 和 Plex 提供的数据。
主要编程语言
该项目主要使用 TypeScript 进行开发,同时使用了 CSS 和 JavaScript。
项目使用的关键技术和框架
- Next.js: 用于构建服务端渲染的 React 应用程序。
- Tailwind.css: 一个功能类优先的 CSS 框架,用于快速UI开发。
- Docker: 容器化技术,用于简化部署和扩展。
- NextAuth.js: 用于处理身份验证和会话管理。
- Framer Motion: 用于创建动画和交互动效。
- Overseerr API: 集成 Overseerr 功能,显示请求 breakdown 和总数。
- Tautulli API: 统计数据的后端支持。
项目安装和配置的准备工作
在开始安装之前,请确保您的系统满足以下要求:
- Docker 环境已经安装并配置正确。
- 如果您打算在互联网上公开应用,您需要有一个域名和 SSL 证书。
详细的安装步骤
-
克隆项目仓库
打开命令行工具,运行以下命令克隆项目:
git clone https://github.com/RaunoT/plex-rewind.git cd plex-rewind
-
创建 Docker Compose 文件
在项目目录中,创建一个
docker-compose.yml
文件,并添加以下内容:version: '3.8' services: plex-rewind: image: ghcr.io/raunot/plex-rewind:latest container_name: plex-rewind environment: - NEXTAUTH_SECRET=your_secret - NEXTAUTH_URL=http://localhost:8383 - NEXT_PUBLIC_SITE_URL=http://localhost:8383 ports: - "8383:8383" volumes: - ./config:/app/config restart: unless-stopped
请将
your_secret
替换为使用openssl rand -base64 32
生成的一个随机字符串。 -
启动容器
在命令行中,运行以下命令来启动应用:
docker-compose up -d
-
访问应用
应用启动后,您可以通过浏览器访问
http://localhost:8383
来查看 Plex Rewind。 -
配置域名(可选)
如果您打算将应用部署到互联网,请将
NEXTAUTH_URL
和NEXT_PUBLIC_SITE_URL
环境变量更改为您的域名,并确保您的 DNS 设置正确,SSL 证书已经安装。
按照以上步骤操作,您应该能够成功安装并运行 Plex Rewind。如果遇到任何问题,请查看项目的 README.md
文件或访问项目的问题页面以获取帮助。