在隔離環境中部署 Data API Builder

本指南將教你如何在沒有網路連線的環境中安裝並執行 Data API 建構器（DAB）。 實體隔離部署在醫療、國防、金融、能源及海事等環境中相當常見，在這些環境中，對外網路連線會受到限制或被禁止。

先決條件

  • 一台能上網下載套件的機器（稱為「暫存機」）。
  • 目標的空中隔斷機器，支援作業系統。
  • 一種在機器間傳輸檔案的方法（USB 隨身碟、核准的檔案傳輸等）。

步驟 1：在暫存機器上下載套件

在有網路連線的機器上，下載所有必要的套件。

下載 .NET 執行階段

請從 .NET 下載頁面 下載適用於您的目標作業系統的 .NET 9.0 ASP.NET Core 執行階段二進位封存檔。 選擇 ASP.NET Core 執行時二進位檔案（Linux 為 .tar.gz，Windows 為 .zip），而非安裝程式或 SDK。

Important

DAB 需要 ASP.NET Core 執行環境，而不只是基本的 .NET 執行環境。 下載 ASP.NET Core 的二進位檔案，這樣就能在沒有安裝程式的情況下解壓。

從 .NET 9.0 下載頁面下載 ASP.NET Core 執行階段 .zip。 選擇目標平台的 Binaries 欄位（x64）。

下載 Data API 建構套件

使用 dotnet tool install 搭配 --tool-path，將 DAB 及其所有相依項目下載到可攜式目錄中：

dotnet tool install --tool-path ./dab-tool Microsoft.DataApiBuilder

此指令建立一個包含所有所需檔案的自包含工具目錄。

步驟二：將檔案傳輸到空氣隔斷機器

將這些項目複製到目標機器：

  • ASP.NET Core 執行時二進位封存檔（.zip 或 .tar.gz）
  • 包含 DAB 工具及所有相依關係的 dab-tool 目錄

步驟三：安裝在有空氣隔熱的機器上

安裝 .NET 執行環境

解壓執行時的二進位壓縮檔。 不需要安裝或網路連線。

Expand-Archive -Path "aspnetcore-runtime-9.0.x-win-x64.zip" -DestinationPath "C:\dotnet"
$env:DOTNET_ROOT = "C:\dotnet"
$env:PATH = "C:\dotnet;$env:PATH"

安裝資料 API 建構器

dab-tool暫存機的目錄本身就已經是自成一體的。 把它加到你的 PATH：

$env:PATH = "C:\path\to\dab-tool;$env:PATH"
dab --version

步驟 4：設定並執行

  1. 建立你的設定檔：

    dab init --database-type mssql --connection-string "Server=<server>;Database=<database>;User ID=<user>;Password=<password>;TrustServerCertificate=true"

  2. 新增實體：

    dab add <entity-name> --source <schema>.<table> --permissions "anonymous:*"

  3. 啟動 DAB：

    dab start

驗證安裝

透過檢查 REST API 端點來確認 DAB 是否正在執行：

curl http://localhost:5000/api/<entity-name>

為了 MCP 伺服器驗證，請驗證健康端點是否回應：

curl http://localhost:5000/health

Tip

要測試 MCP 工具呼叫，請使用 MCP Inspector 或處理完整 MCP 協定初始化握手的 MCP 用戶端函式庫。

網路與防火牆考量

  • DAB 預設會在連接埠 5000 上接聽。 如有需要，使用 ASPNETCORE_URLS 進行調整。
  • 如果使用 CORS，請在您的 dab-config.json 中設定允許的來源。
  • 執行時不需要外網存取。 DAB 完全針對本地或網路可存取的資料庫運作。

相關內容

  • Last updated on