Настройка диалплана и 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)