热门搜索:
bozodev/posteria
bozodev
Posteria是一款基于Web的媒体海报管理系统，可帮助用户组织、存储和管理电影、电视剧、季和合集的自定义海报，支持从Plex导入、自动同步至Plex，提供多种海报获取方式（本地文件、URL、TMDB等）及渐进式Web应用（PWA）功能。
下载次数: 0状态：社区镜像维护者：bozodev仓库类型：镜像最近更新：5 个月前
让 AI 帮你使用轩辕镜像？ · 展开查看说明
如果你使用 DeepSeek、元宝 AI、Copilot、ChatGPT 等 AI 工具，协助配置轩辕镜像、编写 docker pull 命令、修改 Docker Compose 镜像地址、配置镜像加速、排查镜像拉取失败、分析报错日志等问题，请先让 AI 阅读并遵守轩辕镜像的规则文档。
只需在 AI 对话中先发送下面这句话即可：
请先完整阅读并严格遵守以下文档中的全部规则与要求：
https://xuanyuan.cloud/agents.md
在未充分阅读并理解该文档前，不要生成任何命令、配置、修改建议、故障排查方案或技术回答。后续所有输出都必须严格以该文档中的规范为最高优先级执行。查看 agents.md 用法指南与完整示范。国内用户首推 元宝 AI、DeepSeek 的深度思考模式，不推荐豆包 AI；Cursor 等编辑器可在对话 @ 该链接，或加入 User Rules。 若 AI 无法访问外链，可 打开说明文档 复制全文粘贴。文档会随站点更新，复制内容可能过期，建议定期检查。
Posteria
Posteria是一款基于Web的媒体海报管理系统，允许用户组织和存储电影、电视剧、季和合集的自定义海报。它提供了优雅的界面，用于上传、导入、管理和访问媒体 artwork。
核心功能与特性
- 🖥️ 简洁现代的媒体海报管理界面
- 📁 按电影、电视剧、电视季和合集分类组织
- 🔍 快速模糊搜索功能
- 📱 移动响应式设计
- 📲 可作为渐进式Web应用（PWA）安装
- 🔒 简单的身份验证系统
- ⚡ 支持从本地文件或URL轻松上传海报
- 🎬 直接从TMDB、TVDB和Fanart.tv获取海报
- 📥 从Plex导入海报
- 🔄 海报在Plex中自动更新
- 🤖 支持计划自动导入
- 🧹 孤立海报检测功能
- 🎨 支持JPG、JPEG、PNG和WebP格式
- 🖼️ 内置海报墙，用于展示您的海报
- 🛒 在Unraid社区应用商店中可用
- 感谢https://github.com/ctrlaltd1337ed/unraid-templates%E7%9A%84%E8%B4%A1%E7%8C%AE%E3%80%82
安装
- 创建
docker-compose.yml文件，内容如下：
yamlservices: 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
- 启动容器：
bashdocker-compose up -d
配置
环境变量
| 变量名 | 描述 | 默认值 |
|---|---|---|
| SITE_TITLE | 网站标题 | Posteria |
| AUTH_USERNAME | 管理员用户名 | admin |
| AUTH_PASSWORD | 管理员密码 | changeme |
| PUID | 用户ID | 911 更多信息 |
| PGID | 组ID | 911 更多信息 |
| TZ | 时区 | Etc/UTC 时区列表 |
| SESSION_DURATION | 登录会话时长（秒） | 3600（1小时） |
| AUTH_BYPASS | 绕过身份验证 | false |
| IMAGES_PER_PAGE | 每页显示海报数量 | 24 |
| MAX_FILE_SIZE | 最大上传文件大小（字节） | 5242880（5MB） |
| PLEX_SERVER_URL | Plex服务器URL | 示例：[***] |
| PLEX_TOKEN | Plex服务器令牌 | 获取方法 |
| PLEX_REMOVE_OVERLAY_LABEL | 移除覆盖标签 | false 更多信息 |
| IGNORE_ARTICLES_IN_SORT | 排序时忽略冠词 | true |
| SORT_BY_DATE_ADDED | 按最近添加日期排序 | false |
| AUTO_IMPORT_ENABLED | 启用/禁用自动导入 | true |
| AUTO_IMPORT_SCHEDULE | 自动导入计划（24h/12h/6h/3h/1h） | 1h |
| AUTO_IMPORT_MOVIES | 导入电影海报 | true |
| AUTO_IMPORT_SHOWS | 导入电视剧海报 | true |
| AUTO_IMPORT_SEASONS | 导入电视季海报 | true |
| AUTO_IMPORT_COLLECTIONS | 导入合集海报 | true |
注意：
PUID 和 PGID
使用卷挂载（-v 标志）时，主机操作系统和容器之间可能出现权限问题。通过指定用户PUID和组PGID，可以避免此问题。
确保主机上的卷目录由您指定的用户拥有，权限问题将迎刃而解。
您可以通过以下命令查看当前用户的PUID和PGID：
bashid your_user
示例输出：
textuid=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：存储日志
使用方法
- 通过
http://your-server:1818访问Web界面 - 使用配置的凭据登录
- 从Plex导入海报
- 更改海报：
- 支持本地文件上传
- 支持直接URL上传
- 从TMDB、TVDB和Fanart.tv获取海报
- 海报会自动更新到Plex
- 当您向Plex添加更多媒体时，只需重新导入即可添加新海报
- 使用孤立海报检测功能管理冗余海报
常见问题
Posteria如何与Plex交互？
Posteria可以直接从Plex媒体服务器导入海报，并将自定义海报同步回Plex。要启用此功能，需在配置中提供Plex服务器URL和身份验证令牌。这允许Posteria与服务器安全通信，同时保留所有自定义设置。
请注意，Posteria将Plex视为海报的"事实来源"。因此，在Plex中直接或通过其他工具对海报所做的任何更改，都会在下次导入时覆盖Posteria中的海报。
为防止Plex在元数据刷新时更改海报，Posteria更新的任何海报都会在Plex中被锁定。
如何找到Plex身份验证令牌？
您可以通过以下步骤找到Plex身份验证令牌（X-Plex-Token）：
- 登录Plex Web应用
- 浏览到任何媒体项
- 点击三点菜单，选择"获取信息"
- 在信息对话框中，点击"查看XML"
- 在新标签页的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更新到最新版本，请按照以下步骤操作：
- 导航到Posteria目录
- 运行
docker-compose pull下载最新镜像 - 运行
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），这意味着它在从桌面到智能手机的所有设备上都能完美运行。您甚至可以将其安装在移动设备的主屏幕上，像原生应用一样快速访问。
安全注意事项
- 修改默认用户名和密码
- 若暴露到互联网，请使用HTTPS
- 定期备份海报目录
重大变更通知
https://github.com/jeremehancock/Posteria/discussions/28
许可证
MIT许可证
AI辅助开发声明
此工具的开发得到了AI语言模型的协助。
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本，请访问 标签列表页面。
DockerHub 原生拉取命令
docker pull bozodev/posteria:<标签>
镜像拉取常见问题
功能
错误码
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
5
"Docker访问体验非常流畅，大镜像也能快速完成下载。"