Posterizarr安装与配置完全手册Windows、Linux与Docker环境一键部署【免费下载链接】Posterizarr️ Automated poster maker for Plex/Jellyfin/Emby.项目地址: https://gitcode.com/gh_mirrors/po/PosterizarrPosterizarr是一款强大的自动化海报生成工具专为Plex、Jellyfin和Emby媒体服务器设计。本指南将帮助你在Windows、Linux和Docker环境中快速部署和配置Posterizarr轻松打造专业级媒体库海报系统。 准备工作系统要求与必要组件在开始安装前请确保你的系统满足以下要求并准备好必要的API密钥核心依赖媒体服务器Plex、Jellyfin或EmbyAPI密钥TMDB API Read Access Token免费获取Fanart.tv个人API密钥免费获取TVDB项目API密钥免费获取运行环境Docker环境推荐或PowerShell 7.x、Python 3.x、Node.js手动安装需满足图像尺寸要求为获得最佳效果Posterizarr推荐以下图像尺寸海报1000×1500px基础或2000×3000px4K背景图1920×1080px基础或3840×2160px4K标题卡片1920×1080px基础或3840×2160px4KPosterizarr生成的4K分辨率海报示例展示了自动添加的文本和覆盖层效果 Docker部署最简单的一键安装方案Docker是部署Posterizarr的推荐方式无需复杂的依赖管理只需几步即可完成步骤1准备Docker环境确保你的系统已安装Docker和Docker Compose。如果尚未安装可以参考Docker官方文档进行安装。步骤2创建Docker Compose文件在你选择的目录中创建docker-compose.yml文件内容如下--- services: posterizarr: hostname: posterizarr container_name: posterizarr environment: - TZEurope/Berlin # 替换为你的时区 - TERMxterm - RUN_TIMEdisabled image: ghcr.io/fscorrupt/posterizarr:latest restart: unless-stopped user: 1000:1000 # 替换为你的用户ID和组ID ports: - 8000:8000 # Web UI端口 volumes: - /opt/appdata/posterizarr:/config:rw - /opt/appdata/posterizarr/assets:/assets:rw - /opt/appdata/posterizarr/assetsbackup:/assetsbackup:rw - /opt/appdata/posterizarr/manualassets:/manualassets:rw networks: proxy: driver: bridge external: true步骤3启动容器在终端中执行以下命令启动Posterizarrgit clone https://gitcode.com/gh_mirrors/po/Posterizarr cd Posterizarr docker compose up -d步骤4访问Web UI容器启动后打开浏览器访问http://localhost:8000即可进入Posterizarr的Web管理界面。Docker Compose部署Posterizarr的完整流程演示 Windows系统手动安装如果你需要在Windows系统上手动安装Posterizarr请按照以下步骤操作步骤1安装必要依赖安装PowerShell 7安装Git for Windows安装Python 3.x和Node.js步骤2克隆代码库打开PowerShell以管理员身份运行执行以下命令cd C:\Github git clone https://gitcode.com/gh_mirrors/po/Posterizarr cd Posterizarr步骤3安装Web UI依赖cd webui setup.ps1 # 或 setup.bat步骤4启动服务需要在两个独立的终端中分别启动后端和前端服务终端1后端cd webui/backend python -m uvicorn main:app --host 127.0.0.1 --port 8000终端2前端cd webui/frontend npm run build步骤5首次运行测试cd C:\Github\Posterizarr pwsh .\Posterizarr.ps1 -Testing测试模式将在test目录下生成示例海报帮助你预览效果。 Linux系统手动安装Linux用户可以按照以下步骤手动安装Posterizarr步骤1安装系统依赖# 安装PowerShell sudo apt update sudo apt install -y wget apt-transport-https software-properties-common wget -q https://packages.microsoft.com/config/ubuntu/$(lsb_release -rs)/packages-microsoft-prod.deb sudo dpkg -i packages-microsoft-prod.deb sudo apt update sudo apt install -y powershell # 安装Git、Python和Node.js sudo apt install -y git python3 python3-pip nodejs npm步骤2克隆代码库并安装依赖cd /opt/appdata git clone https://gitcode.com/gh_mirrors/po/Posterizarr cd Posterizarr # 安装Fanart API模块 pwsh Install-Module -Name Celerium.FanartTV -Scope AllUsers -Force -AllowClobber # 安装Web UI依赖 cd webui chmod x setup.sh ./setup.sh步骤3启动服务终端1后端cd /opt/appdata/Posterizarr/webui/backend python -m uvicorn main:app --host 0.0.0.0 --port 8000终端2前端cd /opt/appdata/Posterizarr/webui/frontend npm run build步骤4设置定时任务# 每2小时运行一次Posterizarr sudo crontab -e # 添加以下行 0 */2 * * * cd /opt/appdata/Posterizarr pwsh Posterizarr.ps1 /dev/null 21⚙️ 核心配置指南无论你选择哪种安装方式都需要进行基本配置才能让Posterizarr正常工作步骤1配置文件准备将config.example.json复制为config.jsoncp config.example.json config.json使用文本编辑器或Web UI编辑配置文件至少需要填写以下API密钥ApiPart: { tvdbapi: 你的TVDB API密钥, tmdbtoken: 你的TMDB访问令牌, FanartTvAPIKey: 你的Fanart.tv API密钥, PlexToken: 你的Plex令牌如果使用Plex }步骤2媒体服务器配置根据你使用的媒体服务器配置相应部分Plex示例PlexPart: { UsePlex: true, PlexUrl: http://192.168.1.100:32400, LibstoExclude: [YouTube, Audiobooks] }Jellyfin示例JellyfinPart: { UseJellyfin: true, JellyfinUrl: http://192.168.1.101:8096, JellyfinAPIKey: 你的Jellyfin API密钥 }步骤3自定义海报生成设置你可以在config.json中调整各种参数来自定义海报效果例如文本颜色和字体边框样式和宽度覆盖层效果分辨率和质量设置Posterizarr Web UI配置界面可直观调整各种参数 快速开始首次运行与测试完成配置后建议先运行测试模式来验证设置Docker用户docker exec -it posterizarr pwsh /app/Posterizarr.ps1 -Testing手动安装用户# Windows pwsh .\Posterizarr.ps1 -Testing # Linux pwsh Posterizarr.ps1 -Testing测试模式会在test目录下生成示例海报你可以检查这些海报是否符合预期。如果需要调整可以修改配置文件后重新运行测试模式。满意后即可执行完整运行# Docker docker exec -it posterizarr pwsh /app/Posterizarr.ps1 # 手动安装 pwsh Posterizarr.ps1 常见问题与故障排除Web UI无法访问检查服务是否正常运行docker logs posterizarr确认端口映射是否正确防火墙是否允许8000端口尝试访问http://服务器IP:8000而非localhost海报生成失败检查API密钥是否正确配置确保媒体服务器可访问且API密钥有效查看日志文件logs/Scriptlog.log获取详细错误信息性能优化建议在低配置设备上将ParallelJobs设置为1或2对于大型媒体库考虑分批次处理启用DisableHashValidation可加快处理速度可能重复上传 进阶资源官方文档docs/配置示例config.example.jsonWeb UI源代码webui/frontend/模式说明docs/modes.md通过本指南你已经掌握了Posterizarr在不同环境下的安装与配置方法。现在你可以开始打造属于自己的专业媒体库海报系统了如有任何问题欢迎查阅项目文档或提交issue寻求帮助。【免费下载链接】Posterizarr️ Automated poster maker for Plex/Jellyfin/Emby.项目地址: https://gitcode.com/gh_mirrors/po/Posterizarr创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考