跳至主要內容

將 Mastra 部署至 Digital Ocean

本指南涵蓋 Digital Ocean 的 App Platform 與 Droplets。這兩項服務各有優勢，適合不同類型的專案與開發者經驗程度。請閱讀 Digital Ocean 的比較文章，瞭解兩者差異並為你的專案選擇最合適的方案。

資訊

本指南說明如何部署 Mastra server。如果你使用 server adapter 或 web framework，請依照該框架平常的方式部署。

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

你需要一個 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
  • 一個具有指向你 Droplet 之 A 記錄的網域名稱
  • 已設定反向 Proxy（例如使用 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 server 的正式環境建置版本。

  5. 你可以執行 mastra start 指令來啟動 Mastra Server：

    mastra start
    資訊

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

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

    警告

    將端點公開之前，請先設定驗證。

On this page