一目了然
目標: 設定 PowerShell 以配合開發代理運作
時間: 5分鐘
前置條件:設定開發代理
Dev Proxy 支援所有作業系統上的 PowerShell。 在 macOS 上,PowerShell 能正確偵測系統代理變更,且不需要額外設定。 在 Linux 上,Dev Proxy 不會設定系統代理,所以你需要設定代理的環境變數。 在 Windows 上,PowerShell 會快取代理設定,這需要額外步驟。
macOS
在 macOS 上,PowerShell 會自動偵測系統代理變更。 啟動 Dev Proxy,並像平常一樣使用 PowerShell——請求會被攔截,無需額外設定。
Linux
在 Linux 上,Dev Proxy 不會註冊為系統代理,PowerShell 只從環境變數讀取代理設定。 啟動 Dev Proxy 後,請在 PowerShell 工作階段中設定 HTTPS_PROXY 和 HTTP_PROXY 環境變數:
$env:HTTPS_PROXY = "http://127.0.0.1:8000"
$env:HTTP_PROXY = "http://127.0.0.1:8000"
使用完 Dev Proxy 後,清除環境變數:
$env:HTTPS_PROXY = $null
$env:HTTP_PROXY = $null
窗戶
當你在 Windows 上使用 Dev Proxy 搭配 PowerShell 時,可能會遇到 PowerShell 無法偵測系統代理何時啟動或停止的問題。 此問題影響 Windows PowerShell(5.1)與 PowerShell 7+(核心版)。
問題
在 Windows 上,PowerShell 會話在啟動時會快取系統代理設定。 這表示如果你:
- 開啟 PowerShell 工作階段
- 啟動開發代理(它會自動設定為系統代理)
- 從原始 PowerShell 會話中發出 HTTP 請求
請求不會經過開發代理,因為 PowerShell 會使用會話開始時快取的代理設定。
同樣地,如果你:
- 啟動開發代理伺服器
- 開啟 PowerShell 會話並發送請求(這些請求會被正確攔截)
- 停止開發代理
- 從同一個 PowerShell 會話發出請求
請求失敗是因為 PowerShell 仍嘗試使用已不存在的代理伺服器。
解決方法:重新啟動 PowerShell 會話
最簡單的解決方法是啟動或停止 Dev Proxy 後,重新啟動 PowerShell 工作階段。 重新啟動會話可以確保 PowerShell 會接收目前的系統代理設定。
替代方案:手動設定代理伺服器
你可以不依賴系統代理偵測,可以設定開發代理不註冊為系統代理,並在 PowerShell 中手動設定代理。
步驟 1:啟動開發代理(Dev Proxy),不使用系統代理
使用 --as-system-proxy false 選項啟動開發代理。
devproxy --as-system-proxy false
步驟 2:在 PowerShell 中設定代理環境變數
在你的 PowerShell 工作階段中,設定環境變數:HTTPS_PROXY
$env:HTTPS_PROXY = "http://127.0.0.1:8000"
如果你也需要攔截 HTTP 請求:
$env:HTTP_PROXY = "http://127.0.0.1:8000"
步驟 3:完成後清除代理
使用完 Dev Proxy 後,清除環境變數:
$env:HTTPS_PROXY = $null
$env:HTTP_PROXY = $null
使用 PowerShell 設定檔
為了簡化代理設定,你可以在 PowerShell 設定檔中建立函式。 將以下事項加入您的 $PROFILE 檔案:
function Set-DevProxy {
$env:HTTP_PROXY = "http://127.0.0.1:8000"
$env:HTTPS_PROXY = "http://127.0.0.1:8000"
Write-Host "Dev Proxy enabled"
}
function Clear-DevProxy {
$env:HTTP_PROXY = $null
$env:HTTPS_PROXY = $null
Write-Host "Dev Proxy disabled"
}
接著你可以用 Set-DevProxy 和 Clear-DevProxy 指令快速啟用或停用 PowerShell 會話中的代理。