Установка Asterisk на Ubuntu из исходников
Пошаговая шпаргалка по сборке Asterisk из исходников: от установки зависимостей до первого запуска под отдельным пользователем. Команды приведены для актуальных Ubuntu и Debian, отличия от старых инструкций для Ubuntu 16.04 разобраны отдельно.
Что изменилось с Ubuntu 16
Типичная установка Asterisk 14 на Ubuntu 16.04 включала отдельную сборку pjproject 2.6, ручную установку русских звуков с GitHub и запуск через /etc/init.d. С тех пор многое упростилось:
- pjproject собирается автоматически вместе с Asterisk, начиная с версии 15;
- русские звуки выбираются в
menuselectи скачиваются при установке; - chan_sip удалён в Asterisk 21, основной стек — PJSIP;
- Ubuntu 16.04 вне стандартной поддержки. Используйте Ubuntu 22.04 или 24.04 LTS либо Debian 12.
Ниже — порядок действий для современной системы. Все команды выполняются от root или через sudo.
1. Подготовка системы
apt update && apt -y upgrade
apt -y install wget build-essential
timedatectl set-timezone Europe/Moscow
Правильное время важно: по нему пишутся CDR, журналы и имена записей разговоров. Синхронизацию обеспечивает systemd-timesyncd, который в Ubuntu включён по умолчанию.
2. Загрузка исходников
cd /usr/local/src
wget https://downloads.asterisk.org/pub/telephony/asterisk/asterisk-22-current.tar.gz
tar xzf asterisk-22-current.tar.gz
cd asterisk-22.*/
asterisk-22-current всегда указывает на последний выпуск ветки 22. Если на сайте уже доступна более новая LTS-ветка, подставьте её номер.
Если нужны цифровые потоки E1 и платы Digium/Sangoma, до сборки Asterisk установите dahdi-linux, dahdi-tools и libpri. Для чисто IP-станции этот шаг пропускается.
3. Зависимости
В исходниках есть скрипт, который ставит все нужные пакеты для вашего дистрибутива:
contrib/scripts/install_prereq install
Если нужна поддержка MP3 для музыки на удержании, дополнительно выполните contrib/scripts/get_mp3_source.sh.
4. Конфигурация и выбор модулей
./configure
make menuselect
В menuselect стоит проверить:
- Channel Drivers — включён
chan_pjsip; - Core Sound Packages — отметьте
CORE-SOUNDS-RU-WAVилиCORE-SOUNDS-RU-GSM, чтобы получить русские подсказки; - Music On Hold File Packages — набор музыки на удержании;
- Add-ons —
format_mp3, если скачивали исходники MP3.
Ненужные модули лучше отключить здесь, а не через noload в modules.conf: меньше кода — меньше поверхность атаки и быстрее запуск.
5. Сборка и установка
make -j"$(nproc)"
make install
make samples # примеры конфигов в /etc/asterisk
make config # скрипт автозапуска
make install-logrotate
ldconfig
make samples кладёт полный набор примеров со всеми параметрами. Если хотите начать с минимальной рабочей схемы, вместо него выполните make basic-pbx. Оба варианта перезапишут существующие файлы в /etc/asterisk, поэтому на работающей станции сначала сделайте копию.
6. Запуск от отдельного пользователя
Asterisk не должен работать от root. Создадим системного пользователя и отдадим ему каталоги:
groupadd --system asterisk
useradd --system -g asterisk -d /var/lib/asterisk -s /usr/sbin/nologin -c "Asterisk PBX" asterisk
usermod -aG audio,dialout asterisk
chown -R asterisk:asterisk /var/lib/asterisk /var/log/asterisk /var/spool/asterisk /usr/lib/asterisk
chown -R root:asterisk /etc/asterisk
chmod -R u=rwX,g=rX,o= /etc/asterisk
Укажите пользователя в двух местах.
В /etc/default/asterisk:
AST_USER="asterisk"
AST_GROUP="asterisk"
В /etc/asterisk/asterisk.conf, секция [options]:
runuser = asterisk
rungroup = asterisk
Запуск и проверка:
systemctl enable --now asterisk
systemctl status asterisk
ps -o user,cmd -C asterisk
В выводе ps в колонке пользователя должен быть asterisk.
7. Язык и базовые настройки
Русский язык задаётся для каждого абонента параметром language=ru в pjsip.conf или в диалплане через Set(CHANNEL(language)=ru). Русские тоны (гудки, сигнал «занято») включаются в indications.conf:
[general]
country=ru
Большие конфигурации удобно разносить по каталогам и подключать директивой #include, например в extensions.conf:
#include "extensions/*.conf"
Так каждый клиент или отдел живёт в своём файле, а основной конфиг остаётся коротким.
8. Firewall
Откройте порт SIP и диапазон RTP, указанный в /etc/asterisk/rtp.conf (по умолчанию 10000–20000):
ufw allow 5060/udp
ufw allow 10000:20000/udp
Если станцией пользуются только из офиса, ограничьте SIP-порт адресами офиса и оператора. Открытый в интернет порт 5060 начинают сканировать через несколько минут после запуска сервера.
9. Проверка
asterisk -rvvv
В консоли выполните:
core show version
module show like pjsip
pjsip show endpoints
Для нагрузочного теста подойдёт SIPp (пакет sip-tester): он генерирует SIP-вызовы по сценариям и показывает, сколько одновременных звонков выдерживает сервер. Тестируйте только на своём стенде и с отдельным тестовым абонентом.
Что дальше
Станция установлена, но пока ничего не умеет. Следующий шаг — абоненты, транк к оператору и маршруты, это описано в статье о базовой настройке Asterisk после установки. Остальные материалы — в разделе Asterisk.
Частые вопросы
Можно ли поставить Asterisk из репозитория Ubuntu?
Можно командой apt install asterisk, но версия в репозитории обычно отстаёт от актуальной LTS. Сборка из исходников даёт свежую версию и выбор модулей через menuselect.
Нужно ли отдельно собирать pjproject?
Нет. Начиная с Asterisk 15 нужная версия pjproject собирается вместе с Asterisk автоматически, отдельная установка библиотек PJSIP только мешает.
Какую версию Asterisk выбрать?
Для рабочей станции берите LTS-ветку: у Asterisk LTS выходят с чётными номерами (20, 22 и т. д.) и поддерживаются несколько лет. Актуальный список веток есть на downloads.asterisk.org.
Работает ли ещё Ubuntu 16.04 для Asterisk?
Ubuntu 16.04 давно вне стандартной поддержки, а новые версии Asterisk на ней не соберутся без возни с зависимостями. Ставьте Ubuntu 22.04/24.04 LTS или Debian 12.