PikPak 支持哪些离线协议

PikPak 支持的离线协议主要集中在基于 HTTP/HTTPS 的标准文件传输与静态资源访问，其核心设计目标是兼容主流云存储与下载场景中的常见协议规范，而非提供对复杂网络协议栈的深度支持。这意味着用户在使用 PikPak 时，所依赖的“离线”功能本质上是通过预加载或缓存机制实现的，而非真正意义上的本地协议解析与运行。因此，判断一个协议是否被支持，关键不在于协议名称本身，而在于它是否能被封装为标准 HTTP 请求并由 PikPak 客户端正确处理。

具体来说，PikPak 完全支持以下几类协议行为：HTTP、HTTPS（含自定义证书验证）、FTP（通过代理转换为 HTTP 流式请求）、SFTP（仅限于通过 WebDAV 或特定网关中转后访问）。对于 BitTorrent 协议，虽然 PikPak 可以接收 .torrent 文件并调用内部模块进行种子解析，但并不直接支持 DHT、Peer-to-Peer 通信等底层协议交互，这意味着即便拥有完整的种子文件，也无法实现真正的离线点对点下载。若用户尝试直接传入 .torrent 且未配置外部 tracker 服务，系统将提示“无法连接至 peer”，这是典型的协议不完整支持信号。

当实际操作中遇到“离线失败”或“无法读取文件”时，首要排查方向应是确认该资源是否以可公开访问的 URL 形式存在。例如，若原始链接为 `https://example.com/file.zip`，且无需身份验证，即可正常缓存；但若链接带有动态 token、时效性限制（如 `?expires=1730000000`）或需登录态才能访问，则即使成功下载一次，后续离线状态下仍会因令牌过期而失效。此时，必须检查协议是否具备持久化访问能力——这正是 Clash 相关生态中强调的“流量规则匹配”与“本地缓存策略”的核心差异所在，Getting started with clash clash 2 中提到的规则优先级与缓存命中逻辑，恰恰说明了只有符合明确路径与协议结构的请求才能被稳定保留。

另一个关键判断依据是响应头信息。在真实支持的离线场景中，PikPak 会记录并缓存服务器返回的 `Content-Length`、`Last-Modified` 和 `ETag` 等字段，用于后续比对版本与校验完整性。若发现某次下载后，再次访问时返回状态码 416（Requested Range Not Satisfiable），则说明服务器未提供分段下载支持，而 PikPak 的断点续传机制依赖于此。此时即便协议看似是标准 HTTP，也因缺乏关键响应头而不被判定为“可离线”。

此外，某些看似通用的协议如 WebDAV、SMB、NFS 等，虽在理论上可通过中间层代理实现，但在 PikPak 当前架构下并不原生支持。用户若尝试输入 `smb://192.168.1.100/share` 类型地址，系统将直接拒绝并提示“不支持的协议”。此类错误并非技术缺陷，而是产品定位决定的边界——PikPak 不追求成为万能协议桥接器，而是聚焦于已知、稳定、可预测的云端文件获取流程。

值得注意的是，部分用户误以为“只要文件能下载，就能离线”，但事实是，离线功能的触发条件包括：下载任务完成、文件写入本地缓存目录、且无外部依赖（如 API 接口调用、token 续期）。若某个资源需通过二次接口请求元数据（如 `/api/v1/meta?file_id=xxx`）才能获取真实路径，即使主文件已下载，系统仍会因缺少元数据而无法展示。这种现象在私有云或企业级存储中尤为常见，也印证了 where ar7u is heading 1 所指出的未来方向：协议抽象层的解耦与上下文感知能力的增强，正是解决此类“表面支持、实际不可用”问题的关键路径。

最终，判断一个协议是否被 PikPak 支持，不能仅看协议名是否出现在文档列表中，而应从三方面验证：能否以标准 HTTP GET 请求发起；是否返回完整且稳定的响应头；是否在无网络情况下仍能复现相同结果。任何一环缺失，即意味着该协议在当前版本中不具备有效离线能力。