---
title: Поддержка прокси агентами
slug: help/neurons/ru_ru/podderzhka-proksi-agentami
createdAt: 2026-09-08T08:52:13.631Z
---

Поддержка прокси-серверов агентами Linux и Windows теперь доступна на платформе Ivanti Neurons.

## Прокси для агентов Linux

::::ExpandableHeading
## Агенты Linux

### Добавление прокси

Для добавления нового прокси-сервера введите:
`stagentctl proxy --add http://host:port`

:::hint{type="info"}
Поддерживаются только HTTP-прокси без учетных данных.
:::

### Список сконфигурированных прокси-серверов

**Для отображения всех сконфигурированных прокси-серверов и исключений** введите:
`stagentctl proxy --list`

### Удаление прокси

- **Для удаления определенного прокси-сервера из конфигурации** введите
  `stagentctl proxy --remove http://host:port`
- **Для удаления всех сконфигурированных прокси-серверов** введите:
  `stagentctl proxy --remove all`
- Команда возвратит состояние конфигурации после выполнения.
  Если результат - "Прокси-сервер не сконфигурирован", это означает, что после выполнения команды не осталось ни одного прокси-сервера.

### Управление исключением прокси-серверов

- **Для управления хостами с прямым доступом используйте следующую команду для исключения определенного имени хоста, например 'host.com'**:
  `stagentctl proxy --addexclusion host.com`
- **Для исключения совпадений суффиксов используйте следующую команду - исключение всех хостов, заканчивающихся на '.org'**:
  Например, добавление суффикса '.com' исключит все хосты, заканчивающиеся на '.com'.
  `stagentctl proxy --addexclusion .org`
- Начальная точка в команде исключения, например '.org', служит универсальным символом, указывающим, что любой хост, заканчивающийся указанным суффиксом, должен быть исключен.
- **Для полного выключения прокси для всех хостов, используйте следующую команду**:
  `stagentctl proxy --addexclusion "*"`
- **Для удаления исключения определенного хоста используйте следующую команду**:
  `stagentctl proxy --removeexclusion host.com`
- **Для очистки всех исключений используйте следующую команду**:
  `stagentctl proxy --removeexclusion all`

### Регистрация с конфигурацией прокси-сервера

- Во время регистрации агента добавьте параметр `--addproxy`, например,
  `stagentctl register --addproxy http://host:port`.
  Этот прокси-сервер используется для регистрации и сохраняется для использования в будущих сообщениях.
- Кроме того, в момент регистрации конфигурация собирается из переменных среды `http_proxy` или `HTTP_PROXY` и сохраняется.
- Также можно добавить прокси и исключения с помощью команд `proxy --add` и `proxy --addexclusion` перед попыткой регистрации.

### Прокси-серверы с авторизацией

- Вы можете авторизовать прокси-серверы с учетными данными, используя параметр `--proxyauth` при добавлении или выполнении регистрации агента с помощью `--addproxy`.
- Поддержка методов авторизации Digest, Negotiate и NTLM.
- Например, при использовании прокси-сервера с авторизацией используйте следующую команду:
  `stagentctl proxy --add http://user:pass@host:port --proxyauth ntlm`
  `stagentctl register --addproxy http://user:pass@host:port --proxyauth ntlm`

:::hint{type="info"}
Если у вас есть учетные данные для аутентификации прокси-сервера, убедитесь, что задан параметр `--authtype`. Добавление прокси-сервера с именем хоста, которое уже существует, перезаписывает существующий с предоставленными параметрами (тип аутентификации, порт или учетные данные). Переменные среды `http_proxy` и `HTTP_PROXY` игнорируются вместе со всеми переменными среды, связанными с прокси.
:::

### Важные примечания

- Поддерживается использование списков прокси. В случае ошибок подключения пробуется следующий прокси-сервер в списке - иначе будет выполнена попытка подключения без прокси-сервера. Приложение использует первый прокси-сервер после завершения всех вариантов или времени ожидания, отдавая приоритет начальным записям.
- Команда `register --addproxy` добавляет прокси в начало списка, отдавая ему приоритет.

### Безопасность и связь

Приложение обеспечивает безопасное туннельное взаимодействие через прокси-серверы с использованием метода CONNECT, используемого для шифрованных взаимодействий, где прокси-сервер действует только как поставщик туннеля. Все конфигурации прокси-сервера проверяются на предмет использования схемы HTTP без учетных данных и могут включать номер порта.
::::

## Прокси для агентов для Windows

::::ExpandableHeading
## Агенты для Windows

Веб-прокси для агентов Windows можно настроить несколькими способами. Все методы имеют одинаковые доступные свойства прокси и различаются точкой входа. Выберите подходящий метод.

- **Метод 1**: Установите параметры прокси-сервера как часть установки агента.
- **Метод 2**: Установите настройки прокси-сервера для установленного агента, который регистрируется или выполняет повторную регистрацию.
- **Метод 3**: Установите настройки прокси-сервера для агента, который уже установлен и зарегистрирован.

:::hint{type="info"}
С использованием любого из этих методов существующая конфигурация прокси-сервера агента перезаписывается.
Например, у агента, у которого заданы явные настройки прокси-сервера с использованием proxyConfig, такие настройки прокси-сервера будут перезаписаны при последующей регистрации.
:::

**Метод 1: Во время начальной установки и регистрации**

Используйте этот метод, когда конфигурация прокси-сервера известна на момент настройки агента, например, при массовом развертывании новых агентов. Свойства прокси-сервера можно задать в автоматической команде в случае массового развертывания или в графическом интерфейсе регистрации или в сопроводительном файле параметров для одноразовых установок.

- Для автоматической установки, инициированной в Neurons, требуется добавить в команду свойства прокси.

Пример.` IvantiCloudAgent.exe --tenantid 11111… --activationkey BLtwU… --cloudhost https://xxx.ivanticloud.com --mode unattended --proxyMode Custom --proxyServerList ProxyServer.localdomain.com:8080 --proxyBypassList contoso.org;acme.com --proxyAuthType Basic --proxyUsername admin1 --proxyPassword password1`

- Для интерактивной установки, инициированной в Neurons, необходимо добавить свойства прокси в сопутствующий файл параметров.

Например:

```bash
tenantid=1111….
```

```bash
activationkey=BLtwU….
```

```bash
cloudhost=https://xxx.ivanticloud.com
```

```bash
proxyMode=Custom
```

```bash
proxyServerList=ProxyServer.localdomain.com:8080
```

```bash
proxyBypassList=contoso.org;acme.com
```

```bash
proxyAuthType=Basic
```

```bash
proxyUsername=admin1
```

```bash
proxyPassword=password1
```

- Альтернативой интерактивной установке является указание параметров в графическом интерфейсе регистрации в разделе **Конфигурация прокси**.

**Метод 2: Явная конфигурация регистрации**

Используйте этот метод, когда требуется повторная регистрация, а переустановка ненужна. То есть агент уже установлен, но регистрация требует изменений. С этим подходом в дополнение к информации прокси также требуется наличие информации регистрации.

Средство STAgentManagement доступно с установленными агентами в папке C:\Program Files\Ivanti\Ivanti Cloud Agent.

Запустите файл `./STAgentManagement.exe` для получения справочной документации.

- Флаг 'silent' используется только в командной строке.

```bash
STAgentManagement.exe -register -p silent=true -p proxyMode=Custom -p proxyServerList=ProxyServer.localdomain.com:8080 -p proxyAuthType=Basic proxyUsername=admin1
```

```bash
proxyPassword=password1 <and additional arguments for registration>
```

- Запустите команду регистрации для открытия графического интерфейса регистрации и настройки прокси-сервера.

```bash
STAgentManagement.exe -register
```

**Метод 3: Явная конфигурация прокси-сервера**

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

Средство STAgentManagement для установленных агентов находится в папке C:\Program Files\Ivanti\Ivanti Cloud Agent.

Запустите файл `./STAgentManagement.exe` для получения справочной документации.

- Флаг 'silent' используется только в командной строке.

`STAgentManagement.exe -proxyConfig -p silent=true -p proxyMode=Custom -p proxyServerList=ProxyServer.localdomain.com:8080 -p proxyAuthType=Basic proxyUsername=admin1 proxyPassword=password1`

- Запустите команду proxyConfig для открытия графического интерфейса конфигурации прокси-сервера.

`STAgentManagement.exe -proxyConfig`

**Свойства прокси-сервера на клиентах Windows**:

1. **Режим прокси**
   **Описание**: Устанавливает режим прокси-сервера.
   - Значение 'Нет' означает, что прокси-сервер не используется.
   - Значение 'Авто' относится к режиму прокси-сервера, определяемому текущими настройками ОС. Это режим по умолчанию.
   - Значение 'Особый' относится к использованию других свойств прокси-сервера.
2. **Список серверов**
   **Описание**: Имя прокси-сервера и соответствующий порт - можно указать несколько серверов.
3. **Список пропуска**
   **Описание**: Адреса, которые разрешено использовать без прокси-сервера.
4. **Тип аутентификации**
   **Описание**: Устанавливает тип аутентификации для прокси-сервера.
   - 'Базовый' уровень требует определения используемых имени пользователя и пароля.
   - Другие варианты: 'Дайджест', 'NTLM', 'Согласование' и 'Нет' означают, что учетные данные не используются.
   - Значение по умолчанию - 'Нет'.
5. **Имя пользователя и пароль**
   **Описание**: Учетные данные надежно хранятся для использования базового типа аутентификации.
6. **Обновление прокси WinHttp**
   **Описание**: Доступно только в командной строке (не через графический интерфейс). Эта настройка используется только клиентами, которым необходимо, чтобы агент не вмешивался в настройки прокси-сервера WinHTTP. Для получения дополнительной информации см. раздел [Пропуск настроек прокси-сервера WinHTTP](https://forums.ivanti.com/s/article/Opting-Out-of-WinHTTP-Proxy-Settings-Modification-During-Ivanti-Neurons-for-UEM-Agent-Registration)..
::::
