Partilhar via

Definir configurações de proxy para o Azure Local, versão 23H2

  • Artigo

Aplica-se a: Azure Local, versão 23H2

Este artigo descreve como definir as definições de proxy para a implementação na nuvem do Azure Local, versão 23H2, se a sua rede utilizar um servidor proxy para acesso à Internet.

Para obter informações sobre os requisitos de firewall para pontos de extremidade de saída e regras e portas internas para o Azure Local, consulte Requisitos de firewall para o Azure Local.

Antes de começar

Antes de começar a definir as configurações de proxy, certifique-se de que:

  • Você tem acesso a um Azure Local para o qual deseja definir as configurações de proxy. Você também tem as credenciais de administrador local para acessar as máquinas em seu Azure Local.
  • Você sabe o nome do servidor proxy ou endereço IP e porta (opcional). Se não tiver estas informações, contacte o administrador da rede.

Aqui estão algumas considerações importantes a ter em mente antes de definir as configurações de proxy:

  • Entenda que as configurações de proxy são separadas para diferentes componentes e recursos do Azure Local (WinInet,WinHTTP, e Environment Variables). Você deve definir as configurações de proxy para todos os componentes necessários e quaisquer outros recursos que você planeja usar.
  • Embora cada componente tenha parâmetros de comando específicos e requisitos de cadeia de caracteres de lista de bypass de proxy, recomendamos manter a mesma configuração de proxy entre os diferentes componentes e recursos.
  • Não suportamos proxies autenticados usando nome de usuário e senha devido a restrições de segurança.
  • Se você estiver usando a inspeção SSL em seu proxy, precisará ignorar o Azure Local necessário e seus componentes (Arc Resource Bridge, Azure Kubernetes Service (AKS), etc.) URLs de saída.
  • Cada um dos três componentes de proxy no sistema operacional tem requisitos específicos de cadeia de caracteres de lista de bypass de proxy. Não use a mesma cadeia de caracteres para todos os três componentes.

Definir configurações de proxy para WinInet

Você deve definir as configurações de WinInet proxy antes de registrar as máquinas com o Azure Arc.

Instale o WinInetProxy módulo para executar os comandos nesta seção. Para obter informações sobre o módulo e como instalá-lo, consulte Galeria do PowerShell | WinInetProxy 0.1.0. Para obter informações sobre o WinInetProxy script do PowerShell, consulte WinInetProxy.psm1.

Se não conseguir instalar o WinInetProxy módulo numa máquina devido à falta de acesso à Internet, recomendamos que transfira o módulo para o computador de gestão e, em seguida, transfira-o manualmente para a máquina onde pretende executar o módulo. Você também pode usar o cmdlet Start-BitsTransfer PowerShell para transferir um ou mais arquivos entre seu sistema de gerenciamento e uma máquina.

Para definir as configurações de proxy para o sistema operacional Azure Stack HCI, execute o seguinte comando do PowerShell como administrador em cada máquina do sistema:

  1. Conecte-se ao Azure Local por meio do protocolo RDP (Remote Desktop Protocol) e abra uma sessão do PowerShell.

  2. Para definir as configurações de proxy depois de instalar o WinInetProxy módulo, execute o seguinte cmdlet:

    Set-WinInetProxy -ProxySettingsPerUser 0 -ProxyServer http://<Proxy_Server_Address:Proxy_Port> -ProxyBypass <URLs to bypass>

    Os parâmetros são descritos na tabela a seguir:

    Parâmetro Description
    ProxySettingsPerUser Especifica se as configurações de proxy são por máquina ou por usuário:

    - 0 - As configurações de proxy são por máquina.
    - 1 (padrão) - As configurações de proxy são por usuário.
    - Se nenhum valor for fornecido, a ProxySettingsPerUser variável de ambiente será usada, se presente.
    ProxyServer Especifica o ponto de extremidade do servidor proxy no formato http://[Proxy_Server_Address]:[Proxy_Port]. Por exemplo, http://proxy.contoso.com:8080.
    ProxyBypass Especifica a lista de URLs de host que ignoram o -ProxyServer servidor proxy definido pelo parâmetro. Por exemplo, você pode definir -ProxyBypass “localhost” para ignorar URLs de intranet local. No seu Azure Local, a lista deve incluir:

    - Pelo menos o endereço IP de cada máquina.
    - Pelo menos o endereço IP do sistema.
    - Pelo menos os IPs que você definiu para sua rede de infraestrutura. Arc Resource Bridge, AKS e futuros serviços de infraestrutura que usam esses IPs exigem conectividade de saída.
    - Ou você pode ignorar toda a sub-rede de infraestrutura.
    - Nome NetBIOS de cada máquina.
    - Nome NetBIOS do sistema.
    - Nome de domínio ou nome de domínio com curinga asterisco * para qualquer host ou subdomínio.

