Powershell 设置代理：完整指南与技巧 – wiki大全

作者： /

Powershell 设置代理：完整指南与技巧

介绍

在当今复杂的网络环境中，代理服务器扮演着至关重要的角色。无论是出于网络安全、隐私保护、突破地理限制，还是在企业内部环境中访问特定资源，代理都是一个常用且有效的解决方案。PowerShell 作为 Windows 操作系统中强大的命令行工具和脚本语言，自然也提供了多种方式来配置和管理代理设置。

本指南将深入探讨如何在 PowerShell 中设置、验证、禁用以及优化代理服务器的使用。我们将涵盖从环境变量配置到特定 Cmdlet 使用的各种方法，并提供详细的代码示例和实用技巧，帮助您在不同场景下高效地管理 PowerShell 的网络连接。

PowerShell 中设置代理的常用方法

根据您的需求和代理的适用范围，PowerShell 提供了几种不同的方法来配置代理。

1. 通过环境变量设置代理 (推荐用于大多数 CLI 工具)

这是最常用且直接的方法之一，特别适用于大多数命令行工具（如 curl, wget，以及一些 PowerShell 模块内部通过环境变量获取代理设置的场景）。您可以通过设置 HTTP_PROXY、HTTPS_PROXY 和 NO_PROXY 环境变量来定义代理行为。

  • HTTP_PROXY: 用于 HTTP 请求的代理服务器地址。
  • HTTPS_PROXY: 用于 HTTPS 请求的代理服务器地址。
  • NO_PROXY: 一个逗号分隔的域名列表，表示这些域名不需要通过代理访问。

设置环境变量：

您可以选择临时设置（仅对当前 PowerShell 会话有效）或永久设置（对所有新会话和系统范围有效）。

a) 临时设置 (当前会话):

“`powershell

设置 HTTP 代理

$env:HTTP_PROXY = “http://proxyserver.com:8080”

或者带认证

$env:HTTP_PROXY = “http://username:[email protected]:8080”

设置 HTTPS 代理 (通常与 HTTP 代理相同，但可以不同)

$env:HTTPS_PROXY = “http://proxyserver.com:8080”

或者带认证

$env:HTTPS_PROXY = “http://username:[email protected]:8080”

设置不需要代理的地址 (例如，内网地址)

$env:NO_PROXY = “localhost,127.0.0.1,*.internal.com”

验证设置

Get-ChildItem Env:HTTP_PROXY
Get-ChildItem Env:HTTPS_PROXY
Get-ChildItem Env:NO_PROXY
“`

b) 永久设置 (系统范围):

永久设置会修改系统的环境变量，对所有应用程序都可能生效。这通常需要管理员权限。

“`powershell

以管理员身份运行 PowerShell

验证设置 (可能需要重启 PowerShell 或计算机才能完全生效)

Get-ItemProperty -Path ‘HKLM:\SYSTEM\CurrentControlSet\Control\Session Manager\Environment’ -Name HTTP_PROXY
Get-ItemProperty -Path ‘HKLM:\SYSTEM\CurrentControlSet\Control\Session Manager\Environment’ -Name HTTPS_PROXY
Get-ItemProperty -Path ‘HKLM:\SYSTEM\CurrentControlSet\Control\Session Manager\Environment’ -Name NO_PROXY
“`

适用范围和局限性:
* 优点: 简单直接，许多基于 http_proxy 环境变量的工具和库会自动识别并使用。
* 缺点: 不是所有应用程序都支持，特别是那些使用 .NET WebRequest 或特定 API 的应用程序可能需要单独配置。如果代理需要复杂的认证机制，环境变量可能不支持。

2. 通过 .NET WebRequest 对象设置代理 (推荐用于脚本内部的 HTTP 请求)

当您在 PowerShell 脚本中进行 HTTP 或 HTTPS 请求时，特别是使用 System.Net.WebRequest 或 System.Net.WebClient 等 .NET 类时，可以直接在请求对象上配置代理。这种方法提供了更精细的控制，并且不会影响系统或会话的全局代理设置。

