跳至主要內容

將 Mastra 部署至 Digital Ocean

本指南涵蓋 Digital Ocean 的 App Platform 和 Droplets。這兩種服務各有所長，適合不同類型的項目和具備不同專業水平的開發人員。請閱讀 Digital Ocean 的比較，了解兩者的分別，並為你的項目選擇最合適的方案。

資訊

本指南涵蓋如何部署 Mastra 伺服器。如果你使用伺服器 adapter 或網絡框架，請按該框架的一般方式部署。

開始之前
開始之前 的直接連結

你需要一個 Mastra 應用程式和一個 Digital Ocean 帳戶。

App Platform 使用臨時檔案系統，因此你設定的任何儲存空間（包括可觀測性儲存空間）都必須託管於外部。如果你透過檔案 URL 使用 LibSQLStore，請改用遠端託管的資料庫。

App Platform
App Platform 的直接連結

設定好項目後，將它推送至你選擇的遠端 Git Provider（例如 GitHub）。

  1. 按照官方的 App Platform 快速入門操作。當中會引導你連接儲存庫、選擇要部署的分支，並在有需要時設定來源目錄。

  2. 確保系統偵測到「Node.js」構建。你需要設定構建命令，並按所用的依賴套件管理工具設定：

    npm run build

  3. 加入 Mastra 應用程式所需的所有環境變數，包括 API 金鑰、資料庫 URL 和其他設定值。

  4. 系統會自動構建並部署你的應用程式。Digital Ocean 會提供 URL，讓你存取已部署的應用程式。

  5. 你現在可以透過 HTTP 呼叫 Mastra 端點。

    注意

    在公開端點前，請先設定身份驗證。

Droplets
Droplets 的直接連結

先決條件
先決條件 的直接連結

  • 執行 Ubuntu 24.04 LTS 或更新版本的 Droplet
  • 一個已有 A 記錄指向 Droplet 的網域名稱
  • 已設定反向代理（例如使用 nginx）
  • 已設定 SSL 憑證（例如使用 Let's Encrypt）
  • Droplet 已安裝 Node.js 22.13.0 或更新版本

部署
部署 的直接連結

設定好項目後，將它推送至你選擇的遠端 Git Provider（例如 GitHub）。連接至 Droplet，並確保已安裝 git。

  1. 複製你的儲存庫：

    git clone https://github.com/<your-username>/<your-repository>.git

    前往儲存庫目錄：

    cd "<your-repository>"

  2. 安裝項目的依賴套件：

    npm install

  3. 設定 Mastra 應用程式所需的環境變數。在項目根目錄建立 .env 檔案：

    touch .env

    編輯 .env 檔案，並加入環境變數：

    .env
    OPENAI_API_KEY=your-api-key

  4. 構建項目：

    npm run build

    這會在 .mastra/output 目錄建立 Mastra 伺服器的正式版本構建。

  5. 你可以執行 mastra start 命令來啟動 Mastra 伺服器：

    mastra start
    資訊

    Mastra 應用程式預設會在連接埠 4111 執行。請確保反向代理已設定為將請求轉送至此連接埠。

  6. 你現在可以透過 HTTP 呼叫 Mastra 端點。

    注意

    在公開端點前，請先設定身份驗證。

On this page