用途:Static-Hosting 是一个 Convex 组件,让开发者无需外部托管服务,直接从 Convex 提供 React/Vite 静态应用。它通过 Convex HTTP actions 从 Convex 存储中读取并返回文件,适合把前端与 Convex 后端放在同一次部署中。
主要能力:支持单页应用的自动 SPA 回退(spaFallback 选项对未匹配路由返回 index.html),对 Vite 等打包器生成的哈希资源设置长期缓存头,HTML 文件使用 ETag 保证新鲜度;部署时通过内部函数上传构建产物,只有经过认证的 CLI 用户可执行;自动垃圾回收旧部署文件,避免存储膨胀。
使用方式:安装命令为 npm install @convex-dev/static-hosting(当前 npm 版本 @convex-dev/static-hosting@0.2.1)。在 Convex 应用配置与 HTTP 路由中集成,使用 registerStaticRoutes() 提供文件服务。部署时 CLI 通过 generateUploadUrl()、recordAsset() 等内部函数上传构建产物,这些函数仅能通过已认证的 npx convex run 命令访问。部署可采用一次性命令:先以正确的生产 VITE_CONVEX_URL 构建前端,再部署 Convex 后端,最后上传静态文件;也可使用分开的上传命令获得更多控制。
适用场景:全栈应用单后端部署、快速原型与演示、内部工具与管理后台、自包含 SaaS 应用,以及利用部署查询钩子实现新版本可用通知并提示刷新页面。
限制:不适用于已有更简单内置方案的场景、未使用 Convex 作为后端的项目,或不需要该组件功能的场景。资料未提供收费、价格与平台支持等更多细节。