Sing-box在macOS上的Clash API接口响应截断问题分析

问题背景

Sing-box是一款流行的网络工具，其1.11.3版本在macOS Sequoia 15.3系统上运行时，用户报告了一个关于API接口响应不完整的问题。具体表现为当通过浏览器访问API接口时，返回的index.html内容被截断，仅返回512字节的数据。

问题现象

用户在使用macOS App Store安装的1.11.3版本时发现：

1. 通过curl命令访问http://127.0.0.1:9091/ui/接口时，响应内容不完整
2. Wireshark抓包显示，服务器在发送第一个TCP包后立即发送FIN包主动关闭连接
3. 类似问题也出现在Windows 11 24H2系统上，当/proxies接口响应过长时也会被截断

技术分析

经过开发者调查，发现该问题具有以下特点：

1. 仅出现在macOS 15.0及以上版本
2. 仅在使用Network Extension时出现（命令行运行sing-box无此问题）
3. 推测与Go语言的http.FileServer实现与系统安全策略的交互有关

解决方案

开发者采取了以下措施解决该问题：

1. 自行实现了FileServer替代Go标准库的实现
2. 在1.12.0-alpha.9版本中进行了修复测试
3. 后续发布的1.11.4版本中完全解决了该问题

验证结果

用户验证表明：

1. 从GitHub下载的SFM-1.11.4-universal.dmg安装后，API接口响应完整
2. 从App Store下载的1.11.4版本也解决了该问题

技术启示

这个问题展示了跨平台开发中的一些挑战：

1. 系统安全策略可能影响网络通信行为
2. 标准库实现在不同平台可能有不同的表现
3. 网络扩展机制在不同操作系统版本间可能存在兼容性问题

对于开发者而言，这类问题的解决需要：

1. 深入理解各平台网络栈实现差异
2. 掌握网络协议分析工具的使用
3. 具备替代标准库实现的能力

总结

Sing-box团队通过快速响应和深入分析，成功解决了macOS上API接口响应截断的问题。这体现了开源项目对用户体验的重视和技术实力。用户只需升级到1.11.4或更高版本即可避免此问题。