共用方式為

Azure Static Web Apps CLI 概觀

  • 發行項

重要

為了改善靜態 Web Apps CLI 部署的安全性，引進了重大變更，要求您在 2025 年 1 月 15 日之前升級至最新版的靜態 Web Apps CLI。

Azure Static Web Apps 網站裝載在雲端中，且通常會將雲端服務集合連線在一起。 在開發期間，每當您需要在本機執行應用程式時，都需要模擬應用程式在雲端中執行方式的工具。

Static Web Apps CLI （SWA CLI） 包含一系列本機服務，其近似於您的應用程式在 Azure 上執行的方式，但會改為只在您的電腦上執行。

Azure Static Web Apps CLI 提供下列服務：

  • 本機靜態月臺伺服器
  • 前端架構開發伺服器的 Proxy
  • API 端點的 Proxy - 可透過 Azure Functions Core Tools 取得
  • 模擬驗證和授權伺服器
  • 強制執行本機路由和組態設定

運作方式

下圖顯示如何在本機處理要求。

顯示 Azure Static Web App CLI 要求和回應流程的圖表。

重要

移至 以 http://localhost:4280 存取 CLI 所提供的應用程式。

  • 對埠4280提出的要求會根據要求類型轉送至適當的伺服器。

  • 靜態內容 要求，例如 HTML 或 CSS，是由內部 CLI 靜態內容伺服器或前端架構伺服器處理以進行偵錯。

  • 驗證和授權 要求是由模擬器處理，其會為您的應用程式提供假身分識別配置檔。

  • Functions Core Tools 運行時間1 會處理月臺 API 的要求。

  • 所有服務的響應都會傳回至瀏覽器，就像是單一應用程式一樣。

一旦您獨立啟動UI和 Azure Functions API 應用程式，然後啟動 Static Web Apps CLI，並使用下列命令將它指向執行中的應用程式：

swa start http://localhost:<DEV-SERVER-PORT-NUMBER> --api-location http://localhost:7071

或者，如果您使用 swa init 命令，靜態 Web Apps CLI 會查看您的應用程式程式代碼，並建 置 CLI 的swa-cli.config.json組態檔。 當您使用 swa-cli.config.json 檔案時，您可以執行 swa start 以在本機啟動應用程式。

1 如果尚未在您的系統上，CLI 會自動安裝 Azure Functions Core Tools。

開始使用

使用下列資源開始使用靜態 Web Apps CLI。

資源 描述
安裝靜態 Web Apps CLI （SWA CLI） 將 Azure Static Web Apps CLI 安裝到您的電腦。
設定您的環境 設定應用程式讀取組態資訊的方式。
啟動網站模擬器 啟動服務以在本機服務您的網站。
啟動本機 API 伺服器 啟動服務以在本機服務 API 端點。
部署至 Azure 將您的應用程式部署至 Azure 上的生產環境。

注意

使用前端架構建置的網站通常需要 Proxy 組態設定，才能正確處理路由下 api 的要求。 使用 Azure Static Web Apps CLI 時，Proxy 位置值為 /api，而沒有 CLI，則值為 http://localhost:7071/api。

下一步

安裝 CII