Aqui está um exemplo do uso do comando:

Set-WinInetProxy -ProxySettingsPerUser 0 -ProxyServer http://192.168.1.250:8080 -ProxyBypass "localhost;127.0.0.1;*.contoso.com;node1;node2;192.168.1.*;s-cluster"

Considerações sobre a cadeia de caracteres da lista de bypass de proxy WinInet

Ao configurar a lista de bypass de WinInet proxy, tenha em mente os seguintes pontos:

  • Os parâmetros devem ser separados por vírgula , ou ponto-e-vírgula ;.
  • Não há suporte para notação CIDR para ignorar sub-redes.
  • Asterisk pode ser usado como curingas para ignorar sub-redes ou nomes de domínio. Por exemplo, 192.168.1.* para sub-redes ou *.contoso.com para nomes de domínio.
  • O nome do proxy deve ser especificado com http:// e a porta. Por exemplo, http://192.168.1.250:8080.
  • Recomendamos usar a mesma cadeia de caracteres de bypass ao configurar WinInet e WinHTTP.
  • O uso de cadeias de caracteres não é suportado na lista de bypass de <local> proxy.

Exibir e remover a configuração de proxy WinInet

  • Para exibir ou verificar a configuração de proxy atual WinInet , no prompt de comando, digite:

    PS C:\> Get-WinhttpProxy -Advanced

Current WinHTTP proxy settings:

Proxy Server(s) :  http://192.168.1.250:8080
Bypass List     :  localhost;127.0.0.1;*. contoso.com;node1;node2;192.168.1.*;s-cluster

PS C:\>

  • Para remover a configuração de WinInet proxy para atualizações locais do Azure e testemunha de nuvem, no prompt de comando, digite:

    PS C:\> Set-WinInetProxy
Start proxy Configuration
Proxy is Per User
AutoDetect is 0
PACUrl is
ProxyServer is
ProxyBypass is
Entered WriteProxySettingsHelper
Entered WriteProxySettingsHelper

Successfully set proxy
PS C:\> Get-WinhttpProxy -Advanced

Definir configurações de proxy para WinHTTP

Você deve definir as configurações de WinHTTP proxy antes de registrar as máquinas com o Azure Arc.

Para configurar o WinHTTP proxy para atualizações locais do Azure e testemunha de nuvem, execute o seguinte comando do PowerShell como administrador em cada máquina do sistema:

Set-winhttpproxy -proxyserver http://<Proxy_Server_Address:Proxy_Port> -BypassList <URLs to bypass>

Os parâmetros são descritos na tabela a seguir:

Parâmetro Description
ProxyServer Especifica o ponto de extremidade do servidor proxy no formato http://[Proxy_Server_Address]:[Proxy_Port]. Por exemplo, http://proxy.contoso.com:8080.
Lista de Desvios Especifica a lista de URLs de host que ignoram o -ProxyServer servidor proxy definido pelo parâmetro. Por exemplo, você pode definir -ProxyBypass "localhost" para ignorar URLs de intranet local. No seu Azure Local, a lista deve incluir:

- Pelo menos o endereço IP de cada máquina.
- Pelo menos o endereço IP do sistema.
- Pelo menos os IPs que você definiu para sua rede de infraestrutura. Arc Resource Bridge, AKS e futuros serviços de infraestrutura que usam esses IPs exigem conectividade de saída.
- Ou você pode ignorar toda a sub-rede de infraestrutura.
- Nome NetBIOS de cada máquina.
- Nome NetBIOS do sistema.
- Nome de domínio ou nome de domínio com curinga asterisco * para qualquer host ou subdomínio.

