使用 Dev Proxy 搭配 PowerShell

一目了然
目標: 設定 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 會話在啟動時會快取系統代理設定。 這表示如果你:

  1. 開啟 PowerShell 工作階段
  2. 啟動開發代理(它會自動設定為系統代理)
  3. 從原始 PowerShell 會話中發出 HTTP 請求

請求不會經過開發代理,因為 PowerShell 會使用會話開始時快取的代理設定。

同樣地,如果你:

  1. 啟動開發代理伺服器
  2. 開啟 PowerShell 會話並發送請求(這些請求會被正確攔截)
  3. 停止開發代理
  4. 從同一個 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 會話中的代理。