Pangolin项目文件传输限制问题分析与解决方案

问题背景

Pangolin作为一款开源的网络工具，在文件传输方面遇到了与某些隧道服务类似的问题。多位用户报告称，当上传文件大小超过约370MB时，会出现传输失败的情况。这一问题影响了包括Nextcloud、Immich和Synology Photos在内的多个应用程序。

问题现象

通过用户测试发现，不同应用程序在Pangolin环境下表现各异：

• Nextcloud：1.16GB视频文件上传成功且可播放
• Immich：上传失败，日志显示"Request error while uploading file, cleaning up"
• Synology Photos：显示上传完成但实际文件缺失

相比之下，使用Nginx Proxy Manager时，所有测试应用都能成功上传并播放大文件。

技术分析

经过深入调查，发现问题根源在于Traefik的默认配置限制。具体表现为：

1. 传输超时设置不足，导致大文件上传过程中连接中断
2. 默认MTU值(1280)设置较低，可能影响传输效率
3. 内存缓冲区限制可能导致大文件传输失败

解决方案

1. 调整Traefik超时设置

在traefik_config.yml文件中添加以下配置可显著改善大文件传输：

websecure:
  address: ":443"
  transport:
    respondingTimeouts:
      readTimeout: 30m

这一配置将读取超时延长至30分钟，为大文件上传提供足够的时间窗口。

2. 优化MTU设置

虽然提高MTU值(如1420)不能直接解决传输中断问题，但可以提升传输效率。可通过以下方式设置：

# 在gerbil和newt容器中设置环境变量
MTU=1420

3. 内存资源调整

对于特别大的文件传输，确保容器有足够的内存资源也很重要。可以通过Docker的-m参数或Compose文件中的mem_limit进行调整。

验证结果

实施上述解决方案后，用户测试显示：

• Immich Web和移动端应用均能成功上传1GB以上文件
• Synology Photos上传功能恢复，虽然进度显示仍有优化空间
• 传输稳定性显著提升，不再出现370MB左右的传输中断

最佳实践建议

1. 对于生产环境，建议将readTimeout设置为实际业务需求的最小值
2. 定期监控传输性能，根据网络条件调整MTU值
3. 对于内存敏感的应用，考虑分块上传策略
4. 保持Pangolin组件(gerbil和newt)更新至最新版本

总结

Pangolin项目通过调整Traefik配置成功解决了大文件传输限制问题。这一改进使得Pangolin在文件传输能力上超越了某些隧道服务的100MB限制，为需要处理大文件的用户提供了可靠解决方案。项目团队已将此修复纳入正式版本，用户只需更新即可获得完整的文件传输支持。