Shkerka.ruзаметки админа
SIP, Kamailio и софтфоны

Готовые конфиги OpenSIPS: примеры и как их адаптировать

Опубликовано: Обновлено: 3 мин чтенияАвтор: Редакция Shkerka.ru

Писать opensips.cfg с нуля долго, поэтому почти всегда начинают с готового примера. Рассказываем, какие шаблоны конфигурации есть у самого OpenSIPS, как устроена популярная схема из двух узлов — B2BUA и relay с RTPEngine — и что править в примере перед запуском.

Зачем нужны готовые примеры

Конфигурация OpenSIPS — это одновременно настройки модулей и программа маршрутизации SIP-запросов на собственном языке скрипта. Ошибка в порядке проверок легко приводит к открытому ретранслятору звонков или к отказу в регистрации всем абонентам. Поэтому разумный путь — взять проверенный пример, понять каждый блок и уже затем дописывать свою логику.

Примеры полезны и для обучения: по ним хорошо видно, как связаны модули tm, rr, registrar, usrloc, auth_db и dialog.

Официальные шаблоны OpenSIPS

Вместе с OpenSIPS 3.x поставляется генератор конфигураций osipsconfig (в старых версиях — menuconfig). Он задаёт несколько вопросов и собирает рабочий opensips.cfg по одному из шаблонов:

Шаблон Для чего
Residential регистратор и прокси для абонентов офиса или оператора: авторизация, хранение регистраций, вызовы между абонентами
Trunking маршрутизация вызовов между операторами и шлюзами без регистрации абонентов
Load-balancer раздача вызовов на группу медиасерверов (например, Asterisk или FreeSWITCH) с учётом нагрузки

В генераторе включаются опции вроде работы с базой данных, NAT, TLS, учёта вызовов. Получившийся файл — лучшая отправная точка: он гарантированно соответствует установленной версии.

Документация по всем модулям и примеры скриптов — на официальном сайте https://www.opensips.org/Documentation. Выбирайте раздел своей ветки: параметры модулей между версиями отличаются.

Схема из двух узлов: B2BUA и relay с RTPEngine

Распространённая архитектура для небольшого оператора или крупного офиса — два логических сервера OpenSIPS. Их можно развернуть на одной машине (на разных портах) или на двух.

  1. Relay (граничный прокси). Принимает регистрации и вызовы из интернета, авторизует абонентов, исправляет адреса за NAT и через модуль rtpengine направляет медиапоток через RTPEngine.
  2. B2BUA. Работает как «два абонента в одном»: разрывает диалог на два независимых плеча. Это позволяет скрыть внутреннюю топологию, подменять заголовки, реализовывать перевод вызова и сценарии вроде click-to-dial. В OpenSIPS за это отвечают модули b2b_entities и b2b_logic.

Такой набор примеров обычно содержит:

  • opensips.cfg для узла relay: секции listen, загрузку модулей, route с проверками, регистрацией и поиском абонента, onreply_route и failure_route;
  • opensips.cfg для узла B2BUA с описанием сценариев;
  • настройки RTPEngine (адреса интерфейсов, диапазон портов);
  • SQL или команды для заполнения таблиц абонентов и шлюзов.

Как адаптировать пример под свою сеть

Перед первым запуском пройдитесь по списку:

  1. Адреса. Замените IP в директивах socket (в 3.x) или listen (в 2.x) на адреса своих интерфейсов. Проверьте advertised_address, если сервер за NAT.
  2. Домен. Если в скрипте сравнивается домен (is_myself, $rd), укажите свой домен или добавьте alias.
  3. База данных. Пропишите строки подключения db_url с реальным логином и паролем; создайте базу командой opensips-cli -x database create.
  4. Пути к модулям. Параметр mpath должен указывать на каталог модулей вашей установки.
  5. RTPEngine. Адрес управляющего сокета в modparam("rtpengine", "rtpengine_sock", "udp:127.0.0.1:2223") должен совпадать с параметром listen-ng RTPEngine.
  6. Шлюзы и маршруты. Замените адреса операторов и медиасерверов из примера на свои — в скрипте или в таблицах dispatcher, drouting, load_balancer.
  7. Безопасность. Убедитесь, что вызовы наружу разрешены только авторизованным абонентам, иначе сервер станет бесплатным шлюзом для чужих звонков. Добавьте ограничение частоты запросов модулем pike.

Проверка синтаксиса и запуск:

opensips -C -f /etc/opensips/opensips.cfg
systemctl restart opensips
opensips-cli -x mi uptime

Актуальность

OpenSIPS активно развивается, текущие ветки — 3.x, с регулярными LTS-выпусками. По сравнению с 2.x изменилась утилита управления (opensips-cli вместо opensipsctl), появилась директива socket, переработаны B2B-модули. Примеры, написанные под 2.x, годятся как иллюстрация архитектуры, но переносить их надо осознанно, сверяясь с документацией своей версии.

Установка самого сервера описана в статье Установка и начальная настройка OpenSIPS. Если вы выбираете между OpenSIPS и его «родственником» Kamailio, посмотрите установку и настройку Kamailio: идеи конфигурации у проектов общие, а синтаксис и набор модулей различаются.

Частые вопросы

Где лежит конфиг OpenSIPS после установки?

В пакетных установках основной файл — /etc/opensips/opensips.cfg. Шаблоны для генератора конфигураций находятся в каталоге с примерами пакета; точный путь зависит от дистрибутива и версии, его можно найти командой dpkg -L opensips.

Подойдёт ли конфиг от OpenSIPS 2.x для версии 3.x?

Как образец логики — да, но запустить его без правок не выйдет. В 3.x изменились синтаксис ряда функций, параметры модулей и управление (opensips-cli вместо opensipsctl). Переносите логику по блокам и проверяйте каждый модуль по документации нужной версии.

Зачем в схеме нужен RTPEngine?

OpenSIPS обрабатывает только SIP-сигнализацию. Если абоненты за NAT или нужно скрыть медиаадреса, RTP пропускают через RTPEngine, а OpenSIPS управляет им модулем rtpengine, переписывая SDP.

Как проверить конфиг перед перезапуском?

Запустите opensips -C -f /etc/opensips/opensips.cfg: OpenSIPS разберёт файл и сообщит об ошибках, не запуская сервер.