00 / 00
部署指南
上线前检查、部署方式选择、环境变量、数据库迁移和部署后验证。
会员专属文章
项目是 Vite Plus + pnpm workspace monorepo，应用在 products/muse/apps/web 下。
默认生产路径是 Zeabur Docker + PostgreSQL + R2。Cloudflare 负责域名代理、HTTPS、WAF、基础访问统计和对象存储；如果你的主要用户在海外，也可以把同一套 Web 代码部署到 Cloudflare Workers。
部署方式选择
| 方式 | 适合场景 | 入口 |
|---|---|---|
| Zeabur Docker | 默认生产部署，适合大多数团队；Zeabur 托管 Docker 服务和 PostgreSQL，Cloudflare 做域名入口 | Zeabur 部署 |
| 自有服务器 Docker | 用户主要在国内、需要备案路径、需要控制服务器和网络环境 | Docker 部署 |
| Cloudflare Workers | 用户主要在海外、希望低成本使用 Cloudflare 边缘运行时；数据库仍然使用 PostgreSQL | Cloudflare Workers 部署 |
Vercel 不在推荐列表中，因为免费套餐的并发和额度极低，付费方案性价比偏低。Zeabur + Cloudflare 是成本更低、更可控的替代方案。
推荐架构原则
模板只让网页运行时可切换，数据库和对象存储不跟着部署平台分叉：
| 层级 | 选择 | 说明 |
|---|---|---|
| 数据库 | PostgreSQL | Docker、Zeabur、Cloudflare Workers 都连接同一类 PostgreSQL 数据库。国内部署可用自建或云数据库；海外部署可用 Supabase、Neon、Zeabur PostgreSQL 等 |
| 对象存储 | S3 兼容存储，默认示例为 Cloudflare R2 | 代码通过 S3 兼容 API 访问对象存储。R2 是默认推荐，但后续可切换到 AWS S3、腾讯云 COS 或 MinIO |
| Web 运行时 | Docker 或 Cloudflare Workers | Docker 适合国内、自有服务器和 Zeabur；Workers 适合海外轻量部署和 Cloudflare 边缘网络 |
这样做的好处是：国内和海外使用同一套业务代码、同一套数据库模型、同一套迁移和同一套文件存储接口。真正变化的是部署入口，不是产品本身。
这篇文档有问题？