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-tw/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 瞭解顯式的供應商驗收流程。構建成功或被攔截的瀏覽器測試並不能證明這些外部結果。