Aqui está um exemplo do uso do comando:

Set-winhttpproxy -proxyserver http://192.168.1.250:8080 -BypassList "localhost;127.0.0.1;*.contoso.com;node1;node2;192.168.1.*;s-cluster"

Considerações sobre a cadeia de caracteres da lista de bypass de proxy WinHTTP

Ao configurar a cadeia de caracteres da lista de bypass de WinHTTP proxy, lembre-se dos seguintes pontos:

  • Os parâmetros devem ser separados por vírgula , ou ponto-e-vírgula ;.
  • Não há suporte para notação CIDR para ignorar sub-redes.
  • Asterisk pode ser usado como curingas para ignorar sub-redes ou nomes de domínio. Por exemplo, 192.168.1.* para sub-redes ou *.contoso.com para nomes de domínio.
  • O nome do proxy deve ser especificado com http:// e a porta. Por exemplo, http://192.168.1.250:8080.
  • Recomendamos usar a mesma cadeia de caracteres de bypass ao configurar WinInet e WinHTTP.
  • O uso de cadeias de caracteres não é suportado na lista de bypass de <local> proxy.

Exibir e remover a configuração de proxy WinHTTP

  • Para exibir ou verificar a configuração de proxy atual WinHTTP , no prompt de comando, digite:

    PS C:\> Get-WinhttpProxy -Default

Current WinHTTP proxy settings:

Proxy Server(s) :  http://192.168.1.250:8080
Bypass List     :  localhost;127.0.0.1;*.contoso.com;node1;node2;192.168.1.*;s-cluster

PS C:\>

  • Para remover a configuração de WinHTTP proxy para atualizações locais do Azure e testemunha de nuvem, no prompt de comando, digite:

    PS C:\> Reset-WinhttpProxy -Direct
Current WinHTTP proxy settings:
Direct access (no proxy server). 
PS C:\>

Definir configurações de proxy para variáveis de ambiente

Você deve configurar o proxy para o Azure Resource Bridge e AKS antes de registrar as máquinas com o Azure Arc.

Para definir a variável de ambiente do servidor proxy, execute os seguintes comandos como administrador em cada máquina do sistema:

# If a proxy server is needed, execute these commands with the proxy URL and port.
[Environment]::SetEnvironmentVariable("HTTPS_PROXY","http://ProxyServerFQDN:port", "Machine")
$env:HTTPS_PROXY = [System.Environment]::GetEnvironmentVariable("HTTPS_PROXY","Machine")
[Environment]::SetEnvironmentVariable("HTTP_PROXY","http://ProxyServerFQDN:port", "Machine")
$env:HTTP_PROXY = [System.Environment]::GetEnvironmentVariable("HTTP_PROXY","Machine")
$no_proxy = "<bypassliststring>"
[Environment]::SetEnvironmentVariable("NO_PROXY",$no_proxy,"Machine")
$env:NO_PROXY = [System.Environment]::GetEnvironmentVariable("NO_PROXY","Machine")

Os parâmetros são descritos na tabela a seguir:

Parâmetro Description
HTTPS_PROXY variável Especifica o ponto de extremidade do servidor proxy no formato http://[Proxy_Server_Address]:[Proxy_Port]. Por exemplo, http://proxy.contoso.com:8080.
HTTP_PROXY variável Especifica o ponto de extremidade do servidor proxy no formato http://[Proxy_Server_Address]:[Proxy_Port]. Por exemplo, http://proxy.contoso.com:8080.
NO_PROXY variável String para ignorar URLs, domínios e sub-redes da intranet local. No seu Azure Local, a lista deve incluir:

- Pelo menos o endereço IP de cada máquina.
- Pelo menos o endereço IP do sistema.
- Pelo menos os IPs que você definiu para sua rede de infraestrutura. Arc Resource Bridge, AKS e futuros serviços de infraestrutura que usam esses IPs exigem conectividade de saída.
- Ou você pode ignorar toda a sub-rede de infraestrutura.
- Nome NetBIOS de cada máquina.
- Nome NetBIOS do sistema.
- Nome de domínio ou nome de domínio com curinga ponto . para qualquer host ou subdomínio.
- .svc para tráfego interno do serviço Kubernetes.

Aqui está um exemplo do uso do comando:

[Environment]::SetEnvironmentVariable("HTTPS_PROXY", "http://192.168.1.250:8080", "Machine")
$env:HTTPS_PROXY = [System.Environment]::GetEnvironmentVariable("HTTPS_PROXY", "Machine")
[Environment]::SetEnvironmentVariable("HTTP_PROXY", "http://192.168.1.250:8080", "Machine")
$env:HTTP_PROXY = [System.Environment]::GetEnvironmentVariable("HTTP_PROXY", "Machine")
$no_proxy = "localhost,127.0.0.1,.svc,192.168.1.0/24,.contoso.com,node1,node2,s-cluster"
[Environment]::SetEnvironmentVariable("NO_PROXY", $no_proxy, "Machine")
$env:NO_PROXY = [System.Environment]::GetEnvironmentVariable("NO_PROXY", "Machine")

Considerações sobre a cadeia de caracteres da lista de bypass de proxy de variáveis de ambiente

Ao configurar a cadeia de caracteres da lista de bypass de proxy de Variáveis de Ambiente, lembre-se dos seguintes pontos:

  • Os parâmetros devem ser separados por vírgula ,.
  • A notação CIDR para ignorar sub-redes deve ser usada.
  • Asterisk * como curingas para ignorar sub-redes ou nomes de domínio não é suportado.
  • Pontos Devem ser usados como curingas para ignorar nomes de . domínio ou serviços locais. Por exemplo .contoso.com ou .svc.
  • O nome do proxy deve ser especificado com http:// e a porta para as variáveis HTTP_PROXY e HTTPS_PROXY. Por exemplo, http://192.168.1.250:8080.
  • .svc bypass é para comunicação de serviços internos AKS em notação Linux. Isso é necessário para Arc Resource Bridge e AKS.
  • O AKS requer ignorar as seguintes sub-redes. 10.0.0.0/8, 172.16.0.0/12 e 192.168.0.0/16. Essas sub-redes serão adicionadas automaticamente à lista de desvio de variáveis de ambiente se não estiverem definidas.
  • O uso de cadeias de caracteres não é suportado na lista de bypass de <local> proxy.

Confirmar e remover a configuração de proxy de variáveis de ambiente

  • Para confirmar se a configuração de proxy de variáveis de ambiente é aplicada, execute o seguinte comando:

    echo "https :" $env:https_proxy "http :" $env:http_proxy "bypasslist " $env:no_proxy

  • Para remover a configuração de proxy, execute os seguintes comandos como administrador em cada máquina do sistema:

    [Environment]::SetEnvironmentVariable("HTTPS_PROXY", $null, "Machine")
$env:HTTPS_PROXY = [System.Environment]::GetEnvironmentVariable("HTTPS_PROXY", "Machine")
[Environment]::SetEnvironmentVariable("HTTP_PROXY", $null, "Machine")
$env:HTTP_PROXY = [System.Environment]::GetEnvironmentVariable("HTTP_PROXY", "Machine")

Definir configurações de proxy para o agente de servidores habilitado para Arc

Para configurar o agente de servidores habilitado para ArcGIS do Azure para se comunicar por meio de um servidor proxy, execute o seguinte comando:

azcmagent config set proxy.url "http://ProxyServerFQDN:port"

Você pode usar um endereço IP ou um nome de host simples no lugar do FQDN se sua rede exigir. Se o seu servidor proxy for executado na porta 80, você pode omitir ":80" no final.

Para verificar se uma URL de servidor proxy está configurada nas configurações do agente, execute o seguinte comando:

azcmagent config get proxy.url

Para impedir que o agente se comunique através de um servidor proxy, execute o seguinte comando:

azcmagent config clear proxy.url

Não é necessário reiniciar nenhum serviço ao reconfigurar as configurações de proxy com o azcmagent config comando.

Consulte a página do agente de servidores habilitados para Arc para obter mais detalhes Gerenciando e mantendo o agente de Máquina Conectada.

Definir definições de proxy para serviços do Azure

Se você estiver usando ou planeja usar qualquer um dos seguintes serviços do Azure, consulte os seguintes artigos para obter informações sobre como definir as configurações do servidor proxy para cada serviço do Azure:

Próximos passos

Para obter mais informações, consulte: