Готовые конфиги OpenSIPS: примеры и как их адаптировать
Писать 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. Их можно развернуть на одной машине (на разных портах) или на двух.
- Relay (граничный прокси). Принимает регистрации и вызовы из интернета, авторизует абонентов, исправляет адреса за NAT и через модуль
rtpengineнаправляет медиапоток через RTPEngine. - B2BUA. Работает как «два абонента в одном»: разрывает диалог на два независимых плеча. Это позволяет скрыть внутреннюю топологию, подменять заголовки, реализовывать перевод вызова и сценарии вроде click-to-dial. В OpenSIPS за это отвечают модули
b2b_entitiesиb2b_logic.
Такой набор примеров обычно содержит:
opensips.cfgдля узла relay: секцииlisten, загрузку модулей,routeс проверками, регистрацией и поиском абонента,onreply_routeиfailure_route;opensips.cfgдля узла B2BUA с описанием сценариев;- настройки RTPEngine (адреса интерфейсов, диапазон портов);
- SQL или команды для заполнения таблиц абонентов и шлюзов.
Как адаптировать пример под свою сеть
Перед первым запуском пройдитесь по списку:
- Адреса. Замените IP в директивах
socket(в 3.x) илиlisten(в 2.x) на адреса своих интерфейсов. Проверьтеadvertised_address, если сервер за NAT. - Домен. Если в скрипте сравнивается домен (
is_myself,$rd), укажите свой домен или добавьтеalias. - База данных. Пропишите строки подключения
db_urlс реальным логином и паролем; создайте базу командойopensips-cli -x database create. - Пути к модулям. Параметр
mpathдолжен указывать на каталог модулей вашей установки. - RTPEngine. Адрес управляющего сокета в
modparam("rtpengine", "rtpengine_sock", "udp:127.0.0.1:2223")должен совпадать с параметромlisten-ngRTPEngine. - Шлюзы и маршруты. Замените адреса операторов и медиасерверов из примера на свои — в скрипте или в таблицах
dispatcher,drouting,load_balancer. - Безопасность. Убедитесь, что вызовы наружу разрешены только авторизованным абонентам, иначе сервер станет бесплатным шлюзом для чужих звонков. Добавьте ограничение частоты запросов модулем
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 разберёт файл и сообщит об ошибках, не запуская сервер.