Настройка параметров прокси-сервера для локальной среды Azure

Область применения: гиперконвергентные развертывания локальной среды Azure

Это важно

После выпуска Azure Local 2506 не требуется вручную настраивать параметры прокси-сервера на локальных компьютерах Azure. Конфигурация прокси-сервера локальных компьютеров Azure выполняется автоматически во время регистрации Arc. Убедитесь, что вы следуйте инструкциям по развертываниям прокси-сред на основе метода регистрации: регистрация локальной среды Azure в Arc с помощью прокси-сервера. Регистрация Azure Local с помощью Arc с помощью прокси-сервера и шлюза Arc.

В этой статье описывается настройка параметров прокси-сервера для развертывания локального облака Azure, если сеть использует прокси-сервер для доступа к Интернету.

Сведения о требованиях к брандмауэру для исходящих конечных точек и внутренних правил и портов для локальной среды Azure см. в разделе "Требования к брандмауэру для локальной сети Azure".

Перед началом

Прежде чем приступить к настройке параметров прокси-сервера, убедитесь, что:

  • У вас есть доступ к локальной службе Azure, для которой требуется настроить параметры прокси-сервера. У вас также есть учетные данные локального администратора для доступа к компьютерам в локальной среде Azure.
  • Вы знаете имя прокси-сервера или IP-адрес и порт (необязательно). Если у вас нет этих сведений, обратитесь к администратору сети.

Ниже приведены некоторые важные рекомендации, которые следует учитывать перед настройкой параметров прокси-сервера.

  • Узнайте, что параметры прокси-сервера разделены для различных компонентов и функций локальной среды Azure (WinInet,WinHTTPи Environment Variables). Необходимо настроить параметры прокси-сервера для всех необходимых компонентов и любых других функций, которые планируется использовать.
  • Хотя каждый компонент имеет определенные параметры команды и требования к строке обхода прокси-сервера, рекомендуется сохранить одну конфигурацию прокси-сервера в разных компонентах и функциях.
  • Прошедшие проверку подлинности прокси с использованием имени пользователя и пароля не поддерживаются из-за ограничений безопасности.
  • Конечные точки прокси-сервера с доменом .local не поддерживаются, например http://proxy.contosos.local.
  • Если вы используете проверку SSL в прокси-сервере, необходимо обойти Azure Local и его основные компоненты (такие как Arc Resource Bridge, Служба Azure Kubernetes (AKS) и т. д.) исходящие URL-адреса.
  • Каждый из трех компонентов прокси-сервера в операционной системе имеет определенные требования к строке списка обхода. Не используйте одну и ту же строку для всех трех компонентов.
  • Файлы автоматической настройки прокси-сервера (PAC) не поддерживаются.

Настройка параметров прокси-сервера для WinInet

Перед WinInet необходимо настроить параметры прокси-сервера.

WinInetProxy Установите модуль для выполнения команд в этом разделе. Сведения о модуле и его установке см. в коллекции PowerShell | WinInetProxy 0.1.0. Дополнительные сведения о скрипте WinInetProxy PowerShell см. в статье WinInetProxy.psm1.

Если вы не можете установить WinInetProxy модуль на компьютер из-за отсутствия доступа к Интернету, рекомендуется скачать модуль на компьютер управления, а затем вручную перенести его на компьютер, где вы хотите запустить модуль. Вы также можете использовать командлет Start-BitsTransfer PowerShell для передачи одного или нескольких файлов между системой управления и компьютером.

Чтобы настроить параметры прокси-сервера для операционной системы Azure Stack HCI, выполните следующую команду PowerShell от имени администратора на каждом компьютере в системе:

  1. Подключитесь к azure Local через протокол удаленного рабочего стола (RDP) и откройте сеанс PowerShell.

  2. Чтобы настроить параметры прокси-сервера после установки WinInetProxy модуля, выполните следующий командлет:

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

    Параметры описаны в следующей таблице.

    Параметр Описание
    Настройки прокси-сервера на пользователя Определяет, применяются ли параметры прокси-сервера для всего компьютера или для конкретного пользователя.

    — 0 — параметры прокси-сервера устанавливаются отдельно для каждого компьютера.
    — 1 (по умолчанию) — параметры прокси-сервера являются для каждого пользователя.
    — Если значение не задано, ProxySettingsPerUser вместо этого используется переменная среды, если она присутствует.
    ProxyServer Указывает конечную точку прокси-сервера в формате http://[Proxy_Server_Address]:[Proxy_Port]. Например, http://proxy.contoso.com:8080.
    ProxyBypass Указывает список URL-адресов узлов, которые обходят прокси-сервер, заданный параметром -ProxyServer . Например, можно настроить -ProxyBypass "localhost" для обхода URL-адресов локальной интрасети. В вашем локальном Azure в списке должно быть включено следующее:

    — по крайней мере IP-адрес каждого компьютера.
    — По крайней мере IP-адрес системы.
    — По крайней мере IP-адреса, которые вы определили для своей инфраструктурной сети. Arc Resource Bridge, AKS и будущие службы инфраструктуры, использующие эти IP-адреса, требуют исходящего подключения.
    — Или можно обойти всю подсеть инфраструктуры.
    — NetBIOS-имя каждого компьютера.
    — NetBIOS-имя системы.
    — Доменное имя или доменное имя с подстановочным знаком «звездочка» * для любого хоста или поддомена.

