Установка и настройка телефонии Asterisk в Linux Ubuntu. Asterisk: установка и инструкция

Это статья заметка, на случай если мне нужно будет вспомнить, как настроить Asterisk для приема и отправки вызовов. Этой заметки должно хватить для настройки офисной станции на ip pbx Asterisk . До сих пор у меня не было сильного понятия и опыта, как настроить Asterisk для работы не используя FreePbx , то есть, используя только конфигурационные файлы и консоль. Да и сейчас я только учусь этому. В интернете все настройки сводятся к решению той или иной задачи, но я не увидел статьи способной дать хотя бы базу для минимальной настройки IP станции. Может плохо искал.

Итак, я собрал и установил asterisk в папке /etc/asterisk уйма конфигурационных файлов. Что же дальше?

1. Возможность внутренним абонентам совершать вызовы друг другу

2. Настройка внешних линий с целью получения станцией услуги выхода на городские, междугородние номера и приема входящих звонков

3. Настройка возможности совершать вызовы абонентам на городские и междугородние номера. И принимать вызовы из города.

Вот три основные задачи, которые нужно решить, естественно схема может быть разной. То есть абоненты могут объединяться в группы, внешних операторов связи может быть несколько, входящий вызов может быть отправлен на автоинформатор, очередь, а может быть на то и другое. Схема сервисов и услуг может различаться и усложняться, но три первых условия будут выполняться в любом случае.

Поэтому первое, что мы делаем - создаем внутренних абонентов (peer) в файле sip.conf

Абонент А будет иметь следующие настройки :

Disallow=all
allow=ulaw
allow=alaw
type=friend
username=101
secret=password
qualify=yes
context=101
callerid=101
host=dynamic
call-limit=1
canreinvite=yes
accountcode=101
amaflags=billing
deny=0.0.0.0/0
permit=192.168.0.66

Где:
disallow=all , запрещаем использовать все кодеки кроме G.711
allow=ulaw
allow=alaw

type=friend, этот параметр может принимать три значения:

- peer , этот тип используется для совершения входящих и исходящих вызовов. Для входящих вызовов, никогда не будет проверяться соответствие имени пользователя и пароля, а только соответствие с IP адресом и номером порта источника вызова.

- user запись, которая может только совершать входящие вызовы

- friend запись, которая одновременно и peer и user
username=101
secret=password
Логин и пароль соответственно

Периодически отправлять SIP сообщение типа Options, для проверки мониторинга доступности устройства для регистрации, полезно использовать при работе через NAT для сохранения значений в таблице трансляций

Имя контекста, с правилами маршрутизации

АОН нашего номера

host=dynamic
host ip с которого будет происходить регистрация

call-limit=1
(callcounter)
Ограничение одновременных вызов, здесь можно установить количество каналов

canreinvite=yes
(directmedia)

Этот параметр отвечает за процедуру RE- Invite , если no, то все вызовы будут проходить через Asterisk , если yes RTP поток будет отправляться между двумя устройствами минуя Asterisk

accountcode=101
amaflags=billing

CDR запись для поля accountcode будет иметь значение 101
Значение поля AMA flag для исходящих вызовов от этого SIP пользователя

deny=0.0.0.0/0
permit=192.168.0.66
ACL ip, кому разрешим регистрацию

Аналогично для абонента Б :

Disallow=all
allow=ulaw
allow=alaw
type=friend
username=102
secret=password
qualify=yes
context=102
callerid=102
host=dynamic
call-limit=1
canreinvite=yes
accountcode=102
amaflags=billing
deny=0.0.0.0/0
permit=192.168.0.67

Еще часть опций в пире которая может быть полезна:

transport=tcp,udp
Могу работать не только используя udp, требует установки tcpenable=yes в general
rtptimeout=180
rtpholdtimeout=420

Полезно для SIP клиентов, которые не выполняют Hangup при закрытии или отключении. В данном случае RTP сессия сможет сброситься самостоятельно по таймауту, rtpholdtimeout – если вызов на удержании

nat=force_rport,comedia

Если устройство находится за NAT, то фиксируем работу через rport, отправляем RTP пакеты обратно на IP адрес и порт, с которого они были получены, игнорируя информацию из SDP

defaultexpiry=60
Срок действия регистрации в секундах для входящих и исходящих регистраций

dtmfmode=rfc2833

Как будем работать с DTMF сигналами

1. Итак, задача один, настроить маршрутизацию между sip клиентами 101 и 102, в простейшем варианте решается одной строчкой в файле sip.conf и конфигах по include

exten => _XXX,1,Dial(SIP/${EXTEN},20,T)

sip.conf удобно эксплуатировать вот так:

Include => in_out_peer_local

Теперь абонент 101 сможет общаться с абонентом 102 и наоборот 102 сможет позвонить 101

2. Для создания условий, при которых внутренние абоненты смогут выходить на внешние линии, подключим станцию к оператору связи, используя все тот же sip

То есть создадим транк
type=peer
host=XX.XXX.XXX.XX
port=5060
fromdomain=ip нашей станции
nat=no
disallow=all
allow=ulaw
allow=alaw
allow=gsm
canreinvite=no
;allow=g722
trustrpid=yes
sendrpid=yes
dtmfmode=rfc2833
qualify=yes
insecure=invite,port
deny=0.0.0.0/0.0.0.0
permit=XX.XXX.XXX.XX/255.255.255.255
context=provide

Настройки транка очень похожи на настройки пира, в принципе это и есть пир, важные опции
fromdomain – устанавливаем fromdomain в sip пакете, чтобы можно было понять, куда вернуть sip пакеты нашей станции
trustrpid=yes
sendrpid=yes

Доверять или нет полученному Remote- Party- ID

insecure=invite,port

Не требуем аутентификацию входящих сообщений INVITE, не проверяем номер порта только соответствие ip адреса

