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

Установка и начальная настройка OpenSIPS

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

OpenSIPS — SIP-прокси, близкий родственник Kamailio, который часто ставят перед медиасерверами Asterisk. Разбираем установку, подготовку окружения, базу данных, первых абонентов и медиапрокси rtpengine — для ветки 2.2, на которой строилась схема, и для актуальной 3.x.

Схема

OpenSIPS — прямой конкурент Kamailio: функционально они схожи, а логика маршрутизации из одного проекта с небольшими изменениями переносится в другой. Схема из этого примера разделяет роли двух прокси:

UA(A) ---> OpenSIPS1 ---> OpenSIPS2 ---> Asterisk
                                            |
UA(B) <--- OpenSIPS1 <--- OpenSIPS2 <-------+

INVITE от абонента A проходит через пограничный OpenSIPS1 на OpenSIPS2, который отдаёт вызов медиасерверам Asterisk. Asterisk разворачивает вызов обратно на OpenSIPS2, тот передаёт его OpenSIPS1, и OpenSIPS1 доставляет вызов абоненту B. Так регистрация и NAT остаются на пограничном прокси, а приложения телефонии — на медиасерверах. Готовые файлы маршрутизации для этой схемы собраны на странице с конфигами OpenSIPS.

Подготовка сервера

Утилиты, которые понадобятся для отладки:

apt install net-tools tcpdump sngrep mc dnsutils git htop

Исходники берутся из официального репозитория на GitHub. В исходной схеме использовалась LTS-ветка 2.2; для новой установки подставьте актуальную ветку 3.x:

cd /usr/local/src
git clone -b 2.2 https://github.com/OpenSIPS/opensips.git opensips_2_2
cd opensips_2_2

Зависимости для сборки с поддержкой PostgreSQL, TLS, JSON, Lua, Perl, Python, Redis, memcached и SNMP (имена пакетов для Debian; в новых выпусках часть из них переименована, например Python 2 заменён на python3-dev):

apt install build-essential bison flex libncurses5-dev libssl-dev \
  libpq-dev libcurl4-gnutls-dev libxml2-dev libexpat1-dev libpcre3-dev \
  libjson-c-dev libhiredis-dev libmemcached-dev libmicrohttpd-dev \
  liblua5.1-dev libperl-dev libsnmp-dev libsqlite3-dev libldap2-dev \
  libradcli-dev librabbitmq-dev libsctp-dev libconfuse-dev unixodbc-dev \
  default-libmysqlclient-dev xsltproc

Сборка

Модули выбираются в меню:

make menuconfig

Для этой схемы включались: aaa_radius, b2b_logic, cachedb_memcached, carrierroute, compression, cpl_c, db_postgres, dialplan, regex, json, lua, mmgeoip, perl, python, proto_tls, proto_sctp, tls_mgm, presence с модулями presence_dialoginfo, presence_mwi, presence_xml, а также snmpstats и xcap. После выбора — сборка и установка в /usr/local:

make all
make install

Если сервер не один, удобнее собрать собственный deb-пакет (dpkg-buildpackage -rfakeroot в каталоге с debian/) и раскатывать его. Для 3.x есть и готовые пакеты в официальном репозитории apt.opensips.org — это самый простой путь, если не нужны нестандартные модули.

Пользователь, каталоги и служба

adduser --quiet --system --group --disabled-password \
  --shell /bin/false --gecos "OpenSIPS" --home /var/run/opensips opensips
mkdir -p /var/run/opensips
chown opensips:opensips /var/run/opensips

В Debian 9 использовался init-скрипт из packaging/debian, сейчас проще описать юнит systemd:

# /etc/systemd/system/opensips.service
[Unit]
Description=OpenSIPS SIP server
After=network-online.target postgresql.service

[Service]
Type=forking
User=opensips
Group=opensips
RuntimeDirectory=opensips
PIDFile=/run/opensips/opensips.pid
ExecStart=/usr/local/sbin/opensips -P /run/opensips/opensips.pid -f /usr/local/etc/opensips/opensips.cfg -m 2048 -M 128
Restart=on-failure

[Install]
WantedBy=multi-user.target

Ключ -m задаёт разделяемую память в мегабайтах, -M — память каждого процесса. Перед запуском проверьте конфигурацию:

/usr/local/sbin/opensips -C -f /usr/local/etc/opensips/opensips.cfg
systemctl daemon-reload
systemctl enable --now opensips
ss -lunp | grep opensips

Логи

В opensips.cfg задайте log_facility=LOG_LOCAL0, а в rsyslog направьте этот поток в отдельный файл:

# /etc/rsyslog.d/opensips.conf
local0.*    -/var/log/opensips.log

Ротация через logrotate:

/var/log/opensips.log {
    daily
    rotate 90
    missingok
    notifempty
    compress
    delaycompress
    create 640 root adm
    postrotate
        systemctl kill -s HUP rsyslog.service
    endscript
}

Проверить правило без реального выполнения можно командой logrotate -d /etc/logrotate.d/opensips.

База данных

В ветке 2.x параметры базы и домена задавались в opensipsctlrc:

