Настройка диалплана и SIP

Конфигурационные файлы Астериска имеют расширение .conf и находятся в папке /etc/asterisk, поэтому перейдём в эту папку:

cd /etc/asterisk/

Мы рассмотрим самый простой вариант с точки зрения настройки: для связи будем использовать протокол sip. Для этого нам не понадобится устанавливать в сервер Астериск дополнительные платы — для подключения sip-телефонов к Астериску достаточно локальной сети. Можно также не приобретать стационарный sip-телефон, а скачать и установить на компьютер программный телефон (так называемый софтфон), например, X-Lite (скачать файл, открыть сайт, настроить X-Lite), — для звонков нам понадобится только компьютер и гарнитура (наушники) с микрофоном.

Для того, чтобы позвонить с одного sip-телефона на другой, нужно настроить как минимум две вещи: диалплан и модуль SIP (или PJSIP).

В конфигурации модуля SIP нужно описать всех абонентов, которые могут регистрироваться на Астериске (номера телефонов, логины, пароли и другие параметры), а также все другие телефонные станции, с которыми Астериск должен взаимодействовать (получать и отправлять вызовы) по протоколу SIP. Для каждого абонента и станции нужно обязательно указать параметр context (в каком контексте Астериск должен обрабатывать поступающие с них вызовы).

В диалплане же нужно описать все контексты: как именно обрабатывать вызовы в каждом из них.

Создание диалплана

Диалплан (dial plan — «план набора») описан в файле extensions.conf — это самый главный файл Астериска. В нём содержится информация, как будут обрабатываться и куда направляться все входящие и исходящие вызовы.

Сохраним первоначальный файл extensions.conf, созданный командой make samples (для этого добавим к нему расширение .sample), создадим новый файл extensions.conf и откроем его в редакторе nano:

mv extensions.conf extensions.conf.sample
touch extensions.conf
nano extensions.conf

Каждая секция файла (кроме зарезервированных [globals] и [general]) представляет собой так называемый контекст и описывает последовательность действий, которые нужно выполнить в данном контексте. Название секции — это название контекста. Контексты могут включать в себя другие контексты с помощью команды include (команды из другого контекста будут подставлены на место строки include).

Пример файла extensions.conf:

[globals]

[general]
autofallthrough=yes

[default]

[ivr]
exten => 83431000000,1,Goto(1000,1)

exten => 1000,1,NoOp(Call on IVR)
 same =>      n,Answer()
 same =>      n,Playback(your&number)
 same =>      n,SayDigits(${CALLERID(num)})
 same =>      n,Hangup()

[local_calls]
exten => _100[1-9],1,NoOp(Call on local subscriber)
 same =>      n,Dial(PJSIP/${EXTEN},30)
; same =>      n,Dial(SIP/${EXTEN},30)
 same =>      n,Playback(telephone-number&vm-isunavail)
 same =>      n,Hangup()

[remote_calls]
exten => _*XXXX,1,NoOp(Outgoing call on *XXXX number)
 same =>      n,Dial(PJSIP/${EXTEN}@somepbx)
; same =>      n,Dial(SIP/somepbx/${EXTEN})
 same =>      n,Playback(pbx-invalid)
 same =>      n,Hangup()

exten => _X.,1,NoOp(Outgoing call)
 same =>      n,Dial(PJSIP/${EXTEN}@somepbx)
; same =>      n,Dial(SIP/somepbx/${EXTEN})
 same =>      n,Playback(pbx-invalid)
 same =>      n,Hangup()

[somepbx]
include => ivr
include => local_calls

[phones]
include => ivr
include => local_calls
include => remote_calls

После изменения файла extensions.conf перезагрузить диалплан:

/usr/sbin/asterisk -rvvvvv   — подключение к консоли Астериска

*CLI> dialplan reload   — перезагрузить диалплан

*CLI> dialplan show   — посмотреть диалплан

Ctrl+С или exit или quit — выход из консоли

/usr/sbin/asterisk -rx "dialplan reload"   — выполнение консольной команды без подключения к консоли

Выбор загружаемых модулей

mv modules.conf modules.conf.sample
touch modules.conf
nano modules.conf

Есть два варианта. Можно либо указать нужные модули (autoload=no), либо загружать все модули (autoload=yes) из папки /usr/lib/asterisk/modules, кроме тех, которые не нужны.

Рекомендация из книги «Астериск - будущее телефонии» — явно указать только нужные модули. Файл modules.conf будет выглядеть, например, так:

[modules]
autoload=no           ; в файле должны быть только те модули, которые нужно загружать
load => res_adsi.so   ; Интерфейс сервисов для аналогового дисплея
load => pbx_config.so
load => chan_iax2.so  ; Поддержка IAX, требует: res_crypto.so, res_features.so
load => chan_sip.so   ; Поддержка SIP, требует: res_features.so
load => codec_alaw.so ; Требует: ничего
load => codec_gsm.so  ; Требует: ничего
load => codec_ulaw.so ; Требует: ничего
load => format_gsm.so ; Требует: ничего
load => app_dial.so   ; Требует: res_features.so, res_musiconhold.so

Мы же выберем другой вариант и загрузим все модули, кроме некоторых. Наш файл modules.conf будет выглядеть так:

;===== Was in sample file ===========

[modules]
autoload=yes

noload => pbx_gtkconsole.so
load => res_musiconhold.so
noload => chan_alsa.so
noload => chan_console.so

;===== Changes from sample file =====