“`powershell

定义代理服务器地址

$proxyAddress = “http://proxyserver.com:8080”

创建 WebRequest 对象

$request = [System.Net.WebRequest]::Create(“http://example.com”)

创建 WebProxy 对象

$proxy = New-Object System.Net.WebProxy($proxyAddress)

如果代理需要认证

$credentials = New-Object System.Net.NetworkCredential(“username”, “password”)

$proxy.Credentials = $credentials

将代理分配给 WebRequest

$request.Proxy = $proxy

绕过代理的地址列表 (可选)

$proxy.BypassProxyOnLocal = $true # 对于本地地址绕过代理

$proxy.BypassList = @(“*.internal.com”, “localhost”) # 绕过特定地址

发送请求并获取响应

try {
$response = $request.GetResponse()
(New-Object System.IO.StreamReader($response.GetResponseStream())).ReadToEnd()
$response.Close()
} catch {
Write-Error “请求失败: $($_.Exception.Message)”
}
“`

适用范围和局限性:
* 优点: 精确控制每个请求的代理设置，不影响全局环境，适用于复杂的认证场景。
* 缺点: 需要在每次请求中显式配置，对于简单的 CLI 工具使用不够便捷。

3. 修改系统级代理设置 (通常不推荐直接在 PowerShell 中修改)

Windows 系统有一个全局的代理设置，通常通过“Internet 选项”或“网络和 Internet 设置”进行配置。这个设置会影响大多数应用程序，包括浏览器、Microsoft Store 应用以及许多使用 WinHTTP/WinINet API 的程序。

尽管可以在 PowerShell 中通过修改注册表来更改这些设置，但这样做需要管理员权限，并且可能影响整个系统，可能导致意外的行为或与其他网络配置冲突。通常，除非有特定的自动化需求，否则不建议直接通过 PowerShell 修改系统级代理。

a) 获取当前系统代理设置:

“`powershell

获取 Internet Explorer (及系统) 代理设置

$regKey = “HKCU:\Software\Microsoft\Windows\CurrentVersion\Internet Settings”
Get-ItemProperty -Path $regKey | Select-Object ProxyEnable, ProxyServer, ProxyOverride
“`

  • ProxyEnable: 1 表示启用代理，0 表示禁用。
  • ProxyServer: 代理服务器地址和端口（例如 “proxyserver.com:8080″）。
  • ProxyOverride: 绕过代理的地址列表。

b) 设置系统代理 (需要管理员权限并谨慎操作):

“`powershell

警告：此操作将修改系统全局代理设置，请谨慎使用！

请在执行前备份注册表或确保您了解其影响。

假设您要设置 HTTP/HTTPS 代理为 proxyserver.com:8080

$proxyServer = “proxyserver.com:8080”
$proxyOverride = “;*.internal.com” # 示例：绕过本地地址和内部域名

$regKey = “HKCU:\Software\Microsoft\Windows\CurrentVersion\Internet Settings”

启用代理

Set-ItemProperty -Path $regKey -Name ProxyEnable -Value 1

设置代理服务器地址

Set-ItemProperty -Path $regKey -Name ProxyServer -Value $proxyServer

设置绕过代理的地址

Set-ItemProperty -Path $regKey -Name ProxyOverride -Value $proxyOverride

Write-Host “系统代理已设置。某些应用程序可能需要重启才能生效。”
“`

适用范围和局限性:
* 优点: 对整个系统生效，影响范围广。
* 缺点: 影响所有用户和应用程序，可能与其他网络工具冲突，需要管理员权限，修改注册表有风险。

4. 特定模块或工具的代理设置

许多 PowerShell Cmdlet 或第三方工具提供了自己的代理配置参数，这通常是最好的实践，因为它允许您为特定任务定制代理行为，而不会影响其他部分。

a) Invoke-WebRequest 和 Invoke-RestMethod:

这两个 Cmdlet 是 PowerShell 中进行 Web 请求的常用工具，它们都支持 -Proxy 和 -ProxyCredential 参数。

“`powershell

定义代理服务器地址

$proxyAddress = “http://proxyserver.com:8080”

如果代理需要认证

$username = “yourusername”
$password = “yourpassword”
$securePassword = ConvertTo-SecureString -String $password -AsPlainText -Force
$proxyCredential = New-Object System.Management.Automation.PSCredential($username, $securePassword)

使用代理进行 HTTP GET 请求

Invoke-WebRequest -Uri “http://example.com” -Proxy $proxyAddress -ProxyCredential $proxyCredential

使用代理进行 REST API 调用

Invoke-RestMethod -Uri “https://api.example.com/data” -Method GET -Proxy $proxyAddress -ProxyCredential $proxyCredential
``
**b)curl或wget` (如果安装在系统中):**

如果您的系统上安装了 curl 或 wget（通过 Scoop, Chocolatey 或 WSL），它们通常会遵循 HTTP_PROXY 环境变量。但也可以通过命令行参数直接指定：

