Shkerka.ruзаметки админа
Asterisk и IP-АТС

Установка Asterisk на Ubuntu из исходников

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

Пошаговая шпаргалка по сборке 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.