Asterisk 20: конец эры. План перехода на 22/24 LTS
Москва, Щёлковское шоссе, д. 92, корп. 7 · Пн–Пт 9:00–19:00 · +7 903 729-62-41
АйТи Фреш
Серверы и инфраструктура

Asterisk 20 в режиме security-only: как переехать на 22 или 24 LTS без потери звонков

Автор: , директор ООО «АйТи-Фреш» · · ~12 мин чтения
Схема перехода Asterisk 20 на 22 LTS с заменой chan_sip на PJSIP и календарем поддержки
Переход на LTS — это не просто обновление, а замена устаревших механизмов на новые.

Ваша АТС на Asterisk 20 работает, но с 19 октября 2026 года ветка официально перешла в режим Security Fix Only. Полная поддержка прекратится 19 октября 2027 года. Я покажу, как выбрать целевую версию, проверить совместимость конфигов и безопасно обновиться без простоя, используя опыт миграции агентства недвижимости «Три ключа».

Календарь жизни: почему 20-я ветка уже стареет

На дворе ноябрь 2026 года, и если вы всё ещё держитесь за Asterisk 20, то формально вы уже в зоне риска. Согласно официальной таблице жизненного цикла, 19 октября 2026 года ветка 20.x перешла в режим Security Fix Only. Это значит, что новые функции больше не появятся, а исправления будут выходить только для критических дыр безопасности. Полное окончание поддержки (EOL) запланировано на 19 октября 2027 года. После этой даты система останется такой, какая есть сейчас: без обновлений, без защиты от новых угроз, просто кусок кода, который однажды перестанет работать с современными протоколами.

Разберитесь раз и навсегда: update — это смена минорной версии внутри ветки (например, 20.22.0 на 20.23.0), где меняются только баги. Upgrade — это переход на другую мажорную версию (20 → 22 или 24), что всегда влечёт за собой архитектурные изменения, удаление старых модулей и риск поломки. В таблице статусов на сайте документации иногда встречается визуальное несоответствие: колонка «Current Status» может всё ещё показывать «Fully Supported» даже после наступления даты Security Fix Only. Это артефакт обновления страницы, но даты в колонках «Security Fix Only» и «EOL» — истина в последней инстанции. Полагаться нужно именно на них.

Для тех, кто сомневается, стоит ли ждать 24-ю версию: она вышла 5 ноября 2026 года. Это свежий LTS-релиз с поддержкой до 2031 года. Однако переход сразу на самую новую версию — это лотерея с неизвестными багами в экосистеме. Более консервативный и проверенный путь — Asterisk 22 LTS, которая вышла 16 октября 2024 года и гарантированно поддерживается до 16 октября 2028 года. Она уже набрала пару лет эксплуатации, основные проблемы в интеграциях с FreePBX и другими панелями решены, и документация по миграции на неё обширна.

Календарь поддержки версий Asterisk от 20 до 24 LTS с датами EOL
Видно, что у 20-й версии осталось мало времени, а 22 и 24 дают долгую жизнь.

Что исчезло: chan_sip, макросы и ловушки совместимости

Самая большая боль при переходе с 20-й версии — это удаление legacy-модулей. Начиная с версии 21, из Asterisk навсегда ушёл модуль chan_sip. Если ваша конфигурация всё ещё использует sip.conf для регистрации абонентов, вы не сможете просто запустить 22-ю или 24-ю версию. Пакет не поднимется, или телефония просто не заработает. Вам придётся полностью перенести настройки на res_pjsip (pjsip.conf). Это не просто смена имени файла, это смена парадигмы: синтаксис PJSIP строже, он не прощает лишние пробелы и некорректный регистр. В дистрибутиве есть скрипт sip_to_pjsip.py, который поможет конвертировать базовые настройки, но сложные сценарии и хитрые трюки из старых конфигов потребуют ручной правки.

Вторая проблема — удаление приложения app_macro. В версии 21 оно было вырезано, и это ломает диалпланы, построенные на вызовах макросов через команду Dial с модификатором M^. Вместо этого теперь используется Gosub. Если у вас в extensions.conf сотни строк с вызовами макросов, автоматическая конвертация тут не поможет. Также были удалены res_monitor (нужно перейти на MixMonitor), app_osplookup, chan_alsa, chan_mgcp. В 23-й версии ушли ещё дальше: удалён users.conf (настройка каналов теперь в своих конфигах), DeadAGI, функция QUEUE_MEMBER_COUNT. Переход на 24-ю LTS потребует внимания к миграциям базы данных: alembic-скрипты изменят структуру таблиц geolocation и расширят тип поля time в queue_log, что на больших MySQL-базах может вызвать блокировку записи.

Особое внимание уделите ARI (Asterisk REST Interface). Если у вас подключены CRM или самописные скрипты, проверяйте их совместимость. В 22-й версии появились новые события вроде ChannelToneDetected, но старые API могли измениться. Документация часто ссылается на ChangeLog, а не на отдельные UPGRADE.txt (в версиях 21+ они удалены). Это значит, что вам нужно внимательно читать файлы ChangeLog-22.0.0.md и ChangeLog-24.0.0.md в архивах с исходниками, чтобы понять, что именно изменилось в поведении функций и переменных. Например, в 23-й версии ast_variable_retrieve начал возвращать последнее переопределённое значение, что ломает логику наследования в некоторых модулях.

Не запускайте upgrade на боевом сервере без тестирования на копии. Удаление chan_sip и app_macro делает обратный откат невозможным без восстановления полного образа системы.
Сравнение удаленных и новых модулей при переходе с Asterisk 20 на 22/24
Основные изменения касаются протоколов SIP и логики диалплана.

Кейс агентства «Три ключа»: как мы готовились к апгрейду

Возьмём для примера агентство недвижимости «Три ключа». У них 31 рабочее место, АТС работает на Asterisk 20 под управлением Debian 11. Система стояла года три, никто не трогал, кроме мелкого админа, который раз в полгода обновлял пакеты. Когда я пришёл на аудит, выяснилось, что половина абонентов всё ещё на chan_sip, а в диалплане активно используются макросы для обработки входящих звонков. Заказчик хотел «просто обновиться до 22 LTS», но я остановил процесс: без подготовки это гарантированно приведёт к простою телефонии на весь день.

Мы начали с инвентаризации. С помощью grep проверили все файлы в /etc/asterisk на наличие упоминаний sip.conf, app_macro и res_monitor. Выяснили, что около 40 % конфигурации нужно переписывать. Затем мы подняли тестовый сервер — виртуальную машину с чистой системой. На него установили Asterisk 22.12.0. Мы не стали сразу копировать конфиги. Сначала проверили, собирается ли пакет, какие зависимости нужны, и запустили пустой сервер. Только потом начали поэтапно переносить настройки, начиная с pjsip.conf, используя скрипт конвертации и правя ошибки вручную.

Самым болезненным моментом стал отладочный этап. После переноса настроек PJSIP часть телефонов не регистрировалась. Оказалось, что в старых настройках были специфичные параметры, которые PJSIP игнорирует или трактует иначе. Пришлось сравнивать логи сбоев (Verbose 3) на старой и новой версии. Также мы обнаружили, что скрипт автоответчика, написанный на AGI, использовал функцию, которая в новой версии работает иначе. Исправление заняло два вечера. Но зато после этого мы получили работающую копию, которую можно было смело тестировать с реальными звонками, пока основная АТС продолжала работать в штатном режиме.

План действий: от бэкапа до финального свитча

Первый шаг — создание полной резервной копии. Не просто архив папки /etc/asterisk, а полный снимок (snapshot) виртуальной машины или сервера. Если вы работаете с физическим железом, сделайте образ диска и дамп базы данных. Это ваша страховка на случай, если что-то пойдёт не так. Второй шаг — подготовка тестовой среды. Установите целевую версию Asterisk (22 или 24) на отдельном сервере или контейнере. Не пытайтесь делать upgrade «на лету» через apt upgrade, если это не поддерживается вашим дистрибутивом официально. Лучший способ — сборка из исходников или установка из репозитория, соответствующего вашей версии ОС, на чистую систему.

Третий шаг — миграция конфигурации. Скопируйте конфиги на тестовый сервер, но не перезаписывайте их слепо. Используйте скрипты конвертации для chan_sip, а для остальных файлов делайте это вручную или полуавтоматически. Проверьте, что все необходимые модули загружаются (modules.conf). Обратите внимание, что образцы конфигов (.sample) не обновляются автоматически — их нужно копировать из новой версии, если вы хотите использовать новые настройки. Четвёртый шаг — тестирование. Протестируйте все сценарии: входящие, исходящие, очереди, голосовую почту, интеграции с CRM. Убедитесь, что CDR пишется корректно, а ARI-события приходят вовремя.

Финальный шаг — перенос на боевую среду. Это делается в окно обслуживания. Остановите Asterisk на боевом сервере, замените бинарники и конфиги на проверенные (или восстановите образ тестового сервера, если он идентичен). Запустите новую версию и немедленно проверьте работу телефонии. Если что-то пошло не так — откатывайтесь к бэкапу. Не бойтесь тратить время на тестирование: час простоя на этапе тестов сэкономит вам сутки простоя в продакшене. Помните, что после установки новой версии нужно пересобрать все модули, иначе вы получите предупреждения о несовпадении версий.

Пошаговый чек-лист безопасного обновления Asterisk на 22 или 24 LTS
Следование этому списку минимизирует риск простоя АТС.

Выбор версии: 22 LTS или 24 LTS?

Вопрос «какую версию ставить?» волнует многих. Asterisk 22 LTS — это золотая середина. Она вышла в конце 2024 года, уже пережила несколько обновлений, и основные баги исправлены. Поддержка гарантирована до 2028 года, что даёт вам два спокойных года. Большинство сторонних решений, включая FreePBX, имеют стабильные сборки под 22-ю версию. Если ваша задача — просто «обновиться и забыть», выбирайте 22 LTS. Это самый безопасный путь с минимальными рисками совместимости.

Asterisk 24 LTS — это выбор для тех, кто хочет быть на переднем крае. Она вышла в ноябре 2026 года и будет поддерживаться до 2031 года. В ней есть новые фичи, улучшенная производительность и поддержка новейших стандартов. Но есть и риски: некоторые плагины и интеграции могут ещё не адаптироваться под неё, а документация может быть менее подробной, чем для 22-й. Если у вас есть ресурсы на тестирование и вы планируете масштабироваться, 24 LTS — отличный вариант. Но если у вас ограниченный бюджет и команда, лучше подождать пару месяцев, пока экосистема оседает.

Не стоит рассматривать стандартные релизы (21, 23) для производственных систем. Они живут всего два года, и через год после выхода переходят в режим security-only. Для бизнеса, где важна стабильность и долгосрочная поддержка, это слишком короткий срок. Вы будете вынуждены обновляться каждые полтора года, что создаёт постоянный стресс и риски. Лучше один раз перейти на LTS и забыть об обновлениях на 4-5 лет.

Частые ошибки и как их избежать

Самая частая ошибка — попытка обновиться без тестирования. Администраторы думают, что «это же просто обновление пакета», и запускают apt upgrade на боевом сервере. Результат — неработающая телефония и паника. Вторая ошибка — игнорирование chan_sip. Многие до последнего надеются, что старый модуль останется, но в 21-й версии он удалён навсегда. Третья ошибка — незнание о removal app_macro. Диалпланы, построенные на макросах, перестают работать, и администраторы тратят часы на поиск причины, вместо того чтобы сразу заменить их на Gosub.

Ещё одна распространённая проблема — забывчивость про базу данных. При переходе на 24-ю версию alembic-миграции могут изменить структуру таблиц. Если вы не сделаете дамп БД заранее, вы можете потерять данные или получить ошибки при запуске. Также важно помнить про сторонние модули. Если вы используете плагины, написанные сообществом, проверьте, есть ли их обновления для новой версии. Часто они отстают от основных релизов Asterisk и могут не работать без правок.

Не забывайте про документацию. Многие полагаются на старые гайды, которые больше не актуальны. Всегда проверяйте официальную документацию и ChangeLog конкретной версии. В версиях 21+ файлы UPGRADE.txt удалены, поэтому вся информация о ломающих изменениях находится в ChangeLog-<version>.md. Прочитайте их внимательно перед началом миграции.

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

Можно ли обновить Asterisk 20 до 22 через apt upgrade?

Нет, прямой апгрейд через apt между мажорными версиями не поддерживается. Нужно собирать новую версию из исходников или использовать репозиторий для новой версии на чистой системе, затем переносить конфиги.

Что делать, если у меня chan_sip?

chan_sip удалён в версии 21. Перед переходом на 22 или 24 необходимо конвертировать все настройки в res_pjsip, используя скрипт sip_to_pjsip.py и ручную правку.

Нужно ли менять базу данных при переходе на 24 LTS?

Да, в 24 LTS есть alembic-миграции для таблиц geolocation и queue_log. Сделайте дамп БД перед обновлением и запустите миграции после установки.

Стоит ли сразу переходить на 24 LTS?

Если нужна максимальная стабильность и поддержка экосистемы — лучше 22 LTS. 24 LTS подходит, если готовы к тестированию новых фич и возможных багов в сторонних модулях.

Как восстановить систему, если обновление пошло не так?

Единственный надежный способ — полный snapshot виртуальной машины или образ диска до начала работ. Конфиги и БД не помогут, если бинарники или зависимости сломались.

Столкнулись с похожей задачей? Обращайтесь — решим

Если у вас происходит что-то из описанного в этой статье — или любая другая проблема с ИТ-инфраструктурой, — обращайтесь в любое время. Мои специалисты и я лично разберём ситуацию, найдём настоящую причину и доведём до решения.

Возьмёмся и за разовую задачу, и за постоянное обслуживание. Первичная консультация — бесплатно и без обязательств.

📞 +7 903 729-62-41 ✈ Telegram @ITfresh_Boss

С уважением, Семёнов Евгений Сергеевич, директор «АйТи Фреш» — IT-аутсорсинг для компаний до 50 рабочих мест, 15+ лет практики

Источники

© ООО «АйТи-Фреш» · Москва · Все статьи
АйТи-Фреш (ООО «АЙТИ-ФРЕШ») · г. Москва, Щёлковское шоссе, д. 92, корп. 7 · +7 903 729-62-41 · info@itfresh.ru · Пн–Пт 9:00–19:00