3. Дело за малым, как только транк активирован, нужно прописать исходящую маршрутизацию для совершения вызовов абонентам А и Б
Стандарт де факто как бы гласит всегда сначала настраивать исходящую связь

Создаем контекст для совершения исходящих вызовов

Для исходящих вызовов на город

exten => _XXXXXX,1,Dial(SIP/ provider /${EXTEN})
exten => _XXXXXX,n,Hangup

Для исходящих вызовов на междугородние направления

exten => _8.,1,Dial(SIP/ provider /${EXTEN})
exten => _8.,n,Hangup

После того как исходящая связь заработала, настраиваем входящую

В простом случае без автоинформатора, групп и очередей это будут выглядеть так

exten => 2466754,1,Dial(SIP/${EXTEN})
exten => 2466754,n,Hangup

Аналогичным образом настраивается любая станция по принципу рассмотренных пунктов

Linux-программа Asterisk нужна для создания серверов телефонии и АТС. У неё много полезных функций, которые будут к месту в любом офисе. Конференции, автоответчики, распределение звонков, текстовые сообщения , видео, голосовое меню и голосовая почта. Утилита поддерживает популярные протоколы связи. Их можно коммутировать. Но установка Asterisk на Ubuntu - дело не самое простое. Приложение загружается и настраивается через терминал. Поэтому надо изучить консольные команды.

Перейдите в папку «contrib/scripts/» при помощи команды «cd».

Откройте скрипт «get_mp3_source.sh».

Введите «make install».

Подождите, пока загрузятся архивы.

Установленный Asterisk надо настраивать и через меню, и через терминал. Поэтому откройте консоль.

Сделайте конфигурационные файлы. Можно в качестве теста. Команда - «make samples».

Активируйте функцию автозапуска - «make config ldconfig».

Теперь можно запустить сервис - «service asterisk start».

Или сразу открыть его в качестве демона - «/etc/init.d/asterisk start». Чтобы включить его консоль, введите команду «sudo asterisk -rvvvcd».

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

Временно отключите утилиту - «service asterisk stop».

Добавьте нового юзера - «adduser [Имя]». Можете создать группу, которой предоставите нужные права. Она пригодится, если вы решите сделать нескольких пользователей для работы с разными службами Астериска.

Теперь нужна директория для запуска. Добавьте её при помощи команды «mkdir». После неё напишите параметр «-p» и путь к папке «/var/run/asterisk».

Чтобы приложение открывалось сразу под нужным юзером, отредактируйте файл «/etc/default/asterisk». Установите там следующие параметры: «AST_GROUP=»dialout»» и «AST_USER=»asterisk»».

Можно сделать это проще - впишите скрипт «sed -i ‘s/#AST_USER=»asterisk»/AST_USER=»asterisk»/g’ /etc/default/asterisk».

Предоставьте пользователю доступ ко всем папкам программы - «chown -R [Имя-юзера] [Путь-к-каталогу]».

Откройте файл «asterisk.conf», найдите в нём параметр «runuser» и укажите в нём только что созданного пользователя. Если делали группу, также перепишите строчку «rungroup».

Перезагрузите систему - «reboot».

Зайдите под именем Asterisk-юзера - «su [Имя]».

И запустите программу.

Чтобы посмотреть информацию о ней, введите «asterisk -rvvvv».

Утилита готова к работе. Дальнейшие действия зависят от того, в каких условиях будет использоваться станция. Есть несколько файлов, в которых расписана конфигурация:

• conf - общие настройки сервера. В нём можно указать, сколько подключено абонентов. Там устанавливают правила дозвона.
• conf - в нём также настраивают правила дозвона и выставляют параметры звонков.
• conf - конфигурация абонентских аккаунтов.

С Asterisk вы создадите АТС любой сложности. В нём много полезных функций и модулей. После установки и настройки вы сможете взаимодействовать со станцией при помощи клиентского программного обеспечения. Например, Linphone.

Графический интерфейс администратора IP – АТС Asterisk – FreePBX, насчитывает огромное количество опций настройки, вариантов маршрутизации, подключения различного оборудования, начиная от телефонных аппаратов и заканчивая шлюзами. В статье мы опишем базовую настройку тринадцатой версии FreePBX сразу после .

Пошаговое видео

Подключение к FreePBX

Чтобы подключиться к графическому интерфейсу FreePBX, нужно ввести IP – адрес Asterisk, который вы указали на этапе установки. Если вы забыли, какой IP – адрес указали, то подключите монитор и клавиатуру к вашему серверу, а затем введите данные для пользователя root, как показано ниже:

При подключении, вам будет указан IP – адрес вашего сервера. Если версия вашего дистрибутива отличается, и вы не увидели аналогичного вывода, укажите следующую команду:

# ifconfig

Вывод команды позволит вам увидеть все доступные интерфейсы и их IP – адреса.

Активация и пароль администратора

Подключившись к FreePBX 13 через интернет – браузер вам будет сразу предложено создать учетную запись администратора указав логин, пароль и адрес электронной почты администратора системы. После успешного создания, выберите на главной страницу пункт FreePBX Administration и укажите созданные параметры:

Сразу после подключение, перейдите во вкладку Admin → System Admin и нажмите кнопку Activation

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

Настройки SIP

Модуль SIP Settings это графическая визуализация настроек в файле /etc/asterisk/sip_nat.conf. Здесь, с помощью графического интерфейса можно настроить важнейшие параметры, такие как настройки NAT, внешний IP – адрес и настройки кодеков. Чтобы перейти к настройке нажмите на вкладку Settings , а далее Asterisk Sip Settings .

Allow Anonymous inbound SIP Calls
Данная опция позволяет разрешить, или запретить входящие звонки с неизвестных номеров. Мы советуем запрещать данный вид звонков, так как потенциально, разрешенные анонимные звонки могут стать лазейкой для злоумышленников.

