常见问题

页面打不开

在 NAS 容器管理器中检查：

1. QPlay 容器是否正在运行；
2. 7735 端口是否被其他应用占用；
3. 浏览器地址是否使用了 NAS 的实际地址；
4. 容器日志中是否有启动错误。

如果修改过 NAS 端口，使用新的端口打开管理页面，容器端口保持不变。

找不到临时管理员密码

在 NAS 容器管理器中打开 QPlay 容器的“终端”，查看：

/config/initial_admin_password

文件不存在通常表示已经完成过首次改密。不要删除 config 或重新初始化数据，先确认是否使用了正确密码。

授权一直失败

• 确认输入的授权码没有多余空格；
• 确认 NAS 日期和时间正确；
• 网络受限时，在授权页面填写代理后重新验证；
• 检查邮箱和垃圾邮件，不要重复付款。
• 如果升级后首次联网校验遇到暂时性错误，保持服务运行并检查网络；QPlay 会继续重试，不必反复激活。

115 二维码提示正在重试

• 等待扫码时，115 的状态查询可能暂时超时。这不等于二维码已过期，页面会保留二维码并自动重试，可以继续扫码。
• 二维码在 QPlay 中的有效期为生成后 3 分钟，115 也可能提前使其失效；自动重试不会延长有效期。
• 提示“二维码已过期”或“扫码已取消”后，重新生成二维码。
• 如果一直提示正在重试，检查 QPlay 所在设备的网络。运行日志会区分查询超时、连接失败、115 返回错误和响应异常；不要分享二维码或登录凭据。

115 显示“登录已失效”或“连接异常”

• 登录已失效：115 登录凭据已过期，常见于在其他设备退出登录或修改密码之后。点击仪表盘或“设置 → 115 账号”中的“重新扫码登录”，用原来的 115 账号扫码即可。重新登录会保留已有的媒体索引和同步进度，不需要删除账号或重新全量同步。登录失效期间，定时同步会自动暂停，不会每次都产生一条失败任务；重新登录后自动恢复。
• 连接异常：QPlay 暂时无法连接 115，通常是网络问题。检查 QPlay 所在设备的网络后，在“设置 → 115 账号”点击“测试账号状态”。
• 账号列表里的“已停用”只表示该账号被手动停用，与登录是否有效无关。

115 扫描失败或很慢

• 进入“设置”首页，打开“115 账号与绑定”，点击“测试账号状态”；
• 确认媒体库路径以 / 开头，而且确实存在于 115；
• 不要连续重复运行全量同步；
• 大目录需要等待当前任务完成。
• 增量同步报告文件写入失败时，先解决目录权限或磁盘空间问题，再运行增量同步；未完成的变更会重新处理，不必删除媒体库或重建配置。

未识别文件如何再次整理

QPlay 不会自动重试或清理未识别目录中的文件。可以在整理记录页选择最新的失败条目，选择媒体类型并指定 TMDB ID 手动整理；也可以修改文件名，或在主菜单“词表”中补充精准识别词，再将文件移回待整理目录，手动启动自动整理或等待下一次定时任务。

整理后的遗留文件清理只针对待整理目录，不会删除未识别目录中的文件或空文件夹。

外部服务连接失败

打开右上角用户菜单，选择“网络连通性测试”。需要代理时，在“设置 → 系统与安全 → 系统代理”保存 HTTP 或 SOCKS5 代理后重新测试。

Emby 中没有影片

按顺序检查：

1. QPlay“记录 → STRM 记录”中是否有内容；
2. NAS 上是否生成了 STRM；
3. Emby 是否添加了同一个 NAS 文件夹；
4. Emby 是否已经扫描媒体库。

Emby 有海报但不能播放

• Emby 客户端连接地址应为 http://NAS地址:8099；
• QPlay 的 STRM 播放入口也应填写 Emby 能访问的 8099 地址；
• Emby 地址不能填写 localhost；
• 115 主账号必须启用且登录有效；
• 路径包含特殊字符时，启用完整路径编码后重新运行全量同步；
• 在“记录”页面清空播放缓存后重新播放。

容器更新或删除后数据还在吗

只要保留 NAS 上的 config 和 media 文件夹，更新或重新创建容器不会丢失账号、设置和 STRM。不要创建新的空文件夹替代原目录。

可以把管理页面暴露到公网吗

不建议直接暴露未加密的管理页面。远程使用时请使用 NAS 的 HTTPS 安全访问功能，并限制管理页面的访问范围。

仍然无法解决

联系支持时可以提供：

• NAS 类型；
• QPlay 容器状态；
• 去掉 Cookie、Token、邮箱和授权码后的错误信息；
• 问题发生在哪一步。

不要上传账号凭据、完整日志或整个 QPlay 数据目录。