noload => chan_sip.so
;noload => res_pjsip.so
;noload => res_hep.so
;noload => res_hep_pjsip.so
;noload => res_hep_rtcp.so

В данном варианте будет загружен модуль PJSIP.

Чтобы использовать модуль SIP вместо PJSIP, надо в приведённом выше примере закомментировать noload => chan_sip.so и раскомментировать последние четыре строки, а также в файле extensions.conf заменить команды для PJSIP командами для SIP.

После изменения файла modules.conf перезагрузить астериск:

sudo service asterisk restart

Конфигурация модуля PJSIP

Модуль PJSIP - это драйвер каналов sip в Астериске, нужен для выполнения вызовов по протоколу sip (а также некоторых других). Его конфигурация описана в файле pjsip.conf.

Сохраним первоначальный файл pjsip.conf, созданный командой make samples, создадим новый файл pjsip.conf и откроем его в редакторе nano:

mv pjsip.conf pjsip.conf.sample
touch pjsip.conf
nano pjsip.conf

Пример файла pjsip.conf:

;===== Transport ===============

[lan-of-company]
type=transport
protocol=udp
bind=0.0.0.0


;===== Asterisk templates ======

[ast-endp](!)
type=endpoint
language=ru
direct_media=no
media_use_received_transport=yes
allow=!all,alaw
dtmf_mode=rfc4733
media_address=192.168.1.30
transport=lan-of-company

[ast-id](!)
type=identify

[ast-aor](!)
type=aor
max_contacts=1
qualify_frequency=30


;===== Asterisks ===============

[somepbx](ast-endp)
context=somepbx
aors=somepbx
[somepbx](ast-id)
endpoint=somepbx
match=192.168.0.70
[somepbx](ast-aor)
contact=sip:192.168.0.70:5060

;===== Sip-Phone templates =====

[ph-endp](!)
type=endpoint
language=ru
context=phones
direct_media=no
media_use_received_transport=yes
allow=!all,alaw
dtmf_mode=rfc4733
transport=lan-of-company

[ph-auth](!)
type=auth

[ph-aor](!)
type=aor
max_contacts=1
remove_existing=yes
qualify_frequency=30


;===== Sip-Phones ==============

[1000](ph-endp)
auth=1000
aors=1000
[1000](ph-auth)
username=1000
password=1000
[1000](ph-aor)

[1001](ph-endp)
auth=1001
aors=1001
[1001](ph-auth)
username=1001
password=1001
[1001](ph-aor)

[1002](ph-endp)
auth=1002
aors=1002
[1002](ph-auth)
username=1002
password=1002
[1002](ph-aor)

; etc.

После изменения файла pjsip.conf нужно перезагрузить диалплан и модуль PJSIP:

/usr/sbin/asterisk -rvvvvv
*CLI> dialplan reload
*CLI> pjsip reload

Настройка выполнена, если всё настроено правильно, можно звонить!

Диагностика PJSIP

*CLI> pjsip show endpoints   — проверить статус регистрации sip-абонентов

Если вызовы не проходят, как надо, обмен sip-сообщениями можно посмотреть в истории (для этого сначала её нужно включить):

*CLI> pjsip set history on   — включить сохранение истории

*CLI> pjsip show history   — посмотреть историю

*CLI> pjsip set history off   — выключить сохранение истории

*CLI> pjsip set history clear   — очистить сохранённую историю

Добавление маршрутов в другие сети

Для доступности всех ip-адресов, упомянутых в файле, может понадобиться прописать маршруты на подсети, в которых находятся эти адреса. Как это сделать, описано здесь.

Конфигурация модуля SIP

Модуль SIP - старый драйвер каналов sip в Астериске, имеет меньше возможностей и больше не развивается, тем не менее он вполне может использоваться для выполнения вызовов по протоколу sip вместо модуля PJSIP.

Если нужно использовать модуль SIP вместо PJSIP, надо в файле modules.conf указать загрузку модуля SIP вместо PJSIP (подробности здесь), в диалплане заменить команды для PJSIP на аналогичные для SIP, а также описать конфигурацию модуля SIP в файле sip.conf:

mv sip.conf sip.conf.sample
touch sip.conf
nano sip.conf

Пример файла sip.conf с конфигурацией, аналогичной заданной в файле pjsip.conf в примере выше (как видим, файл sip.conf гораздо меньше):

[general]
context=default
language=ru
allowguest=no
allowoverlap=no
dtmfmode=rfc2833
disallow=all
allow=alaw
nat=no


;===== Asterisks ===============

[somepbx]
type=peer
host=192.168.0.70
context=somepbx
qualify=yes


;===== Sip-Phones ==============

[ipphones](!)  ; ! в скобках - признак шаблона (общие настройки для группы телефонов)
type=friend
host=dynamic
context=phones
qualify=yes

[1000](ipphones)
secret=1000

[1001](ipphones)
secret=1001

[1002](ipphones)
secret=1002

; etc.

После изменения файла sip.conf перезагрузить диалплан и модуль SIP:

/usr/sbin/asterisk -rvvvvv
*CLI> dialplan reload
*CLI> sip reload

Настройка выполнена. Если всё настроено правильно — осталось подключить sip-телефоны, и можно звонить!

*CLI> sip show peers   — проверить статус регистрации sip-абонентов

Примечание: при использовании модуля SIP телефон «Grandstream» не регистрировался до тех пор, пока не удалили всё из поля Authenticate ID (в нём был указан номер телефона, как в SIP User ID)