Ниже приведен пример использования команды:

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"

Рекомендации по строкам списка исключений для прокси-сервера WinInet

При настройке списка обхода WinInet прокси-сервера следует учитывать следующие моменты:

  • Параметры должны быть разделены запятыми ,.
  • Нотация CIDR для обхода подсетей не поддерживается.
  • Звездочка может использоваться в качестве подстановочных знаков для обхода подсетей или доменных имен. Например, 192.168.1.* для подсетей или *.contoso.com доменных имен.
  • Имя прокси-сервера должно быть указано с http:// и портом. Например, http://192.168.1.250:8080.
  • Рекомендуется использовать ту же строку обхода при настройке WinInet и WinHTTP.
  • Использование строк <local> не поддерживается в списке исключений для прокси-сервера.

Просмотр и удаление конфигурации прокси-сервера WinInet

  • Чтобы просмотреть или проверить текущую WinInet конфигурацию прокси-сервера, в командной строке введите:

    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:\>

  • Чтобы удалить конфигурацию прокси-сервера для локальных обновлений Azure и облачного свидетеля, в командной строке введите:

    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

Настройка параметров прокси-сервера для WinHTTP

Перед WinHTTP необходимо настроить параметры прокси-сервера.

Чтобы настроить прокси-сервер WinHTTP для локальных обновлений Azure и облачного свидетеля, выполните следующую команду PowerShell от имени администратора на каждом компьютере в системе:

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

Параметры описаны в следующей таблице.

Параметр Описание
ProxyServer Указывает конечную точку прокси-сервера в формате http://[Proxy_Server_Address]:[Proxy_Port]. Например, http://proxy.contoso.com:8080.
Обходной список Указывает список URL-адресов узлов, которые обходят прокси-сервер, заданный параметром -ProxyServer . Например, можно настроить -ProxyBypass "localhost" для обхода URL-адресов локальной интрасети. В вашей локальной установке Azure список должен содержать следующее:

— по крайней мере IP-адрес каждого компьютера.
— По крайней мере IP-адрес системы.
— По крайней мере IP-адреса, которые вы определили для своей инфраструктурной сети. Arc Resource Bridge, AKS и будущие службы инфраструктуры, использующие эти IP-адреса, требуют исходящего подключения.
— Или можно обойти всю подсеть инфраструктуры.
— NetBIOS-имя каждого компьютера.
— NetBIOS-имя системы.
— Доменное имя или доменное имя с подстановочным знаком «звездочка» * для любого хоста или поддомена.

Ниже приведен пример использования команды:

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

Вопросы учета строк в списке обхода прокси-сервера WinHTTP

При настройке WinHTTP строки списка обхода прокси-сервера следует учитывать следующие моменты:

  • Параметры должны быть разделены запятыми ,.
  • Нотация CIDR для обхода подсетей не поддерживается.
  • Звездочка может использоваться в качестве подстановочных знаков для обхода подсетей или доменных имен. Например, 192.168.1.* для подсетей или *.contoso.com доменных имен.
  • Имя прокси-сервера должно быть указано с http:// и портом. Например, http://192.168.1.250:8080.
  • Рекомендуется использовать ту же строку обхода при настройке WinInet и WinHTTP.
  • Использование строк <local> не поддерживается в списке исключений для прокси-сервера.

Просмотр и удаление конфигурации прокси-сервера WinHTTP

  • Чтобы просмотреть или проверить текущую WinHTTP конфигурацию прокси-сервера, в командной строке введите:

    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:\>

  • Чтобы удалить конфигурацию прокси-сервера для локальных обновлений Azure и облачного свидетеля, в командной строке введите:

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

Настройка параметров прокси-сервера для переменных среды

Перед регистрацией компьютеров в Azure Arc необходимо настроить прокси-сервер для агентов Kubernetes с поддержкой Azure Resource Bridge, AKS и Arc.

Чтобы задать переменную среды прокси-сервера, выполните следующие команды от имени администратора на каждом компьютере в системе:

