部署上线

准备顺序

先在隔离本地环境确认网站、账号和工具流程，再准备预发布资源，最后配置生产。部署目标由公开站、工作台和接口三个 Worker，加上 PostgreSQL、两个 Hyperdrive 及外部邮件和支付服务组成。

完整配置及验收表见 部署与验收。本教程说明命令和责任边界，不表示已经替你创建或部署这些资源。

发布前检查

1. 替换域名、品牌、发信地址和占位配置，生成各环境独立认证密钥。
2. 配置数据库、应用角色及两个 Hyperdrive，写入正确环境的绑定 ID。
3. 设置 Worker 环境变量与秘密，核对第三方回调和价格。
4. 完成类型、格式、测试、网站和文档构建。
5. 备份数据库并审查本次迁移，确保旧代码兼容新结构。

手动发布

# 以下命令会更新对应环境，准备完成后再执行
bun db:migrate:staging
bun deploy:staging

生产对应 db:migrate:production 和 deploy:production。部署脚本不自动迁移数据库；CI 则先迁移再部署 Worker。发布顺序为接口、工作台、公开入口，三个步骤不是原子操作。

发布后验证

检查首页静态正文、工具预览及下载、注册与会话、历史隔离、积分幂等、邮件投递、订阅事件与组织权限。配置诊断和编译通过不能替代线上验收。

文档单独构建和发布；本地文档默认禁止搜索索引，公开部署需要正确 DOCS_SITE_URL。客户站的 PUBLIC_SITE_URL 与 APP_ORIGIN 应指向同一正式域名。

详细步骤见 部署边缘服务、生产数据库 和 自动检查与发布。