播放地址与网络

QPlay 提供两个访问入口：

地址	用途
7735	打开 QPlay 管理页面
8099	Emby 客户端播放入口

Emby 客户端应连接 8099，不要连接 7735。需要同时播放副本或子账号播放时，也必须使用 8099。

地址填写

在“设置 → 存储与同步”中：

• STRM 播放入口填写 Emby 能访问的 QPlay 地址，例如 http://NAS地址:8099；
• 如果使用 HTTPS 域名，填写最终的 HTTPS 地址；
• STRM 保存目录填写 NAS 上保存 STRM 的目录，并在 Emby 中添加同一目录。

在“设置 → 媒体服务”中：

• Emby 地址填写 NAS 上的 Emby 地址，例如 http://192.168.1.20:8096；
• QPlay 和 Emby 在同一 Docker 网络时，也可以填写 Emby 在该网络中的地址；
• 不要填写 localhost:8096，它不是 NAS 上的 Emby 地址。

修改 Emby 地址后保存并重启 QPlay，再重新登录管理页面。

远程播放

从外网访问时，建议使用 NAS 自带的 HTTPS 反向代理或安全访问功能：

1. 将管理页面转发到 7735；
2. 将 Emby 播放入口转发到 8099；
3. 为播放入口配置 HTTPS 域名；
4. 将“STRM 播放入口”改为这个 HTTPS 地址；
5. 让 Emby 客户端使用同一个地址。

不要直接把未加密的 7735 管理页面暴露到公网。普通家庭局域网使用时，可以直接使用 NAS 局域网地址。

系统代理

在“设置 → 系统配置 → 系统代理”中，只有 NAS 无法访问外部服务时才启用代理。代理可用于：

• TMDB；
• Telegram；
• 授权服务。

代理地址支持 HTTP 和 SOCKS5。115、Emby 和企业微信通常不需要填写代理。

网络连通性测试

打开右上角用户菜单，选择“网络连通性测试”。测试完成后会显示各项服务是否可访问。

需要代理时，先保存系统代理，再重新测试。

播放失败排查

1. “记录 → STRM 记录”中是否存在媒体；
2. Emby 是否添加了 QPlay 保存 STRM 的同一目录；
3. Emby 客户端是否连接 8099；
4. STRM 播放入口是否能被 Emby 访问；
5. Emby 地址是否填写为 NAS 或局域网中的实际地址；
6. 115 主账号和媒体库目录是否正常；
7. 文件名含空格或特殊字符时，是否开启了完整路径编码；
8. 在“记录 → 播放缓存”中清空缓存后重新播放。