功能說明
适用范围
Viozi 1.0 的所有媒体源类型。
第一步：运行「媒体源体检」
- 进入「设置」→「媒体源管理」。
- 在出问题的媒体源上打开菜单（或向左轻扫），点「媒体源体检」（短名「体检」）。
- 体检会依次检查：配置、地址解析、地址连通性、连接、凭据 / 服务登录、目录访问或资料库读取、扫描就绪。
- 结果显示「可以扫描」「可用但有提醒」或「需要处理」，以及「N 项通过 · N 项提醒 · N 项失败 · N 项未执行」。前一项失败时，后面的项会显示「前序检查未通过，未执行」。
按提示处理
| 提示 | 含义 | 处理 |
|---|---|---|
| 网络不可达 | 当前网络下访问不到 | 确认设备和媒体源在同一局域网或 VPN 下，检查主机和端口 |
| 连接超时 | 没有在限定时间内响应 | 检查 Wi-Fi / VPN、服务器是否休眠、端口转发和 NAS 唤醒状态 |
| TCP 握手成功但服务无响应 | 可能被 VPN / 代理接管，或地址不是这台设备 | 外网时改用公网地址或中继；把内网网段设为直连或暂时关闭 VPN / 代理 |
| 认证问题 | 服务器拒绝了当前凭据 | 重新输入密码、API Key 或令牌；启用了两步验证时先重新连接 |
| 证书问题 | HTTPS 证书无法被信任 | 确认是你自己的服务器证书后，再决定是否信任 |
| 云盘授权过期 | 令牌缺失或已过期 | 重新连接这个云盘并再次授权 |
| 路径问题 | 所选路径无法打开 | 重新选择文件夹，或确认账号有读取权限 |
| 还没有选择扫描目录 | 没选文件夹 | 点「连接并选择目录」或「管理目录」 |
| 服务限流 | 服务方临时限制请求 | 等几分钟后重试，避免短时间内连续扫描或播放 |
| 媒体源响应异常 | 服务器报错 | 检查服务器状态后重试 |
连接失败页面的提示
- 「这是一个内网地址，只有连着同一个网络才通。」→ 离开家里网络时添加公网地址。
- 「用域名访问时，端口通常是 443 或 80」→ 服务自己的端口多半只在内网开放。
- 「这个公网地址走的是不加密连接，很多服务器会直接拒绝。」→ 改用 https。
- 「这条走的是厂商中转」→ 确认设备在线、远程访问已经打开。
- 点「修改地址」可以直接修正。
扫描相关
- 状态显示「扫描中断，可以继续」：点「继续扫描」，会从中断处接着扫。
- 「目录读取成功，但只发现 N 个可见项目」：可能是空文件夹、被过滤的视图或账号权限不足。
- 想重新完整检查一个媒体源：在菜单中点「深度扫描」。
仍然不行
在「诊断报告」中上传日志并附上体检结果的文字描述，见 收集并上传诊断报告。不要在反馈中写密码或服务器地址。