重要
為了改善從 Static Web Apps CLI 部署的安全性，引入了一個重大變更，要求您在 2025 年 1 月 15 日之前將靜態 Web Apps CLI 升級至最新版 2.0.2。
Azure Static Web Apps 網站裝載在雲端中，且通常會將雲端服務集合連線在一起。 在開發期間，每當您需要在本機執行應用程式時，都需要模擬應用程式在雲端中執行方式的工具。
Static Web Apps CLI （SWA CLI） 包含一系列本機服務，其近似於您的應用程式在 Azure 上執行的方式，但會改為只在您的電腦上執行。
Azure Static Web Apps CLI 提供下列服務：
- 本機靜態網站伺服器
- 前端框架開發伺服器的代理伺服器
- API 端點的 Proxy - 可透過 Azure Functions Core Tools 取得
- 模擬驗證和授權伺服器
- 強制執行本機路由和組態設定
運作方式
下圖顯示如何在本機處理要求。
重要
前往 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。
開始
使用下列資源開始使用 Static 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。