Seerr 海报与图片无法从 TMDB 直接加载时如何处理【免费下载链接】seerrOpen-source media request and discovery manager for Jellyfin, Plex, and Emby.项目地址: https://gitcode.com/GitHub_Trending/je/seerr在 Seerr 媒体页或 Discover 页面发现海报、图片加载不出来时先要分清问题出在哪一侧是Seerr 服务器连不上 TMDB API服务端会报[TMDB] failed to retrieve/fetch XXX之类的错误还是浏览器无法直接从 TMDB 拉取图片服务端已拿到数据但页面里图片显示不出来。这两种情况的处理方式不同官方 Troubleshooting 和 General 设置 文档分别给出了对应办法。本文按“先判断、再修网络、最后启用图片代理缓存”的顺序给出完整操作路径。先确认服务器能否连通 TMDB API在改动任何配置之前先用文档给出的命令验证 Seerr 所在服务器是否真的能访问 TMDB API这一步用于区分问题在服务器网络还是在浏览器侧。Docker Compose 部署仓库 compose.yaml 中的服务名为seerrdocker compose exec seerr sh -c apk update apk add curl curl -L https://api.themoviedb.orgDocker CLI 方式docker exec -it seerr sh -c apk update apk add curl curl -L https://api.themoviedb.org裸机 Linuxcurl -L https://api.themoviedb.orgWindows PowerShell(Invoke-WebRequest -Uri https://api.themoviedb.org -Method Get).Content注意容器内的命令会先执行apk update apk add curl即在容器里安装 curl这是文档给出的原命令副作用仅限容器内部。判断标准文档说明如果拿不到任何响应则服务器无法到达 TMDB API“This is usually due to a network configuration issue or a firewall blocking the connection”通常是网络配置问题或防火墙拦截。能拿到响应时服务端到 TMDB 的链路是通的问题多半在浏览器侧直接加载图片可跳到下文“启用图片缓存改由 Seerr 代理图片”一节。修复服务端连不上 TMDB API当确认服务端连不上 TMDB例如日志中出现[TMDB] failed to retrieve/fetch XXX时文档给出三个方向按“改 DNS → 走代理 → 强制 IPv4”的代价从低到高选择。方案一更换 DNS 服务器文档指出该错误经常由 ISP 拦截 TMDB API 的 DNS 解析导致可改用公共 DNS。按部署方式选择其一Docker Compose在compose.yaml的seerr服务下添加dns--- services: seerr: dns: - 8.8.8.8或 Cloudflare DNS- 1.1.1.1、Quad9 DNS- 9.9.9.9。Docker CLI在docker run命令上追加参数--dns8.8.8.8或--dns1.1.1.1、--dns9.9.9.9。Linux 宿主机编辑/etc/resolv.conf添加nameserver 8.8.8.8或1.1.1.1、9.9.9.9。Windows在网络适配器属性中为 IPv4 手动指定上述 DNS 地址。文档说明三种 DNS 可以都试一遍看哪个在你的网络上有效。改完后用上一节的命令重新验证连通性。方案二为 Seerr 配置 HTTP(S) 代理可选分支如果无法更改 DNS 服务器或者如文档提到中国网络环境那样ISP 不仅拦截 DNS 解析、还拦截到 TMDB API 的连接本身则改 DNS 无效应改为让 Seerr 走代理。文档指向 Network 设置中的 HTTP(S) Proxy 选项Troubleshooting 文档中锚点为Enable Proxy Support一节。代理地址、端口由读者按自己的代理环境填写。方案三强制 IPv4 优先解析可选分支有时 IPv6 配置问题会导致主机名解析失败。解决方法是启用Force IPv4 Resolution First设置后重启 SeerrTroubleshooting 文档给出的路径是Settings Networking Advanced NetworkingNetwork 设置文档给出的路径是Settings Network。两份文档对菜单路径的写法略有出入功能相同均为启用Force IPv4 Resolution First后重启 Seerr以你实际界面上的 Network 设置页为准。启用图片缓存改由 Seerr 代理图片如果服务器能连通 TMDB但浏览器仍然无法直接加载 TMDB 图片文档明确建议启用Enable Image Caching设置General 设置页When enabled, Seerr will proxy and cache images from pre-configured sources (such as TMDB). You should enable this if you are having issues with loading images directly from TMDB in your browser.启用后的行为与代价均来自 General 设置文档Seerr 会代理并缓存来自 TMDB 等预配置来源的图片浏览器改为从 Seerr 的图片代理接口取图而不是直连 TMDB图片保存在config/cache/images目录过期图片每 24 小时清理一次文档提示这会占用相当可观的磁盘空间“This can use a significant amount of disk space”磁盘紧张时先评估再开启。Seerr 的图片代理路由实现可参考 imageproxy 路由其默认代理https://image.tmdb.org的图片若你在 Nginx 子目录下部署 Seerr注意反向代理配置中对/imageproxy/路径的sub_filter改写见 Reverse Proxy 文档否则子目录部署下图片路径会指向错误位置。验证与已知限制连通性验证重新执行“先确认服务器能否连通 TMDB API”一节的命令能返回响应即服务端链路恢复。图片验证启用 Enable Image Caching 后刷新媒体页面确认海报经 Seerr 代理后正常显示磁盘占用可观察config/cache/images目录缓存每 24 小时自动清理。若以上都不生效文档对服务端连不通的情况归结为网络配置或防火墙拦截需要自行排查网络环境文档未提供进一步的服务端日志排查步骤。各方案的适用前提改 DNS 要求你有权限修改容器或宿主机的 DNS 配置HTTP(S) 代理要求你已有可用的代理Force IPv4 Resolution First和 Enable Image Caching 均需在 Seerr 设置界面中操作网络类修改DNS 配置、重启 Seerr会使 Seerr 短暂不可用。【免费下载链接】seerrOpen-source media request and discovery manager for Jellyfin, Plex, and Emby.项目地址: https://gitcode.com/GitHub_Trending/je/seerr创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
