Базовая настройка Asterisk после установки
Asterisk установлен, в /etc/asterisk десятки файлов — что дальше? Собираем минимальную рабочую офисную АТС только конфигами и консолью: два внутренних абонента, транк к оператору, звонки наружу и приём входящих.
Что должна уметь любая АТС
Прежде чем править конфиги, сформулируем минимальное техническое задание. Неважно, сколько абонентов и операторов, любая станция решает три задачи:
- Внутренние абоненты звонят друг другу.
- Станция подключена к оператору связи и может звонить в город и по стране.
- Входящие вызовы из города попадают к нужным сотрудникам.
Очереди, автоинформаторы, группы и запись разговоров строятся поверх этого фундамента. Ниже — минимальная конфигурация для Asterisk 20–22 на стеке PJSIP.
Шаг 1. Транспорт и внутренние абоненты
Абоненты описываются в /etc/asterisk/pjsip.conf. В PJSIP один абонент — это три объекта: endpoint (параметры звонков), auth (логин и пароль) и aor (куда доставлять вызовы). Чтобы не повторять одно и то же, используем шаблоны.
[transport-udp]
type=transport
protocol=udp
bind=0.0.0.0:5060
; ---------- шаблоны ----------
[office-endpoint](!)
type=endpoint
context=office
disallow=all
allow=alaw,ulaw
direct_media=no
rtp_symmetric=yes
force_rport=yes
rewrite_contact=yes
dtmf_mode=rfc4733
language=ru
[office-auth](!)
type=auth
auth_type=userpass
[office-aor](!)
type=aor
max_contacts=1
qualify_frequency=60
; ---------- абонент 101 ----------
[101](office-endpoint)
auth=101
aors=101
callerid=Reception <101>
[101](office-auth)
username=101
password=Zx7-Strong-Pass-101
[101](office-aor)
; ---------- абонент 102 ----------
[102](office-endpoint)
auth=102
aors=102
callerid=Manager <102>
[102](office-auth)
username=102
password=Zx7-Strong-Pass-102
[102](office-aor)
Что здесь важно:
disallow=allиallow=alaw,ulaw— разрешаем только G.711. Для России основной кодек — alaw.direct_media=no— RTP идёт через Asterisk. Это проще для NAT и записи разговоров; прямой медиапоток включают, только когда все телефоны в одной сети.rtp_symmetric,force_rport,rewrite_contact— набор для абонентов за NAT: отвечать туда, откуда пришёл пакет, а не туда, что написано в SDP.qualify_frequency=60— раз в минуту станция отправляет OPTIONS и следит, доступен ли телефон.dtmf_mode=rfc4733— DTMF внеполосно, это бывшийrfc2833.
Пароли делайте длинными: подбор SIP-паролей и звонки за чужой счёт — самая частая атака на открытые в интернет АТС.
Шаг 2. Звонки между абонентами
Маршруты живут в /etc/asterisk/extensions.conf. Внутренний контекст office, указанный у абонентов, разрешает набирать трёхзначные номера:
[office]
exten => _1XX,1,Dial(PJSIP/${EXTEN},20,tT)
same => n,Hangup()
Опции t и T разрешают обеим сторонам перевод вызова через функции features.conf. После правки выполните dialplan reload в консоли — абоненты 101 и 102 уже могут звонить друг другу.
Шаг 3. Транк к оператору
Большинство операторов работает по регистрации с логином и паролем. Транк — это тот же endpoint, плюс объект registration и identify, по которому Asterisk узнаёт входящие пакеты оператора.
[provider-auth]
type=auth
auth_type=userpass
username=login
password=provider-secret
[provider-reg]
type=registration
transport=transport-udp
outbound_auth=provider-auth
server_uri=sip:sip.provider.example
client_uri=sip:login@sip.provider.example
retry_interval=60
[provider]
type=aor
contact=sip:sip.provider.example
[provider]
type=endpoint
transport=transport-udp
context=from-provider
disallow=all
allow=alaw,ulaw
outbound_auth=provider-auth
aors=provider
from_user=login
from_domain=sip.provider.example
direct_media=no
[provider-identify]
type=identify
endpoint=provider
match=sip.provider.example
Если оператор подключает по IP без регистрации, секции provider-reg и provider-auth не нужны: достаточно aor с адресом оператора и identify с его IP в match. Это аналог старых host= и insecure=invite,port.
Шаг 4. Исходящие маршруты
Сначала настраивают исходящую связь: так сразу видно, что транк работает. Разделим направления, чтобы потом можно было раздавать абонентам разные права.
[out-city]
exten => _[2-9]XXXXXX,1,Dial(PJSIP/${EXTEN}@provider,60)
same => n,Hangup()
[out-long]
exten => _8XXXXXXXXXX,1,Dial(PJSIP/${EXTEN}@provider,60)
same => n,Hangup()
[office]
exten => _1XX,1,Dial(PJSIP/${EXTEN},20,tT)
same => n,Hangup()
include => out-city
include => out-long
Формат номера (с восьмёркой, с +7 или без кода) зависит от оператора — уточните его в документации подключения. Если оператору нужно передавать городской номер станции, добавьте перед Dial строку Set(CALLERID(num)=4951234567).
Шаг 5. Входящие вызовы
Контекст from-provider принимает звонки на городской номер. В простом случае без меню и очередей вызов уходит сразу на два телефона:
[from-provider]
exten => 4951234567,1,Dial(PJSIP/101&PJSIP/102,30)
same => n,Hangup()
Какой номер приходит в EXTEN — полный, с кодом или с плюсом, — смотрите в консоли при первом тестовом звонке и подстраивайте шаблон.
Проверка
asterisk -rx "module reload res_pjsip.so"
asterisk -rx "dialplan reload"
asterisk -rx "pjsip show endpoints"
asterisk -rx "pjsip show registrations"
Абоненты должны быть в состоянии Avail или Not in use, регистрация у оператора — Registered. Для разбора проблем откройте консоль asterisk -rvvv и включите pjsip set logger on: будет видно каждое SIP-сообщение.
Если у вас старая конфигурация на sip.conf
Модуль chan_sip объявлен устаревшим ещё в Asterisk 17 и удалён в Asterisk 21. Основные параметры переносятся так:
| chan_sip | PJSIP |
|---|---|
type=friend, host=dynamic |
endpoint + auth + aor с max_contacts |
secret |
password в секции auth |
canreinvite / directmedia |
direct_media |
nat=force_rport,comedia |
force_rport, rtp_symmetric, rewrite_contact |
qualify=yes |
qualify_frequency в aor |
dtmfmode=rfc2833 |
dtmf_mode=rfc4733 |
insecure=invite,port |
секция type=identify |
Dial(SIP/101) |
Dial(PJSIP/101) |
Дальше на этой базе можно строить сервисы: очереди вызовов, автоинформатор и другие сценарии из раздела Asterisk.
Частые вопросы
Можно ли настроить Asterisk без FreePBX?
Да. Для небольшого офиса достаточно трёх файлов: pjsip.conf с абонентами и транком, extensions.conf с маршрутами и при необходимости rtp.conf. Веб-интерфейс удобен, но не обязателен.
Что делать со старым sip.conf?
Модуль chan_sip удалён в Asterisk 21. Конфигурацию нужно перенести в pjsip.conf; для черновой конвертации в исходниках есть скрипт contrib/scripts/sip_to_pjsip/sip_to_pjsip.py, но результат стоит проверить руками.
Почему абоненты слышат друг друга в одну сторону?
Почти всегда это NAT. Включите на endpoint rtp_symmetric, force_rport и rewrite_contact, а для сервера за NAT задайте external_media_address и external_signaling_address в секции транспорта и откройте диапазон RTP из rtp.conf.
Как ограничить регистрацию абонента по IP?
В PJSIP для этого используются ACL: секции type=acl в pjsip.conf или правила в acl.conf с параметрами permit и deny. Точный набор опций проверьте в документации вашей версии Asterisk.