Управление услугами. Именованные профили услуг [Документация VAS Experts]

Различия

Показаны различия между двумя версиями страницы.

Ссылка на это сравнение

Предыдущая версия справа и слеваПредыдущая версия
Следующая версия
Предыдущая версия
dpi:dpi_components:platform:subscriber_management:subsman_cmd [2026/03/11 11:21] elena.krasnobryzhdpi:dpi_components:platform:subscriber_management:subsman_cmd [2026/07/02 13:02] (текущий) – ↷ Операцией перемещения обновлены ссылки elena.krasnobryzh
Строка 1: Строка 1:
 {{tag>Услуги}} {{tag>Услуги}}
-====== Управление услугами ======+====== Управление услугами. Именованные профили услуг ======
 {{indexmenu_n>3}} {{indexmenu_n>3}}
-Управление абонентами осуществляется с помощью утилиты ''fdpi_ctrl''+Создание, изменение и удаление профилей услуг осуществляется с помощью утилиты ''fdpi_ctrl''\\ 
-<note important>Рекомендуем использовать [[dpi:dpi_components:platform:subscriber_management:subsman_profiles]], что упростит управление услугами.</note> +Услуги делятся на три типа: 
 +  * **Без профиля** — настройки услуги описаны в конфигурации DPI или не требуют описания, например 9 сервис (отправка биллингового NetFlow/RADIUS Accounting) 
 +  * **Анонимные (без имени) профили** — услуга не создается заранее, параметры услуги задаются в момент подключения услуги абоненту в json-формате 
 +  * **Именованные профили** — услуга создается до подключения абоненту, хранится во внутренней базе DPI — [[dpi:dpi_components:platform:dpi_admin:admin_db|]] 
 + 
 +**Именованные профили** по сравнению с анонимными профилями имеют следующие преимущества: 
 +  - Упрощают администрирование абонентов 
 +  - Позволяют находить абонентов с требуемым профилем по имени профиля 
 +  - Позволяют изменить профиль всем абонентам с заданным профилем просто изменив параметры профиля 
 +  - Позволяют контролировать ограничение на количество уникальных профилей (максимум 65535) 
 + 
 +**Анонимные (без имени) профили** в свою очередь имеют следующие преимущества: 
 +  - Не нужно заниматься менеджментом профиля (создавать его и удалять), профиль освобождается вместе с удалением абонента или профиля у абонента 
 +  - Не нужно придумывать имя профиля 
 ===== Синтаксис команд ===== ===== Синтаксис команд =====
 Общий формат команд: Общий формат команд:
