深色模式
MoviePilot 常见问题
这篇文章用于整理 MoviePilot 使用中经常遇到的问题。排查时建议先看“最近改过什么”，例如升级版本、改端口、改路径、换路由器、改密码、换站点 Cookie。
排查前先准备
| 信息 | 为什么需要 |
|---|---|
| NAS 型号和系统版本 | 判断功能入口和权限差异 |
| MoviePilot 版本 | 不同版本插件和配置项可能不同 |
| 部署方式 | Docker、Compose、套件方式排查路径不同 |
| 报错截图或日志关键词 | 判断是网络、权限、插件还是路径问题 |
| 最近改动 | 很多问题都和最近一次修改有关 |
OCR 签到相关
部分站点签到可能需要 OCR 识别验证码。常见做法是额外部署 OCR 服务，再把 OCR 服务地址填入 MoviePilot。
常见检查点：
- OCR 容器是否启动。
- 端口是否映射正确。
- MoviePilot 是否能访问 OCR 服务地址。
- 站点是否更新了验证方式。
如果使用 Docker 部署 OCR 服务，建议先确认容器日志没有明显报错，再回到 MoviePilot 插件里测试。
绕过 Cloudflare 验证失败
遇到 Cloudflare 验证时，通常需要关注：
- MoviePilot 版本是否过旧。
- 站点是否修改了验证策略。
- Cookie 是否过期。
- 是否需要重新登录并同步 Cookie。
- 网络出口是否被站点限制。
这类问题不一定是本地配置错误，很多时候和站点策略有关。
手机 App 相关
手机端功能异常时，先分清是“内网访问问题”还是“外网访问问题”。
| 场景 | 排查方向 |
|---|---|
| 家里 Wi-Fi 可以，外面不行 | 远程访问、反代、证书、端口 |
| 手机和电脑都打不开 | 服务状态、端口、防火墙 |
| 只有 App 不行 | App 地址、登录信息、版本兼容 |
微信通知不推送
微信通知不推送时，可以按这个顺序检查：
- 通知插件是否启用。
- Token、Key、可信 IP 是否正确。
- MoviePilot 日志里有没有推送失败记录。
- 服务器时间是否异常。
- 最近是否换过网络、代理或反向代理。
如果更换过可信 IP 或通知服务配置，建议重新测试一次推送。
下载完成后没有入库
这是最常见的问题之一，优先检查路径映射。
需要确认：
- qBittorrent 的下载目录。
- MoviePilot 看到的下载目录。
- MoviePilot 整理后的媒体库目录。
- Jellyfin / Emby / Plex 指向的媒体库目录。
建议让多个容器看到一致的路径，例如都使用 /downloads 和 /media，这样最不容易出错。
搜索不到资源
可能原因：
- 关键词不准确。
- 年份、季数、标题匹配不对。
- 站点 Cookie 失效。
- 索引器异常。
- 站点暂时不可用。
- 规则过于严格。
建议先用更简单的关键词搜索，再逐步增加年份、季数和清晰度限制。
推荐的 SSH 工具
如果需要登录 NAS 排查 Docker 容器，可以使用自己熟悉的 SSH 工具。新手优先选择界面清晰、支持保存主机信息的软件。
WARNING
SSH 和 root 权限具有风险，不熟悉命令时不要随意删除目录或重启关键服务。
继续阅读
迁移来源: Wiki 常见问题汇总