Local Networks
Введите локальные (находящиеся внутри вашей сети) адреса подсетей, которым Asterisk будет доверять. Например, 192.168.2.0/255.255.255.0

RTP Ranges
Укажите диапазон RTP портов. Рекомендуем все оставлять по умолчанию.

Strict RTP
Когда между двумя устройствами устанавливается RTP поток, то назначаются адреса источника и назначения. При включенной данной опции, все пакеты приходящие с другого IP – адреса буду отброшены. Мы рекомендуем не выключать данную опцию.

Codecs
Галочкой отметьте нужные кодеки.

Положение кодеков указывает их приоритет. Например, на скриншоте ниже приоритет отдан g.711 u-law, затем g.711 a-law, gsm и так далее. Более подробно про телефонные вы можете прочитать в наших прошлых статях.
Настройка NAT в FreePBX

В большинстве случаев, если администратор обнаруживает проблему односторонней слышимости, или то, что звонки обрываются спустя несколько секунд разговора – проблема в NAT. Вот что нужно сделать, чтобы избавиться от этой проблемы: в настройка модуля Asterisk SIP Settings , переходим во вкладку Chan SIP Settings и отмечаем следующее:

NAT - yes
IP Configuration - Static IP
Override External IP - введите ваш внешний IP - адрес

Reinvite Behavior - No
Обязательно укажите в настройках Local Networks в предыдущей вкладке вашу локальную подсеть. Помимо этого, пробросьте на вашем маршрутизаторе порт 5060 и диапазон портов из параметра RTP Ranges , по умолчанию равный 10000-20000

Настройка сетевых параметров FreePBX

Есть три важных пункта данной настройки:

Настроить статический IP – адрес для сервера

Настроить DNS

Настроить временную зону

Перейдем к настройке IP. Для этого, перейдите во вкладку Admin → System Admin → Network Settings

Здесь мы настраиваем следующие опции:

• Network Interface - сетевой интерфейс, то есть конкретная сетевая карта (NIC)
• IP Assignment - выберите Static чтобы настроить статический IP - адрес
• Static IP - введите IP – адрес сервера
• Netmask - маска сети
• Gateway - шлюз по умолчанию
• Start Automatically - старт при загрузке сервера

Настроим уведомления нашего сервера Asterisk, при таких сбоях, как например малое дисковое пространство или сбой в работе RAID массива:

Производим настройку следующих опций:

• From Address - адрес электронной почты, который АТС будет указывать как адрес отправителя при формировании письма
• Storage Notifications - почта для уведомлений о проблемах с хранением данных (сбой RAID или нехватка места на дисках)
• Intrusion Detection Notifications IP - почта для уведомлений о вторжениях или попытках взлома сервера

Конфигурация системы безопасности

В Asterisk встроена система обнаружения вторжений – Fail2Ban. Для настройки системы перейдите во вкладку Admin → System Admin → Intrusion Detection

Система гибкая, и, порой реагирует когда не нужно:) Поэтому, советуем заранее вносить в Whitelist перечень нужных IP – адресов, таких как IP SIP – прокси, адреса шлюзов, например FXS. Порой, бывает так, что в бан попадает IP – адрес FXS шлюза, к которому подключены все офисные аналоговые телефоны.

• Status - мы рекомендуем всегда контролировать состояние Fail2Ban, чтобы статус был running
• Intrusion Detection - в данном пункте можно остановить и перезапустить службу.
• Ban Time - время в секундах, которое IP – адрес будет находиться в статусе блокировки
• Max Retry - количество попыток подключения к АТС, которое пользователь может осуществить в течение Find Time.
• Find Time - время, в течение которого у пользователя есть Max Retry попыток подключения к системе.
• E-mail: - адрес электронной почты, на которую будут отправляться уведомления о внесении нового IP – адреса в бан.
• Whitelist - список заранее внесенных IP – адресов, которым доверяет администратор.

Настройка внутренних номеров

Для настройки телефонных аппаратов и создания внутренних номеров перейдите во вкладку Applications → Extensions . Процесс создания внутренних номеров (Extension) мы описали в статье по ссылке ниже:

Настройка SIP - транка

Подключение к провайдеру является важнейшим этапом в настройке вашего сервера IP - АТС Asterisk. Именно настройки провайдера, позволят нашим пользователям совершать исходящие, и принимать входящие вызовы. Для настройки SIP – транка перейдите во вкладку Connectivity → Trunks . Процесс создания SIP - транка подробно расписан в статье по ссылке ниже:

Настройка маршрутизации