“`powershell

使用 curl 指定代理

curl –proxy http://proxyserver.com:8080 http://example.com

使用 wget 指定代理

wget -e use_proxy=yes -e http_proxy=http://proxyserver.com:8080 http://example.com

“`

适用范围和局限性:
* 优点: 最具针对性，只影响特定命令或工具，不会造成全局影响，通常支持详细的代理配置（如认证）。
* 缺点: 需要了解每个工具或 Cmdlet 的具体代理参数。

验证代理设置

在设置代理后，验证其是否正常工作至关重要。

1. 检查环境变量:

powershell
Get-ChildItem Env:HTTP_PROXY
Get-ChildItem Env:HTTPS_PROXY
Get-ChildItem Env:NO_PROXY

2. 测试网络连接:

使用 Invoke-WebRequest 或 Invoke-RestMethod 访问一个外部网站，最好是能显示您的公网 IP 的网站，以确认流量是否通过代理。

“`powershell

假设您已设置环境变量或通过 -Proxy 参数

try {
# 尝试访问一个显示 IP 的网站
$result = Invoke-RestMethod -Uri “http://ifconfig.me/ip”
Write-Host “您的公网 IP (可能通过代理): $result”

# 如果没有代理，直接访问
# $directResult = Invoke-RestMethod -Uri "http://ifconfig.me/ip"
# Write-Host "您的直接公网 IP: $directResult"

} catch {
Write-Error “代理测试失败: $($_.Exception.Message)”
}
“`

禁用/移除代理设置

当不再需要代理时，应将其禁用或移除，以避免不必要的网络开销或潜在问题。

1. 移除环境变量:

a) 临时移除 (当前会话):

“`powershell
Remove-Item Env:HTTP_PROXY
Remove-Item Env:HTTPS_PROXY
Remove-Item Env:NO_PROXY

验证是否已移除

Get-ChildItem Env:HTTP_PROXY # 应该显示找不到项目
“`

b) 永久移除 (系统范围):

“`powershell

以管理员身份运行 PowerShell

Write-Host “系统级代理环境变量已移除。某些应用程序可能需要重启才能生效。”
“`

2. 禁用系统级代理 (如果之前手动设置):

“`powershell

警告：此操作将修改系统全局代理设置，请谨慎使用！

请在执行前备份注册表或确保您了解其影响。

$regKey = “HKCU:\Software\Microsoft\Windows\CurrentVersion\Internet Settings”

禁用代理

Set-ItemProperty -Path $regKey -Name ProxyEnable -Value 0

清除代理服务器地址和绕过列表 (可选，但推荐)

Remove-ItemProperty -Path $regKey -Name ProxyServer -ErrorAction SilentlyContinue
Remove-ItemProperty -Path $regKey -Name ProxyOverride -ErrorAction SilentlyContinue

Write-Host “系统代理已禁用。某些应用程序可能需要重启才能生效。”
“`

技巧与最佳实践

  • 安全性考虑: 永远不要在公共脚本或版本控制系统中硬编码代理认证的用户名和密码。使用 PowerShell 的 ConvertTo-SecureString 和 PSCredential 对象来安全地处理凭据。对于环境变量，如果可能，请使用安全的凭据管理系统或在运行前手动输入。
  • 错误处理: 在 PowerShell 脚本中进行网络请求时，务必包含错误处理机制 (try-catch 块)，以便在代理连接失败或目标网站不可达时优雅地处理错误。
  • 配置文件管理: 对于复杂的代理设置或频繁切换代理的场景，考虑将代理地址、端口和认证信息存储在一个配置文件（例如 JSON, XML 或纯文本文件）中。脚本可以读取这些文件来动态配置代理，提高灵活性和可维护性。
  • 避免冲突: 确保您的 PowerShell 代理设置不会与 VPN 客户端、网络安全软件或其他代理工具（如 Fiddler、Charles Proxy）冲突。在某些情况下，这些工具可能会覆盖或干扰 PowerShell 的代理配置。
  • 区分内外网: 充分利用 NO_PROXY 环境变量或 BypassList 参数来指定不需要通过代理的内部网络地址，这可以提高内部通信的效率并减少代理服务器的负担。

总结

PowerShell 提供了灵活多样的代理设置方法，以适应各种网络环境和自动化需求。从简单的环境变量配置到精细的 .NET WebRequest 控制，再到特定 Cmdlet 的参数，理解这些方法及其适用场景是高效管理网络连接的关键。通过遵循本指南中的实践和技巧，您将能够更安全、更高效地在 PowerShell 中利用代理服务器。

滚动至顶部