部署概覽
Mastra 應用程式可部署至任何與 Node.js 相容的環境。你可以部署 Mastra 伺服器、與現有 Web 框架整合、部署至雲端供應商,或使用 Mastra 平台進行可觀測性分析、使用 Studio 及部署伺服器。
Runtime 支援「Runtime 支援」的直接連結
Mastra 可在下列任何 runtime 環境中執行:
- Node.js
v22.13.0或更新版本 - Bun
- Deno
- Cloudflare
部署選項「部署選項」的直接連結
Mastra 伺服器「Mastra 伺服器」的直接連結
Mastra 提供由 Hono 驅動、可獨立部署的伺服器。使用 mastra build 指令建置應用程式,再將輸出部署至偏好的 VM、容器或 PaaS 平台。
需要完整掌控基礎架構、長時間執行的處理程序或 WebSocket 連線時,請使用此選項。Mastra 伺服器部署指南提供更多詳細資訊。
Monorepo「Monorepo」的直接連結
將 Mastra 伺服器部署為 monorepo 設定的一部分,方法與獨立部署相同。
請閱讀 monorepo 部署。
Mastra 平台「Mastra 平台」的直接連結
Mastra 平台提供三項產品,可用來部署、監控及管理以 Mastra 框架建置的 AI 應用程式:
- 可觀測性:獨立的託管產品,可搜尋各 Mastra 專案與部署的 Trace、記錄及指標
- Studio:用於測試 Agent、執行 Workflow 及檢查 Trace 的託管視覺化環境
- 伺服器:以 API 伺服器形式執行 Mastra 應用程式的正式環境部署目標
詳情請參閱 Mastra 平台概覽。
雲端供應商「雲端供應商」的直接連結
Mastra 應用程式可部署至雲端供應商與無伺服器平台。Mastra 內含適用於 Vercel、Netlify 與 Cloudflare 的選用內建部署器,可將建置和部署流程自動化。
需要自動擴展、儘量減少基礎架構管理,或已使用其中一個平台時,請使用此選項。
Sandbox「Sandbox」的直接連結
將 Mastra 伺服器部署至暫時性的 Workspace Sandbox(例如 Vercel Sandbox 或 E2B),幾秒內即可取得可用的公開 URL。
此選項適合即時預覽、從 CI pipeline 部署、驗證 Agent 建置的應用程式,或為每位使用者執行不受信任的獨立執行個體。請閱讀 Sandbox 部署指南。
Web 框架「Web 框架」的直接連結
Mastra 與 Web 框架整合後,會使用該框架的標準部署流程,隨應用程式一同部署。下列指南涵蓋部署時各框架特有的設定需求。
將 Mastra 加入現有的 Next.js 或 Astro 應用程式時,請使用這些指南。
Workflow 執行器「Workflow 執行器」的直接連結
Mastra Workflow 預設使用內建執行引擎。若正式環境工作負載需要代管基礎架構,也可將 Workflow 部署至 Inngest 等專用平台,以使用步驟記憶化、自動重試及即時監控功能。
執行選項請參閱 Workflow 執行器指南,設定說明請參閱 Inngest 部署指南。
Workers「Workers」的直接連結
在正式環境部署中,Mastra 可在與 API 伺服器分離的專用 worker 處理程序內執行 Workflow 協調、cron 排程及背景 Tool。如此便能獨立擴展各項職責並隔離故障。詳情請參閱 Workers。