部署概览

模板提供人工部署和 AI 部署两条路径。两者使用同一份源码、配置、预检、迁移和健康检查规则，区别只是由谁执行操作。

先选择运行方式

方式	适合人群	你需要做什么	文档
本地 Mock	购买前体验、开发和页面走查	安装 Node 与 pnpm，一条命令启动	本地体验
人工部署	熟悉 Linux、Docker 与域名的开发者	逐项配置并执行部署、验证、备份	人工部署
AI 部署	希望 AI 按仓库协议执行的用户	提供服务器权限与业务选择，保管密钥并复核报告	AI 部署

AI 部署不是托管服务。服务器、域名、数据库、第三方账号和生产责任仍由站点运营者持有。

生产结构

典型生产流量从 Nginx 进入主站与 Auth，业务接口由 Space API 提供，PostgreSQL 和 Redis 只在内部网络中访问。Worker 独立运行定时与异步任务。

正式上线至少需要：

• 主站、Auth 与 API 使用 HTTPS 域名。
• PostgreSQL、Redis 和持久卷有备份与恢复方案。
• Cookie、Session、CSRF、数据库与机器令牌使用独立高熵密钥。
• 按启用模块配置对象存储、支付、邮件、视频或 AI Provider。
• 数据库与 Redis 不直接暴露到公网。
• 部署前通过 pnpm ops:template:preflight。

推荐顺序

1. 先在本机运行完整 Mock，确认产品是否满足需要。
2. 确定站点名称、域名、启用模块和 Provider。
3. 准备服务器、DNS、第三方账号和生产密钥。
4. 在服务器执行安装、配置校验和安全预检。
5. 启动生产服务并验证登录、上传、支付和邮件等真实链路。
6. 完成备份恢复演练，再正式导入内容和用户。

部署不是结束

上线后还需要持续执行：版本升级、数据库备份、对象存储备份、证书续期、日志与告警检查、密钥轮换和安全更新。对应流程见升级与回滚和安全说明。