# Использование прокси

В ряде сценариев может потребоваться отправка запросов от **Webim** к внешним сервисам через **прокси-сервер**.

Прокси используются для следующих случаев:

  * запросы в каналы (MAX, Telegram, Viber и др.);

  * отправка пуш-уведомлений (`hpk` — Huawei, `apns` — iOS, `fcm` — Android).

Настройки прокси могут указываться двумя способами:

  1. **Глобальная конфигурация** — задаётся в [редакторе настроек аккаунта](https://webim.ru/kb/for-admins/service-pages/account-config-editor.html) (`proxies`), применяется ко всем поддерживаемым каналам и сервисам, если у них нет индивидуальных настроек.

  1. **Индивидуальная конфигурация** — задаётся на уровне конкретного канала через Панель управления.

## Поддерживаемые типы прокси

Webim поддерживает только **HTTP-прокси**. Использование других типов (например, SOCKS-прокси) не предусмотрено.

!!! Note "N.B."
    Если в вашей инфраструктуре используется нестандартный прокси, убедитесь, что он поддерживает **HTTP-протокол**.

## Каналы с поддержкой прокси

На момент версии Webim **10.7**, использование прокси доступно **только для следующих каналов**:

  * **LINE**

  * **Telegram**

  * **Viber**

Для остальных каналов (например, WhatsApp[^whatsapp_footnote], VK и др.) прокси не применяется. Даже если в настройках задан глобальный прокси — запросы будут отправляться напрямую.

## Настройка прокси на уровне канала

Чтобы задать прокси для конкретного канала:

  1. Перейдите в раздел **Каналы общения** в интерфейсе **РМО**.  
  ![Настройки каналов общения](https://webim.ru/kb/img/devops/proxy/channel-settings.webp){ style="width: 283px; max-width: 100%" }

  1. Нажмите **Добавить** или выберите нужный канал и нажмите **Редактировать**.
  ![Добавление или редактирование канала](https://webim.ru/kb/img/devops/proxy/channel-settings-edit.webp){ style="width: 705px; max-width: 100%" }

  1. В нижней части формы включите опцию **Использовать прокси**, заполните поля и нажмите **Сохранить**.
  ![Включение прокси](https://webim.ru/kb/img/devops/proxy/channel-settings-proxy.webp){ style="width: 765px; max-width: 100%" }

Описание полей:

| Параметр         | Описание                                                    |
|------------------|-------------------------------------------------------------|
| **Адрес**        | IP-адрес или доменное имя прокси-сервера.                   |
| **Порт**         | Порт, используемый для подключения.                         |
| **Пользователь** | Имя пользователя (если прокси требует аутентификацию).      |
| **Пароль**       | Пароль пользователя (если прокси требует аутентификацию).   |

В форме канала **Telegram** также может быть поле **URL прокси для вебхука** (`webhook_proxy_url`).

При редактировании уже сохранённого канала **Адрес** прокси, **Пароль** и (для Telegram) **URL прокси для вебхука** отображаются частично скрытыми. Чтобы изменить поле, введите новое значение целиком. Незаполненные поля не маскируются. Подробнее о виде маски см. в разделе [Каналы общения](https://webim.ru/kb/channels/).

После сохранения настроек канал будет использовать указанный прокси. Если прокси не включён на уровне канала, будет использоваться глобальная конфигурация.

## Глобальная настройка прокси

Глобальная конфигурация указывается в account config в блоке `proxies` и применяется ко всем поддерживаемым каналам и сервисам (пуши, каналы), если у них нет индивидуальной настройки.

Пример блока в [редакторе настроек аккаунта](https://webim.ru/kb/for-admins/service-pages/account-config-editor.html):

```json
{
  "channels": {
    "host": "127.0.0.1",
    "port": "3128",
    "user": "user1",
    "password": "12345"
  },
  "fcm": {
    "host": "127.0.0.1",
    "port": "3128",
    "user": "user1",
    "password": "12345"
  },
  "apns": {
    "host": "127.0.0.1",
    "port": "3128",
    "user": "user1",
    "password": "12345"
  },
  "hpk": {
    "host": "127.0.0.1",
    "port": "3128",
    "user": "user1",
    "password": "12345"
  }
}
```

!!! Note "N.B."
    Если у вас нет доступа к редактору настроек аккаунта, обратитесь к вашему **аккаунт-менеджеру Webim** для изменения настроек.

---

Использование прокси в Webim позволяет адаптировать систему под особенности корпоративной инфраструктуры и повысить безопасность соединений.

Перед настройкой убедитесь, что:

  * нужный канал поддерживает работу через прокси;

  * выбранный прокси работает по **протоколу HTTP**.

[^whatsapp_footnote]: WhatsApp принадлежит корпорации Meta, деятельность которой признана экстремистской и запрещена в РФ.

---

Источник: https://webim.ru/kb/devops/proxy.html