Partilhar via

Definir configurações de proxy para o Azure Local

  • Artigo

Aplica-se a: Azure Local 2311.2 e posterior

Este artigo descreve como definir definições de proxy para a implementação da nuvem local do Azure 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 lista de bypass de proxy, recomendamos manter a mesma configuração de proxy para os diferentes componentes e recursos.
  • Proxies autenticados usando nome de usuário e senha não são suportados devido a restrições de segurança.
  • Se estiveres a usar a inspeção SSL no teu proxy, precisas de efetuar um bypass ao necessário Azure Local e aos seus componentes (Arc Resource Bridge, Azure Kubernetes Service (AKS), etc.) URLs de saída.
  • Cada um dos três componentes de proxy no sistema operativo tem requisitos específicos para a lista de exclusões do proxy. Não use a mesma cadeia de caracteres para todos os três componentes.
  • Não há suporte para arquivos de configuração automática de proxy (PAC).

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 Descrição
    ConfiguraçõesDeProxyPorUtilizador 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 servidor proxy definido pelo parâmetro -ProxyServer. 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 um asterisco curinga * 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 proxy bypass de WinInet, 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.
  • O asterisco pode ser usado como curinga para contornar 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 Descrição
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 servidor proxy definido pelo parâmetro -ProxyServer. 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 asterisco * como caráter universal 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 lista de bypass de proxy WinHTTP, 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.
  • O asterisco pode ser usado como caracteres universais 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 Descrição
variável HTTPS_PROXY Especifica o ponto de extremidade do servidor proxy no formato http://[Proxy_Server_Address]:[Proxy_Port]. Por exemplo, http://proxy.contoso.com:8080.
Variável HTTP_PROXY Especifica o ponto de extremidade do servidor proxy no formato http://[Proxy_Server_Address]:[Proxy_Port]. Por exemplo, http://proxy.contoso.com:8080.
variável NO_PROXY String para contornar 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 de 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 lista de exclusão de proxy em variáveis de ambiente string

Ao configurar a string da lista de bypass do proxy das 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.
  • O asterisco * como caracteres universais para contornar sub-redes ou nomes de domínio não são suportados.
  • Pontos . devem ser usados como caracteres universais 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 a comunicação dos serviços internos do AKS em notação Linux. Isso é necessário para Arc Resource Bridge e AKS.
  • AKS precisa 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 exclusão de proxy <local>.

Confirmar e remover a configuração de proxy das 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 habilitados com 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: