Установка и начальная настройка OpenSIPS
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 с изменённой сигнатурой), поэтому сверяйтесь с документацией модулей своей версии.
Проверка работы
- Зарегистрируйте два софтфона на
sbc.example.ruпод абонентами 101 и 102. - Убедитесь, что регистрации видны: в 3.x —
opensips-cli -x mi ul_dump, в 2.x —opensipsctl ul show. - Позвоните с 101 на 102 и посмотрите диалог в
sngrep: INVITE должен пройти через оба прокси и медиасервер, а RTP — через rtpengine. - Если звонок не проходит, повысьте
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.