После того, как мы настроили внутренние номера и SIP – транки для подключения к провайдеру, нам необходимо настроить маршрутизацию вызова. В рамках данной настройки, мы будем учить наш сервер Asterisk как обрабатывать входящий и исходящие вызовы. Connectivity Нам жаль, что статья не была полезна для вас:(Пожалуйста, если не затруднит, укажите по какой причине? Мы будем очень благодарны за подробный ответ. Спасибо, что помогаете нам стать лучше!

Файл конфигурации для каналов в , как для входящих, так и для исходящих вызовов.

Каждый SIP клиент или сервер определяется в этом файле как текстовый блок, по типу приведенного ниже:

type=yyy
parameter1=value
parameter2=value

Где xxx - это имя, ассоциируемое с SIP клиентом, или это может быть произвольным именем SIP устройства, на которое можно ссылаться из других конфигурационных фалов. Обычно, если SIP телефон имеет номер екстеншена 123, тогда, соответствующие ему настройки в этом файле начинается со строки . Обратите внимание, что для того, чтобы можно было позвонить на этот экстеншен 123, вы должны описать его в Вашем плане набора. может быть: "user", "peer" или "friend".

Сервер Asterisk определяет соответствие входящего вызова с именем устройства, для клиентов с type=user, основываясь на заголовке From: имя пользователя (игнорируя SIP домен). Другой путь обработки входящих SIP запросов - это определение их соответствия секции в этом файле, используя IP адрес поступившего запроса для определения того, от кого этот запрос поступил, и поиск подходящего значения параметра Host= в секции пользователя . Если этот параметр задан как Host=dynamic, тогда не будет подходящих совпадений, до того как SIP клиент не зарегистрируется на сервере.

Asterisk в роли SIP клиента В файле конфигурации в секции добавьте определение register:

Формат:
register => user [:secret[:authuser]] @host [:port]

Пример:
; Зарегистрировать 2345 у sip провайдера, как номер 1234 на нашей стороне.
register => 2345:[email protected]/1234

user - идентификатор пользователя, используемый для SIP сервера (например, 2345) authuser - не обязательное имя пользователя для авторизации на SIP сервере secret - пароль пользователя host - имя домена или хоста SIP сервера. Этот SIP сервер должен быть определен в своей секции файла sip.conf, где должны быть заданы его параметры (mysipprovider.com). port - на какой номер порта посылать запросы на регистрацию на сервере host. По умолчанию - 5060 /1234 - номер екстеншена для приема вызовов в Вашем Asterisk. 1234 - вставляется в SIP заголовок contact, SIP запроса на регистрацию. Этот екстеншен используется удаленным SIP сервером, когда ему необходимо совершить вызов в сторону Вашего Asterisk. Смотри примеры, приведенные ниже. По умолчанию, используется контекстный "s".
Это, конечно, все хорошо, но использование незашифрованных паролей в текстовом файле - не самая удачная идея, но что же можно еще сделать теперь.
Вам необходимо регистрироваться, только если: a) должна быть возможность позвонить к Вам, и b) одна из сторон имеет динамический IP адрес. Проверить, удачно ли зарегистрировался Ваш сервер, можно с помощью CLI команды: "SIP SHOW REGISTRY", аналогично, можно получить список клиентов, зарегистрированных на Вашем сервере, с помощью команды: "SIP SHOW PEERS". Вы можете просмотреть более детальную информацию о зарегистрированном клиенте, при помощи команды: "SIP SHOW PEER ". Выполните команду "HELP SIP" в CLI консоли, чтобы получить список дополнительных команд.

Определение сервера, для совершения исходящих вызовов, должно быть примерно таким:

type=peer
secret=password
username=2345
host=sipserver.mysipprovider.com
fromuser=2345
fromdomain=fwd.pulver.com
nat=yes
context=from-mysipprovider ; этот контест должен быть определен в extensions.conf

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

Exten => _9.,1,Dial(SIP/${EXTEN:1}@mysipprovider-out,30,r)

Обратите внимание, что конструкция ${EXTEN:1} извлекает все содержимое переменной, в которой содержится вызываемый екстеншен (совпавший с шаблоном), за исключением первой цифры, в данном случае: 9 + набор цифр. Обратитесь к разделу по работе с подстроками в описании , для более подробной информации.

exten => 1234,1,Answer ; 1234 - екстеншен из контактной информации, по умолчанию - "s"
exten => 1234,2,Dial(SIP/111,25,Ttr) ; входящий вызов перенаправляем на SIP телефон с номером 111
exten => 1234,3,Hangup

Конфигурация SIP - секция general Секция , файла sip.conf, включает в себя следующие переменные:

= : Разрешенные кодеки, порядок выбора кодека, задается порядком их описания в этой команде (Сначала используйте: DISALLOW=ALL, перед тем, как разрешить какие то конкретные кодеки) allowtransfer= yes | no: Появилась, начиная с версии 1.4.0. При установке в значение "no" - запрещает все виды перевода вызовов. (за исключением тех, что разрешены в описании настроек пользователя). =all:Запрещает использование всех кодеков (глобальная настройка) allowguest = yes (по умолчанию) | no: Разрешить или запретить гостевые вызовы (по умолчанию - yes, в качестве значения можно указать параметр "osp", если asterisk собран с поддержкой OSP) = yes | no: Если разрешено, кто угодно может использовать сервер в качестве пира (без проверки на возможность доступа; может быть удобно, при работе с SER SIP прокси). bindaddr = 0.0.0.0:IP адрес, на который Asterisk будет принимать IP пакеты SIP вызовов bindport=5060:номер порта, на который Asterisk будет принимать IP пакеты SIP вызовов callerid = : Информация для Сaller*Id, используется, когда нет ничего из того, что можно было бы использовать в качестве этого значения. По умолчанию - "asterisk". (Возможность переназначить значение по умолчанию есть в версии Asterisk 1.0.9. Насчет других версий нет полной уверенности.) = update | yes | no (глобальная настройка). По некоторым причинам, значение по умолчанию - "Yes", будьте внимательны... context = :Это используемый по умолчанию, который используется, когда для клиента не определен свой . Этот , определенный для клиента, используется для маршрутизации вызовов от этого клиента до нужного места назначения. Содержимое описывается в файле плана набора - extensions.conf. defaultexpirey=120:Продолжительность периода входящей или исходящей регистрации. : inband | info | rfc2833 (глобальная настройка) = domains: Список доменов, разделенных запятыми, за которые отвечает сервер Asterisk. (появилось в Asterisk 1.2.x) = 200.201.202.203:IP адрес, который будет использоваться в SIP сообщениях, если наш сервер находиться за NAT. externhost = hostname.tld: (новый параметр в Asterisk 1.2.x) externrefresh = xxx: Этим параметром мы определяем, как часто будет производиться поиск записи в DNS имени хоста, определенном в параметре "externhost" (новый параметр в Asterisk 1.2.x) = 192.168.1.0/255.255.255.0: определение локальной сети и ее маски. fromdomain= : Установка домена по умолчанию в поле From: SIP сообщений, при работе в качестве SIP ua (клиента). maxexpirey=3600: Максимально разрешенная продолжительность регистрации. minexpiry=60: (Переменная появилась, начиная с версии Asterisk 1.4.0) Минимально разрешенная продолжительность регистрации. = yes | no (установка для соединений с пирами) Обратите внимание, что в Asterisk 1.0.x, параметр nat может принимать значения: no | never | route | yes. notifymimetype=text/plain:Позволяет переопределить mime type в сообщениях MWI NOTIFY, используемых в сообщениях, которые отправляются системой . pedantic = yes|no:Включить медленную, педантичную проверку полей Call-ID и всех строк в многострочном заголовке SIP сообщения и кодированных URI заголовков port = : SIP порт, используемый по умолчанию. (это не тот порт, на котором Ваш Asterisk ждет IP пакеты. Смотри параметр: bindport) promiscredir=yes | no: Включение поддержки сообщений 302 Redirects; (No - будет переадресовать все к локальному екстеншену, который получен в поле Contact, а не к екстеншену, который указан в поле назначения вызова.) realm = realm (Этой настройкой можно изменить realm для авторизации, со значения по умолчанию - Asterisk, на любое выбранное Вами. Работает, начиная с Asterisk версии 1.x) register => @ / :Зарегистрироваться на сервере SIP провайдера. = yes|no: Включить поиск для вызовов tos= : Данный параметр удален, начиная с версии Asterisk 1.4.0. Установка параметров IP QoS для исходящих медиапотоков. t1min= : (Переменная появилась, начиная с версии Asterisk 1.4.0) Минимальная задержка прохождения сообщений до хоста и обратно (roundtrip time), для которого отслеживается состояние (monitored host). Значение по умолчанию - 100 ms. = : (Переменная появилась, начиная с версии Asterisk 1.4.0) Установка параметров IP QoS для SIP пакетов. = : (Переменная появилась, начиная с версии Asterisk 1.4.0) Установка параметров IP QoS для пакетов, передающих аудиоданные по протоколу RTP. = : (Переменная появилась, начиная с версии Asterisk 1.4.0) Установка параметров IP QoS для пакетов, передающих видео данные по протоколу RTP.
videosupport=yes|no: Включает поддержку SIP видео : Параметр позволяет изменить значение SIP заголовка "User-Agent". = yes|no: Если включено, то полученному значению Remote-Party-ID можно доверять.

Конфигурация SIP - клиенты и пиры Нижеприведенные переменные могут быть заданы в описании каждого SIP клиента:

: Пользователь может быть ассоциирован с неким кодом доступа (accountcode). Используется для . : Разрешенные и запрещенные кодеки. : Категория для CDR записей. Можно выбрать: default, omit, billing, documentation. Смотри: .allowoverlap: Начиная с версии 1.4.x. Значения: yes/no, по умолчанию: yes. Установка в "no" запрещает поддержку "overlap dialing".allowsubscribe: Начиная с версии 1.4.x. Значения: yes/no, по умолчанию: no. Установка в "no" запрещает отслеживание состояние (subscriptions) данного клиента.allowtransfer: Начиная с версии 1.4.x. Разрешить (yes) или запретить (no) перевод вызова для этого пользователя.auth: Начиная с версии 1.4.x. Ссылка на запись из секции (только для типа peer).autoframing: Начиная с версии 1.4.x. Включение (yes) или выключение (no) autoframing"a.buggymwi: Начиная с версии 1.4.x. Значения: yes/no, по умолчанию: no. Cisco SIP firmware не полностью поддерживает RFC для индикации наличия новой голосовой почты (MWI). Установите значение этого параметра в "yes", чтобы не получать сообщения об ошибке, при отправке MWI телефонам с данной проблемой. : Определяет группу вызовов (call group) для вызовов через это устройство.callingpres: Начиная с версии 1.4.x. Режим публикации CallerId, значения смотри в файле doc/callingpres.txt из дистрибутива asterisk.call-limit: Начиная с версии 1.4.x__. Ограничение на кол-во вызовов для пользователя. Для типа "peer" - на исходящие, для "user" - на входящие. : Включайте, если только на клиенте поддерживается функция: .cid_number: Начиная с версии 1.4.x. Номерная часть поля CallerID.context: Контекст плана набора, в который попадают вызовы, поступающие от данного клиента. : IP адрес клиента по умолчанию, когда host= определен, как DYNAMIC. Используется, если клиент еще не зарегистрировался, при необходимости его вызова. : Как клиент обрабатывает сигнализацию DMTF. : Указываем имя пользователя для поля "from", когда происходит вызов с использованием этой записи. = : Установка домена по умолчанию в поле From:, SIP сообщений, когда происходит вызов с использованием этой записи.fullname: Начиная с версии 1.4.x. Часть с именем, поля CallerID.g726nonstandard: Начиная с версии 1.4.x. Значения: yes/no, по умолчанию: no. Если клиент собирается для сеанса связи "договориться" использовать звуковой кодек G726-32, с использованием компрессии AAL2, вместо RFC3551 (что требуется для аппаратов фирмы Sipura и шлюзов от Grandstream, и может другим). То это противоречит спецификации RFC3551, клиент _должен_ вместо этого "договориться" использовать AAL2-G726-32:-(host: Как нам найти нашего клиента - IP адрес или имя хоста. Если Вам нужно, чтоб телефон самостоятельно зарегистрировался, используйте значение dynamic вместо IP адреса или имени хоста. : Ограничение на число одновременных соединений с нашим SIP клиентом. Эти параметры устарели, в версии 1.4.x - не используются. : very|yes|no|invite|port: Определяет как обрабатывать соединения с пирами. По-умолчанию значение "no" (аутентификация для всех соединений включена). (invite и port добавлено в версии 1.2.x). : Код языка, которые определены в файле indications.conf - где определяется язык приветствий и специфичные для каждой страны настройки сигналов телефонов. : Екстеншен голосового ящика (для работы индикатора новых сообщений)maxcallbitrate: Начиная с версии 1.4.x. Максимальный битрейт для видео в kbit/s. По умолчанию: 384 kbit/s.mohsuggest: Начиная с версии 1.4.x. Назначение см. в sip.conf. : MD5-Hash строки: " :asterisk: " (может использоваться вместо параметра secret).musiconhold: Устанавливает класс музыки ожидания (musiconhold) для вызовов с данного SIP телефона. Для вызовов, которые поступают на данный телефон, задание этого класса необходимо делать командой , расположенной выше по приоритету (меньшее значение приоритета в плане набора), чем команда Dial в плане набора. Параметр MusicOnHold устанавливается для совершаемых вызовов, а не для телефонов, и если для обработки вызова для екстеншена используется команда , то она переопределит, заданное этим параметром значение, для этого вызова. : Эта переменная изменяет образ действия сервера Asterisk для клиентов находящихся за файрволом с трансляцией адресов (NAT). Но этот параметр не решает проблемы, если сам Asterisk находится за таким файрволом, а клиент снаружи (в сети internet с нормальным IP адресом).outboundproxy: Адрес прокси сервера для исходящих вызовов (только для типа peer).permit, deny: Ограничения по IP адресу и IP сети для клиента. Примечание: в версии 1.4.x параметр mask уже не используется. : Группа для "pickup" вызовов поступающих вашим сослуживцам, используя комбинацию "*8" и приложение Pickup() для работы с екстеншеном *8.port: SIP порт клиента.progressinband: Начиная с версии 1.4.x. Значения: yes/no/never, по умолчанию: never. Должен ли asterisk генерировать самостоятельно звуковой сигнал вызова для вызывающего абонента (in-band ringing). Используйте значение "never", чтобы никогда не производилась генерация этого сигнала, даже в случае, когда некоторые странные устройства не могут генерировать его самостоятельно.promiscredir: Начиная с версии 1.4.x. Значения: yes/no, по умолчанию: no. Если установлено в значение "yes", то этим мы разрешаем отправлять SIP сообщения с кодом 302 или сообщения для переадресации вызова, для SIP клиентов с не локальными IP адресами. Стоит отметить, что поведение promiscredir при совершении переадресации вызова, который производиться в локальной системе, может привести к зацикливанию вызова, т.к. Asterisk не умеет обрабатывать "hairpin" вызовы. : Периодическая проверка доступности клиента. restrictcid: (yes/no) Этот параметр не используется, вместо него используйте callingpres. rfc2833compensate: Начиная с версии 1.4.x. Значения: yes/no, по умолчанию: no. Включение компенсации передачи DTMF сигналов с других серверов asterisk версии до 1.4.*. В данных случаях, Вы должны включить эту функцию или прием DTMF сигналов не будет работать должным образом. : Прерывать вызов, если нет активности RTP медиапотока более чем x секунд и если линия не находиться в режиме удержания (hold). : Прерывать вызов, если нет активности RTP медиапотока более чем x секунд, в режиме удержания линии (hold) (значение должно быть больше, чем rtptimeout)secret: Если Asterisk выступает в роли SIP сервера, тогда данный SIP клиент должен автризироваться с данным паролем (shared secret). Если же Asterisk выступает в роли SIP клиента, работающим с удаленным SIP сервером, для которого требуется авторизация для запросов "SIP INVITE", тогда это поле будет использовано для авторизации в сообщениях "SIP INVITE", которые наш Asterisk будет отправлять удаленному SIP серверу.sendrpid: Отправлять или нет заголовок Remote-Party-Id этому SIP клиенту. Значения: yes/no, по умолчанию: yes.setvar: Начиная с версии 1.4.x. В значении указывается пара "переменная=значение" для переменной канала, при вызовах с данного девайса.subscribecontext: Начиная с версии 1.4.x. Указывается название контекста, в котором будут обрабатываться SIP запросы SUBSCRIBE.subscribemwi: Начиная с версии 1.4.x. Значения "yes" и "no". Назначение см. sip.conf.t38pt_udptl: Начиная с версии 1.4.x. Значения: yes/no, по умолчанию: no. Включить/выключить поддержку T.38 для данного клиента. : Значения: yes/no, по умолчанию: no. Устанавливается в "yes", если можно доверять полученному от SIP клиента Remote-Party-ID. : Тип клиента - только исходящие вызовы, только входящий или все вместе?useclientcode: Начиная с версии 1.4.x. Значения: yes/no, по умолчанию: no.usereqphone: Начиная с версии 1.4.x. Значения "yes" и "no". Добавить или нет ";user=phone" в URI, которое содержит нормальный вызываемый номер. : Если Asterisk выступает в роли SIP клиента, работающим с удаленным SIP сервером, для которого требуется авторизация для запросов "SIP INVITE", тогда это поле будет использовано для авторизации в сообщениях "SIP INVITE", которые наш Asterisk будет отправлять удаленному SIP серверу. А также, для пиров, которые регистрируются на нашем сервере Asterisk, если это имя пользователя используется в сообщениях INVITE, до тех пор, пока он зарегистрирован на сервере.videosupport: Значения: yes/no, по умолчанию: yes. Параметр для включения поддержки SIP видео. Вам может понадобиться включить поддержку видео для конкретного SIP клиента, если, например, в глобальной части конфигурации она выключена, и Вы хотите выборочно ее включить только для конкретных пользователей.vmexten: Начиная с версии 1.4.x. Назначение см. sip.conf (только для типа peer).

