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

Базовая настройка Asterisk после установки

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

Asterisk установлен, в /etc/asterisk десятки файлов — что дальше? Собираем минимальную рабочую офисную АТС только конфигами и консолью: два внутренних абонента, транк к оператору, звонки наружу и приём входящих.

Что должна уметь любая АТС

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

  1. Внутренние абоненты звонят друг другу.
  2. Станция подключена к оператору связи и может звонить в город и по стране.
  3. Входящие вызовы из города попадают к нужным сотрудникам.

Очереди, автоинформаторы, группы и запись разговоров строятся поверх этого фундамента. Ниже — минимальная конфигурация для 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.