tg-vault/upload_architecture.md

上传架构 📤

当前流程：服务器中转上传（代理模式）

目前，TG Vault 采用 服务器中转 的上传策略，这种设计确保了跨平台存储的统一性与安全性。

🔄 核心步骤

1. 客户端 -> 服务器：前端上传组件将文件发送到后端服务器（/api/upload 接口）。
2. 服务器缓存：后端服务器接收文件并将其保存到临时目录（backend/uploads）。
3. 服务器 -> 存储源：存储管理器 (StorageManager) 根据当前激活的提供商，将临时文件实际推送到对应端（OneDrive, S3, WebDAV 等）。
4. 清理与反馈：上传成功后，服务器会删除临时文件，并通知前端更新列表。

✅ 优势

• 极致安全：所有存储 API 密钥、Refresh Token 仅由后端持有，绝不暴露给客户端。
• 跨平台一致性：前端无需关心存储协议（S3/WebDAV/OSS），只需通过统一的 API 进行交互。
• 功能预处理：服务器可以在文件最终入库前，自动执行缩略图生成、视频转码或杀毒扫描。

⚠️ 局限性

• 流量成本：上传流量会被消耗两次（由于服务器中转）。
• 延迟增加：文件需要完整落盘服务器后再推送到第三方云端，会有一定的链路延迟。

Note

尽管代理模式增加了服务器负载，但它极大简化了前端逻辑，并提供了最佳的隐私保护。

---

返回文档中心 源码