tusd在Google Cloud Run环境中实现大文件上传的技术实践

背景与问题分析

在基于Google Cloud Run部署tusd服务时，开发者遇到了上传进度无法正常反馈的问题。经过排查发现，这与Cloud Run的特殊网络环境限制密切相关。Cloud Run作为无服务器容器平台，其前端负载均衡器会终止TLS连接，并以HTTP/2明文（h2c）方式向后端转发请求。

技术瓶颈解析

核心问题源于两个技术层面的限制：

1. HTTP/2明文传输限制：Cloud Run负载均衡器与后端服务之间采用h2c协议，而标准Go语言net/http库仅支持基于TLS的HTTP/2
2. 请求大小限制：Cloud Run对HTTP/1请求有32MB的大小限制，这对大文件上传产生严重影响

解决方案对比

临时解决方案（已验证有效）

1. 调整分块大小：通过设置tus-js-client的chunkSize参数（小于32MB），可以规避HTTP/1请求限制
2. 引入Nginx代理层：
   • 接收Cloud Run的h2c请求
   • 转换为HTTP/1.1与tusd服务通信
   • 实现协议转换的同时保持上传功能

长期解决方案（待实现）

基于golang.org/x/net/http2/h2c包实现HTTP/2明文支持：

• 需注意首次请求内存占用问题
• 需要添加明确的文档说明
• 保持与现有功能的兼容性

最佳实践建议

1. 对于生产环境，推荐采用Nginx代理方案作为过渡
2. 开发测试时可临时使用小分块上传方案
3. 密切关注Go语言对h2c支持的发展动态
4. 对于超大文件（>1GB）上传，建议评估分块大小对性能的影响

经验总结

云原生环境下部署文件上传服务时，需要特别注意：

• 平台特定的网络协议栈实现
• 请求大小限制等隐形约束
• 协议转换带来的性能损耗
• 客户端与服务端的协同适配

通过本文的分析和方案对比，开发者可以更好地在Cloud Run环境中部署tusd服务，实现稳定可靠的大文件上传功能。