Velociraptor项目在Firefox 127+版本中的文件下载异常分析与解决方案

在Velociraptor项目的使用过程中，部分用户反馈在Firefox 127及以上版本中下载文件时，文件名前后会被自动添加下划线。这一现象引起了开发团队的关注，经过深入分析，发现这与HTTP协议规范中Content-Disposition头部的处理方式变化有关。

问题现象

当用户通过Velociraptor GUI界面下载文件时，使用Firefox 127+版本浏览器会观察到：

• 下载的文件名前后被自动添加下划线字符
• 需要手动重命名才能正常使用文件
• 该问题在Chromium内核浏览器(如Chrome、Edge)中不会出现

技术分析

问题的根源在于HTTP响应头中Content-Disposition字段的处理差异。根据RFC 5987规范：

1. filename*参数应采用RFC 5987编码格式，示例格式为：filename*=UTF-8''%c2%a3%20and%20%e2%82%ac%20rates
2. 标准filename参数则应使用引号包裹，如：filename="example.jpg"

Velociraptor项目原先的实现中，对filename*参数也使用了引号包裹，这在旧版浏览器中能被宽容处理，但Firefox 127+版本开始严格执行RFC规范，将引号视为文件名的一部分，导致系统自动将其替换为下划线。

解决方案

开发团队通过以下调整解决了该问题：

1. 移除了filename*参数中的引号包裹
2. 确保仅对标准filename参数使用引号
3. 保持对RFC 5987编码格式的严格遵守

这一修改既解决了Firefox中的异常问题，又保持了对其他浏览器的兼容性。

经验总结

该案例揭示了浏览器对HTTP标准实现逐渐严格化的趋势。开发者在处理HTTP头部时应当：

• 严格遵循相关RFC规范
• 避免对标准参数和扩展参数采用相同的处理方式
• 针对不同浏览器进行充分测试

Velociraptor项目通过这次问题修复，不仅解决了具体的技术问题，也提升了代码对HTTP标准的合规性，为后续的跨浏览器兼容工作打下了良好基础。