SIP_DOMAIN=sbc.example.ru
DBENGINE=PGSQL
DBHOST=dbhost
DBPORT=5432
DBNAME=opensips
DBRWUSER=opensips
DBRWPW="secret"
DBROOTUSER="postgres"
STORE_PLAINTEXT_PW=0
MI_CONNECTOR=FIFO:/var/run/opensips/opensips_fifo

Затем создавались таблицы, домен и абоненты:

opensipsdbctl create
opensipsctl domain add sbc.example.ru
opensipsctl add 101@sbc.example.ru secret101
opensipsctl add 102@sbc.example.ru secret102

В 3.x то же делает opensips-cli. URL базы указывается в его конфигурации (database_url в /etc/opensips-cli.cfg):

opensips-cli -x database create
opensips-cli -x user add 101@sbc.example.ru secret101
opensips-cli -x mi domain_reload

Домен добавляется строкой в таблицу domain, после чего список перечитывается MI-командой domain_reload.

Медиапрокси rtpengine

rtpengine от Sipwise берёт на себя RTP: проксирует медиа через NAT, умеет SRTP и запись. Его собирают из исходников (https://github.com/sipwise/rtpengine) в deb-пакеты или ставят из пакетов дистрибутива, если они есть. Для пересылки в ядре нужен модуль xt_RTPENGINE; старые версии требовали вручную добавлять правило iptables на диапазон медиапортов, новые управляют правилами сами — сверьтесь с документацией вашей версии.

Подключение в opensips.cfg:

loadmodule "rtpengine.so"
modparam("rtpengine", "rtpengine_sock", "udp:127.0.0.1:2223")

В маршрутизации вызывайте rtpengine_offer() на INVITE с SDP, rtpengine_answer() на ответ и rtpengine_delete() при завершении вызова.

Каркас маршрутизации

Конфигурация OpenSIPS состоит из глобальных параметров (listen, log_level, число процессов), загрузки модулей с их параметрами и блоков маршрутизации. Главный блок — route, через который проходит каждый входящий запрос. Минимальная логика пограничного прокси выглядит так:

route {
    if (!mf_process_maxfwd_header(10)) {
        send_reply(483, "Too Many Hops");
        exit;
    }

    if (has_totag()) {
        # запрос внутри существующего диалога
        if (loose_route()) {
            t_relay();
            exit;
        }
        send_reply(404, "Not here");
        exit;
    }

    if (is_method("REGISTER")) {
        if (!www_authorize("", "subscriber")) {
            www_challenge("", "auth");
            exit;
        }
        save("location");
        exit;
    }

    record_route();
    # здесь — аутентификация INVITE, выбор Asterisk через dispatcher и t_relay()
}

Регистрации сохраняются в таблицу location, а для вызовов на медиасерверы удобно использовать модуль dispatcher: он балансирует нагрузку между несколькими Asterisk и проверяет их доступность по OPTIONS. Точные имена функций аутентификации различаются между ветками 2.x и 3.x (в 3.x они вынесены в модуль auth_db с изменённой сигнатурой), поэтому сверяйтесь с документацией модулей своей версии.

Проверка работы

  1. Зарегистрируйте два софтфона на sbc.example.ru под абонентами 101 и 102.
  2. Убедитесь, что регистрации видны: в 3.x — opensips-cli -x mi ul_dump, в 2.x — opensipsctl ul show.
  3. Позвоните с 101 на 102 и посмотрите диалог в sngrep: INVITE должен пройти через оба прокси и медиасервер, а RTP — через rtpengine.
  4. Если звонок не проходит, повысьте log_level и смотрите /var/log/opensips.log.

Что изменилось

Ветка 2.2 давно вышла из поддержки, а Debian 9 — тоже. Для новой установки берите Debian 12 и актуальную LTS-ветку OpenSIPS 3.x: синтаксис конфигурации в ней заметно переработан, часть модулей переименована, а opensipsctl и osipsconsole заменены на opensips-cli. Логика схемы и рекомендации по rtpengine при этом остаются в силе. Разобраться в сообщениях, которые идут через прокси, поможет шпаргалка по основам SIP, а альтернативный вариант прокси описан в статье об установке Kamailio.

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

Чем OpenSIPS отличается от Kamailio?

Оба проекта выросли из SER и близки по архитектуре и языку конфигурации, поэтому решения часто переносятся с небольшими правками. Отличаются набором модулей, синтаксисом части функций и инструментами управления: в OpenSIPS 3.x это opensips-cli.

Куда делись opensipsctl и osipsconsole?

В OpenSIPS 3.0 их заменила утилита opensips-cli на Python. Она создаёт базу, управляет абонентами и отправляет MI-команды работающему серверу.

Зачем OpenSIPS нужен rtpengine?

Сам OpenSIPS обрабатывает только сигнализацию. rtpengine проксирует RTP: решает проблемы NAT, умеет шифрование SRTP и транскодирование, а модуль ядра позволяет пересылать медиа без нагрузки на процессор.

Какую версию OpenSIPS ставить сегодня?

Актуальную LTS-ветку 3.x. Ветка 2.2 давно не поддерживается и подходит только для сопровождения старых установок; список поддерживаемых версий есть на opensips.org.