Больше 30 абонентов? Переводим PJSIP в базу через ODBC и Sorcery
Если у вас больше 30 сотрудников и каждый новый звонок требует правки конфига, вы стоите на пороге катастрофы. Я покажу, как перевести PJSIP-абонентов в базу данных через Asterisk Realtime, используя ODBC и механизм Sorcery. Это убережёт от ошибок синтаксиса и позволит добавлять пользователей одним INSERT без перезагрузки Asterisk. Разберу на примере колл-центра «Домовёнок», где мы заменили хаос в конфиге на управляемую схему с кэшированием.
Почему pjsip.conf рушится при росте штата
Представьте себе колл-центр интернет-магазина «Домовёнок». У них 48 рабочих мест, сменная работа, постоянная текучка. Раньше, когда у них было 5 операторов, всё работало: пришёл новый человек — сисадмин открывает pjsip.conf, пишет три секции: endpoint, auth, aor. Сохраняет, делает reload. Всё чисто. Но когда стало 48 человек, и люди приходят и уходят каждые две недели, эта система начала давать сбои. Ошибка в одной запятой, забытый пробел или неверный формат строки приводили к тому, что при перезагрузке модуля падала вся телефония. А перезагружать модуль PJSIP в рабочее время — это значит остановить звонки всем операторам.
Мы в «АйТи-Фреш» видели, как администраторы тратят часы на поиск лишней скобки в конце файла. А если правку делал стажёр? Тогда паника. Проблема не в людях, а в методе. Хранить конфигурацию 50+ абонентов в плоском текстовом файле — это как вести бухгалтерию в блокноте. На бумаге всё красиво, пока не нужно будет найти ошибку за прошлый квартал. В Asterisk при большом количестве объектов статический конфиг становится узким горлышком. Любое изменение требует чтения всего файла, парсинга и полной перезагрузки состояния. Это долго и опасно.
Кроме того, есть проблема безопасности. Конфиг-файлы часто лежат в общем доступе для чтения, и там могут быть пароли. Хотя в PJSIP они обычно хешируются, практика показывает, что люди пишут их в открытом виде. А ещё есть проблема резервных копий. Вы уверены, что ваш bkp pjsip.conf актуален на момент аварии? Или это версия от вчерашнего дня, когда уволили половину отдела? Переход на Realtime решает эти проблемы, перекладывая ответственность за целостность данных на СУБД, которая умеет транзакции и логи.
Архитектура Realtime: Sorcery, ODBC и маппинг таблиц
Как это работает изнутри? В основе лежит механизм Sorcery, который управляет жизненным циклом объектов Asterisk. Вместо того чтобы читать файл, Sorcery обращается к внешнему источнику. Для этого используется модуль res_odbc, который обеспечивает связь с базой данных через драйвер ODBC. В файле sorcery.conf мы указываем, какие типы объектов (endpoint, auth, aor) брать из базы данных и из каких именно таблиц. Это называется маппинг. Например, объект endpoint маппится на таблицу ps_endpoints, auth на ps_auths, aor на ps_aors. Имя таблицы должно начинаться с префикса ps_, если вы используете стандартную схему.
Настройка начинается с файла /etc/asterisk/sorcery.conf. Здесь критически важно соблюсти порядок строк. Документация Asterisk чётко говорит: строка кэширования должна идти ПЕРЕД строкой realtime. Если вы напишете realtime первым, Asterisk проигнорирует кэш и будет бегать в базу данных при каждом звонке, что убьёт производительность. Правильная последовательность выглядит так: сначала строка с указанием кэша (endpoint/cache = memory_cache,...), а затем строка с указанием источника (endpoint = realtime,ps_endpoints). Также нужно помнить, что секция в sorcery.conf должна называться точно как модуль, например [res_pjsip].
Для подключения к базе данных используется файл /etc/asterisk/res_odbc.conf. Там описывается пул соединений. Мы задаём имя DSN, которое должно совпадать с записью в системном файле odbc.ini. Также указываем пользователя и пароль. Параметр pre-connect => yes заставляет Asterisk устанавливать соединение сразу при старте, что ускоряет работу. Но самое важное — это драйвер. Для MySQL или MariaDB я настоятельно рекомендую использовать MariaDB ODBC connector, а не стандартный MySQL ODBC, так как последний имеет известные проблемы со стабильностью. Проверить работу соединения можно командой CLI 'odbc show'. Если видите 'Connected: No', значит, проблема в драйвере или правах доступа, а не в Asterisk.
- Модуль res_odbc.so должен быть загружен (preload в modules.conf)
- Файл sorcery.conf: секция [res_pjsip] с маппингом объектов
- Порядок строк: сначала cache, потом realtime
- DSN в res_odbc.conf должен совпадать с odbc.ini
- Использовать MariaDB ODBC connector для стабильности
Создание схемы базы данных и управление миграциями
Какие таблицы нужны? Вы не можете просто создать пустые таблицы и начать писать туда данные. Структура таблицы должна строго соответствовать ожиданиям модуля res_pjsip. К счастью, проект Asterisk предоставляет инструмент для автоматической генерации схемы — Alembic. Он находится в каталоге contrib/ast-db-manage/ исходного кода Asterisk. Вам нужно скопировать config.ini.sample в config.ini, отредактировать строку sqlalchemy.url с указанием вашей базы данных, и запустить команду alembic -c config.ini upgrade head. Эта команда создаст все необходимые таблицы: ps_endpoints, ps_auths, ps_aors, ps_contacts и другие.
Alembic создаёт колонки, соответствующие параметрам конфигурации PJSIP. Имена колонок совпадают с именами параметров в конфиг-файле. Но есть нюанс: любая таблица, используемая через Sorcery, должна иметь колонку id типа VARCHAR(128). Это первичный ключ, который связывает все части объекта. Если вы создадите таблицу вручную без id, Sorcery не сможет найти объект. Также обратите внимание на специальные символы. Точка с запятой ';' в значениях конфига является разделителем в некоторых форматах, поэтому при записи в БД её нужно заменять на ^3B, иначе парсинг сломается.
Что делать, если вышла новая версия Asterisk и появились новые параметры? Alembic поддерживает миграции. Команда upgrade head применит все новые изменения схемы, добавив отсутствующие колонки. Но будьте осторожны: downgrade base откатит всё к пустому состоянию и удалит таблицы. Используйте это только для тестов. В продакшене всегда делайте бэкап базы перед обновлением схемы. Мы в «АйТи-Фреш» всегда делаем полную копию базы перед запуском миграций, даже если уверены в изменениях. Одна ошибка в скрипте миграции может оставить вас без телефонии на несколько часов.
Производительность и кэширование: почему realtime не всегда медленно
Самый частый страх админов: «База данных будет тормозить звонки». И действительно, прямой доступ к БД при каждом пакете SIP — это очень медленно. Но мы же не делаем этого! Мы используем встроенный механизм кэширования Sorcery. Когда Asterisk запускается или когда происходит событие обновления, объекты загружаются в оперативную память (memory_cache). Дальнейшие запросы к этим объектам идут из кэша, и скорость становится сравнимой со статическим конфигом. Кэш настраивается в тех же строках sorcery.conf, которые мы обсуждали выше. Параметры object_lifetime_maximum и object_lifetime_stale позволяют контролировать, как долго объект живёт в кэше.
Параметр object_lifetime_stale определяет, через сколько секунд объект считается устаревшим. Пока он в кэше, Asterisk отдаёт старую версию, а обновление идёт в фоне. Это гарантирует, что активные звонки не прервутся из-за изменений в базе. Параметр object_lifetime_maximum — это абсолютный лимит жизни объекта, после которого он гарантированно удаляется из кэша. Если вы поставите 0, объект будет жить вечно, пока не перезагрузится модуль. Для объектов, которые меняются редко (endpoint, aor), можно ставить большие значения, например 1800 секунд (30 минут). Для контактов, которые обновляются постоянно, значения должны быть меньше.
Но есть ловушка. Если вы измените данные в базе данных напрямую (например, через SQL-консоль или админку CRM), Asterisk об этом не узнает мгновенно. Кэш останется старым. Чтобы принудительно обновить кэш, нужно использовать CLI-команды: sorcery memory cache expire или sorcery memory cache populate. Команда expire удаляет объекты из кэша, заставляя Asterisk перечитать их из БД при следующем обращении. Команда populate очищает весь кэш и сразу заполняет его данными из бэкенда. Это критически важно при массовом импорте абонентов. Без этого команда 'core reload' не поможет, так как Sorcery кэширует объекты независимо от перезагрузки конфигов.
- endpoint, aor, auth читаются часто, меняются редко — кэш с большим TTL
- contact читается и записывается часто — кэш с меньшим TTL
- После прямого изменения БД используйте 'sorcery memory cache expire'
- Команда 'populate' полностью перезагружает кэш из бэкенда
- Параметр expire_on_reload удаляет объекты кэша при перезагрузке модуля
Практика: безопасное добавление абонента одним INSERT
Давайте вернёмся к «Домовёнку». Раньше приходило уведомление о приёме нового сотрудника, и администратор открывал конфиг. Теперь всё иначе. Мы написали простой скрипт, который по данным из CRM делает три INSERT-запроса в транзакции. Первый INSERT в таблицу ps_aors создаёт адресную запись. Второй INSERT в ps_auths создаёт учётные данные для авторизации. Третий INSERT в ps_endpoints создаёт сам терминал, связывая его с AOR и Auth через поле id. Все три записи имеют одинаковый уникальный идентификатор, например 'operator_101'. Благодаря транзакции, если один из запросов упадёт, все откатятся, и в базе не останется «половинчатого» абонента.
Почему это лучше? Во-первых, не нужно перезагружать Asterisk. Модуль res_pjsip видит изменения в базе почти мгновенно (благодаря механизму отслеживания изменений или периодической проверке, если настроено). Во-вторых, исключается человеческий фактор. Нет лишних пробелов, нет опечаток в именах переменных. Скрипт валидирует данные перед вставкой. В-третьих, это масштабируемо. Добавлять 1 абонента и 100 абонентов — это одно и то же время работы скрипта. В статике добавление 100 абонентов потребовало бы ручного копипаста 300 строк кода и риска сломать всё.
Важный момент: транспорт. Как я уже говорил, transport нельзя хранить в базе. Поэтому в скрипте мы не пишем транспорт. Он берётся из глобальных настроек или по умолчанию. Если нужно указать конкретный транспорт для абонента, это делается в колонке transport в таблице ps_endpoints, но сам транспорт должен быть определён в pjsip.conf. Если транспорта с таким именем нет, регистрация не сработает. Мы в «АйТи-Фреш» всегда проверяем, что все используемые транспорты определены в статическом конфиге перед запуском скрипта импорта.
- Создать транзакцию в СУБД
- INSERT в ps_aors с уникальным id
- INSERT в ps_auths с тем же id
- INSERT в ps_endpoints с ссылкой на aor и auth
- COMMIT транзакции
- Сброс кэша: 'sorcery memory cache expire'
Резервное копирование и восстановление
Когда конфигурация лежит в базе данных, подход к бэкапам меняется. Больше не нужно бэкапить файл pjsip.conf. Теперь нужно бэкапить базу данных. Это проще и надёжнее. Стандартные утилиты mysqldump или pg_dump отлично справляются с задачей. Но есть нюанс: нужно бэкапить не только таблицы ps_*, но и таблицы, связанные с очередями, планами маршрутизации и другими модулями, если они тоже используют Realtime. Мы в «АйТи-Фреш» делаем полную дампу всей базы asterisk ежедневно. Это гарантирует, что при потере сервера мы восстановим не только конфигурацию, но и логи, и историю вызовов, если они там хранятся.
Восстановление тоже простое. Вы разворачиваете новый сервер, устанавливаете Asterisk, настраиваете ODBC и Sorcery, запускаете Alembic для создания структуры, и затем восстанавливаете данные из дампа. После этого нужно запустить команду 'sorcery memory cache populate', чтобы заполнить кэш новыми данными. Готово. Телефония работает. Никакого ручного копирования конфигов. Это особенно актуально для компаний с несколькими серверами или для миграции в облако. Вы просто переносите базу данных, и вся конфигурация переезжает вместе с ней.
Однако, не забывайте про бэкапы самих конфигов. Даже если основная конфигурация в базе, файлы modules.conf, sorcery.conf, res_odbc.conf и pjsip.conf (где лежат транспорты и глобальные настройки) всё равно существуют. Их тоже нужно бэкапить. Но это уже статические файлы, которые меняются редко. Их можно включить в общий бэкап системы. Главное — не потерять структуру базы и настройки подключения к ней. Потеря базы данных с конфигурацией PJSIP равносильна потере всей телефонии.
Частые вопросы
Можно ли хранить контакты в базе данных?
Да, можно использовать таблицу ps_contacts, но по умолчанию контакты хранятся в astdb. Хранение в БД удобно для синхронизации, но требует правильной настройки кэша.
Нужно ли перезагружать Asterisk после добавления абонента?
Нет, не нужно. Благодаря механизму Sorcery и кэшированию, изменения в базе данных применяются динамически. Достаточно сбросить кэш командой CLI при необходимости.
Какое влияние на производительность оказывает Realtime?
При правильной настройке кэширования производительность Realtime сравнима со статическим конфигом. Прямой доступ к БД без кэша будет медленным, поэтому кэш обязателен.
Можно ли использовать PostgreSQL вместо MySQL?
Да, Asterisk поддерживает PostgreSQL через ODBC. Принцип настройки тот же, но нужно использовать соответствующий ODBC-драйвер и настроить DSN в odbc.ini.
Что делать, если Sorcery не видит новые объекты?
Проверьте, что кэш не заблокировал изменения. Выполните команду 'sorcery memory cache expire' или 'sorcery memory cache populate' для принудительного обновления.
Нужен ли отдельный сервер базы данных?
Для небольших систем (до 50–100 абонентов) достаточно локальной базы. При большой нагрузке рекомендуется вынести БД на отдельный сервер для изоляции ресурсов.
Источники
- Asterisk Docs: Setting up PJSIP Realtime — Проверена архитектура Sorcery, маппинг таблиц ps_endpoints/ps_auths/ps_aors, порядок строк в sorcery.conf (cache перед realtime), запрет на хранение transport в БД. URL: https://docs.asterisk.org/Configuration/Channel-Drivers/SIP/Configuring-res_pjsip/Setting-up-PJSIP-Realtime/
- Asterisk Docs: Configuring res_odbc — Проверена структура res_odbc.conf, параметры enabled, dsn, pre-connect, рекомендации по драйверам MariaDB ODBC vs MySQL ODBC. URL: https://docs.asterisk.org/Configuration/Interfaces/Back-end-Database-and-Realtime-Connectivity/ODBC/Configuring-res_odbc/
- Asterisk Docs: Sorcery Caching — Проверены параметры кэширования memory_cache: object_lifetime_stale, object_lifetime_maximum, expire_on_reload, CLI-команды для управления кэшем. URL: https://docs.asterisk.org/Fundamentals/Asterisk-Configuration/Sorcery/Sorcery-Caching/
- Asterisk Docs: Database Support Configuration — Проверен формат extconfig.conf, маппинг семейств ps_* на драйвер odbc, необходимость preload модулей res_odbc и res_config_odbc. URL: https://docs.asterisk.org/Fundamentals/Asterisk-Configuration/Database-Support-Configuration/Realtime-Database-Configuration/
- Asterisk Contrib: ast-db-manage — Проверены команды Alembic для создания и миграции схемы БД (upgrade head, downgrade base), структура config.ini. URL: https://raw.githubusercontent.com/asterisk/asterisk/master/contrib/ast-db-manage/README.md
- Asterisk Docs: Performance Tuning — Проверено сравнение производительности статического конфига, БД и кэша, рекомендации по частоте чтения объектов (endpoint, auth, contact). URL: https://docs.asterisk.org/Deployment/Performance-Tuning/