Обратите внимание Asterisk (пока) не поддерживает протокол SIP через TCP транспорт. Поддерживается только через UDP протокол. Для телефонов Grandstream: устанавливайте параметр dtmfmode=info, а для GXP2000 dtmfmode=inband Asterisk использует входящий поток, в качестве источника для тайминга (timing) для отправки исходящего потока. Если входящий поток прерывается из-за работы функции подавления тишины (silence suppression), тогда качество музыки ожидания (musiconhold) будет очень плохим. Как следствие, Вы не можете использовать функцию подавления тишины в паузах (silence suppresion). Обязательно убедитесь, что у ВСЕХ SIP телефонов выключена возможность подавление тишины (silence suppression).Примеры Каждый SIP клиент, который должен работать с Asterisk, должен быть определен в файле SIP.CONF. Ниже приводиться несколько примеров:

type=friend ; может быть: "friend" (это: peer+user), "peer" или "user"
context=from-sip
username=grandstream1 ; обычно, этот параметр совпадает с названием секции -
fromuser=grandstream1 ; переназначает callerid, например,
; бывает необходимо для форварда вызовов - FWD
callerid=John Doe
host=192.168.0.23 ; У нас используется статический но интранетовский IP адрес
nat=no ; между нашим телефоном и Asterisk нет трансляции IP адресов (NAT)
canreinvite=yes ; заставляет весь голосовой RTP трафик проходить через Asterisk
dtmfmode=info ; может быть, как INBAND, так и INFO, например, для телефонов BudgeTone
mailbox=1234@default ; у клиента есть голосовой ящик 1234 в контексте голосовых ящиков: "default"
disallow=all ; необходимо задать disallow=al, перед тем, как использовать параметр allow=
allow=ulaw ; Обратите внимание: в клиентских секциях, порядок выбора кодека
; описанный в параметре allow= не имеет никакого значения!
;allow=alaw
;allow=g723.1 ; Asterisk поддерживает кодек g723.1 только в режиме pass-thru!
;allow=g729 ; Только в режиме Pass-thru , если у Вас нет лицензии на использование кодека g729

Выключите функцию подавления тишины (silence suppression) в клиенте X-Lite ("Transmit Silence"=YES)!
;Обратите внимание, что Xlite сам посылает NAT пакеты keep-alive, следовательно, надобности в qualify=yes нет.
type=friend
username=xlite1
callerid="Jane Smith"
host=dynamic
nat=yes ; клиент X-Lite находиться за роутером с трансляцией IP адресов (NAT)
canreinvite=no ; Обычно, устанавливается в "NO", если клиент находиться за NAT
disallow=all
allow=gsm ; Кодек GSM требует намного меньшую полосу пропускания, тем ulaw.
allow=ulaw
allow=alaw

type=friend
secret=blah
host=dynamic
dtmfmode=inband ; Можно выбрать из: inband, rfc2833, или info
defaultip=192.168.0.59
mailbox=1234,2345 ; Голосовой ящик для работы индикатора "полученных новых сообщений"
disallow=all
allow=ulaw ; если режим для dtmf установлен "inband",
allow=alaw ; то мы должны использовать только кодек g.711

type=friend
username=user2_pingtel
secret=blah
host=dynamic
qualify=1000 ; Рассматриваем клиента как неработающего,
; если ответ от него идет более 1 сек.
callgroup=1,3-4 ; Клиент является членом групп вызовов: 1, 3 и 4
pickupgroup=1,3-4 ; Мы можем совершать "pick-up" вызовов, нажатием *8,
; для вызовов из групп 1, 3 и 4
defaultip=192.168.0.60
disallow=all
allow=ulaw
allow=alaw
allow=g729

Type=friend
username=user3_cisco
secret=blah
nat=yes ; Этот телефон находиться за роутером с NAT
host=dynamic
canreinvite=no ; Аппараты Cisco иногда подвисают,
; через некоторое кол-во reinvite запросов
qualify=200 ; Рассматриваем пир как нерабочий,
; если отклик от него приходит дольше, чем 200ms
defaultip=192.168.0.4
disallow=all
allow=ulaw
allow=alaw
allow=g729

type=friend

Username=user4_cisco
fromuser=markster ; Определяем имя пользователя, помещаемого в поле "from" вместо callerid
secret=blah
defaultip=192.168.0.4 ; используйте или host=dynamic или defaultip=...
amaflags=default ; Может быть: default, omit, billing, documentation
accountcode=markster ; Пользователь ассоциирован с accountcode для упрощения билинга.
disallow=all
allow=ulaw
allow=alaw
allow=g729
allow=g723.1

Нижеприведенное описание взято с Digium Asterisk handbook.

После того, как Вы определите эти SIP аккаунты для Ваших клиентов в файле SIP.conf, то у этих клиентов появляется возможность зарегистрироваться на сервере asterisk и совершать исходящие вызовы. Для того, чтоб они могли принимать вызовы, Вам необходимо описать екстеншены для них в Вашем файле плане набора . Пример:

Exten => 1010,1, Dial(SIP/user3_cisco,10,t)

Если кто-нибудь совершит вызов на номер 1010, тогда будут совершена попытка вызвать SIP клиента, зарегистрированного как user3_cisco.

