部署

Mastra 应用可以部署到任何与 Node.js 兼容的环境。你可以部署 Mastra 服务端，或与现有 Web 框架集成。其他选项包括云提供商，以及用于可观测性、Studio 和服务端部署的 Mastra 平台。

运行时支持

Mastra 可以运行在以下任一运行时环境中：

• Node.js v22.13.0 或更高版本
• Bun
• Deno
• Cloudflare

部署选项

Mastra 服务端

Mastra 提供一个由 Hono 驱动的服务端，可以独立部署。使用 mastra build 命令构建应用，并将产物部署到你偏好的 VM、容器或 PaaS 平台。

当你需要完全控制基础设施、长时间运行的进程或 WebSocket 连接时，请使用此选项。Mastra 服务端部署指南提供了更多细节。

Monorepo

在 monorepo 中部署 Mastra 服务端，方法与独立部署相同。

阅读 monorepo 部署。

Mastra 平台

Mastra 平台提供三个产品，用于部署、监控和管理使用 Mastra 框架构建的 AI 应用：

• 可观测性：一个独立托管的产品，可跨 Mastra 项目和部署搜索 Trace、日志和指标
• Studio：一个托管可视化环境，用于测试 Agent、运行 Workflow 以及检查 Trace
• 服务端：一个生产部署目标，将你的 Mastra 应用作为 API 服务端运行

在 Mastra 平台概述中了解更多。

云提供商

Mastra 应用可以部署到云提供商和无服务器平台。Mastra 内置可选的 Vercel、Netlify 和 Cloudflare 部署器，可为相应平台构建应用。然后，你通过平台本身部署构建产物。

当你需要自动扩缩容、尽量减少基础设施管理，或已经在使用这些平台时，请使用此选项。

• Amazon Bedrock AgentCore
• Amazon EC2
• AWS Lambda
• Azure App Services
• Cloudflare
• Digital Ocean
• Inngest
• Kubernetes
• Kubernetes (Helm)
• Neon
• Netlify
• Render
• Temporal
• Vercel

沙箱

将 Mastra 服务端部署到临时工作区沙箱（例如 Vercel Sandbox 或 E2B），几秒内即可获得可公开访问的 URL。

此选项适用于即时预览、从 CI 流水线部署、验证 Agent 构建的应用，或运行不受信任的按用户实例。阅读沙箱部署指南。

Web 框架

当 Mastra 与 Web 框架集成时，它会使用该框架的标准部署流程随应用一起部署。以下指南介绍部署时特定框架的配置要求。

在将 Mastra 添加到现有 Next.js 或 Astro 应用时，请使用这些指南。

• 在 Vercel 上使用 Next.js
• 在 Vercel 上使用 Astro
• 在 Netlify 上使用 Astro

Workflow Runner

Mastra Workflow 默认使用内置执行引擎运行。对于需要托管基础设施的生产工作负载，Workflow 也可以部署到 Inngest 等专用平台，以获得步骤记忆化和自动重试，并支持实时监控。

访问 Workflow Runner 指南了解执行选项，访问 Inngest 部署指南了解设置说明。

Worker 进程

对于生产部署，Mastra 可以在独立于 API 服务端的专用 Worker 进程中运行 Workflow 编排、定时调度以及后台工具执行。这样你可以独立扩展各项职责并隔离故障。详情请参阅 Workers。