# 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")

Параметры описаны в следующей таблице.

Параметр Описание
переменная HTTPS_PROXY Указывает конечную точку прокси-сервера в формате http://[Proxy_Server_Address]:[Proxy_Port]. Например, http://proxy.contoso.com:8080.
переменная HTTP_PROXY Указывает конечную точку прокси-сервера в формате http://[Proxy_Server_Address]:[Proxy_Port]. Например, http://proxy.contoso.com:8080.
переменная NO_PROXY Строка для обхода URL-адресов, доменов и подсетей локальной интрасети. В локальной среде Azure список должен содержать следующее:

— по крайней мере IP-адрес каждого компьютера.
— По крайней мере IP-адрес системы.
— NetBIOS-имя каждого компьютера.
— NetBIOS-имя системы.
— доменное имя или доменное имя с подстановочным символом с точкой . для любого узла или поддомена.
— По крайней мере IP-адреса, которые вы определили для своей инфраструктурной сети. Arc Resource Bridge и будущие службы инфраструктуры, использующие эти IP-адреса, требуют исходящего подключения.
— Или можно обойти всю подсеть инфраструктуры.
— Подсети, в которых планируется развернуть кластеры AKS.
- .svc, kubernetes.default.svc а также .svc.cluster.local для внутреннего трафика службы Kubernetes.
- 10.0.0.0/8, 172.16.0.0/12 и 192.168.0.0/16. Эти подсети необходимы для создания кластеров AKS и агентов Azure Arc.

Ниже приведен пример использования команды:

[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,kubernetes.default.svc,.svc.cluster.local,192.168.1.0/24,10.0.0.0/8,172.16.0.0/12,192.168.0.0/16,.contoso.com,node1,node2,s-cluster"
[Environment]::SetEnvironmentVariable("NO_PROXY", $no_proxy, "Machine")
$env:NO_PROXY = [System.Environment]::GetEnvironmentVariable("NO_PROXY", "Machine")

Рекомендации по обходу строк списка переменных среды

При настройке строки списка обхода переменных среды прокси-сервера следует учитывать следующие моменты:

  • Параметры должны быть разделены запятыми ,.
  • Нотация CIDR для обхода подсетей должна использоваться.
  • Звездочка * как подстановочные знаки для обхода подсетей или доменных имен не поддерживаются.
  • . Точки должны использоваться в качестве подстановочных знаков для обхода доменных имен или локальных служб. Например, .contoso.com или .svc.
  • Имя прокси-сервера и порт должны быть указаны для переменных HTTP_PROXY и HTTPS_PROXY. Например, http://192.168.1.250:8080.
  • .svc, kubernetes.default.svc и .svc.cluster.local обходятся для связи внутренних служб AKS в среде Linux. Эти значения необходимы для шлюза ресурсов Arc и AKS.
  • AKS требует обхода следующих подсетей: 10.0.0.0/8, 172.16.0.0/12и 192.168.0.0/16. Эти подсети добавляются в список обхода переменных среды автоматически, если они не определены.

Подтвердите и удалите конфигурацию прокси переменных среды

  • Чтобы подтвердить, что конфигурация прокси через переменные среды применена, выполните следующую команду:

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

  • Чтобы удалить конфигурацию прокси-сервера, выполните следующие команды от имени администратора на каждом компьютере в системе:

    [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")

Настройка параметров прокси-сервера для агента серверов с поддержкой Arc

Чтобы настроить агент серверов с поддержкой Azure Arc для обмена данными через прокси-сервер, выполните следующую команду:

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

Вы можете использовать IP-адрес или простое имя узла вместо полного доменного имени (FQDN), если это требуется вашей сетью. Если ваш прокси-сервер работает на порту 80, в конце можно не указывать ":80".

Чтобы проверить, настроен ли URL-адрес прокси-сервера в параметрах агента, выполните следующую команду:

azcmagent config get proxy.url

Чтобы остановить обмен данными агента через прокси-сервер, выполните следующую команду:

azcmagent config clear proxy.url

При перенастройки параметров прокси-сервера с azcmagent config помощью команды не требуется перезапускать службы.

Ознакомьтесь со страницей агента серверов с поддержкой Arc, чтобы получить дополнительные сведения об управлении агентом подключенного компьютера и обслуживании.

Настройка параметров прокси-сервера для служб Azure

Если вы используете или планируете использовать любую из следующих служб Azure, ознакомьтесь со следующими статьями, чтобы узнать, как настроить параметры прокси-сервера для каждой службы Azure:

Дальнейшие действия

Дополнительные сведения см. в разделе:

  • Последнее обновление: