For AI agents: fetch the complete documentation index at /llms.txt, the full documentation corpus at /llms-full.txt, the agent skill at /skill.md, or this page as Markdown at /zh/docs/web/deployment.md (or send Accept: text/markdown).

部署清单

准备生产依赖，并验证你打算交付的流程。

询问本指南

按此顺序准备公共应用程序

部署意味着在托管服务上运行您的应用程序，以便其他人可以访问它。 localhost 只能在您的开发环境中访问。首先在本地完成真正的数据库支持的登录，选择下面的托管指南，创建单独的测试数据库，并使用实际的公共 HTTPS 应用程序 URL 配置主机的环境设置。将本地演示设置与公共应用程序分开。

在存储库根目录的第二个终端中，运行下面的 Web 检查。成功的构建会在您的计算机上创建一个生产版本；它不会上传或发布它。不要将 corepack pnpm --filter @supastack/web start 与部署混淆：start 在本地运行之前构建的版本。仅在端口 3000 上停止开发服务器后运行它。

请遵循所选主机的迁移、环境和启动步骤指南。测试注册、电子邮件代码、重启后保存的帐户数据以及开始销售前提供商沙箱中的付费功能。移动或桌面客户端必须指向此正在运行的 HTTPS 后端。发布本机应用程序是一个单独的步骤，记录在其平台的分发指南中。

corepack pnpm --filter @supastack/web typecheck
corepack pnpm --filter @supastack/web build

准备服务

创建 Postgres 数据库，应用存储库的迁移，并在托管仪表板中输入公共应用程序 URL 和身份验证设置。为您启用的功能选择一个受支持的网络计费提供商和一个交易电子邮件提供商。当您的产品使用其后台工作流程时配置 Trigger.dev；您不需要每次集成来发布基本应用程序。

在接受生产 AI 任务之前，配置好不可变的模型/价格目录与工作区 AI 策略。空的别名策略应让这些选项不可用。

构建并部署 Web 应用

从存储库根目录运行以下 Web 命令并解决所有错误，然后再继续。 typecheck 检查类型，test 运行 Web 测试，build 在本地创建生产文件。按照您选择的托管指南上传并使用其服务器端环境设置运行它们。这些命令不会部署应用程序。

corepack pnpm --filter @supastack/web typecheck
corepack pnpm --filter @supastack/web test
corepack pnpm --filter @supastack/web build

验证已部署的边界

在已部署数据库上验证登录与持久化；测试工作区隔离；确认 Stripe 沙箱 webhook 处理与权限变更；跑一个后台任务直到结果持久化与事务性投递。

阅读仓库中的 docs/real-provider-smoke.md 与 docs/production-ai-runtime.md 了解显式的供应商验收流程。构建成功或被拦截的浏览器测试并不能证明这些外部结果。