bozodev/posteria Docker 镜像 - 轩辕镜像 | Docker 镜像高效稳定拉取服务

Posteria

Posteria是一款基于Web的媒体海报管理系统，允许用户组织和存储电影、电视剧、季和合集的自定义海报。它提供了优雅的界面，用于上传、导入、管理和访问媒体 artwork。

核心功能与特性

• 🖥️ 简洁现代的媒体海报管理界面
• 📁 按电影、电视剧、电视季和合集分类组织
• 🔍 快速模糊搜索功能
• 📱 移动响应式设计
• 📲 可作为渐进式Web应用（PWA）安装
• 🔒 简单的身份验证系统
• ⚡ 支持从本地文件或URL轻松上传海报
• 🎬 直接从TMDB、TVDB和Fanart.tv获取海报
• 📥 从Plex导入海报
• 🔄 海报在Plex中自动更新
• 🤖 支持计划自动导入
• 🧹 孤立海报检测功能
• 🎨 支持JPG、JPEG、PNG和WebP格式
• 🖼️ 内置海报墙，用于展示您的海报
• 🛒 在Unraid社区应用商店中可用
  • 感谢@ctrlaltd1337ed的贡献。

安装

1. 创建docker-compose.yml文件，内容如下：

yaml
services:
  posteria:
    image: bozodev/posteria:latest
    container_name: posteria
    ports:
      - "1818:80"
    environment:
      - SITE_TITLE=Posteria

      - AUTH_USERNAME=admin # 请修改此项！
      - AUTH_PASSWORD=changeme # 请修改此项！
      - SESSION_DURATION=3600 # 单位为秒
      - AUTH_BYPASS=false # 若将Posteria暴露在本地网络外，请勿启用

      - PUID=1000 # 指定用户ID
      - PGID=1000 # 指定组ID
      - TZ=Etc/UTC # 指定时区

      - IMAGES_PER_PAGE=24
      - MAX_FILE_SIZE=5242880 # 单位为字节

      - PLEX_SERVER_URL=
      - PLEX_TOKEN=
      - PLEX_REMOVE_OVERLAY_LABEL=false # 为兼容Kometa，请设为true

      - IGNORE_ARTICLES_IN_SORT=true # 设为false可在排序时包含冠词（A、An、The）
      - SORT_BY_DATE_ADDED=false # 设为true可按Plex中的"最近添加"日期排序，而非按字母顺序

      - AUTO_IMPORT_ENABLED=false # 启用/禁用自动导入
      - AUTO_IMPORT_SCHEDULE=1h # 计划选项：24h、12h、6h、3h、1h
      - AUTO_IMPORT_MOVIES=false # 导入电影海报
      - AUTO_IMPORT_SHOWS=false # 导入电视剧海报
      - AUTO_IMPORT_SEASONS=false # 导入电视季海报
      - AUTO_IMPORT_COLLECTIONS=false # 导入合集海报
    volumes:
      - ./posters:/config/posters
      - ./data:/config/data # 日志存放于此
    restart: unless-stopped

2. 启动容器：

bash
docker-compose up -d

配置

环境变量

注意：

PUID 和 PGID

使用卷挂载（-v 标志）时，主机操作系统和容器之间可能出现权限问题。通过指定用户PUID和组PGID，可以避免此问题。

确保主机上的卷目录由您指定的用户拥有，权限问题将迎刃而解。

您可以通过以下命令查看当前用户的PUID和PGID：

bash
id your_user

示例输出：

text
uid=1000(your_user) gid=1000(your_user) groups=1000(your_user)

PLEX_REMOVE_OVERLAY_LABEL

控制Posteria在更新海报时是否移除Plex中的"覆盖"标签。"覆盖"标签用于Kometa在更新海报时重新应用覆盖层。如果您使用Kometa，请设为true。

更多信息

卷挂载

Docker容器使用以下卷挂载：

• /config/posters：存储海报
• /config/data：存储日志

使用方法

1. 通过http://your-server:1818访问Web界面
2. 使用配置的凭据登录
3. 从Plex导入海报
4. 更改海报：
   • 支持本地文件上传
   • 支持直接URL上传
   • 从TMDB、TVDB和Fanart.tv获取海报
