NAS 片库能打开，视频为什么播不了？局域网与远程播放排查
海报能显示，不代表播放器能访问 NAS 视频。按家里也失败、只有外网失败、部分文件失败和播放卡顿，检查播放线路、目录映射、网络与解码能力。
在播放器里能看到海报、简介和季集，点播放却失败，先不要全库重新刮削。片库能打开与视频能读取，是两件事。 已有 NAS 可以继续存文件，让 Drivemby 负责识别和整理，不需要先把视频搬到网盘。
本文按 2026 年 10 月 17 日核对的产品行为整理，重点是排查顺序，不承诺某一种网络配置一定成功。首次接入另见 NAS 与网盘接入指南。
先分清片库连接与视频线路
| 环节 | 做什么 | 成功后还不能证明什么 |
|---|---|---|
| Agent 同步 | 将文件清单等信息同步给 Drivemby，用于建立片库 | 不能证明播放器能读取视频 |
| 播放器连接 Drivemby | 登录片库，取得作品和播放来源 | 不能证明 NAS 地址在当前网络可达 |
| 播放器访问 NAS 线路 | 按该来源的地址读取视频 | 连通后仍要验收格式、字幕、拖动与持续播放 |
NAS 视频由播放器直接访问相应文件服务，Drivemby 不转发 NAS 视频流量。片库服务器地址不是家庭网络的自动中转服务；管理页面能打开，也不能代替视频文件的实际读取测试。
第一步：固定一个样本，先在家里试播
选一部已经识别完成、原文件仍在 NAS 上的视频，记下作品、所在目录、播放器和网络。先用家中网络播放，再用同一设备、同一文件切换到外部网络。每次只调整一项，便于判断原因。
| 现象 | 优先检查 |
|---|---|
| 家里和外网都失败 | 文件是否存在、目录是否可读、播放方式与地址是否匹配 |
| 家里成功，外网失败 | 外网线路、域名解析、访问权限及当前网络是否能到达 NAS |
| 同一目录部分文件失败 | 文件状态、格式、音轨、字幕与客户端解码能力 |
| 能开始但卡顿或拖动失败 | 持续带宽、NAS 负载、文件服务与中间代理的读取方式 |
尚未显示作品时，先排查目录选择、同步和识别；不要把“没有入库”和“已入库但播不了”混在一起。通用维护步骤见 自建与 NAS 片库维护清单。
第二步：家里也失败，先检查地址与目录
在 Agent 管理页面检查当前播放方式及线路提示。使用 Docker 自带文件服务时，核对局域网地址是不是 NAS 在家中网络里的地址，端口是否与自己的部署一致；不要把容器内部地址或另一台设备的地址当成播放器可访问地址。
如果使用自己的 WebDAV，检查地址、账号权限，以及影视文件夹在 WebDAV 上的路径。容器内的挂载路径和 WebDAV 对外路径可能不同。 只确认容器能扫描目录，不足以证明 WebDAV 中同一路径存在。
直接添加的 WebDAV 来源与挂进容器的本地目录也要区分：Docker 自带文件服务不负责转发 WebDAV 来源。出现“当前访问方式下无法播放”时，先按该目录的来源选择合适的播放方式，不要靠重复扫描修正线路配置。
第三步：只有外网失败，用外面的网络验收
家中的局域网地址通常只在家庭网络内有效。需要在外面观看时，配置适合自己的远程访问方案，并核对播放器实际选择的线路；只保存一个域名，并不会自动打通网络。
- 用手机移动网络或另一处网络，测试同一部视频；关闭 Wi-Fi 后确认测试网络确实已改变。使用自己的 VPN 时，先确认它已经连通家庭网络。
- 核对远程地址、协议和端口；使用 HTTPS 时检查证书，使用自己的 WebDAV 时还要确认账号具有读取权限。
- 核对自己采用的路由器、防火墙或反向代理配置。IPv6 方案还取决于观看端网络能否访问对应 IPv6 地址，不能只看 NAS 获得了 IPv6。
- 回到播放器验证开始播放和拖动进度。浏览器能打开管理页面、Agent 显示在线或某次线路检测成功，都不能代替这一步。
有些家庭网络不能从内网访问自己的外网地址。遇到“内网无法验证外网地址”，先从真正的外部网络测试，不能仅凭这条提示断言线路不可用。反过来，在家里测试通过，也不能保证出门后的网络可用。
远程访问涉及自己的家庭网络和文件服务权限。保留已验证可用的局域网配置，避免排查外网时覆盖唯一可用的线路；不要为了测试关闭整套防火墙或公开后台管理权限。
第四步：能连接，再区分格式与带宽
同一线路中只有个别文件失败，可以用另一部已知可播放的视频对照，再分别检查视频编码、音轨和字幕。Drivemby 当前不提供服务端转码，不能把客户端不支持的格式自动转换成能播的版本；需要转码时，可以保留自建服务或自行准备合适的文件版本。
能开始播放却持续缓冲时，分别观察家庭上行、观看端下载、NAS 读取和代理链路。不要只用宽带套餐的下载速率判断外网播放能力，视频本身的码率也会变化。
如果只有拖动失败，检查文件服务和中间代理是否正确处理播放器的范围读取请求。HTTP 的 Range 机制允许客户端请求文件的一部分，见 MDN 范围请求说明。这只是排查方向，不能仅凭现象认定是代理故障。
留下一份可复查的验收记录
在自己的实际设备上，分别记录家中与外网的结果：能否开始、连续播放、拖动、切换所需音轨和显示字幕。失败时保留发生时间、播放器版本、文件格式、线路名称和错误提示；分享日志前去掉密码、令牌、完整签名播放链接及私人地址。
这份记录比“NAS 在线但不能看”更容易缩小问题范围。配置改动不合适时，先切回保留的可用线路；原视频和旧播放方式继续保留。准备从自建媒体库转过来的用户，可按 迁移与并行试用指南验收，再逐步扩大目录。
常见问题
NAS 已经同步成功，为什么外网仍然播不了？
同步是 Agent 把文件清单交给 Drivemby，播放则需要播放器访问 NAS 的视频地址。只在家里可达的地址，不会因同步成功自动变成外网可达；需要在实际观看网络中验证播放线路。
使用 Drivemby，需要把 NAS 视频搬到网盘吗？
不需要。即使影视全部在 NAS 上，也可以让 Drivemby 做识别、刮削和片库整理，原文件继续留在 NAS。播放时仍需有播放器能访问的线路。
线路检测通过，能保证所有设备都播放正常吗？
不能。检测只覆盖当时的测试请求，不能代替真实设备对视频、音轨、字幕和拖动进度的验收；换到外网后还要重新验证。
把你的收藏整理成片库
邮箱验证码即可注册，几分钟连好第一个网盘。