trentferguson/homescreen-hero

Plex配套应用镜像文档

镜像概述

该镜像是一款自托管的Plex配套应用，旨在增强Plex媒体服务器的使用体验。它提供主屏幕管理、服务器运行状态监控及实用工具集，帮助用户更高效地管理Plex媒体库和优化使用体验。

核心功能与特性

• 主屏幕管理：支持自定义Plex主屏幕布局，调整内容展示顺序，个性化媒体浏览界面
• 服务器洞察：提供Plex服务器运行状态监控，包括资源占用、媒体库统计和用户活动分析
• 实用工具集：集成多种辅助工具，辅助媒体文件管理、元数据维护和服务器配置优化

使用场景与适用范围

• 个人Plex用户：需要个性化管理Plex界面和监控服务器状态的个人用户
• 家庭媒体中心：家庭环境中负责维护Plex媒体库的管理者
• 小型媒体服务：为少量用户提供Plex服务的小型媒体服务运营场景

使用方法与配置说明

基本部署示例

Docker Run命令

bash
docker run -d \
  --name plex-companion \
  -p 8080:8080 \
  -v /path/to/local/data:/app/data \
  -e PLEX_SERVER_URL=http://your-plex-server-ip:32400 \
  -e PLEX_TOKEN=your-plex-access-token \
  [镜像名称]:latest

Docker Compose配置

yaml
version: '3'
services:
  plex-companion:
    image: docker.xuanyuan.run/[镜像名称]:latest
    container_name: plex-companion
    ports:
      - "8080:8080"
    volumes:
      - /path/to/local/data:/app/data
    environment:
      - PLEX_SERVER_URL=http://your-plex-server-ip:32400
      - PLEX_TOKEN=your-plex-access-token
    restart: unless-stopped

配置参数说明

• 端口映射：默认使用8080端口，可根据需求调整宿主机端口映射
• 数据卷挂载：建议挂载本地目录到/app/data以持久化应用配置和数据
• 环境变量：
  • PLEX_SERVER_URL：Plex服务器访问地址（必填）
  • PLEX_TOKEN：Plex服务器访问令牌（必填，可从Plex账户设置中获取）

访问与使用

部署完成后，通过浏览器访问http://宿主机IP:8080即可打开应用界面，根据引导完成初始配置，包括连接Plex服务器、设置主屏幕布局和启用所需工具功能。

注意事项

• 确保Plex服务器与应用在同一网络环境或可相互访问
• 定期更新镜像以获取最新功能和安全修复
• 妥善保管Plex访问令牌，防止未授权访问