飞牛同步 连接方式HTTPS 缺省端口下连接异常

zhjay

问题描述

在使用反向代理或 Cloudflare Tunnels 环境下，NAS 通过标准的 HTTPS 443 端口对外提供服务。

• 现象 A： 当连接地址填写为 https://xxxx.com（省略端口）时，客户端可以正常验证身份并登录成功。
• 现象 B： 登录后，同步任务报错 状态异常。日志显示 [ERROR] 创建连接失败: Host连接类型需要指定端口。
• 临时解决方法： 必须手动将地址改为 https://xxxx.com:443 才能恢复正常。

技术分析

1. 符合 RFC 标准的预期： 根据网络协议规范，当 URI scheme 为 https 且未指定端口时，客户端程序应自动缺省补全为 443。
2. 逻辑不一致： 目前客户端的“登录模块”支持缺省端口解析，但底层的“同步/连接模块”（fn_sync_client_lib）显然缺乏这一逻辑，导致其在解析不带冒号的 URL 时直接抛出错误。
3. 用户体验差： 既然登录阶段已经成功建立了连接，后续的同步任务理应沿用登录时的地址属性，而不应强制要求用户手动标注标准端口。

优化建议

1. 增加 URL 自动补全逻辑： 建议在底层库 fn_sync_client_lib 中增加判断：若检测到连接前缀为 https:// 且 host 部分无端口声明，自动赋值 443；同理 http:// 赋值 80。
2. 统一连接上下文： 确保同步任务直接复用登录成功后的有效 Endpoint 信息，避免二次解析 URL 时出现标准不统一的问题。
3. 兼容性改进： 即使默认端口是 5667 或其他自定义端口，如果用户是通过 443 登录进来的，说明当前网络环境（如反代、WAF）已经完成了端口映射，客户端应“顺着”现有的 443 通道进行数据传输。

飞牛产品同学

感谢反馈，这个我们转给相关同事评估一下