Строка 25: Строка 39:
 | 4    | фильтрация по черному списку                                                                                  | [[dpi:dpi_options:opt_filtration:filtration_ctrl#активация_управления_услуги_фильтрации_на_уровне_абонентов_-_subscriber_management|Описание]]  | | 4    | фильтрация по черному списку                                                                                  | [[dpi:dpi_options:opt_filtration:filtration_ctrl#активация_управления_услуги_фильтрации_на_уровне_абонентов_-_subscriber_management|Описание]]  |
 | 5    | белый список и Captive Portal                                                                                 | [[dpi:dpi_options:opt_capture:capt_mgmt#управление_профилем_по_умолчанию_5_услуга|Описание]]                                                    | | 5    | белый список и Captive Portal                                                                                 | [[dpi:dpi_options:opt_capture:capt_mgmt#управление_профилем_по_умолчанию_5_услуга|Описание]]                                                    |
-| 6    | уведомление через HTTP redirect                                                                               | [[dpi:dpi_components:platform:subscriber_management:subsman_profiles|Описание]]                                                                 |+| 6    | уведомление через HTTP redirect                                                                               | [[dpi:dpi_components:platform:subscriber_management:subsman_cmd#команды_управления_услугами|Описание]]                                                                 |
 | 7    | кэширование                                                                                                   | [[dpi:dpi_options:opt_cache:cache_ctrl|Описание]]                                                                                               | | 7    | кэширование                                                                                                   | [[dpi:dpi_options:opt_cache:cache_ctrl|Описание]]                                                                                               |
 | 8    | пройдена DDOS защита                                                                                          | [[dpi:dpi_options:opt_ddos:ssg_ddos:ddos_ddos:ddos_ddos_settings|Описание]]                                                                              | | 8    | пройдена DDOS защита                                                                                          | [[dpi:dpi_options:opt_ddos:ssg_ddos:ddos_ddos:ddos_ddos_settings|Описание]]                                                                              |
Строка 31: Строка 45:
 | 10   | DDOS защита                                                                                                   | [[dpi:dpi_options:opt_ddos:ddos_ctrl|Описание]]                                                                                                 | | 10   | DDOS защита                                                                                                   | [[dpi:dpi_options:opt_ddos:ddos_ctrl|Описание]]                                                                                                 |
 | 11   | CGNAT и NAT 1:1                                                                                               | [[dpi:opt_cgnat|Описание]]                                                                                                                      | | 11   | CGNAT и NAT 1:1                                                                                               | [[dpi:opt_cgnat|Описание]]                                                                                                                      |
-| 12   | запись трафика в PCAP                                                                                         | [[dpi:dpi_options:opt_li:li_ctrl#управление_записью_pcap|Описание]]                                                                             |+| 12   | запись трафика в PCAP                                                                                         | [[dpi:dpi_components:platform:li_ctrl#управление_записью_pcap|Описание]]                                                                             |
 | 13   | мини Firewall                                                                                                 | [[dpi:dpi_options:opt_firewall|Описание]]                                                                                                       | | 13   | мини Firewall                                                                                                 | [[dpi:dpi_options:opt_firewall|Описание]]                                                                                                       |
 | 14   | отведение трафика на TAP интерфейс                                                                            | [[dpi:dpi_options:dpi_divert_spec|Описание]]                                                                                                    | | 14   | отведение трафика на TAP интерфейс                                                                            | [[dpi:dpi_options:dpi_divert_spec|Описание]]                                                                                                    |
 | 15   | спецабонент (весь трафик помещается в cs0, не применяется фильтрация (4 услуга) для vChannel и общего канал)  | [[dpi:dpi_options:opt_bandwidth_mgmt:vipsub|Описание]]                                                                                          | | 15   | спецабонент (весь трафик помещается в cs0, не применяется фильтрация (4 услуга) для vChannel и общего канал)  | [[dpi:dpi_options:opt_bandwidth_mgmt:vipsub|Описание]]                                                                                          |
 | 16   | белый список и переадресация на Captive Portal без доступа в интернет                                         | [[dpi:dpi_options:opt_capture:capt_mgmt#управление_именованным_профилем_16_услуга|Описание]]                                                    | | 16   | белый список и переадресация на Captive Portal без доступа в интернет                                         | [[dpi:dpi_options:opt_capture:capt_mgmt#управление_именованным_профилем_16_услуга|Описание]]                                                    |
-| 17   | зеркалирование трафика в заданный VLAN                                                                        | [[dpi:dpi_options:opt_li:li_ctrl#зеркалирование_в_vlan|Описание]]                                                                               |+| 17   | зеркалирование трафика в заданный VLAN                                                                        | [[dpi:dpi_components:platform:li_ctrl#зеркалирование_в_vlan|Описание]]                                                                               |
 | 18   | полисинг по сессии для определенных протоколов и определение классов трафика на уровнях канала и абонента     | [[dpi:dpi_options:opt_shaping:shaping_session|Описание]]                                                                                        | | 18   | полисинг по сессии для определенных протоколов и определение классов трафика на уровнях канала и абонента     | [[dpi:dpi_options:opt_shaping:shaping_session|Описание]]                                                                                        |
 | 19   | подмена DNS ответов, в планах: перенаправление DNS запросов на DNS сервер провайдера                          | [[dpi:dpi_options:dns_substitution|Описание]]                                                                                                   | | 19   | подмена DNS ответов, в планах: перенаправление DNS запросов на DNS сервер провайдера                          | [[dpi:dpi_options:dns_substitution|Описание]]                                                                                                   |
Строка 44: Строка 58:
 | 254  | VRF                                                                                                           | [[dpi:dpi_components:router#управление_vrf_абонентами|Описание]]                                                                                | | 254  | VRF                                                                                                           | [[dpi:dpi_components:router#управление_vrf_абонентами|Описание]]                                                                                |
  
-===== Примеры ===== +====== Создание, подключение и отключение услуг ======
-  - Подключить услугу: <code bash>fdpi_ctrl load --service 9 --ip 192.168.0.1 +
-#или +
-fdpi_ctrl load --service 9 --login USER1</code> +
-  - Отключить услугу: <code bash>fdpi_ctrl del --service 9 --ip 192.168.0.1</code> +
-  - Получить список с подключенной услугой: <code bash>fdpi_ctrl list all --service 9</code> +
-  - Получить информацию по конкретному IP: <code bash>fdpi_ctrl list --service 9 --ip 192.168.0.1</code> +
-  - При задании списка IP можно одновременно задать несколько опций --file--ip, --ip_range, --cidr: <code bash> +
-fdpi_ctrl list --service 9 --ip 192.168.0.1 --ip 192.168.0.2 --file fip_1.txt --ip_range 192.168.0.3-192.168.0.6 --login USER1</code> Операция применится для всех указанных элементов, по которым не произошло ошибки.\\ :!: При возникновении ошибки отката внесенных изменений не происходит! +
-  - Подключение услуг с именованными профилями: <code bash>fdpi_ctrl load --service 4 --profile.name blocked --login Test</code>+
  
-=====Настройка блокировки протоколов TCP и UDP ===== +<note important>Имя профиля уникально для каждой услугит.е''profile_name_1'' для услуги 4 (черный список) отличается от ''profile_name_1'' для услуги 5 (белый список)</note>
-Параметр ''udp_block'' отвечает за блокировку протокола UDP. Если в конфигурационном файле DPI ''/etc/dpi/fastdpi.conf'' есть этот параметр — то происходит блокировка TCP+UDP, если нет — блокируется только TCP.+
  
-Чтобы начать блокировать протоколы UDP (например, QUIC), необходимо добавить в конфигурационный файл параметр ''udp_block'' со значением 2 или 3 (начать блокировку после двух или трёх прошедших пакетов). Такие значения  +Создание именованного профиля для услуги 6 (единоразовый redirect), нотификации о новостях оператора связи и подключение данной услуги с профилем на абонента: 
-устанавливаются так как бывает, что проходит большое количество одиночных пакетов, которые не учитываются в трафике, но могут вызвать сильную нагрузку на DPI. +<code bash> 
-<code bash>udp_block=3</code>+fdpi_ctrl load profile --service 6 --profile.name redir_to_news --profile.json '{ "redirect" : "http://mysite.com/ips_news", "check" : true }' 
 +fdpi_ctrl load --service 6 --profile.name redir_to_news --ip 192.168.0.1 
 +fdpi_ctrl load --service 6 --profile.name redir_to_news --login test 
 +</code>
  
-Добавление параметра не требует рестарта DPI, достаточно сделать reload:+<note important>[[dpi:dpi_components:platform:subscriber_management:subsman_res|]]</note> 
 + 
 +Подключение услуги 6 без профиля (параметры услуги берутся из файла конфигурации DPI):
 <code bash> <code bash>
-service fastdpi reload+fdpi_ctrl load --service 6 --ip 192.168.0.1 
 +fdpi_ctrl load --service 6 --login test
 </code> </code>
 +
 +Подключение услуги 6 с анонимным профилем (профиль без имени, который существует до отключения услуги абоненту):
 +<code bash>
 +fdpi_ctrl load --service 6 --profile.json '{ "redirect" : "http://mysite.com/ips_news", "check" : true }' --ip 192.168.0.1
 +fdpi_ctrl load --service 6 --profile.json '{ "redirect" : "http://mysite.com/ips_news", "check" : true }' --login test
 +</code>
 +
 +Отключение услуги 6 для конкретного абонента:
 +<code bash>fdpi_ctrl del --service 6 --ip 192.168.0.1
 +fdpi_ctrl del --service 6 --login test
 +</code>
 +
 +====== Команды управления услугами ======
 +Получить список все абонентов с подключенной услугой 6: 
 +<code bash>fdpi_ctrl list all --service 6</code>
 +
 +Поиск абонентов, которым подключена услуга 6 с конкретным именованным профилем:
 +<code bash>
 +fdpi_ctrl list all --service 6 --profile.name redir_to_news
 +</code>
 +
 +Получить информацию по конкретному IP для 6 услуги: 
 +<code bash>fdpi_ctrl list --service 6 --ip 192.168.0.1</code>
 +
 +Удаление именованного профиля (при удалении профиля в нем не должно содержаться абонентов)
 +<code bash>
 +fdpi_ctrl del profile --service 6  --profile.name redir_to_news
 +</code>
 +
 +Изменение настроек услуги с именованным профилем (новые настройки применятся ко всем абонентам с заданным профилем услуги)
 +<code bash>
 +fdpi_ctrl load profile --service 6 --profile.name redir_to_news --profile.json '{ "redirect" : "http://mysite.com/ips_news_new", "check" : true }'
 +</code>
 +
 +Просмотр всех созданных профилей по всем услугам
 +<code bash>
 +fdpi_ctrl list all profile --service
 +</code>
 +
 +При задании списка IP можно одновременно задать несколько опций ''--file'', ''--ip'', ''--ip_range'', ''--cidr'': 
 +<code bash>
 +fdpi_ctrl list --service 6 --ip 192.168.0.1 --ip 192.168.0.2 --file fip_1.txt --ip_range 192.168.0.3-192.168.0.6 --login USER1
 +</code> 
 +
 +Операция применится для всех указанных элементов, по которым не произошло ошибки.
 +
 +:!: При возникновении ошибки отката внесенных изменений не происходит!
 +
 +<note tip>[[dpi:dpi_components:platform:dpi_admin:tcp_udp]]</note>
  
 =====Подключение дополнительных опций через Личный кабинет===== =====Подключение дополнительных опций через Личный кабинет=====
Строка 74: Строка 133:
   - Выбрать из списка лицензию, для которой требуются доп.опции   - Выбрать из списка лицензию, для которой требуются доп.опции
   - Выбрать необходимые опции из списка доступных   - Выбрать необходимые опции из списка доступных
-  - Нажать “Отправить заявку”\\ {{:dpi:dpi_components:platform:subscriber_management:my_lic.png?direct&1000|}} +  - Нажать “Отправить заявку”\\ {{:dpi:dpi_components:platform:subscriber_management:options.png?nolink&1000|}} 
-  - Заполнить данные и отправить заявку\\ {{:dpi:dpi_components:platform:subscriber_management:application_co.png?direct&400|}}+  - Заполнить данные и отправить заявку\\ {{:dpi:dpi_components:platform:subscriber_management:application_co.png?nolink&400|}}