云映 FTP 文件源：用小目录验证连接与播放

FTP 文件源的验证不能停在“账号登录成功”。目录列表、进入子目录和播放视频是不同环节，一个环节正常不代表其他环节全部可用。本篇适合已有 FTP 服务、想判断它是否适合当前云映版本的人，采用一个浅层测试目录逐步核对，不把所有服务器行为都预先当成兼容。

先确认服务实际使用的协议

向服务器管理者确认提供的是 FTP、FTPS 还是 SFTP，三者不能只凭名称相似就混用。云映的 FTP 与 SFTP 是不同来源类型；不要把 SFTP 的端口填进 FTP 表单，再期待应用自动识别。若服务要求加密 FTP，也需要确认当前应用版本和服务的具体方式能配合，不能把一个“安全”选项理解为所有加密模式都经过验证。

本篇先以自己可信网络中的普通 FTP 测试服务为例，不建议把重要账号凭据用于不可信网络的明文连接。准备一个只读测试账号、明确的主机地址和端口，以及可访问的基础目录。常见默认端口只是起点，实际值必须以服务器配置为准。

建立一个没有歧义的测试目录

在账号可见范围内准备 VideoTest，直接放入一段小 MP4，再建立一个 Subfolder 放第二段。两个文件使用不同名称，时长也略有区别，方便检查是否真的切换了目录。先在另一个可靠客户端确认账号能看到并读取两段文件，避免测试目录本身就存在权限或路径错误。

不要第一步就用多层中文目录、几千个文件与超大视频混合测试。先使用简单路径建立基线，成功后再逐项加入实际环境中的复杂情况。这不是要求所有文件都改名，而是用最少变量判断问题发生在连接、目录还是媒体读取。

在 FTP 表单里逐项填写

打开云映“来源”，添加文件源并选择 FTP。名称可写“FTP 测试库”，主机填写服务器地址，端口填写管理员给出的数字，用户名和密码填写测试账号。基础路径表示登录后的起点，例如账号已经以测试目录为根时可以使用 /，不要把服务器操作系统里的绝对磁盘路径直接照搬进去。

填写后先检查主机框里是否误带了文件名、网页路径或其他协议前缀。密码中有特殊字符时，注意键盘是否自动替换引号或加入空格。保存前确认协议类型没有选错，尤其不要把“能连接 SSH”误当成“FTP 一定能连接”。

分三步核对连接结果

第一步只看登录是否成功，记录失败提示发生在提交后立即还是等待较久。第二步查看基础目录，确认直接放在里面的第一段视频能被列出。第三步进入子目录，确认看到的是第二段而不是重复显示根目录内容。目录列表必须与服务器端实际结构相符，不能只看出现了几个文件名就算通过。

若根目录可见、子目录异常，先保留这个结果，不要立即扫描整个来源。可以把需要测试的视频暂放在明确可读的浅层目录，验证播放；正式整理则应选择当前版本实际能稳定访问的方案。应用与服务器的目录兼容问题，不应通过给账号更高权限来盲目解决。

再检查实际视频播放

从明确可见的目录打开小视频，检查开头、声音和中间跳转。若文件能列出却无法播放，说明目录访问与媒体读取之间仍有问题。此时不要把它当成视频已经导入本地，更不要断网后期待继续播放。FTP 来源的连接状态不等于离线下载完成，本文也不把离线能力作为完成条件。

把同一文件通过本地导入播放一次，或从同一服务器的另一种已配置协议读取。若本地正常而 FTP 失败，记录协议、目录深度、文件大小与现象，再选择可工作的访问方式。可参照SMB 文件源或WebDAV 文件源做同文件对照，不要同时换视频内容。

识别登录后才出现的问题

有些 FTP 服务的目录访问与数据传输会受到服务器网络配置影响，登录提示正常也可能在列目录或传文件时等待。先比较同一网络下另一个客户端的结果，再检查服务端说明，不要只在云映里反复改密码。若所有客户端都卡在数据读取，问题范围更接近服务器或网络；若只有当前应用异常，则保留兼容性边界。

基础路径也需要单独验证。账号登录后看到的根目录可能已经被限制在某个共享内，再填一次完整系统路径反而会指向不存在位置。先用账号可见的根开始，逐级进入目录并记录结果。遇到空列表时，要区分“确实没有文件”和“列目录失败”，不能直接据此删除服务器上的内容。

决定是否用于正式媒体库

只有在登录、根目录、子目录与小视频播放都符合预期后，再考虑扩大扫描范围。先增加少量文件，观察列表与实际播放是否仍一致，然后再加入更大视频。若某一环节始终不能稳定通过，就把 FTP 保留为已验证的有限用途，改用其他已支持并实测可行的文件源，不需要为了一个协议反复重建整个媒体库。

打开“安全连接”就等于 SFTP 吗？ 不是。SFTP 是独立协议，应使用对应入口。FTP 表单中的加密选项是否满足服务要求，需要按当前版本与服务器方式验证。先向管理员确认连接协议和加密要求，不要只凭开关名称判断是否兼容。

为什么教程不保证所有 FTP 视频都能播？ 商店列出的协议支持说明有对应能力范围，实际仍受目录实现、服务器配置和媒体格式影响。把每个阶段分开测试，能给出可复现的结果，比一句“支持 FTP 所以一定没问题”更适合自己的环境。

资料来源与版本

依据云映官方商店说明公开的 FTP／SFTP 能力及现有连接入口整理，2026 年 10 月 23 日核对公开版本 1.1.0。连接成功后还需分别检查目录浏览和播放；FTPS、离线下载及多级目录的表现可能因客户端版本与服务器配置而异。