5. 海报会自动更新到Plex
6. 当您向Plex添加更多媒体时，只需重新导入即可添加新海报
7. 使用孤立海报检测功能管理冗余海报

常见问题

Posteria如何与Plex交互？

Posteria可以直接从Plex媒体服务器导入海报，并将自定义海报同步回Plex。要启用此功能，需在配置中提供Plex服务器URL和身份验证令牌。这允许Posteria与服务器安全通信，同时保留所有自定义设置。

请注意，Posteria将Plex视为海报的"事实来源"。因此，在Plex中直接或通过其他工具对海报所做的任何更改，都会在下次导入时覆盖Posteria中的海报。

为防止Plex在元数据刷新时更改海报，Posteria更新的任何海报都会在Plex中被锁定。

如何找到Plex身份验证令牌？

您可以通过以下步骤找到Plex身份验证令牌（X-Plex-Token）：

1. 登录Plex Web应用
2. 浏览到任何媒体项
3. 点击三点菜单，选择"获取信息"
4. 在信息对话框中，点击"查看XML"
5. 在新标签页的URL中，找到"X-Plex-Token="参数

有关详细说明，请访问Plex支持文章。

可以将Posteria用作Plex海报的备份吗？

不可以，Posteria不应被视为Plex海报的备份。Posteria将Plex视为"事实来源"，这意味着在Plex中所做的任何更改（无论是直接还是通过其他工具）都会在下次导入（计划或手动）时自动同步到Posteria，并覆盖Posteria中不同的海报选择。我们强烈建议分别备份Plex元数据和Posteria海报目录，以确保在需要时可以恢复您偏好的海报选择。

什么是"孤立检测"？

孤立检测是一项帮助您识别Posteria中未链接到Plex媒体库中任何媒体的海报的功能。当您从库中删除内容但海报仍保留在Posteria中时，可能会出现这种情况。Posteria可以检测这些孤立海报，让您决定是保留它们供将来使用还是删除以节省空间。

Posteria的安全性如何？

Posteria包含基本身份验证以保护您的海报集合。您可以在docker-compose.yml文件中设置用户名和密码。建议修改默认凭据并使用强密码。与Plex服务器的所有通信均使用Plex身份验证令牌安全进行。

如果您想将Posteria暴露在网络外部，建议使用Tailscale™ 或其他***解决方案。

如何更新Posteria？

要将Posteria更新到最新版本，请按照以下步骤操作：

1. 导航到Posteria目录
2. 运行docker-compose pull下载最新镜像
3. 运行docker-compose up -d以新版本重启容器

更新过程中，您的海报集合和设置将被保留，因为它们存储在挂载的卷中。

在哪里可以找到媒体海报？

有几个优秀的资源可用于查找高质量的媒体海报：

• The Poster Database - 社区驱动的自定义海报集合，包含各种风格和主题
• The Movie Database (TMDB) - 庞大的官方和粉丝制作 artwork 库，现已与Posteria完全集成，支持自动海报获取
• The TV Database (TVDB) - 全面的电视剧海报和粉丝艺术数据库，现已与Posteria完全集成，支持自动海报获取
• Fanart.tv - 高质量的电影、电视剧和合集 artwork，现已与Posteria完全集成，支持自动海报获取
• Mediux - 专业设计的媒体 artwork 集合

Posteria在更改海报时，支持在URL上传器中使用来自Mediux YAML文件的URL，使其成为管理集合的便捷选择。

Posteria是否可在Unraid上使用？

是的！

Posteria可在Unraid™ 社区应用商店中找到。

更多信息

Posteria是否支持移动设备？

是的！Posteria设计为响应式渐进式Web应用（PWA），这意味着它在从桌面到智能手机的所有设备上都能完美运行。您甚至可以将其安装在移动设备的主屏幕上，像原生应用一样快速访问。

安全注意事项

1. 修改默认用户名和密码
2. 若暴露到互联网，请使用HTTPS
3. 定期备份海报目录

重大变更通知

更多信息

许可证

MIT许可证

AI辅助开发声明

此工具的开发得到了AI语言模型的协助。