Замечания Переменная ${VXML_URL} может быть использована для добавления дополнительного элемента в заголовке SIP сообщения "To:". Значение этой переменной будет добавлено, через точку с запятой, в конец заголовка "To:" SIP сообщения. Обратите внимание, что предыдущее описание использования этой возможности содержало ошибки; использование этой переменной не имеет никакого эффекта при загрузке сообщений в телефон Cisco 7960 (что-то в данный момент отключено в SIP firmware телефонов Cisco). Это проблема описана в: author"s e-mail Переменная ${ALERT_INFO} может использоваться для создания нового заголовка с именем "Alert-Info:", он может использоваться для задания определенного типа звонка на телефонных аппаратах фирмы Cisco, работающих с протоколом SIP, на которых установлено firmware версии 6.0 или выше. Для телефонов , переменная ALERT_INFO может принимать следующие значения, для задания определенного встроенного сигнала вызова: - Bellcore-BusyVerify
- Bellcore-Stutter
- Bellcore-MsgWaiting
- Bellcore-dr1
- Bellcore-dr2
- Bellcore-dr3
- Bellcore-dr4
- Bellcore-dr5
На данный момент нет возможности определить другой вызовов, можно выбрать только варианты проигрывания какого-либо вызова. Нужно весьма тщательно слушать, чтобы сказать, что сигналы вызова действительно чем-то отличаются. Существует багрепорт к Cisco: Cisco bug ID CSCec42938 , в котором предлагается доделать возможность выбора сигналов вызова.Пример 1 John Todd, loligo.com: http://www.loligo.com/asterisk/current/sip.conf Соединение с Free World Dialup (без использования NAT) [ general ]
disallow=all
allow=gsm
allow=ulaw
allow=alaw
context=from-sip
maxexpirey=180
defaultexpirey=160
tos=reliability
register => : @fwd.pulver.com/CONTACT

[ fwd.pulver.com ]
type=friend
secret=
username=
host=fwd.pulver.com
insecure=very ; необходимо для поддержки входящих FWD вызовов

Теперь идем к описанию файла , и смотрим как нам настроить контексты и в плане набора.

Пример 2 Использование Asterisk в связке с SIP прокси SER [ general ]
context=OUTGOING
autocreatepeer=yes

[ Provider ]
type=friend
username=XXXXX
secret=XXXXX
host=xxxxx.FakeProvider.com

Итак, теперь когда Asterisk получает вызов с SER, то он выполняет действие "autocreatepeer" и позволяет обработать этот вызов в контексте OUTGOING.

Управление sip.conf из внешних источников : использование механизма RealTime для SIP каналов. Так же, как и в других.conf файлах, может использоваться директива #include, для включения другова файла в конфигурацию sip.conf.Замечания для различных версий: Дополнительные возможности, добавленные, начиная с версии 0.7.2 2004-01-23: Добавлена CLI команда "sip reload", для перезагрузки sip канала, чтобы изменения внесенные в файл sip.conf вступили в силу, без перезагрузки сервера Asterisk. 2004-01-25: Поддержка хранения определений SIP пиров в базе данных. Хранение конфигурации в базе данных на этот момент было реализовано не полностью, но работает. Смотри: 2004-06: Поддержка хранения определений SIP пользователей в базе данных.

Добрый день, в этой статье я расскажу как установить самый популярный сервер VoIP телефонии Asterisk. С помощью данного сервера Вы сможете организовать телефонию в офисе, дома, или реализовать автоматическое оповещение, но об этом я расскажу в других статьях. И так приступим к установки asterisk на ubuntu server.

Установить Asterisk на Ubuntu Server крайне просто, понадобится всего одна команда:

sudo apt-get install asterisk

Первым делом после установки Asterisk, необходимо отключить возможность принимать звонки анонимно. Для этого открываем файл sip.conf и снимаем комментарий со строки allowguest=no, так как по умолчанию там стоит Yes. Кстати для поиска данной строки в nano можно нажать Ctrl+W и ввести искомую часть строки и нажать на Enter, если таких слов несколько в тексте то, для продолжения поиска нажать Ctrl+W и Enter.

sudo nano /etc/asterisk/sip.conf

В этом же файле можем указать провайдеров VoIP и своих внутренних абонентов. Я использую оператора it-sekret, так как у него дешевые звонки it-sekret.ru . Для этого в конце файла добавляем

Для оператора:

Type=peer context=it-sekret host=xxx.it-sekret.ru username=USERNAME secret=PASSWORD fromuser=USERNAME nat=force_rport insecure=port,invite

Если у оператора нужна постоянная регистрация, например для входящих вызовов, то надо написать вот такую строку

Register => userID:[email protected]/userID

Где userID это имя пользователя выданное оператором и PASSWORD это пароль, xxx.it-sekret.ru адрес сервера выданный оператором.

Создаем внутреннего абонента:

Type=friend context=internal host=dynamic username=1001 secret=1234

После добавления этих записей сохраняем файл и выходим. Для того, чтоб применить настройки необходимо либо перезапустить сервер, либо сказать ему, чтоб он перечитал настройки. Этот способ лучше, так как если сервер у Вас действующий, то звонки которые сейчас идут не оборвутся.

sudo asterisk -r
reload
Настройка телефона или софтфона

Теперь настроим телефон или софтфон. Я использую X-lite, программных телефонов достаточно много, можете использовать на Ваш вкус. Настройки X-lite выполните как на скриншоте.

Для проверки правильности выполненных настроек в CLI Asterisk (далее просто CLI) выполните команду sip show peers

Настройка правил набора Asterisk.(Диал план)

Первым делом сделаем копию оригинального файла extension.conf

sudo mv /etc/asterisk/extensions.conf
/etc/asterisk/extensions.conf.bak

Теперь в extension.conf пропишем правило для исходящего звонка.

sudo nano /etc/asterisk/extensions.conf exten => _X.,1,Dial(SIP/it-sekret/${EXTEN})

В CLI выполним команду reload, для применения настроек. И теперь попробуем совершить звонок.

Звонок прошел, теперь надо настроить входящий звонок. Для этого нужно прописать правило набора.

sudo nano /etc/asterisk/extensions.conf exten => s,1,Dial(SIP/1001)

На этом простая настройка заканчивается, в следующих статьях я расскажу как сделать запись разговоров, настроить IVR, сделать CallBack(обратный звонок) с сайта и многое другое.