Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Не знаете с чего начать? Следуйте данной инструкции, которая поможет Вам запустить MikoPBX в работу как можно быстрее.
В данной главе приведена пошаговая инструкция для выполнения установки MikoPBX на различных платформах.
Первые шаги с MikoPBX. Как узнать IP адрес вашей системы, войти в веб-интерфейс и выполнить базовые настройки. читать далее...
После установки MikoPBX необходимо произвести настройку программной лицензии MIKO SaaS License, без неё невозможна работа с дополнительными модулями. читать далее...
В разделе Телефония Вы можете настроить список сотрудников, настроить для каждого сотрудника его внутренний номер, настроить маршрутизацию звонков и проанализировать историю вызовов.
MikoPBX управляет учетными записями телефонов, поставщиков услуг. Вы узнаете, как настраивать учетные записи в этой главе.
В разделе представлено решение задач телефонии, с которыми чаще всего сталкиваются администраторы телефонных станций. Перейдя по ссылкам снизу, Вы сможете ознакомиться с практическими примерами и найти ответы на часто задаваемые вопросы о MikoPBX.
Данная инструкция поможет Вам запустить MikoPBX в работу как можно быстрее. Следуйте инструкциям шаг-за-шагом в том порядке, в котором они представлены.
MikoPBX - полноценная операционная система для вашего оборудования, не является отдельной программой. Поставляется в виде образа (файл *.iso, *.img, *.raw).
Возможны несколько вариантов установки MikoPBX. Выберите для себя наиболее подходящий вариант установки:
На данном этапе необходимо задать правила маршрутизации входящих и исходящих вызовов, как будут обрабатываться звонки, идущие через определенного провайдера.
Для создания правил маршрутизации Вам могут понадобиться:
Благодарим Вас за выбор MikoPBX! MikoPBX - это сервер телефонии с операционной системой и удобным веб интерфейсом. Она работает практически с любой телефонной технологией в мире. MikoPBX основана на Asterisk и имеет очень низкие требования к аппаратному обеспечению ПК.
Содержание полной документации по MikoPBX доступно по .
ВНИМАНИЕ! Перед установкой MikoPBX обязательно ознакомьтесь с !
Установка АТС на виртуальную машину. .
Установка АТС в публичное облако. .
Установка MikoPBX с USB на отдельно выделенный сервер. ПК должен поддерживать загрузку с USB. .
Установка MikoPBX в Докер контейнер. .
После успешной установки АТС необходимо перейти к её настройкам в web-интерфейсе. Следуйте для осуществления первого запуска АТС в web-интерфейсе.
Для стабильной работы АТС необходимо настроить сеть через раздел Сеть и Firewall → Сетевые интерфейсы. Выполните настройку по.
В MikoPBX все локальные подсети возможно описать в разделе Сеть и Firewall → Сетевой экран. Сетевой экран предназначен для ограничения доступа к станции по типу трафика и подсетям. Выполните настройку по .
Fail2ban блокирует IP адреса с нестандартной активностью, он способен снизить скорость неудачных попыток аутентификации, позволяет защитить Вашу АТС от взлома. Выполните настройку по .
На данном этапе создаем учетные записи для внутренних номеров сотрудников. Следуйте для создания списка внутренних номеров.
Для подключения провайдера в MikoPBX следуйте .
На этом основная настройка MikoPBX завершена! Для более глубокого изучения возможностей MikoPBX рекомендуем обратиться к .
Для использования различных модулей вам необходимо зарегистрироваться в Marketplace. О том как сделать это - Вы можете прочитать .
Пример расчета необходимой пропускной способности канала для различных кодеков на 30 одновременных звонков. АТС поддерживает наиболее популярные кодеки:
G.711 - 4.67 Mbps
GSM - 1.68 Mbps
G.722 - 4.67 Mbps
G.729 - 1.38 Mbps
Расчет ориентировочный, при использовании одного кодека на всех устройствах, подключенных к АТС. Подробнее тут.
Мы рекомендуем использовать два жестких диска для развертывания АТС.
Жесткий диск объемом 800 Mb для основной системы
Жесткий диск объемом 50+ Gb для записей разговоров
1 (2 ядра) процессор x86-64
2Gb оперативной памяти
Сетевой адаптер
ПК, с такими параметрами, в наших тестах, держит 38 одновременных входящих звонков при условиях:
К очереди подключено 10 агентов (все online)
Каждую секунду поступает новый звонок
Клиенту во время ожидания воспроизводится музыка (MOH)
На АТС не установлено доп. модулей
Ориентировочно, 1 час разговора занимает 14Мб места на диске.
Перейдите в консоль установки MikoPBX, запомните IP-адрес, которая получила Ваша АТС.
Введите полученный IP-адрес MikoPBX в web-браузере. Отобразится страница авторизации.
По умолчанию логин - admin, пароль - admin.
После успешной авторизации MikoPBX автоматически откроет настройки для смены пароля
Более подробную информацию об Общих настройках в разделе Системных настроек.
Протестировано на:
Intel NUC DCCP847DYE
Intel NUC D54250WUKH
Большинство современных ПК поддерживают загрузку с USB устройства. MikoPBX может быть запущена с USB устройства.
Обратите внимание! Минимальная емкость USB диска - 600MB
Режим Bootable USB предназначен для работы АТС с USB диска (флэш карты). Используйте для установки файл *.img
Режим Live USB предназначен для установки или восстановления системы. Используйте для установки файл *.iso
Для создания загрузочного USB диска рекомендуем использовать приложение imageUSB. Скачать можно по ссылке. Альтернатива - используйте balenaEtcher
Загрузите и установите приложение.
Запустите ImageUSB
Выполните действие «Refresh drives». Выберите USB диск, далее выберите файл образа. Выполните действие «Write»
Дождитесь окончания записи, далее подключите USB диск к ПК. Перезагрузите ПК для загрузки с диска.
Будьте внимательны при выборе устройства к форматированию. Изменения не обратимы!
Откройте приложение «Terminal» (Терминал)
Подключите USB диск
Выполните команду:
Будет отображена информация о всех подключенных дисках
В текущем примере имя устройства USB «/dev/disk3». Cравним вывод команды «diskutil list» до и после подключения устройства.
Форматируем диск. Потребуется ввести пароль администратора
Отключим устройство следующей командой
Запишем образ на USB носитель
Дождитесь окончания записи, далее подключите USB диск к ПК. Перезагрузите ПК для загрузки с диска.
Установка MikoPBX в качестве гостевой машины в VirtualBOX
2. Создайте новую виртуальную машину.
3. Укажите Имя и Папку машины.
Тип - Linux.
Версия - Other Linux (64Bit).
Нажмите Далее.
Укажите размер основной памяти - 1024 МБ, а так же количество процессоров - 2
Нажмите Далее.
5. Выберите Создать новый виртуальный жесткий диск. Введите размер диска 700 МБ, а так же поставьте галочку у пункта "Выделить место в полном размере"
Нажмите Создать.
6. Подтвердите создание виртуальной машины: нажмите кнопку Готово.
1. Перейдите к настройкам созданной виртуальной машины.
Для этого нажмите Настроить.
2. Перейдите на вкладку Носители. Добавьте новый жёсткий диск для хранения записей разговоров.
3. В появившемся окне нажмите Создать.
4. Формат жёсткого диска выберите - VDI (VirtualBox Disk Image).
Нажмите Далее.
5. Жёсткий диск должен быть фиксированного размера.
Поставьте галочку рядом с пунктом "Выделить место в полном размере"
Нажмите Далее.
6. Укажите Имя создаваемого диска.
Установите Размер диска порядка 50 ГБ.
Нажмите Готово.
7. Выделите вновь созданный диск и нажмите Выбрать.
8. Созданный диск появиться в списке носителей.
9. Смонтируйте на оптический диск образ MikoPBX. Для этого в разделе Носители выделите оптический диск и в разделе Атрибуты нажмите кнопку выбора файла образа.
10. В появившемся меню нажмите Выбрать файл диска...
11. Выберите скачанный ISO-образ диска и нажмите Открыть.
12. Перейдите на вкладку «Сеть». Установите Тип подключения в значение Сетевой мост.
Нажмите ОК для сохранения всех произведенных настроек.
1. Запустите созданную виртуальную машину.
2. Откроется командный интерфейс АТС. АТС начнет загружаться.
На данном этапе MikoPBX загружается с оптического диска, на который записан ISO-образ. На это нам указывает строчка: "The system is loaded in Recovery mode".
Выбрать пункт меню - клавиша Enter.
3. Переключите язык интерфейса на русский. Для этого выполните Change Language -> Русский. Меню примет вид.
4. Произведите установку MikoPBX.
Все данные на диске, куда устанавливается MikoPBX, будут потеряны.
Нажмите Выполнить установку.
5. Отобразится информация о всех доступных дисках (в данном примере: sdb, sdc).
Диск, на который будет установлена MikoPBX, называется системным (SYSTEM). В качестве системного диска можно выбрать диск, размер которого превышает 500 Мб.
6. Введите с клавиатуры имя диска, который вы подразумевали под "системный", в текущем случае sdb и нажмите Enter (Если он выбран по умолчанию можно просто нажать Enter).
7. Система запросит подтверждение. Введите - y и нажмите Enter.
8. После выполнения установки будет предложено выбрать диск для хранения записей разговоров.
Ориентировочно, 1 час разговора занимает 14Мб места на диске.
Введите имя диска (в данном примере - единственный доступный диск sdc) и нажмите Enter.
9. После завершения установки система перезагрузится.
Теперь MikoPBX будет запускаться с диска sdb, на который вы ее установили. Увидим, что строчка «The system is loaded in Recovery mode» отсутствует.
На этом установка MikoPBX завершена.
Для того, чтобы открыть панель управления вам надо вбить в строку браузера IP-адрес вашей виртуальной машины.
Логин и пароль по умолчанию - admin
На этом установка MikoPBX на завершена.
1. Скачайте программу VirtualBox по и установите ее.
Перемещаться по пунктам меню можно .
Также можно выбирать пункт меню нажав на соответствующую пункту цифру.
Создаем новую виртуальную машину.
После скачивания последней версии образа (ссылка), указываем ISO файл с установочным дистрибутивом.
Нажимаем "Continue"
Выбираем тип операционной системы Other Linux 5.x and later kernel 64-bit
Нажимаем "Continue"
Выбираем тип биоса Legacy
Нажимаем "Continue"
Нажимаем "Finish"
После создания виртуальной машины, дождитесь ее загрузки
Перейдите в раздел "[3] Reboot the system"
Выберите "[2] Shutdown"
После выключения виртуальной машины, перейдите в настройки
Выберите "Add device"
Выберите "New Hard Disk"
Нажмите "Add..."
Выберите размер жесткого диска(мы рекомендуем не менее 50ГБ)
Нажмите "Apply"
1 час записи разговоров занимает примерно 14мб на диске.
Запустите виртуальную машину
Выберите пункт "[8] Install"
Введите имя диска, на который будет установлена MikoPBX
В нашем случае - sdb, введите его название и нажмите Enter
Подтвердите выбор диска: введите y
Выберите диск для записи разговоров
В нашем случае - sdc, введите его название и нажмите Enter
Система перезагрузится и MikoPBX будет готова к использованию.
В АТС отображается IP адрес станции, по которому к ней можно подключится
Введите IP адрес станции в строку браузера и у вас откроется меню входа в MIkoPBX
Логин и пароль по умолчанию - "admin"
Создаём новую виртуальную машину
Указываем Имя, Тип и Версию виртуальной машины, как показано на изображении ниже.
Выбираем хранилище для создания.
Для данной виртуальной машины выделяем объём оперативной памяти 1024 Мб. Создаём новый виртуальный жёсткий диск для основной системы размером 500 Мб.
Выбираем тип контроллера SCSI и тип адаптера, как на изображении ниже
Выбираем BIOS в качестве Firmware.
Проверяем и сохраняем изменения.
Перейдём к настройкам созданной виртуальной машины. Создайте новый жесткий диск для хранения записей разговоров.
Для такого диска, мы рекомендуем указывать размер не менее, чем 50 ГБ
Переходим на вкладку носителей CD/DVD Drive. Загружаем iso-образ для установки. Ставим галочку слева от пункта "Connect as power on"
Запустите созданную виртуальную машину.
Откроется командный интерфейс АТС. АТС начнет загружаться.
На данном этапе MikoPBX загружается с оптического диска, на который записан ISO-образ. На это нам указывает строчка: "The system is loaded in Recovery mode".
Перемещаться по пунктам меню можно клавишами управления курсором.
Выбрать пункт меню - клавиша Enter.
Также можно выбирать пункт меню нажав на буквенно-цифровом блоке клавиатуры соответствующую пункту цифру.
Переключите язык интерфейса на русский. Для этого выполните Change Language -> Русский. Меню примет вид:
Произведите установку MikoPBX.
Все данные на диске, куда устанавливается MikoPBX, будут потеряны.
Нажмите Выполнить установку.
Отобразится информация о всех доступных дисках (в данном примере: sdb, sdc).
Введите с клавиатуры имя диска, который вы подразумевали под "системный", в текущем случае sdb и нажмите Enter (Если он выбран по умолчанию можно просто нажать Enter).
Система запросит подтверждение. Введите - y и нажмите Enter.
После выполнения установки будет предложено выбрать диск для хранения записей разговоров.
Ориентировочно, 1 час разговора занимает 14Мб места на диске.
Введите имя диска (в данном примере - единственный доступный диск sdc) и нажмите Enter.
После завершения установки система перезагрузится.
Теперь MikoPBX будет запускаться с диска sdb, на который вы ее установили. Увидим, что строчка «The system is loaded in Recovery mode» отсутствует.
На этом установка MikoPBX завершена.
Для того, чтобы открыть панель управления вам надо вбить в строку браузера IP-адрес вашей виртуальной машины.
Логин и пароль по умолчанию - admin
На этом установка MikoPBX на завершена.
Варианты установки MikoPBX в Yandex Cloud
В сервисе Yandex Cloud есть возможность загрузить АТС MikoPBX из образа в маркетплейсе Яндекса или из образа на основе загруженного *.raw файла из дистрибутива MikoPBX (промежуточные релизы)
В оснастке Hyper-V Manager выполните действие «Действие» - «Создать» - «Виртуальная машина...«. Будет открыт помощник создания виртуальной машины
На первом шаге введите имя виртуальной машины
Выберите вариант «Поколение 1»
Выделите необходимый размер оперативной памяти. Мы рекомендуем не менее 2 Гб
Уберите галочку с пункта "Использовать для этой виртуальной машины динамическую память"
Выберите подключение к сети
Для операционной системы выделите диск размером 1Гб
Выберите заранее скачанный файл образа диска с расширением .iso
Нажмите "Готово"
Перейдите в параметры виртуальной машины
Перейдите во вкладку "Контроллер 0 IDE" и нажмите "Добавить"
Нажмите "Создать"
Выберите формат "VHD"
Выберите тип диска фиксированного размера
Укажите Имя и Расположение диска
Укажите Размер диска (Мы рекомендуем размер диска не менее 50 Гб)
1 час записи разговоров занимает примерно 14мб на диске.
Нажмите "Готово"
Удалите DVD-дисковод
Перейдите в "Действие" -> "Пуск"
Нажмите "Подключить"
Выберите "[8] Install"
Введите имя диск, на который будет установлена система, в нашем случае - sdb
Подтвердите ваш выбор: введите y
Выберите диск для записи разговоров - в нашем случае sdc
Система перезагрузится и надпись "Recovery mode" исчезнет. MikoPBX готова к работе.
IP адрес вашей станции вы можете найти в интерфейсе АТС
Введите его в строку браузера и у вас откроется Веб-интерфейс MikoPBX
Пароль и логин по умолчанию - admin
Установка MikoPBX в Yandex Cloud из Marketplace
Для начала зарегистрируйтесь в сервисе Yandex Cloud.
Приступим к настройке
Откройте Все сервисы / Инфраструктура и сеть / Compute Cloud
Перейдите в раздел Виртуальные машины
На вкладке выберите Создать ВМ
Введите имя виртуальной машины, например vm-mikopbx
Укажите зону доступности
Укажите параметры вычислительных ресурсов виртуальной машины, исходя из ожидаемой нагрузки на АТС и вашего бюджета. Для тестовой машины можно указать Гарантированная доля vCPU - 20%, RAM - 1 Гб
В разделе Выбор образа/загрузочного диска выберите Marketplace / Показать все продукты Marketplace / VoIP / MikoPBX IP АТС
В разделе Диски и файловые хранилища скорректируйте размер загрузочного диска до 1 Гб
Для развертывания АТС используйте два диска:
диск объемом 1 Гб для основной системы
диск объемом 50+ Гб для хранения записей разговоров
В разделе Диски и файловые хранилища выберите Добавить диск
На открытой вкладке введите имя диска для хранения данных, например storage-mikopbx
Укажите тип диска HDD
Укажите размер диска не менее 50 Гб
Наполнение - Пустой
Для других полей на вкладке используйте значения по умолчанию
Нажмите кнопку Добавить
В разделе Сетевые настройки выберите существующую или создайте новую облачную сеть
В поле Подсеть в выпадающем меню выберите Добавить подсеть
На открытой вкладке введите имя подсети, например local-mikopbx
В поле CIDR укажите диапазон адресов, например 172.16.32.0/24
Для других полей на вкладке используйте значения по умолчанию
Нажмите кнопку Создать
Публичный адрес и Внутренний IPv4-адрес оставьте в положении Автоматически
В разделе Доступ укажите Сервисный аккаунт
Введите Логин и SSH-ключ, предварительно сгенерированный по инструкции
В разделе Дополнительные настройки установите флажок Разрешить доступ к серийной консоли
Завершив ввод значений, нажмите кнопку Создать ВМ
Дождитесь запуска созданной виртуальной машины, обычно первый запуск занимает 6-8 минут. Статус Running, еще не означает что система полностью развернулась
Откройте созданную виртуальную машину и перейдите в раздел Серийная консоль
Скопируйте внешний адрес созданной виртуальной машины и введите его в строке браузера
Для входа используйте указанные во вкладке Серийная консоль логин и пароль
Установка MikoPBX в Yandex Cloud с помощью утилиты yc
Утилита Yandex Cloud позволяет автоматизировать создание инстансов. Ее можно использовать в скриптах.
На странице продукта скопируйте значение image_id. В текущем примере fd83g1qbk6m3jnl5cvah (для версии 2022.3.15). Идентификатор образа следует укзаать в параметре create-boot-disk image-id
Получим список каталогов
Выбираем каталог и указываем его имя в параметре folder-name
Список зон
Описываем зону в параметре zone
Запускаем инстанс
Список инстансов обновится
Используйте EXTERNAL IP для входа и ID в качестве пароля для пользователя admin web интерфейса
Для начала авторизуйтесь на сайте https://cloud.vk.com
Приступим к настройке
Откройте Виртуальные сети / Сети
На вкладке Сети выберите Создать
Введите имя новой сети, например pbx_network
Для других полей используйте значения по умолчанию
Завершив ввод значений, нажмите кнопку Добавить сеть
Перейдите к своему аккаунту
В выпадающем меню выберите Ключевые пары
Если у вас есть ключ SSH, выполните следующее
Выберите Импортировать ключ
Введите название ключа и укажите ключ в поле Публичный ключ
Нажмите кнопку Импортировать ключ
Если у вас нет ключа SSH, выполните следующее
Выберите Создать ключ
Введите название ключа, например mikopbx_ssh_key
Нажмите кнопку Создать ключ
Откройте Облачные вычисления / Образы
На вкладке Образы выберите Создать образ
Укажите источник - Файл
Выберите файл из дистрибутива MikoPBX с расширением .raw
Введите название образа, например mikopbx_image
Завершив ввод значений, нажмите кнопку Создать образ
Откройте Облачные вычисления / Виртуальные машины
На вкладке Виртуальные машины выберите Создать инстанс
Введите имя виртуальной машины, например mikopbx_vm
В поле Категория виртуальной машины выберите Все актуальные типы виртуальных машин
Укажите Тип виртуальной машины, исходя из ожидаемой нагрузки на АТС. Для тестовой машины можно указать STD2-1-1
Выберите Зону доступности
Укажите Тип диска - HDD
В качестве Операционной системы выберите mikopbx_image
Перейдите к следующему шагу Настройки сети
Выберите созданную Сеть pbx_network
Выберите созданный Ключ виртуальной машины mikopbx_ssh_key
Включите переключатель Назначить внешний IP
Для других полей используйте значения по умолчанию
Завершив ввод значений, нажмите кнопку Создать инстанс
Как только инстанс будет создан, сразу остановите его запуск
Для развертывания АТС используйте два диска:
диск объемом 1 Гб для основной системы
диск объемом 50+ Гб для хранения записей разговоров
Откройте Облачные вычисления / Диски
На вкладке Диски выберите Создать диск
Введите название диска, например mikopbx_storage_disk
Укажите Источник - Пустой диск
Укажите Тип диска - Сетевой HDD-диск (ceph-hdd)
Выберите Зону доступности такую же, как и у инстанса
Укажите размер диска не менее 50Гб
Включите переключатель Подключить диск к инстансу
Выберите созданный инстанс mikopbx_vm
Для других полей используйте значения по умолчанию
Завершив ввод значений, нажмите кнопку Создать диск
Откройте Облачные вычисления / Виртуальные машины
Запустите созданный инстанс mikopbx_vm
Откройте Виртуальные сети / Настройки firewall
На вкладке Настройки firewall выберите Добавить
Введите имя группы правил, например mikopbx_rules
Нажмите кнопку Создать группу
На открытой вкладке в разделе Входящий трафик выберите Добавить правило
Выберите Тип - Все протоколы и все порты
Укажите Удаленный адрес - Все IP-адреса
Нажмите кнопку Сохранить правило
В разделе Виртуальные машины с группой правил mikopbx_rules выберите Добавить виртуальную машину
Выберете созданную виртуальную машину mikopbx_vm и нажмите Добавить группу правил
Обязательно выполните настройку Firewall на самой АТС MikoPBX
Дождитесь запуска созданного инстанса, обычно первый запуск занимает 6-8 минут
Откройте Облачные вычисления / Виртуальные машины
Перейдите к созданной виртуальной машине mikopbx-vm
На открытой вкладке перейдите в раздел Логи
Скопируйте внешний адрес созданной виртуальной машины и введите его в строке браузера
Для входа используйте указанные во вкладке Серийная консоль логин и пароль
Самый простой способ установки MikoPBX - установка готового образа из AWS Marketplace, если вы хотите запустить нестандартную версию MikoPBX, то воспользуйтесь подробной инструкцией, где мы по шагам описали каким образом можно создать AMI образ из любого дистрибутива MikoPBX.
Авторизуйтесь в сервисе Amazon Web Services https://aws.amazon.com
Приступим к настройке
Для быстрого и удобного поиска в сервисе Amazon используйте панель поиска
Откройте Services / Compute / EC2 и перейдите в раздел Images / AMI Catalog
На открытой вкладке в поисковой строке введите MikoPBX
В разделе AWS Marketplace AMIs выберите образ MikoPBX, нажав кнопку Select
Нажмите кнопку Launch an instance form AMI для создания виртуальной машины
Введите имя виртуальной машины (Name), например mikopbx-vm
Если у вас есть ключ SSH, выполните следующее
Укажите SSH ключ в поле Key pair
Если у вас есть нет ключа SSH, выполните следующее
Выберите Create new key pair и укажите имя пары ключей (Key pair name), например mikopbx_key
Следуйте дальше по инструкции
Для развертывания АТС используйте два диска:
диск объемом 1 Гб для основной системы
диск объемом 50+ Гб для хранения записей разговоров
При необходимости измените размер диска для хранения данных в разделе Configure storage, по умолчанию его размер - 50Гб
Для других полей используйте значения по умолчанию
Нажмите кнопку Launch instance
Перейдите к созданной виртуальной машине mikopbx-vm
На открытой вкладке выберите Connect / EC2 serial console, дождитесь полной загрузки системы, пока не отобразятся параметры авторизации
Скопируйте внешний адрес созданной виртуальной машины и введите его в строке браузера
Для входа используйте указанные в EC2 serial console логин и пароль
Обязательно выполните настройку Firewall на самой АТС MikoPBX
Для начала авторизуйтесь на портале Microsoft Azure https://portal.azure.com/
Приступим к настройке
Для быстрого и удобного поиска на портале Azure используйте панель поиска
Откройте Меню / Все службы / Общие / Группы ресурсов
На вкладке Группы ресурсов выберите Создать
Введите имя группы, например MikoPBX_group
Для других полей используйте значения по умолчанию
Завершив ввод значений, нажмите кнопку Просмотр и создание, затем кнопку Создать
Откройте Меню / Все службы / Интернет вещей / Учетные записи хранения
На вкладке Учетные записи хранения выберите Создать
Укажите созданную группу ресурсов MikoPBX_group
Введите имя учетной записи, например pbximgs
Для других полей используйте значения по умолчанию
Завершив ввод значений, нажмите кнопку Проверка, затем кнопку Создать
Перейдите к карточке созданной учетной записи хранения pbximgs
На открытой вкладке перейдите в меню Хранилище данных / Контейнеры
Добавьте новый контейнер
Введите имя контейнера, например imgs
Нажмите кнопку Создать
Откройте созданный контейнер imgs
На открывшейся вкладке выберите Отправка
Выберите файл из дистрибутива MikoPBX с расширением .vhd
Нажмите кнопку Отправка
Откройте Меню / Все службы / Вычисление / Образы
На вкладке Образы выберите Создать, создадим новый образ на основе загруженного *.vhd файла
Укажите группу ресурсов MikoPBX_group
Введите уникальное имя для образа, например MikoPBX_Azure
Укажите тип ОС - Linux
Укажите поколение виртуальных машин - Поколение 1
Выберите BLOB-объект хранилища по ссылке Обзор, Обзор / pbximgs / imgs / *.vhd
Укажите тип учетной записи - HDD (цен. категория "Стандартный")
Для других полей используйте значения по умолчанию
Завершив ввод значений, нажмите кнопку Просмотр и создание, затем кнопку Создать
Откройте Меню / Все службы / Вычисление / Виртуальные машины
На вкладке Виртуальные машины выберите Создать / Виртуальная машина Azure
Укажите группу ресурсов MikoPBX_group
Введите имя виртуальной машины, например MikoPBX-vm
Выберите созданный ранее образ, Посмотреть все образы / Другие элементы / Мои изображения / MikoPBX_Azure
Укажите размер машины (совокупность параметров ЦП / ОЗУ не менее 1Гб / HDD)
Укажите имя пользователя для учетной записи администратора
Если у вас есть ключ SSH, выполните следующее
Выберите источник открытого ключа SSH - Использовать существующий открытый ключ
Укажите его в поле открытый ключ SSH
Если у вас есть нет ключа SSH, выполните следующее
Выберите источник открытого ключа SSH - Создать новую пару ключей
Укажите имя пары ключей, например mikopbx_key
Следуйте дальше по инструкции
В поле тип лицензии укажите Другое
Для других полей используйте значения по умолчанию
Для развертывания АТС используйте два диска:
диск объемом 1 Гб для основной системы
диск объемом 50+ Гб для хранения записей разговоров
Перейдите на вкладку Диски
Укажите тип диска ОС
Установите флажок Удалить с виртуальной машиной
Создайте новый диск данных
Укажите размер диска не менее 50Гб
Для других полей используйте значения по умолчанию, нажмите кнопку ОК
Завершив ввод значений, нажмите кнопку Просмотр и создание, затем кнопку Создать
Откройте созданную виртуальную машину и перейдите в раздел Сетевые подключения / Параметры сети / Правила
На вкладке выберите Создание правила для порта / Правило входящего порта
Укажите диапазоны портов назначения - 0 - 65535
Выберите протокол TCP
Укажите имя, например TCP
Для других полей используйте значения по умолчанию
Завершив ввод значений, нажмите кнопку Добавить
Аналогично создайте правило для UDP. Укажите диапазоны портов назначения - 0 - 65535, протокол UDP и имя
Обязательно выполните настройку Firewall на самой АТС MikoPBX
Откройте созданную виртуальную машину и перейдите в раздел Подключение
В выпадающем меню Дополнительные способы подключения выберите Серийная консоль
Скопируйте внешний адрес созданной виртуальной машины и введите его в строке браузера
Для входа используйте указанные во вкладке Последовательная консоль логин и пароль
Для начала авторизуйтесь на сайте https://cloudinf.1c.ru
Приступим к настройке
Откройте Виртуальные сети / Сети
На вкладке Сети выберите Создать
Введите имя новой сети, например pbx_network
Для других полей используйте значения по умолчанию
Завершив ввод значений, нажмите кнопку Добавить сеть
Перейдите к своему аккаунту
В выпадающем меню выберите Ключевые пары
Если у вас есть ключ SSH, выполните следующее
Выберите Импортировать ключ
Введите название ключа и укажите ключ в поле Публичный ключ
Нажмите кнопку Импортировать ключ
Если у вас нет ключа SSH, выполните следующее
Выберите Создать ключ
Введите название ключа, например mikopbx_ssh_key
Нажмите кнопку Создать ключ
Откройте Облачные вычисления / Образы
На вкладке Образы выберите Создать образ
Укажите источник - Файл
Выберите файл из дистрибутива MikoPBX с расширением .raw
Введите название образа, например mikopbx_image
Завершив ввод значений, нажмите кнопку Создать образ
Откройте Облачные вычисления / Виртуальные машины
На вкладке Виртуальные машины выберите Создать инстанс
Введите имя виртуальной машины, например mikopbx_vm
В поле Категория виртуальной машины выберите Все актуальные типы виртуальных машин
Укажите Тип виртуальной машины, исходя из ожидаемой нагрузки на АТС. Для тестовой машины можно указать STD2-1-1
Выберите Зону доступности
Укажите Тип диска - HDD
В качестве Операционной системы выберите mikopbx_image
Перейдите к следующему шагу Настройки сети
Выберите созданную Сеть pbx_network
Выберите созданный Ключ виртуальной машины mikopbx_ssh_key
Включите переключатель Назначить внешний IP
Для других полей используйте значения по умолчанию
Завершив ввод значений, нажмите кнопку Создать инстанс
Как только инстанс будет создан, сразу остановите его запуск
Для развертывания АТС используйте два диска:
диск объемом 1 Гб для основной системы
диск объемом 50+ Гб для хранения записей разговоров
Откройте Облачные вычисления / Диски
На вкладке Диски выберите Создать диск
Введите название диска, например mikopbx_storage_disk
Укажите Источник - Пустой диск
Укажите Тип диска - Сетевой HDD-диск (ceph-hdd)
Выберите Зону доступности такую же, как и у инстанса
Укажите размер диска не менее 50Гб
Включите переключатель Подключить диск к инстансу
Выберите созданный инстанс mikopbx_vm
Для других полей используйте значения по умолчанию
Завершив ввод значений, нажмите кнопку Создать диск
Откройте Облачные вычисления / Виртуальные машины
Запустите созданный инстанс mikopbx_vm
Откройте Виртуальные сети / Настройки firewall
На вкладке Настройки firewall выберите Добавить
Введите имя группы правил, например mikopbx_rules
Нажмите кнопку Создать группу
На открытой вкладке в разделе Входящий трафик выберите Добавить правило
Выберите Тип - Все протоколы и все порты
Укажите Удаленный адрес - Все IP-адреса
Нажмите кнопку Сохранить правило
В разделе Виртуальные машины с группой правил mikopbx_rules выберите Добавить виртуальную машину
Выберете созданную виртуальную машину mikopbx_vm и нажмите Добавить группу правил
Обязательно выполните настройку Firewall на самой АТС MikoPBX
Дождитесь запуска созданного инстанса, обычно первый запуск занимает 6-8 минут
Откройте Облачные вычисления / Виртуальные машины
Перейдите к созданной виртуальной машине mikopbx-vm
На открытой вкладке перейдите в раздел Логи
Скопируйте внешний адрес созданной виртуальной машины и введите его в строке браузера
Для входа используйте указанные во вкладке Серийная консоль логин и пароль
Установка MikoPBX в облако Google Cloud
Авторизуйтесь на платформе https://console.cloud.google.com/
Приступим к настройке
Для быстрого и удобного поиска на платформе Google Cloud используйте панель поиска
Откройте Navigation menu / Products & solutions / Storage / Cloud Storage
На вкладке Cloud Storage выберите Create
Введите имя хранилища, например miko-images
Для других полей используйте значения по умолчанию
Завершив ввод значений, нажмите кнопку Create
Откройте созданное хранилище miko-images
На открывшейся вкладке выберите UPLOAD FILES
Загрузите файл из дистрибутива MikoPBX с расширением .vhd
Дождитесь окончания загрузки файла
Откройте Navigation menu / APIs & Services / Library / Google Enterprise API / Cloud Build API
На открывшейся вкладке выберите ENABLE
Проверьте роли учетной записи службы Cloud Build, для этого
Откройте страницу IAM https://console.cloud.google.com/projectselector2/iam-admin/iam
Выберите свой проект Google Cloud
Установите флажок Include Google-provided role grants
В таблице найдите строку с адресом электронной почты, заканчивающимся на @cloudbuild.gserviceaccount.com
Выберите Править (Edit principal)
Роли, которые должны быть предоставлены учетной записи службы Cloud Build, - Сompute Admin и Service Account User
Если нужных ролей нет, добавьте и нажмите SAVE
Откройте Navigation menu / APIs & Services / Library / Google Enterprise API / Compute Engine API
На открывшейся вкладке выберите ENABLE
Откройте Navigation menu / Products & solutions / Compute / Compute Engine
Перейдите в раздел Storage / Images
Выберите CREATE IMAGE для создания нового образа
Введите имя образа (Name), например mikopbx-new-image
Укажите тип источника (Source) - Virtual disk (VMDK, VHD)
Выберите Virtual disk file по ссылке BROWSE, Browse / miko-images / .vhd
Уберите флажок Install guest packages
В поле Operating system on virtual disk укажите - No operating system. Data only.
Для других полей используйте значения по умолчанию
Завершив ввод значений, нажмите кнопку Create и дождитесь окончания создания образа
Во вкладке Compute Engine перейдите в раздел Virtual machines / VM Instance
Выберите CREATE INSTANCE
Введите имя виртуальной машины (Name), например mikopbx-vm
В таблице Machine configuration / General purpose выберите Series - N1
В разделе Machine type в выпадающем меню выберите Shared-core / f1-micro
Для развертывания АТС используйте два диска:
диск объемом 1 Гб для основной системы
диск объемом 50+ Гб для хранения записей разговоров
В разделе Boot disk выберите CHANGE
На открытой вкладке перейдите к CUSTOM IMAGES
В поле Image выберите созданный ранее образ mikopbx-new-image
Для других полей на вкладке используйте значения по умолчанию
Нажмите кнопку SELECT
В разделе Advanced options / Disks выберите ADD NEW DISK
На открытой вкладке введите имя диска для хранения данных (Name), например disk-storage-mikopbx
Укажите размер диска (Size) не менее 50Гб
Для других полей на вкладке используйте значения по умолчанию
Нажмите кнопку SAVE
Если у вас есть ключ SSH, выполните следующее
В разделе Advanced options / Security / MANAGE ACCESS выберите ADD ITEM
Укажите его в поле SSH key
Если у вас есть нет ключа SSH, сразу перейдите к пункту 18
Для других полей используйте значения по умолчанию
Завершив ввод значений, нажмите кнопку CREATE
Откройте Navigation menu / VPC network / Firewall
Выберите CREATE FIREWALL RULE для создания нового правила для входящего соединения
Введите имя нового правила (Name), например internal-allow
Укажите Direction of traffic - Ingress
Укажите Targets
Из выпадающего меню в поле Source filter выберите IPV4 ranges и в поле Source IPv4 ranges укажите 0.0.0.0/0
В разделе Protocols and ports установите флажок TCP (Ports - 0-65535) и флажок UDP (Ports - 0-65535)
Для других полей используйте значения по умолчанию
Завершив ввод значений, нажмите кнопку CREATE
Обязательно выполните настройку Firewall на самой АТС MikoPBX
Откройте вкладку Compute Engine и перейдите в раздел Virtual machines / VM Instance
Перейдите к созданной виртуальной машине mikopbx-vm
На открытой вкладке перейдите к Logs / Serial port 1 (console)
Скопируйте внешний адрес созданной виртуальной машины и введите его в строке браузера
Для входа используйте указанные в Serial port 1 (console) логин и пароль
Авторизуйтесь в сервисе Amazon Web Services https://aws.amazon.com
Для выполнения инструкций установите утилиту командной строки Amazon, для этого откройте Терминал и введите в командной строке
Приступим к настройке
Для быстрого и удобного поиска в сервисе Amazon используйте панель поиска
Перейдите к своему аккаунту
В выпадающем меню выберите Security credentials
Если у вас нет ключа доступа, выполните следующее
В таблице Access keys выберите Create access key
Скопируйте Access key и Secret access key
Если у вас есть ключ доступа, скопируйте Access key и Secret access key
Откройте Services / Storage / S3
На вкладке выберите Create bucket
Введите уникальное имя бакета (Bucket name)
Для других полей используйте значения по умолчанию
Завершив ввод значений, нажмите кнопку Create bucket
Откройте созданный бакет и выберите Upload
На открывшейся вкладке выберите Add files
Загрузите файл из дистрибутива MikoPBX с расширением .raw
Нажмите кнопку Upload
Дождитесь окончания загрузки файла
Если для данного облака не выполнялось, сделайте один раз
Создайте отдельную папку для файлов на компьютере
Создайте в папке файл trust-policy.json
Откройте Терминал и перейдите к созданной папке
Выполните команду vi trust-policy.json
Перейдите в режим редактирования, нажав i, вставьте текст
Нажмите ESC и напишите :wq, чтобы записать файл
Аналогично создайте файл role-policy.json, измените значение имени бакета в тексте на имя созданного вами бакета
Аналогично создайте файл import-image.sh, измените значения параметра DEFAULT_BUCKET на имя созданного вами бакета и параметра DEFAULT_IMAGE на имя образа, загруженного в бакет
Выполните команду aws configure, укажите регион и скопированные ключи Access key и Secret access key
Выполните команду
Выполните команду
Выполните команду
В случае успешного выполнения команды будет сформирован уникальный идентификатор образа AMI
Откройте Services / Compute / EC2 и перейдите в раздел Images / AMIs
Выберите созданный образ и нажмите кнопку Launch an instance form AMI для создания виртуальной машины
Введите имя виртуальной машины (Name), например mikopbx-vm
Укажите тип машины (Instance type) - t3.micro
Если у вас есть ключ SSH, выполните следующее
Укажите SSH ключ в поле Key pair
Если у вас есть нет ключа SSH, выполните следующее
Выберите Create new key pair и укажите имя пары ключей (Key pair name), например mikopbx_key
Следуйте дальше по инструкции
В разделе Network settings установите флажки Allow SSH traffic и Allow HTTPS traffic
Для развертывания АТС используйте два диска:
диск объемом 1 Гб для основной системы
диск объемом 50+ Гб для хранения записей разговоров
При необходимости измените размер диска для хранения данных в разделе Configure storage, по умолчанию его размер - 50Гб
Для других полей используйте значения по умолчанию
Нажмите кнопку Launch instance
Перейдите к созданной виртуальной машине mikopbx-vm
На открытой вкладке выберите Connect / EC2 serial console, дождитесь полной загрузки системы, пока не отобразятся параметры авторизации
Скопируйте внешний адрес созданной виртуальной машины и введите его в строке браузера
Для входа используйте указанные в EC2 serial console логин и пароль
Обязательно выполните настройку Firewall на самой АТС MikoPBX
Настройка основных телефонных номеров
MicroSIP
Jitsi
PhonerLite
Телефон (Mac OS)
WebRTC tutorial using SIPML5
Настройка телеграмм как SIP софтфон
Yealink T19
Yealink T21
Yealink T28
Snom D120
В разделе Сотрудники представлен список внутренних учетных записей сотрудников. Слева от сотрудника отображается статус авторизованного устройства. Если устройство успешно авторизовано под данной внутренней учетной записью, то кружок отображается зеленым цветом, иначе серым.
В строке поиска можно найти необходимый контакт. Поиск можно осуществлять по имени сотрудника, внутреннему номеру, мобильному номеру, адресу электронной почты.
На форме также есть возможность сортировки списка сотрудников по имени, внутреннему номеру, мобильному номеру, адресу электронной почты. Имеются кнопки копирования пароля учетной записи в буфер обмена, редактирования учетной записи и её удаления.
Для добавления нового сотрудника необходимо нажать кнопку Добавить сотрудника.
На вкладке Основные параметры задаются общие настройки внутренней учетной записи сотрудника:
ФИО пользователя - допускается использование кириллицы. Это значение будет использоваться при подстановке CALLERID(name) абонента, будет отображаться в соответствующем поле экрана телефона.
Внутренний номер - он же используется в качестве Логин при подключении телефона.
Мобильный номер - используется для дополнительной маршрутизации.
Адрес электронной почты - используется для email оповещений.
Пароль для SIP
Установите сложные пароли на учетные записи (пароль для SIP)! Пароль должен удовлетворять следующим требованиям:
длина пароля должна быть длиннее восьми символов;
пароль должен содержать буквы ВЕРХНЕГО и нижнего регистра;
пароль должен содержать цифры и специальные знаки: «-», «_», «[]», «{}», «@», «;».
Открываются путем нажатия на раскрывающийся список Расширенные настройки.
В поле Переопределение строки набора введите правило набора мобильного номера для Вашего провайдера. Например, в основных настройках номер мобильного телефона указан в формате 89164577878, согласно правилам исходящей маршрутизации для провайдера звонок возможен только на номера, начинающиеся с 7. Следовательно в поле Переопределение строки набора следует указать номер 79164577878.
Количество вызовов, при котором номер считается «занятым». В таком статусе начинают работать правила маршрутизации. Это описание не распространяется на очередь вызовов.
Настройка определяет, как DTMF-сигналы передаются через SIP.
Позволяет указать используемый транспортный протокол для данной учетной записи.
Подсеть, которая описана в разделе Cетевой экран. Указывает на разрешенную подсеть для этой учетной записи. Подключение из прочих подсетей будет вызывать ошибку авторизации.
Дополнительные параметры SIP учетки
Данное поле служит для изменения/переопределения конфигурационных файлов asterisk.
Переопределять можно практически все параметры. К примеру при использовании chan_pjsip SIP аккаунт сотрудника описывается следующими секциями:
Для переопределения полей в секциях следует заполнить поле Дополнительные параметры следующим образом:
На данной вкладке вы можете настроить правила переадресации вызовов в случае, если сотрудник не может ответить на звонок, занят или недоступен.
Период времени в секундах определяет, сколько времени будет продолжаться попытка вызова на внутреннюю учетную запись сотрудника. Если в течение этого времени сотрудник не сможет ответить на вызов, вы можете указать на какой номер следует направить вызов дальше. По умолчанию, вызов будет переадресован на мобильный номер сотрудника.
Кроме того, вы можете указать номера, на которые следует направить вызов в случае занятости и недоступности сотрудника. Таким образом, если сотрудник занят или недоступен, вызов будет переадресован на указанные номера.
Вы можете настроить эти параметры в соответствии с вашими предпочтениями и требованиями.
«Host система» должна быть запущена на базе Linux 5+. Тестировалось на Debian 11 и Ubuntu-21.04, Ubuntu Server 22.04 LTS
Перед началом работы с Docker, необходимо установить сам Docker и Docker Compose. Вот как это можно сделать:
Перед созданием контейнера на хостовой машине необходимо создать пользователя и группу с ограничеными правами, а также папку для хранения настроек конфигурации и записей разговоров.
Для запуска контейнера с вашим приложением воспользуйтесь следующими командами:
Чтобы убедиться, что ваше приложение MikoPBX запостилось и работает в Docker-контейнере, можно выполнить следующие шаги после его запуска. Эти шаги помогут проверить состояние контейнера и просмотреть его логи.
Сначала нужно удостовериться, что контейнер успешно запущен и работает. Для этого используем команду docker ps
, которая покажет список запущенных контейнеров и их статус.
Эта команда выведет информацию о всех активных контейнерах. Убедитесь, что контейнер mikopbx
присутствует в списке и его статус указывает на то, что он запущен и работает (например, статус up).
После подтверждения того, что контейнер запущен, следующим шагом будет просмотр логов для проверки, что приложение загрузилось без ошибок и функционирует нормально. Команда docker logs
позволит вам увидеть вывод, который генерирует ваше приложение.
Просмотрите вывод команды на наличие сообщения, подобного указанному ниже. Это сообщение свидетельствует о том, что MikoPBX успешно загружена и готова к использованию:
Если отображается процесс запуска MikoPBX то необходимо подождать и повторить команду docker logs mikopbx
При старте контенер не имеет информации об адресе хостовой системы, потому необходимо открыть внешний адрес хостовой системы, в данном случае Ubuntu в браузере. https://<IP адрес хост системы>
Войдите в веб-интерфейс, используя логин admin
и пароль admin
, чтобы убедиться, что веб-интерфейс доступен и функционирует корректно.
Флаг NET_ADMIN необходим для возможности работы системы проактивной защиты fail2ban и фаервола iptables внутри контейнера. При срабатывании блокировки доступа, например при вводе неверного пароля, доступ с IP адреса злоумышленника будет заблокирован.
При необходимости можно скорректировать стандартный набор портов, которые использует MikoPBX. Это можно сделать объявляя переменные окружения при запуске контейнера.
Ниже перечислены некоторые переменные окружения, которые позволят скорректировать используемые MikoPBX порты и настройки.
SSH_PORT - порт для SSH (22)
WEB_PORT - порт для работы web интерфейса по протоколу HTTP (80)
WEB_HTTPS_PORT - порт для работы web интерфейса по протоколу HTTPS (443)
SIP_PORT - порт для подключения SIP клиента (5060)
TLS_PORT - порт для подключения SIP клиента с шифрованием (5061)
RTP_PORT_FROM - начало диапазона RTP портов, передача голоса (10000)
RTP_PORT_TO - конец диапазона RTP портов, передача голоса (10800)
IAX_PORT - порт для подключения IAX клиентов (4569)
AMI_PORT - порт AMI (5038)
AJAM_PORT - порт AJAM используется для подключения панели телефонии для 1С (8088)
AJAM_PORT_TLS - порт AJAM используется для подключения панели телефонии для 1С (8089)
BEANSTALK_PORT - порт для сервера очередей Beanstalkd (4229)
REDIS_PORT - порт для сервера Redis (6379)
GNATS_PORT - порт для сервера gnatsd (4223)
ID_WWW_USER - идентификатор пользователя www-user (можно задать выражением
$(id -u www-user)
, где www-user имя НЕ root пользователя)
ID_WWW_GROUP - идентификатор группы www-user (можно задать выражением
$(id -g www-user)
, где www-user имя НЕ root группы)
WEB_ADMIN_LOGIN - логин для доступа в Web интерфейс
WEB_ADMIN_PASSWORD - пароль для доступа в Web интерфейс
Вот пример файла docker-compose.yml
, который может быть использован для управления вашим контейнером MikoPBX через Docker Compose:
Сохраните содержимое в файл docker-compose.yml, выполните необходимые корректировки и запускайте MikoPBX коммандой:
Также можно оганизовать запуск нескольких контенеров MikoPBX на одном хосте, но здесь надо учитывать особенности работы Docker с портами, если не использовать режим –net=host то это приведет к высокой нагрузке на процессор хостовой системы, т.к. Docker создает для каждого выделенного порта отдельное правило в Iptables.
С включенным режимом –net=host вам необходимо вручную следить за распределением доступных портов между запускаемыми контейнерами и встроенными приложениями. Например, для запуска двух контейнеров с MikoPBX на одном хосте, можно использовать следующий конфигурационный файл:
Существует вариант запуска контейнеров с MikoPBX в режиме –net=bridge, но как описано выше для использования этого режима необходимо или существенно ограничить диапазон RTP портов, или открывать к ним доступ на хостовой машине не используя возможности Docker.
Для этого вам необходимо написать небольшой скрипт, для определения имени текущего мостового интерфейса и IP адреса каждого контейнера, и после запуска docker compose добавить необходимые правила iptables для диапазона RTP портов следующим образом:
Опишем несколько контейнеров в файле docker-compose.yaml, определим разные порты для веб интерфейса, SIP портов и диапазоны RTP портов, чтобы они не пересекались.
Создаем папку для скриптов
Сохраняем файлы start-multiple-mikopbx.sh и docker-compose.yaml в эту папку.
Устанавливаем необходимые зависимости для работы скрипта.
Переходим в нашу папку, добавляем права на выполнение и запускаем наш скрипт.
Пока ожидаем запуск контейнеров, проверяем настройки брендмауера на хосте, при необходимости открваем те порты, которые указаны в нашем docker-compose.yaml файле, а именно:
TCP/UDP порты 5060 и 6060 для SIP
UDP диапазоны 10000-10800 и 20000-20800 для передачи звука по RTP
TCP порты 8443 и 9443 для HTTPS протокола, для работы Web интерфейса.
Входим по очереди на каждую из станций по адресам:
https://<IP хостовой машины>:8443
https://<IP хостовой машины>:9443
В каждой машине должен быть включен режим NAT, указывая что контейнер находится за маршрутизатором в настройках сетевого интерфейса. Если станции будут использоваться внутри локальной сети, то в поле внешнего IP прописваем локальный IP адрес хостовой машины, в противном случе ее публичный IP адрес.
Важное замечание! Один из наших контейнеров использует проброс с SIP порта с изменением его значения 5060 -> 6060. В данном случае, для корректной работы системы, необходимо добавить внешнее значение SIP порта в настройках NAT в разделе сетевых интерфейсов MikoPBX. Эту настройку также можно сделать задав соответвующее значение переменной окружения EXTERNAL_SIP_PORT=6060 в файле docker-compose.
На этом настройка завершена, можно настраивать учетные записи и выполнять звонки.
Помимо использования нашего официального реестра, вам может понадобиться вариант создания контейнера из образа, например для бета версии. В составе опубликованных релизов и предрелизов поставляется tar архив, который мы используем для создания контейнера.
Вот пример кода, для его использования:
Команда для подключения к консоли АТС:
Команда для подключения к консольному меню АТС:
Подключение к shgrep для анализа SIP
Если необходимо использовать «», то контейнер следует запускать с флагом –privileged. Когда MikoPBX запускается в контейнере, резервное копирование можно также выполнять архивированием каталогов cf и storage вручную . В этом случае привелегированный режим можно не использовать, но в момент копирования контейнер должен быть остановлен.
Флаг –net=host указывает на то, что NAT между хостов и контенером не будет использоваться. MikoPBX будет подключена напрямую к сети хостовой машины. Все порты, которые должен занять контейнер будут заняты и на хост машине. Если на хост машине, какой-то из портов недоступн, то при загрузке MikoPBX возникнут ошибки. Подробнее в
Полный список всех возможных параметров настроек доступен в исходном коде .
Конференц-связь используют для проведения групповых обсуждений, совещаний или переговоров в тех случаях, когда у собеседников нет возможности встретиться лично, а также в случаях, когда один вопрос требуется обсудить сразу несколькими абонентами.
Список конференц-комнат располагается в разделе Телефония -> Конференции.
Для создания новой конференц-комнаты нажмите кнопку Добавить конференцию.
Необходимо указать название конференции и ее внутренний номер, позвонив на который можно в эту конференцию зайти.
Для того чтобы в конференцию не могли зайти сотрудники, для которых это обсуждение не предназначено, можно защитить конференц-комнату паролем. Для этого заполните поле cr_pinCode. В это поле можно вводить только цифры, минимум одна цифра.
В этом случае для того чтобы попасть в данную конференцию сотруднику после набора номера конференции необходимо будет ввести пин-код.
Все собеседники общаются только голосом (никаких других способов передачи информации, кроме речевого, не предоставляется);
все собеседники могут говорить и слышать друг друга одновременно (то есть обеспечивается дуплексная связь);
участники используют для общения телефоны (аппаратные или программные).
Каждый участник конференции звонит на номер конференции. Первый участник слышит музыку на удержании до тех пор, пока к конференции не присоединится хотя бы еще один участник.
Сотрудник может перевести своего собеседника в конференцию, реализовав перевод с помощью комбинации старкодов на своем телефоне. Перевести в конференцию можно как внутренний номер, так и внешний. Комбинация для переводов задается в разделе Система -> Общие настройки -> Переводы вызовов. Пример: Сотрудник набирает комбинацию **1111 (комбинация для безусловного перевода) и его собеседник попадает в конференцию и становится её первым участником. У переводившего сотрудника вызов завершается, и, чтобы попасть в конференцию он звонит на номер конференции 1111.
Максимальное количество участников конференции не ограничено.
IVR меню включает в себя варианты маршрутов входящих вызовов, в которых используется интерактивное голосовое меню (IVR).
Перед созданием IVR меню необходимо загрузить звуковые файлы, которые будут проигрываться клиенту при звонке в Вашу компанию. Звуковые файлы добавляются в разделе Телефония → Звуковые файлы
Также есть возможность записать файл с помощью микрофона, если с АТС соединиться по https.
Перейдите в Телефония → IVR меню.
Нажмите Создать новое IVR меню. Задайте наименование IVR меню, номер и при необходимости комментарий. Выберите звуковой файл, который вы загрузили на предыдущем этапе.
Настройте Действия при донаборе. В первой колонке укажите добавочный номер, а во второй настройте правило адресации.
Задайте Количество повторов перед переводом на номер по умолчанию.
Установите Таймаут ожидания ввода добавочного номера (значение в секундах), после которого будет повтор голосового приветствия.
Номер по умолчанию необходим для случая, если клиент не ввел добавочный номер (к примеру не было технической возможности).
Включите переключатель Разрешить набор любого внутреннего номера при необходимости.
Введите номер IVR меню, позвонив на который, можно на это IVR попасть.
Нажмите Сохранить.
При звонке на голосовое меню (Номер IVR меню) начинает проигрываться звуковой файл Голосовое приветствие.
Во время проигрывания голосового меню можно набирать добавочный номер сотрудника. За эту возможность отвечает флаг Разрешить донабор любого внутреннего номера. IVR позволяет разрешить донабор любого внутреннего номера: очереди, IVR, внутреннего номер сотрудника.
После проигрывания голосового меню происходит ожидание в течении Таймаут ожидания ввода добавочного номера для набора добавочного. Общее время для набора номера = Длительность звукового файла + Таймаут ожидания ввода добавочного номера.
Если общее время для набора номера истекло происходит повторное голосовое оповещение и ожидание в течении таймаута, то есть следующая попытка IVR.
Если пользователь некорректно набирает номер или вообще ничего не набирает, то также происходит повторное голосовое оповещение и ожидание в течении таймаута - следующая попытка IVR.
Максимальное количество попыток задается в параметре Количество повторов, перед переводом на номер по умолчанию.
Как только попытки превысят указанное значение, происходит переадресация на Номер по умолчанию.
Очереди позволяют:
Распределять телефонные звонки между группой сотрудников (агентов): Вы можете создать очередь вызовов и добавить в нее несколько сотрудников. Когда поступает звонок, система автоматически направляет его к доступному сотруднику в очереди, обеспечивая более равномерное распределение нагрузки и повышая эффективность обработки вызовов.
Удерживать клиента на линии, если все сотрудники заняты: Если все сотрудники в очереди заняты обработкой других вызовов, клиент будет удерживаться на линии, пока не освободится один из сотрудников. Это помогает избежать потери вызовов и обеспечивает более качественное обслуживание клиентов.
Оповещать клиента о позиции в очереди и приблизительном времени ожидания: При нахождении клиента в очереди система может предоставлять информацию о его текущей позиции в очереди и ориентировочное время ожидания. Это помогает удержать клиента в курсе ситуации и улучшает его опыт общения.
Передавать на телефон сотрудника имя очереди, вместе с номером клиента: Когда сотрудник принимает вызов из очереди, на его телефоне отображается не только номер клиента, но и имя соответствующей очереди. Это помогает сотруднику более эффективно обрабатывать вызовы и предоставлять персонализированное обслуживание.
Для настройки очередей вызовов в MikoPBX следует перейти в раздел "Телефония" и выбрать "Очереди вызовов". Здесь вы сможете создать и настроить свои очереди в соответствии с требованиями вашего бизнеса и потребностями обслуживания клиентов.
Длительность вызова на очередь по умолчанию равна 300 секундам. После истечения этого времени вызов будет завершен. Для обхода этого ограничения следует настроить Сценарий 1 (см. далее инструкции Маршрутизация звонков при сбоях).
Для добавления новой очереди выполните действие Создать новую очередь.
Укажите Название очереди - при настройке маршрутизации вы будете ориентироваться на него.
Заполните описание в поле Заметка - оно будет доступно в списке очередей.
В разделе Операторы очереди можно добавить произвольное число сотрудников (агентов очереди) и указать стратегию распределения вызовов.
Варианты стратегии:
Вызываются все доступные участники до тех пор, пока кто-то из них не ответит на вызов (по умолчанию);
Вызывается первый свободный участник, который дольше всех не вызывался из этой очереди;
Вызывается первый свободный участник, который обработал наименьшее количество вызовов из данной очереди;
Случайным образом вызывается не занятый участник, обрабатывающий очередь;
Циклическое распределение с памятью. Запоминается последний участник, ответивший на вызов;
Вызов поступает на каждого участника очереди по порядку.
В этом разделе можно дополнительно указать:
Номер телефона для этой очереди - по этому номеру можно позвонить на очередь с любого внутреннего номера сотрудника. Также на этот номер можно перевести вызов.
Краткое название очереди - для отображения перед CallerID абонента на телефонном аппарате, например consult.
Время попытки дозвона агенту - время в секундах, в течение которого вызов будет идти на одного агента очереди. По завершении этого времени вызов агенту сохраняется в историю звонков как пропущенный. По завершении времени попытки дозвона до одного агента вызов направится на следующего агента согласно выбранной стратегии.
Время отдыха агента после обработки вызова, перед тем как начать принимать новые звонки - время в секундах, которое отсчитывается с момента завершения разговора агентом очереди до момента поступления нового телефонного звонка агенту.
Получать новые звонки во время разговора - переключатель включает / отключает возможность принятия новых звонков во время текущего разговора.
Что абонент слышит во время ожидания - во время ожидания ответа на свой звонок клиент может слышать музыку на удержании или сигнал вызова.
Фоновая музыка (MOH) - можно указать уникальный звуковой файл для воспроизведения клиенту во время ожидания, к примеру рекламные материалы.
Оповещать о текущей позиции в очереди - если все операторы (агенты очереди) заняты, то включив этот переключатель, можно оповестить клиента о его позиции в очереди. Если активирована опция Дополнительный звуковой анонс, то этот анонс дополнит информацию о позиции.
Оповещать о расчетном времени ожидания - если все операторы (агенты очереди) заняты, то включив этот переключатель, можно оповестить клиента о примерном времени ожидания ответа на вызов. Если активирована опция Дополнительный звуковой анонс, то этот анонс дополнит информацию о расчетном времени.
Дополнительный звуковой анонс - звуковое сообщение проигрывается только если все участники очереди заняты.
Время в секундах для периодического повтора всех оповещений - описывает c каким интервалом произносить оповещение о позиции в очереди, времени ожидания и анонс.
Сценарий 1 - в данном сценарии можно настроить максимально допустимое время ожидания клиента в очереди. Если в течение заданного времени никто из агентов очереди не смог ответить клиенту, то можно задать номер, на который будет в дальнейшем перенаправлен вызов.
Сценарий 2 - если в очереди нет агентов (то есть в данный момент ни один агент не зарегистрирован на АТС), то можно указать номер, на который будет переведен вызов клиента.
В данных сценариях в качестве номера переадресации можно выбрать не только внутренний номер, а также конференцию, очередь, IVR, приложение диалплана служебный номер.
Длительность вызова на очередь по умолчанию равна 300 секундам. Если необходим больший интервал, то задайте в Сценарий 1, большую длительность и укажите резервный номер.
Поддерживаемый формат файлов mp3 и wav
Звуковые файлы в MikoPBX используются в различных сценариях звонков и интерактивных голосовых меню (в IVR меню, в Нерабочем времени, в Очередях вызовов и для разных системных оповещений, а также В музыке на удержании) для воспроизведения голосового приветствия или оповещения клиента.
Список доступных звуковых файлов отображается в разделе Телефония -> Звуковые файлы.
Для добавления нового звукового файла нажмите Добавить звуковой файл.
Нажмите Загрузить и выберите звуковой файл.
Откорректируйте наименование файла при необходимости.
Сохраните изменения.
При работе по протоколу https есть возможность записать звуковой файл с использованием микрофона. При работе по https должен использоваться доверенный сертификат.
Звуковые файлы хранятся на АТС по пути /storage/usbdisk1/mikopbx/media/custom
Функция доступна начиная с версии 2020.2.XXX
Если клиент при звонке попадает в очередь или ожидает переадресацию, АТС проигрывает для него мелодию. Есть возможность загрузить свои мелодии для прослушивания во время ожидания. Это можно сделать на вкладке Музыка на удержании описанным выше способом.
История вызовов - это список истории входящих, исходящих и внутренних вызовов. Располагается в Телефония -> История вызовов.
История вызовов в MikoPBX позволяет:
Отобразить все вызовы;
Отобразить вызовы по отбору;
Визуально отобразить пропущенные вызовы из общего списка звонков;
Скачать/прослушать запись разговора.
Каждый элемент списка содержит информацию о:
номере телефона звонящего абонента (Кто);
номере телефона, на который звонили (Кому);
дате и времени свершения звонка (Дата звонка);
длительности разговора (Длительность) - время голосового приветствия не учитывается.
Вызовы, отмеченные красным цветом, являются пропущенными. Длительность разговора для пропущенных вызовов равна нулю, такие вызовы невозможно прослушать.
Для каждой записи истории звонков доступна возможность прослушивания и скачивания записи разговоров. Записи разговоров скачиваются локально на ПК в формате .mp3.
Каждая строка вызова содержит полную информацию об участниках разговора.
На скриншоте выше отображено следующее:
Вызов поступил на номер 79255283744;
На вызов ответила Белкина;
Белкина осуществила консультативный перевод на Шевченко;
Шевченко продолжила разговор с клиентом.
Для применения отбора нужно после ввода в поле значения нажать Enter.
В строке поиска истории вызовов можно реализовать следующие отборы:
1) Отбор по номеру телефона
В строке поиска можно ввести как внутренний номер сотрудника, так и номер клиента (внешний).
2) Отбор по двум номерам телефона
В строке поиска через пробел можно ввести два номера телефона. Если ввести "74952293042 302", то будут отображены все отвеченные вызовы между двумя номерами. Отвеченные вызовы - это вызовы, имеющие длительность разговора больше 0 секунд, время голосового приветствия не учитывается.
3) Отбор по дате
При открытии истории звонков, журнал по умолчанию формируется на текущую дату. Установите нужный вам период и нажмите Применить.
4) Отбор по linkedid
linkedid - уникальный идентификатор звонка. Данным отбором удобно пользоваться, если необходимо найти вызов, исходя из данных журнала звонков 1С. Для применения этого отбора: 1. Откройте журнал звонков 1С; 2. Выделите нужную строку; 3. Нажмите Подробнее во встроенном плеере (или вызвав контекстное меню на данной строке); 4. Скопируйте поле Идентификатор; 5. Вставьте это значение в строку поиска истории вызовов MikoPBX и нажмите Enter.
Чтобы совершать или принимать внешние телефонные звонки по телефонной сети общего пользования или Интернет, вы должны создать, по крайней мере, одну учетную запись провайдера. Каждая технология имеет свой тип учетной записи. Для добавления новой учетной записи или изменения существующей, перейдите в Маршрутизация -> Провайдеры телефонии.
Обзор провайдеров содержит список всех доступных поставщиков услуг. Зеленый значок перед именем поставщика означает, что MikoPBX зарегистрировала этого провайдера, и Вы можете начать работу с этим провайдером. С помощью переключателя слева можно включать использование провайдера и отключать соответственно.
Для подключения новой учетной записи провайдера нажмите Подключить SIP или Подключить IAX в зависимости по типа подключаемой учетной записи.
Инструкции по подключению наиболее популярных поставщиков услуг можно найти в нашем FAQ.
В общих настройках SIP провайдера укажите следующие настройки:
Название провайдера - произвольное удобное вам наименование. Оно будет отображаться в списках выбора в соответствующих меню.
Тип учетной записи - тип регистрации учетной записи провайдера. Подробнее про тип регистрации.
Хост или IP адрес - может быть либо URL либо IP-адресом
Логин и Пароль, который предоставляет ваш провайдер
Режим DTMF - определяет, как DTMF сигналы передаются через SIP. Cуществуют различные стандарты, используемые для передачи DTMF SIP-провайдерам. Попробуйте использовать различные стандарты для того, чтобы найти режим, который подойдет вам. inband передает нажатия клавиш в качестве «тона». Для использования этого стандарта вам необходим аудио кодек высокого качества. Auto, rfc и info передают нажатия клавиш в SIP кодирование.
В этом разделе следует перечислить все адреса поставщика услуг связи, с которых могут приходит входящие звонки. Доступ для этих адресов к портам SIP и RTP будет автоматически открыт на firewall.
По умолчанию принимает значение 5060. SIP протокол описывает, каким образом клиентское приложение (например, софтфон) может запросить начало соединения у другого, возможно, физически удалённого клиента, находящегося в той же сети, используя его уникальное имя. Протокол определяет способ согласования между клиентами об открытии каналов обмена на основе других протоколов, которые могут использоваться для непосредственной передачи информации (например, RTP).
Позволяет указать используемый транспортный протокол для данной учетной записи провайдера.
Это SIP прокси сервер провайдера для обработки запросов. Реальный SIP сервер, может отличаться от этого адреса. Outbound proxy принимает на себя первичные запросы и перенаправляет на нужный сервер.
Режим NAT - Это механизм в сетях TCP/IP, позволяющий преобразовывать IP-адреса транзитных пакетов.
force_rport,comedia опция заменяющая nat=yes;
force_rport даже если ни одного параметра rport не было указано, действовать, так, как если бы он был;
comedia отправлять RTP пакеты обратно к порту с которого они были получены, игнорируя требуемый порт в SDP заголовке;
auto_comedia если Asterisk сможет определить, что устройство находится за NAT, установить опцию comedia;
no не выполнять никакой специальной обработки NAT, кроме той что указана в RFC 3581.
При включение этой опции Asterisk будет отправлять SIP Options пакеты. Это необходимо для поддержки NAT туннелирования на вашем маршрутизаторе.
Укажите частоту, с которой Asterisk будет отправлять SIP сообщение типа OPTIONS для проверки, что данное устройство работает и доступно для совершения вызовов.
Если данное устройство, не ответит в течение заданного периода (60 секунд по умолчанию), тогда Asterisk рассматривает это устройство как выключенное и недоступное для совершения вызовов.
Можно отключить использование поля fromuser заголовка SIP-пакета.
Параметры файла pjsip.conf fromuser и fromdomain используются для вызовов исходящих от Asterisk в сторону SIP устройства.
Можно переопределить:
имя пользователя в поле From в SIP пакетах (fromuser);
имя домена в поле From в SIP пакетах (fromdomain).
Для этого служат поля User и Domain соответственно.
Актуально начиная с версии 2019.4
В этом поле вы можете изменять конфигурационные файлы Asterisk.
Переопределять можно практически все параметры. К примеру при использовании chan_pjsip провайдер описывается следующими секциями:
Для переопределения полей в секциях следует заполнить поле Дополнительные параметры следующим образом:
Для завершения настройки нажмите Сохранить.
Актуально начиная с версии 2019.4. Более общая версия инструкций, которая подойдет для более ранних версий доступна в статье Регистрация нескольких учетных записей от одного провайдера.
Бывают случаи, когда необходимо подключить несколько учетных записей одного поставщика услуг связи. В этом случае настройки Хост или IP адрес и Порт соединения SIP могут оказаться одинаковыми для всех учетных записей.
Asterisk такую ситуацию обыгрывает по-своему. АТС не сможет корректно «приземлить» вызов на нужного провайдера и вызов оборвется.
В качестве решения, в старых версиях АТС можно было для какой учетной записи описать дополнительные входящие маршруты и заполнить поле Дополнительный номер (DID) значением Логин. И так для каждой учетной записи требовалось создать N-ое количество дополнительных маршрутов, равное количеству аккаунтов провайдера.
Альтернатива инструкции Регистрация нескольких учетных записей от одного провайдера. Такой подход был не очевиден.
Поле Логин в большинстве случаев при входящем звонке будет использоваться в качестве номера назначения Дополнительный номер (DID). И, учитывая, что выходящие маршруты для всех Логин будут описаны, вызов будет корректно обработан телефонной станцией.
Этот вариант используется при подключении большинства провайдеров.
Необходимость регистрации возникает в случае, когда провайдер не может знать, с какого IP-адреса будет подключаться клиент, к примеру, когда АТС расположена за NAT. Сервер провайдера обычно на публичном IP-адресе.
Входящая регистрация
Этот вариант актуален для работы некоторых FXO / GSM шлюзов - когда внешнее устройство должно подключиться к вашей АТС по логину и паролю.
Также этот вариант актуален, когда удаленное устройство находится за NAT и MikoPBX не может знать его IP адрес.
Аутентификация по IP адресу, без пароля
Актуально для безопасных частных сетей. Так к примеру Ростелеком часто ведет свой сетевой кабель и подключает клиента к своей локальной сети.
АТС и провайдер в данном случае должны находиться в одной и той же сети.
В данном разделе описываются правила работы станции в нерабочее время, праздники и выходные дни. В нерабочие дни обычно никто из сотрудников не может принять вызов, поэтому клиенту проигрывается голосовое уведомление с просьбой перезвонить в компанию в рабочее время.
Чтобы добавить новое правило нажмите на кнопку Добавить интервал времени.
Откроется форма создания нового правила.
В ней:
Период - календарный период отсутствия сотрудников в офисе. Например, на время новогодних или майских праздников
Дни недели - конкретные дни недели, для которых будет выполняться данное правило
Период времени - период времени отсутствия сотрудников в течении суток.
Применять только к определенным входящим маршрутам - можно активировать эту функцию и с помощью нее выбирать на какие входящие маршруты будет распространяться данное правило. (Подробнее ниже)
Действие с входящим вызовом - можно выбрать проиграть звуковой файл или перевести вызов. Перевести вызов можно на конференцию, IVR меню, очередь, внутренний номер сотрудника или служебные номера завершения вызова.
В поле Комментарий можно заметку, с описанием созданного правила, чтобы по данному описанию можно было быстро сориентироваться о сущности данного правила.
Активировав эту функцию, сверху у вас появится новое меню "Ограничения по маршрутам"
Здесь вы можете выбрать к каким конкретно маршрутам будет применяться создаваемое вами правило.
Данным правилом указываются звонки с конца рабочего дня (19:00) и до начала рабочего дня (9:00).
Данным правилом указываются звонки по субботам и воскресеньям.
Дополнительные модули позволяют расширить возможности функционала основной системы.
Если у Вас не подключены и не установлены данные модули, Вам будет доступен раздел «Маркетплейс». Напротив каждого модуля есть кнопка для его скачивания и установки.
Если Вы используете актуальные версии модулей, список «Макркетплейс» будет пустой.
Функционал доступен для версии MikoPBX 2019.4.94+
Любой модуль можно вынести в боковое меню интерфейса:
Нажмите на значок редактирования справа от модуля
Нажмите на значок настроек в верхней правой части
Включите параметр "Показывать модуль в боковом меню"
Нажмите "Сохранить"
В данном разделе необходимо создать правила и шаблоны распределения исходящих звонков для подключенных к АТС провайдеров.
Вы можете создавать неограниченное количество правил исходящей маршрутизации.
Для одного провайдера можно создать несколько правил.
Чтобы добавить новое правило исходящей маршрутизации нажмите на кнопку Добавить новое правило.
Название правила можно задавать произвольным.
В заметке можно описать маршрут звонка, который хотите реализовать, в дальнейшем это может помочь вам в отладке.
Приведенный на картинке выше пример означает следующее: если набранный номер начинается с "7" или "8", и остальная часть номера состоит 10 цифр.
Если набираемый номер подходит под правила нескольких маршрутов, то вызов будет производится в порядке описания маршрутов, поочередно, пока вызов не будет отвечен, или пока подходящие маршруты не закончатся.
Преобразовать номер - данная настройка предназначена для удаления префикса номера и замены его на нужный префикс.
В приведенном примере в начале номера не отсекаются цифры и не добавляются цифры.
Выберите из списка провайдера, для которого настроили исходящую маршрутизацию и сохраните изменения.
Например, номер +74952293042 должен быть преобразован к номеру 84952293042.
Реализация правила выглядит следующим образом:
Например, номера 84952293042 и 74952293042 должны быть преобразованы к номеру +74952293042.
Реализация правила выглядит следующим образом:
Например, номера 4952293042 и 4996382584 должны быть преобразованы к номеру 84952293042 и 84996382584 соответственно.
Реализация правила выглядит следующим образом:
Например, номера 84952293042 и 74996382584 должны быть преобразованы к номеру 2293042 и 6382584 соответственно.
Реализация правила выглядит следующим образом:
В данном разделе необходимо создать правила и шаблоны распределения входящих звонков для созданных в MikoPBX провайдеров. Правила входящих звонков описывают маршрут звонка с момента его поступления в АТС до момента его завершения. Вы можете создавать неограниченное количество правил входящей маршрутизации. Для одного провайдера можно создать несколько правил.
Правила располагаются в списке в порядке их приоритета. Если за указанный в правиле интервал времени никто не ответит на входящий вызов, то вызов направится на следующее по приоритету правило. Правила можно перемещать в списке вверх-вниз, то есть изменять их приоритет, перетаскивая их за стрелки.
Если ни по одному из правил на звонок не ответили, применяется входящий маршрут по умолчанию.
Доступны следующие действия, которые можно указать в качестве правила по умолчанию:
Воспроизвести сигнал занято - клиент будет воспроизведен сигнал занято и входящий вызов будет завершен;
Положить трубку;
Перевести вызов - вызов можно перевести на номер, который вы можете выбрать в поле, расположенном справа от действия. В качестве номера для перевода можно выбрать IVR-меню, очередь вызовов, конференцию, внутренний номер сотрудника.
Для одного провайдера можно описать несколько входящих маршрутов.
Сперва вызов идет по верхнему маршруту. Если клиент недозвонился, то вызов идет по нижнему правилу (более низкий приоритет). Если клиент не дозвонился и по второму маршруту, то вызов идет по маршруту по умолчанию.
Чтобы добавить новое правило входящей маршрутизации нажмите на кнопку Добавить новое правило.
В поле Заметка опишите маршрут, который хотите реализовать. В дальнейшем это поможет вам в отладке схемы звонка.
Выберите Провайдера, для которого создаете новый шаблон распределения входящих звонков.
Дополнительный номер DID - это номер, на который вам позвонил клиент. Это не обязательное поле и его следует заполнять, если необходимо более точно маршрутизировать вызовы.
На следующем шаге необходимо указать на какой телефонный номер будет направлен входящий вызов от клиента. В качестве телефонного номера могут выступать номера IVR-меню, очереди вызовов, конференции, внутренние номера сотрудников.
Укажите время, в течение которого вызов будет идти на указанный вами телефонный номер.
Если спустя указанный интервал времени никто не ответит на входящий вызов, то вызов направится на следующее по приоритету правило.
Кнопкой с ластиком можно очистить поля, напротив которых эта кнопка располагается.
Дополнительные примеры настройки исходящей маршрутизации доступны в разделе .
Задайте шаблон для исходящих звонков. Подробнее про шаблоны номеров .
Примеры преобразования номеров приведены .
Номер начинается с | Остальная часть номера состоит из указанного количества цифр | Примеры номеров |
---|
Дополнительные примеры настройки входящей маршрутизации доступны в разделе .
[7-8]{1} | 10 | 79257184255, 84952293042 |
7925 | оставьте поле пустым | 79257184255, 7925, 7925718… |
7ХХ | 0 | 700, 701, 702… |
74952293042 | 0 | 74952293042 |
74(95|99) | 7 | 74952293042, 74996382584… |
(7|8)0{1} | 1 | 700, 701, 802, 803… |
(25|26) | 0 | 25, 26 |
[0-9]{1} | 0 | цифра от 0 до 9-ти, вхождение один раз |
[1-5]{2} | 0 | 12, 15, 14, 25 цифра от 1 до 5-ти, вхождение два раза |
[8-9]+ | 0 | 8899, 888, 988888 цифра от 8 до 9-ти, вхождение от одного и более раз |
Приложения диалпланов - это программируемые голосовые приложения на PHP и Asterisk Dialplan. MikoPBX поставляется с несколькими предварительно сконфигурированными приложениями. С некоторыми базовыми знаниями планов набора Asterisk можно легко создавать дополнительные приложения. Как и учетная запись телефона, приложения могут иметь внутренний номер, присвоенный в настройках.
Ниже вы увидите описание базовых приложений, включенных в MikoPBX:
Приложения MikoPBX создаются из нескольких планов набора Asterisk приложений. В системе есть много примеров готовых к выполнению приложений. Для добавления нового приложения MikoPBX нажмите на "Добавить новое" в меню приложений.
Всего в несколько шагов Вы сможете создать свои собственные приложения. Во-первых, определите Название и Номер вызова для приложения, при необходимости заполните поле Комментарий. Возможный тип кода приложения:
PHP-AGI скрипт - AGI - это встроенный в Asterisk метод выполнения внешних скриптов (по аналогии с CGI для http серверов), который может расширить функциональность asterisk при помощи других языков программирования, в частности PHP. AGI скрипты могут управлять вызовом в плане набора, вызываются из файла: extensions.conf
Диалплан Asterisk - конфигурация плана набора содержится в файле конфигурации Asterisk - extensions.conf. Это один из самых важных конфигурационных файлов. В нем определяется обработка и маршрутизация входящих и исходящих вызовов. Этот файл управляет поведением всех соединений проходящих через Вашу АТС.
Внесем ясность: мы будем называть MikoPBX приложения - приложениями, планы набора Asterisk -функциями. Например, Answer(), NoOP(), Set() and Wait() - это функции. Эти отдельные целевые функции Asterisk, которые затем объединяются в MikoPBX для создания более мощных MikoPBX приложений. Опишите логические операции в текстовом поле Программный код. Обратите внимание, что в одной строке одновременно допускается только одна команда, например:
На рисунке пример простейшего приложения для номера 000063. После набора номера, вы услышите, как робот озвучивает Ваш внутренний номер.
MikoPBX будет проверять используемые команды. Не исключено, что неправильно запрограммированные операции могут повлиять на работоспособность вашей телефонной системы.
Описание Asterisk функций, которые Вы можете использовать в своих приложениях:
Нажмите Сохранить для завершения настройки.
Данная статья содержит пошаговые инструкции по обновлению MikoPBX на более новую версию.
Перед обновлением обязательно сделайте резервную копию настроек АТС. Делается это при помощи модуля резервного копирования.
В некоторых разделах интерфейса (например, Сотрудники) в правом нижнем углу указана текущая версия MikoPBX.
В web-интерфейсе АТС перейдите в Обслуживание → Обновление PBX.
Если есть версии АТС новее вашей текущей, они будут отображены в таблице Доступны онлайн обновления, в которой в первом поле номер версии, а во втором - список изменений.
Рекомендуем проводить обновления последовательно, «не перепрыгивая» через релизы.
Далее возможны два варианта обновления: обновление онлайн, обновление скачанным img-файлом.
Будьте внимательны! Если система установлена на тот же диск, где хранятся записи разговоров, то могут быть сложности с обновлением. см. форум
Появится окно предупреждения. Нажмите в нем Обновить.
АТС загрузит и применит обновления, а затем перезагрузится.
Следует сразу заметить, что данным способом можно выполнить не только обновление, но и откат на более прежнюю версию.
Начнется скачивание img-образа. Дождитесь завершения загрузки.
Затем нажмите Применить обновление, а в появившемся окне предупреждения нажмите Обновить.
Начнется применение обновлений. После окончания которого АТС перезагрузится.
Ниже приведен пример с АТС, установленной на виртуальную машину VirtualBOX. Обновление производится с версии 2022.2.102 до версии 2022.3.15. Скачайте из репозитория iso-образ нужной вам версии АТС.
В консоли отобразится соответствующая строка "The system loaded in Recovery mode" («АТС загружена в режиме восстановления» на русском).
Выберите Install / Repair (или нажмите на клавиатуре цифру 8) и нажмите «Enter».
Вам нужна команда "Update to version ****.*.**". Нажмите на клавиатуре цифру 2, затем нажмите «Enter». Начнется установка обновления. Когда она завершится, АТС перезагрузится.
После перезагрузки АТС сообщения "The system loaded in Recovery mode" уже не будет, что означает, что АТС загрузилась с жесткого диска, а не с виртуального оптического привода. Вверху зеленым шрифтом будет обозначена установленная версия обновления.
Для обновления контейнера MikoPBX до последней версии, вы можете выполнить следующие шаги в командной строке. Эти шаги включают остановку текущего контейнера, скачивание новой версии образа и запуск контейнера с использованием обновлённого образа. Вот пример такого процесса:
Для начала нужно корректно остановить работающий контейнер. Это позволяет избежать потери данных и гарантирует, что все процессы внутри контейнера завершатся правильно:
После остановки контейнера его можно безопасно удалить. Удаление контейнера нужно для того, чтобы можно было запустить новый экземпляр с новыми настройками и образом:
Следующий шаг — это скачивание последней версии образа MikoPBX. Использование тега latest
обеспечивает получение самой свежей версии:
Наконец, запускаем новый контейнер с использованием последней версии образа и теми же настройками, что и ранее (включая монтирование томов и прочие параметры сети):
Данные: Поскольку данные сохраняются в Docker томах (mikopbx_cf
и mikopbx_storage
), они остаются нетронутыми при обновлении, что позволяет сохранить настройки и пользовательские данные.
Переменные окружения: Убедитесь, что все необходимые переменные окружения передаются корректно.
Безопасность: Перед обновлением всегда рекомендуется создать резервные копии ваших данных.
Эти шаги помогут обеспечить гладкое и безопасное обновление вашего контейнера MikoPBX.
Регистрация MikoPBX не влияет на базовый функционал системы. Вы можете использовать MikoPBX для работы со звонками без регистрации и установки дополнительных модулей. Но мы рекомендуем пройти процедуру регистрации станции для получения онлайн обновлений и возможности установки расширений.
Общая информация о механизме лицензирования MIKO SaaS License описана здесь.
Возникают проблемы или ошибки в системе лицензирования? Рекомендуем начать с этой диагностики.
Обязательное требование - необходим доступ в Интернет. ПК, на котором запускается MikoPBX, должен иметь доступ к следующим адресам:
1. Вы впервые установили MikoPBX и у Вас НЕТ регистрационного номера ни на один из продуктов МИКО.
Выполните процедуру регистрации.
2. Если вы уже проходили процедуру регистрации для одного из программных продуктов МИКО(Панель телефонии для 1С, Журнал звонков, Модуль умной маршрутизации) и Вам необходимо указать регистрационный номер полученный ранее для корректной работы магазина расширений в MikoPBX.
Проверьте активированную лицензию в личном кабинете.
3. Ранее Вы использовали старую версию Askozia ME 5.2+ и хотите перейти на новую АТС MikoPBX.
Проверьте активированную лицензию в личном кабинете.
Регистрация доступна только если у клиента нет регистрационного номера.
Регистрационный номер имеет формат: MIKO-ХХХХХ-ХХХХХ-ХХХХХ-ХХХХХ.
В результате процедуры регистрации будет сформирован регистрационный номер
Перейдите в раздел "Модули" -> "Управление модулями"
Нажмите на значок установки любого модуля, система перенесет вас на вкладку лицензирования.
Перейдите во вкладку "Регистрация и управление лицензией"
Заполните всю необходимую информацию и нажмите "Сохранить"
После регистрации вам высветиться окно, подтверждающее регистрацию лицензионного ключа. Вы можете навестись и посмотреть номер своего лицензионного ключа.
Нажмите "Сохранить"
Перейдите в раздел "Модули" -> "Управление модулями"
Нажмите на значок установки любого модуля, система перенесет вас на вкладку лицензирования.
Перейдите во вкладку "Регистрация и управление лицензией"
Вставьте Ваш регистрационный номер и нажмите «Сохранить».
После ввода регистрационного номера, подтверждающее регистрацию лицензионного ключа. Вы можете навестись и посмотреть номер своего лицензионного ключа.
Нажмите "Сохранить"
...
Что такое MIKO SaaS сервер лицензирования? Подробности здесь.
Лицензии для MikoPBX являются лицензиями на хост. При активации лицензии на ПК устанавливается привязка этой лицензии к данному ПК (хосту). Подсчет количества используемых лицензий будет производится нашим сервером лицензирования в разрезе хостов.
Для триальной лицензии подсчет активных привязок лицензий к хосту осуществляется аналогичным образом.
Переходим в MIKO SaaS сервер лицензирования.
Вводим регистрационный номер или ранее активированный купон и нажимаем кнопку "Login". Ранее активированный купон означает, что купон был активирован в MikoPBX, т.е. была пройдена процедура активации купона.
Переходим в "Sessions monitor"
Таким образом на рисунке выделена привязка, которая относится к использованию лицензии для MikoPBX.
Слева для каждой привязки в колонке Информация есть кнопка i, которая позволяет посмотреть подробную информацию о хосте, к которому привязана лицензия.
Для каждой привязки в колонке "Action" есть кнопка Drop, которая позволяет сбросить активную привязку лицензии от хоста.
Возникают проблемы или ошибки в системе лицензирования? Рекомендуем начать с этой диагностики.
Подробности читайте здесь.
Когда Вы устанавливаете MikoPBX, осуществляется привязка регистрационного номера к хосту. Поэтому в случае переустановки MikoPBX на другой ПК необходимо выполнить следующие действия:\
Проверьте активированную лицензию в личном кабинете.
(2008) Нет необходимой лицензии
Авторизуйтесь на сайте https://lm.miko.ru используя ваш регистрационный номер MIKO-XXXXX-XXXXX-XXXXX-XXXXX. Зайдите в раздел лицензионных ключей и убедитесь что у вас есть боевая лицензий на «MikoPBX». Если лицензия есть, то сбросьте привязку к хосту в разделе Sessions Monitor. Если у вас нет лицензии на MikoPBX, запросите бесплатно новую или дополнительную на lic@miko.ru
(2051) Не удалось зарегистрировать эту копию, т.к. вы уже регистрировали ее ранее с другими параметрами Email/Компания.
Данная ошибка воспроизводится, если ранее Вы уже выполняли процедуру регистрации или использовали регистрационный номер MIKO-XXXXX-XXXXX-XXXXX-XXXXX на этой машине. Поищите в почте письмо указав отправителя lic@miko.ru Как вариант, вы можете указать правильно email адрес, который вы использовали ранее для получения ключа на этой станции и повторить процедуру регистрации.
(2022) Не удалось зарегистрировать эту копию. На указанный email уже был сгенерирован регистрационный номер для другой компании.
Данная ошибка воспроизводится, если ранее Вы уже выполняли процедуру регистрации или уже имеете регистрационный номер MIKO-XXXXX-XXXXX-XXXXX-XXXXX на указанный email адрес. Поищите в почте письмо указав отправителя lic@miko.ru или укажите корректное название компании, которое вы использовали при получении регистрационного номера в прошлый раз.
PBX: Failed to send request, Post …. request canceled while waiting for connection (Client.Timeout exceeded while awaiting headers)
Данная ошибка связана с отсутствием доступа к интернет на вашей телефонной станции.
Если самостоятельно решить проблему не удастся, ждем Вашего обращения через форму обратной связи!
Меню выключения/перезагрузки системы вы можете найти в MikoPBX, нажав на "Перезагрузка" в разделе "Обслуживание"
При открытии страницы будет отображен список активных звонков на АТС. Отображается дата начала звонка, «Кто» и «Кому» звонит.
«Перезагрузить АТС» - команда начинает перезагрузку станции.
«Выключение АТС» - завершает все процессы и отключает станцию.
Пока есть активные вызовы перезагрузка и отключение не будут доступны через web интерфейс.
Вы можете перезагрузить станцию через консольное меню. Для этого выберете раздел «[3] Перезагрузить систему»
Если вы хотите перезагрузить станцию: нажмите «[1] Перезагрузить MikoPBX»
Если вы хотите выключить станцию: нажмите «[2] Выключить»
Система перезагрузится.
В случае аварийной перезагрузки АТС (например, выключение электроэнергии) может потребоваться выполнить проверку диска на ошибки.
В консольном меню АТС введите команду «[9] Консоль(Shell)» и нажмите Enter
Система запустить консоль АТС
Введите команду Reboot
Нажмите Enter
Система перезагрузится с проверкой диска.
Содержит 3 вкладки: просмотр логов, информация о системе, захват сетевых пакетов.
Раздел позволяет просмотреть файлы логов для детального анализа работы АТС
Для начала работы - выберите файл
Установите лимит строк для выборки
Установите офсет - значение сдвига в выборке
Установите фильтр по вхождению строки в выборку
Доступны следующие возможности:
Допустим необходимо проанализировать прохождение исходящего звонка на номер 74952293042
Выберите файл для анализа asterisk/verbose.
В качестве фильтра установите номер телефона 74952293042.
В поле лимит укажите значение с запасом, к примеру 2000, иначе могут быть выданы не все записи лога.
В последней строке выборке следует найти идентификатор:
В данном примере ID = C-0000000f.
Повторяем запрос лога, но уже с фильтром C-0000000f.
Будет получен весь лог прохождения dialplan.
Полученные данные можно отправить специалисту технической поддержки.
Вкладка отображает следующую информацию:
Сетевые настройки
Нагрузка на CPU
Потребляемая оперативная память
Настройки iptables
Данный раздел позволяет произвести детальный анализ ошибок в работе АТС.
Вы можете запустить сбор сетевых пакетов, проходящих через сетевой интерфейс.
Для запуска процесса нажмите кнопку Старт.
Воспроизведите вашу проблему: совершите звонок или иное действие, приводящее к сбою / ошибке.
Нажмите кнопку Остановить и скачать.
Сетевые пакеты будут автоматически сохранены в архив MikoPBXLogs_log-tcpdump-XXXXXXXXXX. Также они должны автоматически сохраниться в папку Загрузки вашего браузера.
Подсказка
Вы можете скачать все накопленные на АТС системные логи. Для этого нажмите кнопку Скачать все системные логи.
Системные логи будут автоматически сохранены в архив MikoPBXLogs_log-sys-XXXXXXXXXX.zip. Логи автоматически должны сохраниться в папку Загрузки вашего браузера. Так же данный архив с логами можно получить из каталога /storage/usbdisk1/mikopbx/tmp, подключившись к АТС при помощи WinSCP. Файл - log-sys-XXXXXXXXXX.zip
Будьте внимательны! При большом объеме звонков или прочей сетевой «нагрузки» на АТС логи могут занять довольно много места на диске.
Другие способы снятия лога:
Для использования модуля его нужно установить.
Перейдите в пункт меню Управление модулями, найдите в списке Модуль резервного копирования и загрузите его.
Затем включите его, нажав на переключатель. После обновления страницы браузера модуль появится в разделе Обслуживание.
В разделе Обслуживание нажмите Модуль резервного копирования для открытия его главной страницы.
На главной странице модуля нажмите кнопку Создать архивную копию.
Затем, используя переключатели, необходимо выбрать, какие именно данные будут включены в архивную копию АТС, т.е. какие данные необходимо сохранить:
Настройки PBX - все настройки конфигурации MikoPBX, которые были выполнены в web-интерфейсе в соответствующих разделах
Файлы с записями разговоров - сохранение всех записей разговоров в формате *.mp3.
Нажмите Создать архивную копию.
После завершения операции в списке резервных копий появится созданная копия.
В списке резервных копий есть возможность выполнить следующий действия:
Восстановить из резервной копии
Скачать резервную копию
Удалить резервную копию
Восстановление из резервной копии
В списке резервных копий выберите нужную и выполните действие Восстановить из резервной копии
Выберите категории данных к восстановлению
Подтвердите действие, Нажав ОK.
Будет запущен процесс восстановления, после завершения АТС будет перезагружена. Прогресс восстановления данных из архива будет отображен на текущей странице
Рекомендуем восстанавливать данные в два этапа:
Восстановление Звуковые файлы + Настройки PBX + История разговоров
Восстановление Файлы записи разговоров. Это наиболее длительный этап
Кликните по кнопке Загрузить файл для восстановления
Выберите файл, с расширением *.csv
Дождитесь завершения операции
Формат файла должен быть следующим
extension - обязательное поле, внутренний номер пользователя
username - обязательное поле, имя пользователя, допускает кириллица
password - обязательное поле, пароль для SIP аккаунта
mobile-phone - мобильный номер телефона
ringtime - как долго звонить на внутренний номер
enable-forward - включить адресацию на мобильный после ringtime
Пример файла
Функция позволяет загрузить из FreePBX все Extensions, которые будут преобразованы в Сотрудников
Перейдите в интерфейс модуля Admin -> Bulk Handler.
Экспортируйте данные Extensions
Откройте в MikoPBX интерфейс модуля резервного копирования
Кликните по кнопке Загрузить файл для восстановления
Выберите файл, с расширением *.csv
Дождитесь завершения операции
Режим FTP - будет создан ZIP архив. Для данного режима необходимо наличие ftp-сервера.
Режим SFTP - создается IMG контейнер. Для данного режима достаточно только самой MikoPBX.
Режим WebDav - создается IMG контейнер.
Наиболее быстрые варианты резервного копирования по расписанию - SFTP и WebDav. FTP морально устарел, со временем возможность использования этого протокола будет исключена из модуля резервного копирования.
Для настройки автоматического резервного копирования на главной странице модуля нажмите кнопку Расписание архивации.
Для включения резервного копирования активируйте переключатель Архивация по расписанию.
Адрес сервера - IP-адрес MikoPBX, или адрес SFTP / FTP сервера
Порт - для режима SFTP - порт 22. При отключении флага «Режим SFTP» активируется режим FTP - порт 21
Имя пользователя - имя пользователя для авторизации на сервере. Для режима SFTP имя пользователя - root.
Пароль - пароль для авторизации на сервере. Для режима SFTP пароль от пользователя root.
Путь на сервере - директория, в которую будут сохраняться резервные копии. Рекомендуемый каталог на MikoPBX: /storage/usbdisk1/mikopbx/backup/
При использовании WebDav каталог из поля Путь на сервере необходимо создать заранее, вручную.
Расписание - укажите в какой день выполнять резервное копирование и время, когда запустить операцию
Оставлять последние Х версий - укажите, какое количество версий бекапа должно обязательно сохраняться
Настройки PBX - все настройки конфигурации MikoPBX, которые были выполнены в web-интерфейсе в соответствующих разделах
Файлы с записями разговоров - сохранение всех записей разговоров в формате *.mp3
Номер приложения | Описание приложения |
---|---|
Наименование команды | Описание |
---|---|
Обновления загружаются на АТС и сразу же применяются. Для обновления таким способом нажмите кнопку в нужной вам версии обновления.
Для обновления данным способом нажмите кнопку в нужной вам версии обновления.
Затем нажмите кнопку и выберите данный img-файл.
В программе VirtualBOX откройте настройки виртуальной машины на которой установлена АТС. Перейдите в раздел Носители. Выделите виртуальный оптический привод. Нажмите на значок в группе Атрибуты, нажмите Выбрать файл диска. Выберите скачанный iso-образ АТС. Запустите машину.
1. Cкачать полученную выборку в виде файла
2. Обновить выборку
3. Автоматическое обновление выборки
Если в папке Загрузки архив найти не удалось , можете и скачать его из директории /storage/usbdisk1/mikopbx/tmp - файл log-tcpdump-XXXXXXXXXX.zip
Можете, воспользовавшись поиском в WinSCP, в поле имени искомого файла ввести "log-tcpdump*", а в каталоге поиска ввести просто "/storage"
С помощью
С помощью
С помощью
История разговоров - сохранение истории базы данных cdr.db (расположение: /storage/usbdisk1/mikopbx/astlogs/asterisk/cdr.db). Данная настройка не предполагает сохранение самих записей разговоров, т.е. будет сохранена вся информация на вкладке Телефония → История вызовов () без возможности прослушивания / скачивания файлов записей.
Звуковые файлы - сохранение звуковых файлов, которые были загружены на АТС в разделе Телефония → Звуковые файлы ().
Нажмите
Установите в FreePBX модуль
История разговоров - сохранение истории базы данных cdr.db (расположение: /storage/usbdisk1/mikopbx/astlogs/asterisk/cdr.db). Данная настройка не предполагает сохранение самих записей разговоров, т.е. будет сохранена вся информация на вкладке Телефония → без возможности прослушивания / скачивания файлов записей
Звуковые файлы - сохранение звуковых файлов, которые были загружены на АТС в разделе Телефония → .
000063
Приложение считывает внутренний номер сотрудника, используемое для вызова приложения, и озвучивает его сотруднику, т.е. сотруднику озвучивается его внутренний номер на АТС
000064
0000MILLI - Генерирует постоянный звуковой сигнал частотой 1000 Гц. Используется для проверки качества соединения.
10003246
Приложение Echo посылает полученные аудиосигналы обратно пользователю, чтобы можно было определить длительность задержки. В общем, Вы слышите, что Вы говорите. Приложение в основном используется для тестирования.
answer
Перевести вызов в отвеченное состояние.
channel status
Возвращает статус подключенного канала.
control stream file
Отправка в канал заданного звукового файла, с возможностью управления его проигрывания (пауза/перемотка/возобновление проигрывания) с помощью получаемых от абонента DTMF цифр, если заданы. (Asterisk 1.2)
database del
Удаление ключа/значения из базы данных.
database deltree
Удаление дерева ключей/значений из базы данных.
database get
Получить значение из базы данных.
database put
Добавление/изменение значения в базе данных.
exec
Выполнение заданной Команды. (Команды - это функции, которые Вы используете при описании плана набора в файле extensions.conf ).
get data
Получить данные из канала.
get option
Ведет себя аналогично команде «STREAM FILE», но используется с заданным значением для таймаута. (Asterisk 1.2)
get variable
Получить значение переменной канала.
hangup
Разорвать соединение (Hangup) на текущем канале.
noop
Пустая команда. Ничего не делает.
receive char
Принимает один символ из канала, если он поддерживает эту возможность.
receive text
Принимает текстовую строку из канала, если он поддерживает эту возможность.
record file
Производит запись в заданный файл.
say alpha
Проговаривает заданную строку символов. (Asterisk 1.2)
say date
Проговаривает дату. (Asterisk 1.2)
say datetime
Проговаривает дату и время, согласно заданному формату. (Asterisk 1.2)
say digits
Проговаривает заданную строку цифр.
say number
Проговаривает заданный номер.
say phonetic
Проговаривает заданную строку символов.
say time
Проговаривает время.
send image
Отправляет изображение в канал, если он поддерживает эту возможность.
send text
Отправляет текст в канал, если он поддерживает эту возможность.
set autohangup
Автоматическое завершение соединение (Autohangup) на канале в заданное время.
set callerid
Установка callerid для текущего канала.
set context
Установка контекста для текущего канала.
set extension
Изменение екстеншена для текущего канала.
set music
Включение/Выключение музыки ожидания (Music on hold), например: «SET MUSIC ON default».
set priority
Установка значения приоритета для следующей выполняемой команды для канала.
set variable
Установка переменной канала.
stream file
Отправка звукового файла в канал.
tdd mode
Установка режима TDD для канала, который может его поддерживать, для включения возможности взаимодействия с TDD.
verbose
Запись сообщения в verbose log сервера asterisk.
wait for digit
Ожидание нажатия DTMF кнопки
В данном разделе производится настройка Fail2ban.
Fail2ban включается вместе с Сетевым экраном переключателем в разделе Сеть и FireWall → Сетевой экран.
Сервис Fail2ban блокирует IP адреса с нестандартной активностью. При неудачной попытке авторизации в лог АТС попадет информация об ошибке, Fail2ban анализирует все неудачные попытки авторизации и считает их. Когда количество неудачных попыток авторизации превышает максимально допустимое количество, IP-адрес отправляется в бан. Fail2ban способен снизить скорость неудачных попыток аутентификации.
Будьте внимательны, Fail2ban не поможет при использовании простых паролей.
Настройки защиты от взлома можно найти в боковом меню:
Если происходит определенное число неудачных попыток входа (Количество попыток для блокировки) в течение определенного периода (В течение (секунд)), IP адрес будет заблокирован в течение заданного периода времени (Блокировать на (секунд)).
Белый список адресов определяет IP - адреса, которые не будут заблокированы Fail2ban. Указывать можно как ip адрес 93.188.40.10, так и подсеть 93.188.40.10/32. В качестве разделителя используется «пробел».
Обратите внимание, что если Вы в разделе «Сетевой экран» для подсети указали настройку «Никогда не блокировать адреса из этой сети», то подсеть автоматом попадает в белый список и добавлять ее вручную не требуется. Не нужно пытаться наполнять вручную список белых IP-адресов, желательно в исключительных случаях прописывать IP-адреса.
Список заблокированных адресов показывает , какие IP-адреса в настоящее время заблокированы.
Так же вы можете разблокировать адрес кликом на соответствующую иконку в таблице
В MikoPBX все локальные подсети возможно описать в разделе «Сеть и Firewall» → «Сетевой экран». Сетевой экран предназначен для ограничения доступа к станции по типу трафика и подсетям.
Чтобы добавить новое правило, необходимо нажать на кнопку:
Название правила можно задать произвольным. Справа от адреса подсети есть поле Маска подсети в формате CIDR.
SIP&RTP-регистрация телефонов и голосовой трафик - Session Initiation Protocol используется для установки соединений между VoIP телефонами
WEB-доступ к административному интерфейсу настройки АТС
SSH-root доступ к системе. SSH(Secure Shell) позволяет получить доступ к консоли MikoPBX.
AMI-доступ к asterisk manager api через telnet. Asterisk Manager Interface (AMI) предоставляет доступ к Asterisk по TCP/IP протоколу.
AJAM - доступ к asterisk manager api, через http, https
ICMP-проверка связи командой ping
CTICLIENT-подключение панели телефонии для 1С
У каждой подсети есть флаг «Это VPN или локальная сеть». При установке этого флага MikoPBX будет представляться всем локальным подсетям локальным IP, а не внешним.
Флаг «Никогда не блокировать адреса из этой сети» следует включать только для доверенных подсетей. Если включен данный флаг, то правила защиты от взлома на данную подсеть не распространяются.
В данном подразделе происходит настройка часов и календаря.
Вам нужно установить часовой пояс, чтобы верно отображалось системное время. Если часовой пояс не задан, уведомления и история звонков будут фиксироваться с неправильным временем.
Настройка производится в разделе «Система» - «Дата и время»:
Существует возможность установить время «вручную», без использования NTP сервера. По возможности, рекомендуем использовать автоматическое определение времени.
Для настройки времени вручную переключите тумблер "Корректировать время вручную"
Для получения уведомлений о пропущенных вызовах и сообщениях голосовой почты по электронной почте необходимо настроить SMTP-клиент. SMTP (Simple Mail Transfer Protocol) используется для отправки электронной почты через Интернет. SMTP-клиенты взаимодействуют с SMTP сервером, который отправляет электронную почту.
SMTP хост - адрес почтового сервера
SMTP порт - порт почтового сервера
SMTP логин, SMTP пароль - параметры авторизации
Адрес отправителя - от имени этого адреса будут отправляться электронные письма
Email системного администратора - на этот электронный адрес будут отправляться все системные уведомления, к примеру о нехватке места на диске. При изменении и сохранении настроек на этот адрес будет отправлено тестовое письмо
Использовать TLS - активирует использование шифрования при подключении к серверу, для подключения по SSL, необходимо к адресу сервера добавить описание протокола
Проверять сертификат сервера - в ряде случаев необходимо отключить, при использовании самоподписанных сертификатов
Использовать оповещения - позволяет включить / отключить все оповещения на email, включая голосовую почту
Если сервер поддерживает защищенное соединение только по SSL, то можно явно указать протокол в поле «SMTP хост», к примеру
Email для уведомлений о пропущенных - по умолчанию, уведомления о пропущенных отправляются на email, указанный в карточке сотрудника. Если вызов не удается сопоставить с сотрудником или email не указан, то вызов будет направлен на этот «общий» адрес
Тема, текст, подвал письма могут содержать параметры в виде ИМЯ_ПАРАМЕТРА
Список доступных «параметров»:
NOTIFICATION_MISSEDCAUSE - на текущий момент всегда принимает значение «NOANSWER», т.е. пропущенный вызов
NOTIFICATION_CALLERID - от кого был вызов
NOTIFICATION_TO - кому был вызов
NOTIFICATION_DURATION - длительность в секундах
NOTIFICATION_DATE - дата вызова
Есть возможность настроить адрес и шаблон оповещения о голосовой почте:
Голосовая почта будет отправлена каждому сотруднику, кто пропустил вызов (если email указан в его карточке).
Голосовая почта всегда будет отправлена на «Единый Email для отправки сообщений голосовой почты»
Прослушать запись голосовой почты возможно из истории звонков АТС
В теме, теле и подвале email можно использовать следующие «параметры»:
VM_DATE - дата и время
VM_CALLERID - callerid звонящего, состоит из name и num, пример «Alexey Portnov» <101>
VM_DUR - длительность сообщения
VM_CALLER_NAME - имя звонящего (берется из VM_CALLERID)
VM_CALLER_NUM - номер телефона звонящего (берется из VM_CALLERID)
Чтобы указать параметр, нужно использовать конструкцию вида ИМЯ_ПАРАМЕТРА.
Нажмите Сохранить для завершения настройки.
Введем IP адрес АТС MikoPBX в браузере и перейдем в Система → Почта и уведомления.
Настройки SMTP клиента для сервиса Mail:
SMTP хост - smtp.mail.ru
SMTP Порт - 465 (Порт для обслуживания клиентов)
Адрес отправителя и Логин - E-mail с которого будут отправляться сообщения о пропущенных вызовах
Пароль - пароль от электронной почты, необходимый для авторизации
Метод шифрования - Использовать TLS
Возвращаемся в Система → Почта и уведомления. Осуществим отправку тестового письма на электронную почту любого сервиса. В случае успешного тестирования на указанный Вами адрес электронной почты придет тестовое письмо.
Введем IP адрес АТС MikoPBX в браузере и перейдем в Система → Почта и уведомления.
Настройки SMTP клиента для сервиса Gmail:
SMTP хост - smtp.gmail.com
SMTP Порт - 465 (Порт для обслуживания клиентов)
Адрес отправителя и Логин - E-mail с которого будут отправляться сообщения о пропущенных вызовах
Пароль - пароль от электронной почты, необходимый для авторизации
Метод шифрования - Использовать TLS
Возвращаемся в Система → Почта и уведомления. Осуществим отправку тестового письма на электронную почту любого сервиса. В случае успешного тестирования на указанный Вами адрес электронной почты придет тестовое письмо.
Asterisk Manager Interface (AMI) - мощный и удобный программный интерфейс (API) Asterisk для управления системой из внешних программ. Благодаря AMI внешние программы могут осуществлять соединения с Asterisk посредством TCP протокола, инициировать выполнение команд, считывать результат их выполнения, а так же получать уведомления о происходящих событиях в реальном времени. AMI часто используют для интеграции с бизнес-процессами и системами, программным обеспечением CRM (Customer Relationship Managment — управление взаимодействия с клиентами). Управление Asterisk часто осуществляется из консоли CLI, но при использовании AMI не требуется прямой доступ к серверу, на котором запущен Asterisk. AMI — это наиболее простой инструмент, который в руках разработчика может оказаться очень мощным и гибким средством для интеграции с другими программными продуктами. Он дает возможность разработчикам использовать информацию, генерируемую Asterisk, в реальном масштабе времени.
Первое что необходимо сделать, это включить AMI и завести пользователя, с помощью которого клиентская программа будет аутентифицироваться. «Система» - «Доступ к AMI»
Права пользователя AMI, устанавливаемые в секции [user] конфигурационного файла /etc/asterisk/manager.conf
В данном разделе производится настройка основных параметров системы. Данные параметры рекомендуется настраивать сразу после установки АТС.
Название PBX системы - будет отображаться на главной странице MikoPBX
Дополнительное описание - будут видеть только администраторы системы.
Язык звуковых сообщений - укажите язык оповещений
Длина внутреннего номера - максимальная длина внутреннего номера (для сотрудников)
Максимальный таймаут между цифрами при вводе добавочного
Перезапускать АТС каждую ночь - рестарт asterisk каждую ночь
Отправлять разработчикам информацию о сбоях - при возникновении ошибки, ее описание будет выслано разработчикам (требуется доступ в интернет)
Запись разговоров - позволяет включить / отключить запись
Запись внутренних разговоров - позволяет включить / отключить запись внутренних разговоров
Сохранять записи разговоров в стерео режиме изменяет режим записи с mono на stereo. Поток записи будет разделен на входящий и исходящий и объединен в стерео файл.
Имеется слайдер, с помощью которого можно выбрать сколько будут храниться записи разговоров.
Так же можно выбрать звуковой файл для предупреждения о записи разговоров.
Телефонные звонки сохраняются в формате mp3. Пример информации об итоговом файле записи разговора:
Ориентировочно, 1 час разговора занимает 14Мб места на диске.
Парковка - это вариант «удержания» клиента на линии. Полезно использовать в том случае, когда необходимо временно разъединиться с клиентом для уточнения некоторой информации. Клиенту во время парковки будет проигрываться мелодия.
В MikoPBX возможно два варианта парковки вызова от клиента:
Если вам необходимо запарковать вызов клиента, введите *2. Вызов клиента MikoPBX поставит на удержание, а Вам сообщит номер слота припаркованного вызова. Любой сотрудник может забрать вызов, набрав с телефона номер слота припаркованного вызова.
В разделе Переводы вызовов задайте номер для парковки. При переадресации вызова клиента на номер парковки, MikoPBX поставит такой вызов на удержание, а Вам сообщит номер слота припаркованного вызова. Любой сотрудник может забрать вызов, набрав с телефона номер слота припаркованного вызова.
Диапазон номеров слота припаркованного вызова можно задать в разделе Переводы вызовов: Начальный парковочный слот и Конечный парковочный слот.
MikoPBX предлагает два вида переводов: Условный и Безусловный (слепой).
При использовании условного перевода Вы можете поговорить с человеком прежде, чем переадресовать вызов. Вызывающий абонент находится в это время на удержании. После того как человек, который переадресовывает вызов, вешает трубку, переадресация успешно завершается.
Если вы переведете вызов, не поговорив предварительно с коллегой, то этот перевод Безусловный. Например, если вам поступает второй входящий звонок, а Вы уже разговариваете по телефону. Чтобы не прерывать текущий вызов, Вы переводите новый вызов на свободного коллегу.
По умолчанию комбинация для условного перевода - две решетки
По умолчанию комбинация для безусловного перевода - две звездочки
Время возврата вызова если нет ответа после безусловного (слепого) перевода - 45 сек.
Если звонит телефон коллеги, то есть возможность перехватить вызов набрав *8<НомерКоллеги>. Если номер коллеги не известен, то можно просто набрать *8.
Session Initiation Protocol (SIP) является сигнальным протоколом, используемым большинством телефонов VoIP. Вы можете изменить SIP-порт(по умолчанию порт 5060) для повышения безопасности. Кроме того, некоторым SIP провайдерам необходимы дополнительные параметры, такие как Периоды регистрации (Время через которое регистрация будет сброшена). Некоторые брандмауэры закрывают порты после периода неактивности. Такое поведение может потребовать сократить время ожидания регистрации SIP провайдеров. Другой причиной может быть необходимость в различных тайм-аутах при регистрации некоторых SIP-провайдеров. Значения по умолчанию:
SIPMiniExpiry - минимальная продолжительность регистрации в секундах, по умолчанию 60 секунд;
SIPMaxExpiry - максимальная продолжительность регистрации в секундах, по умолчанию 3600 секунд.
В режиме реального времени Transport Protocol (RTP) определяет стандартный формат для передачи аудио и видео по IP-сетям. По умолчанию, RTP использует диапазон портов между 10000 и 10200. Для некоторых маршрутизаторов и брандмауэров, возможно, потребуется настроить диапазон портов. Еще одна причина для настройки диапазона портов - большое количество параллельных звонков. Каждый вызов использует два RTP порта. Это означает,что если есть 200 портов, то возможно только 100 параллельных звонков. Если ваша телефонная система должна обрабатывать больше звонков в одно и то же время, необходимо расширить диапазон портов.
«Адрес STUN сервера» - в ряде случаев, к примеру при использовании WebRTC помогает при работе АТС за NAT.
«Использовать WebRTC» - будут произведены дополнительные настройки для работы с WebRTC соедиением. К примеру для внутреннего номера 201 будет создан дополнительный endpoint, подключиться к которому будет возможно по протоколу WebRTC с использованием URL
sip:201-WS@IP_PBX
Настройка разрешенных кодеков для АТС в целом.
Asterisk Manger Interface (AMI) — мощный и удобный программный интерфейс (API) Asterisk для управления системой из внешних программ. Благодаря AMI внешние программы могут осуществлять соединения с Asterisk посредством TCP протокола, инициировать выполнение команд, считывать результат их выполнения, а так же получать уведомления о происходящих событиях в реальном времени. AMI часто используют для интеграции с бизнес-процессами и системами, программным обеспечением CRM (Customer Relationship Managment — управление взаимодействия с клиентами). AMI принимает подключения, устанавливаемые на сетевой порт (по умолчанию - TCP порт 5038). Клиентская программа подключается к AMI через этот порт и аутентифицируется, после этого Asterisk будет отвечать на запросы, а также отправлять извещения о изменениях состояния заданных подсистем. Asynchronous Javascript Asterisk Manager (AJAM) - это новая технология, которая позволяет веб-браузерам или другим приложениям с поддержкой HTTP и веб-страницам напрямую обращаться к интерфейсу Asterisk Manager (AMI) через HTTP/HTTPS. По умолчанию используется порт 8088.
SSH или Secure Shell — это зашифрованный протокол, который часто используется для взаимодействия и удаленного управления серверами. SSH сервер может выполнять аутентификацию пользователей с помощью различных алгоритмов. Самый популярный — это аутентификация по паролю. Он достаточно прост, но не очень безопасный. Пароли передаются по безопасному каналу, но они недостаточно сложны для противостояния попыткам перебора. Вычислительная мощность современных систем в сочетании со специальными скриптами делают перебор очень простым.
Авторизация через SSH-клиент по умолчанию в MikoPBX:
Логин - root
Пароль - admin, рекомендуем сразу изменить это значение
Существует более безопасный и надежный способ аутентификации — ключи SSHа. Каждая пара ключей состоит из открытого и закрытого ключа. Секретный ключ сохраняется на стороне клиента и не должен быть доступен кому-либо еще. Утечка ключа позволит злоумышленнику войти на сервер, если не была настроена дополнительная аутентификация по паролю.
Мы настоятельно рекомендуем отключить аутентификацию по паролю. Для этого активируйте опцию «Отключить авторизацию по паролю»
Открытый ключ используется для шифрования сообщений, которые можно расшифровать только закрытым ключом. Это свойство и используется для аутентификации с помощью пары ключей. Открытый ключ загружается на удаленный сервер, к которому необходимо получить доступ. Его нужно добавить в специальный файл ~/.ssh/authorized_keys.
Когда клиент попытается выполнить проверку подлинности через этот ключ, сервер отправит сообщение, зашифрованное с помощью открытого ключа, если клиент сможет его расшифровать и вернуть правильный ответ — аутентификация пройдена.
Публичный(открытый) SSH-ключ можно сохранить на АТС в поле SSH Authorized Keys. Если у Вас несколько публичных ключей, то их можно скопировать подряд, разделитель - пустая строка.
В данном подразделе для повышения безопасности Вы можете изменить HTTP-порт (по умолчанию порт 80) или активировать режим HTTPS. HTTPS (HyperText Transfer Protocol Secure) — расширение протокола HTTP для поддержки шифрования в целях повышения безопасности. Данные в протоколе HTTPS передаются поверх криптографических протоколов SSL или TLS. В отличие от HTTP с TCP-портом 80, для HTTPS по умолчанию используется TCP-порт 443.
Редирект на HTTPS - при попытке открыть web интерфейс по протоколу http пользователь будет переадресован на HTTPS
При начале работы системы АТС сама генерирует сертификат для работы по https - это «самоподписанный» сертификат, то есть не заверенный публичным «регистратором», но тем не менее этот сертификат позволяет работать по https и шифровать трафик между АТС и браузером.
В данном подразделе необходимо изменить Логин WEB-интерфейса и Пароль WEB-интерфейса.
Авторизация в MikoPBX по умолчанию:
Логин - admin
Пароль - admin
Введем IP адрес АТС MikoPBX в браузере и перейдем в Система → Почта и уведомления.
Настройки SMTP клиента для сервиса Yandex:
SMTP хост - smtp.yandex.ru
SMTP Порт - 465 (Порт для обслуживания клиентов)
Адрес отправителя и Логин - E-mail с которого будут отправляться сообщения о пропущенных вызовах
Пароль - пароль от электронной почты, необходимый для авторизации
Метод шифрования - Использовать TLS
Осуществим отправку тестового письма на электронную почту любого сервиса. В случае успешного тестирования на указанный Вами адрес электронной почты придет тестовое письмо.
Для большей безопасности следует использовать «». Не используйте основной пароль от почтового ящика.
Для получения уведомлений о пропущенных вызовах по электронной почте необходимо настроить SMTP-клиент. Подробная информация об уведомлениях в MikoPBX рассмотрена . В рамках данной инструкции будет рассмотрен пример настройки уведомлений о пропущенных вызовах для почтового сервиса Mail.
О том, как настроить шаблон письма для создания e-mail уведомлений вы можете прочитать .
Всегда используйте «Пароли приложений» для авторизации. . smtp от Gmail
Для получения уведомлений о пропущенных вызовах по электронной почте необходимо настроить SMTP-клиент. Подробная информация об уведомлениях в MikoPBX рассмотрена . В рамках данной инструкции будет рассмотрен пример настройки уведомлений о пропущенных вызовах для почтового сервиса Gmail.
Сохраним введенные настройки и перейдем к настройке Вашего почтового аккаунта. Особенностью сервиса Gmail является то, что к Вашему аккаунту автоматически запрещен доступ ненадежным приложениям, к которым относится MikoPBX, поэтому необходимо вручную разрешить доступ к данным приложениям (инструкции по настройке размещены ).
О том, как настроить шаблон письма для создания E-mail уведомления вы можете прочитать .
Для добавления новой учетной записи необходимо указать Имя пользователя и Пароль. Кроме того, необходимо задать Сетевой фильтр, т.е. из какой подсети разрешено подключение к пользователю AMI. Вы можете разрешить подключения с любых адресов, либо указать конкретную сеть, настройку который Вы произвели в разделе Сеть и Firewall → .
Идентификатор прав | Чтение | Запись |
---|
Как создать ключ для авторизации по SSH и добавить его на сервер? Подробности читайте .
Для получения уведомлений о пропущенных вызовах по электронной почте необходимо настроить SMTP-клиент. Подробная информация об уведомлениях в MikoPBX рассмотрена . В рамках данной инструкции будет рассмотрен пример настройки уведомлений о пропущенных вызовах для почтового сервиса Yandex.
по настройки smtp. Для большей безопасности следует использовать «». Не используйте основной пароль от почтового ящика.
О том, как настроить шаблон письма для создания e-mail уведомлений вы можете прочитать .
System | Чтение общей информации о системе, например, уведомления о перезагрузке конфигурации | Позволяет пользователю выполнять Asterisk системы управления такими командами, как Restart, Reload, или Shutdown. Это разрешение также предоставляет пользователям возможность запускать системные команды за пределами Asterisk. Предоставление такого разрешения эквивалентно предоставлению доступа к командной оболочке, с правами пользователя / группы, под которыми запущен процесс Asterisk |
Call | Чтение события о каналах в системе | Позволяет пользователю устанавливать информация на каналах |
Log | Предоставляет пользователю доступ к чтению логов | Только чтение |
Verbose | Предоставляет пользователю доступ к чтению подробных логов | Только чтение |
Agent | Чтение событий статуса агентов из app_queue и chan_agent модулей | Позволяет пользователю выполнять действия для управления и получения состояния очередей и агентов |
User | Доступа к пользовательским событиям, а также событиям Jabber / XMPP пользователей | Позволяет пользователю выполнять команду UserEvent, для создания пользовательских событий |
Config | Только для записи | Позволяет пользователю получать, обновлять и перегружать файлы конфигурации |
Command | Только для записи | Позволяет пользователю выполнять команды Asterisk CLI из AMI |
Dtmf | Позволяет пользователю получать события DTMF | Только чтение |
Reporting | Доступ к событиям качества звонка, таким как jitterbuffer или RTCP | Позволяет пользователю выполнять ряд действий для получения статистики и информации о состоянии всей системы |
Cdr | Чтение событий записи данных в CDR | Только чтение |
Dialplan | Чтение событий установки переменных диалплана, создания экстенов | Только чтение |
Originate | Только для записи | Разрешение пользователю выполнять команду Origitate, которая отправляет запрос на создание нового звонка |
Перейдите в раздел «Общие настройки» -> "Удаление настроек системы"
В поле ввода вставьте текст "удалить всё", нажмите "Сохранить"
Откройте консольное меню MikoPBX. С клавиатуры введите 9 для перехода в консоль АТС.
Введите последовательно две команды:
После выполнения данных команд MikoPBX перезагрузится. Вход в web-интерфейс происходит с логином (admin) и паролем (admin) по умолчанию.
При публикации АТС на публичном IP адресе возникает задача по защите АТС от сканеров, вредителей, кто пытается подобрать пароли к SIP учетным записям АТС. Если установлен простой числовой пароль, то он будет подобран очень быстро, что повлечет убытки.
Для базовой защиты от сканеров обязательно следует включить fail2ban. Дополнительно, можно более тонко настроить правила iptables.
Перейдите в раздел "Кастомизация системных файлов"
Перейдите к редактированию файла /etc/firewall_additional
Установите режим "Добавлять в конец файла", вставьте следующий код:
Добавленное правило позвонил блокировать все входящие запросы по UDP протоколу, которые содержать подстроку «friendly-scanner»
Более полный пример набора правил:
Это обезопасит от большинства сканеров, которые при запросе упоминаю User-Agent.
MikoPBX установлена на отдельно выделенный сервер по инструкции. В качестве дополнительного диска для хранения записей разговоров (диск storage) подключен 4-ый раздел основного диска (/dev/sda4), где установлена MikoPBX. Свободное место на 4-ом разделе диска закончилось. Необходимо подключить к MikoPBX в качестве диска storage отдельный диск (/dev/sdb) и перенести на него все записи разговоров, которые ранее хранились на 4-ом разделе основного диска.
Подключитесь к MikoPBX через SSH-клиент по инструкции
Отключаем storage диск «sda4»:
Увеличить размер диска позволяют некоторый виртуальные машины
Перед работами обязательно выполните резервное копирование данных!
Для выполнения предложенных далее команд потребуется Подключение к АТС с помощью SSH-клиента.
Диск для хранения данных обычно монтируется в каталог «/storage/usbdisk1». Из примера выше видно, что на текущий момент доступно 4.5G из 4.9G.
Перед началом работ следует отмонтировать диск. Для этого запустите скрипт:
Убедитесь, что диск для хранения данных более не смонтирован:
Для начала удалим существующий раздел. Эта операция НЕ удаляет данные на диске, просто правит таблицу разделов.
Запускаем редактор разделов:
Система запросит ввести команду, вводим «d» и жмем Enter:
Система запросит выбрать раздел к удалению, он один, вводим номер раздела «1» и жмем Enter:
Сохраняем таблицу разделов, вводим команду «w» и жмем Enter:
Запускаем редактор разделов:
Система запросит ввести команду, вводим «n» и жмем Enter:
Далее указываем команду «p», раздел будет первичным, жмем Enter:
Вводим номер создаваемого раздела «1», жмем Enter:
Далее система запросит ввести номера первого и последнего сектора «First sector» / «Last sector», ждем Enter, ничего не вводим и соглашаемся со значениями «по умолчанию».
Размер раздела должен соответствовать размеру диска.
Запускаем команду проверки:
Пример результата работы команды:
Запускаем команду:
Пример вывода команды:
При загрузке система автоматически смонтирует диск для хранения данных:
При работе с поставщиками услуг связи периодически могут возникать проблемы. К примеру сервер поставщика не отвечает / не доступен. В рамках данной статьи будет предложен механизм оповещения на email системного администратора.
Подключитесь к АТС с помощью SSH-клиента
Создадим каталог для хранения скриптов:
Создадим новый файл nano:
При добавлении на АТС нового Сотрудника на АТС заводится учетная запись SIP с числовым внутренним номером. В ряде случаев, в целях безопасности есть необходимость изменить имя для авторизации этого сотрудника.
При настройке SIP Клиентов часто можно увидеть два ключевых параметра:
Username - обычно равен ID учетной записи, в случае с MikoPBX равен внутреннему номеру
Auth Username - имя пользователя для авторизации. В случае MikoPBX равен внутреннему номеру
Для изменения имени авторизации:
Откройте учетную запись сотрудника на редактирование
Перейдите к «Расширенным настройкам» → «Дополнительные параметры SIP»
Добавьте следующие строчки:
Вместо MIKO204 укажите имя для авторизации, желательно использовать и буквы и цифры
Бывают случаи, когда при телефонном звонке очень тихо слышно клиента и на телефонном аппарате / софтфоне нет возможности повысить уровень громкости. Опишем способ, который может помочь в решении проблемы:
Перейдите в раздел "Система" -> "Кастомизация системных файлов"
Откройте на редактирование modules.conf
Добавьте в конец файла
Сохраните изменения
Откройте на редактирование файл extensions.conf
Добавьте следующий код в конец файла:
Сохраните изменения.
Откройте на редактирование файл features.conf
Добавьте в конец файла следующий код:
Сохраните изменения.
Громкость по умолчанию станет выше, значение 5 вместо 0. При желании сотрудник может набрать #1 для увеличения громкости или #0 для уменьшения.
Запустите скаченную программу. У вас откроется главное меню.
Перейдите в раздел «Соединение» - «Данные»
«Имя пользователя для автовхода» укажите root
«Строка типа терминала» укажите xterm-256color
Перейдите в раздел «Кодировка»
«Кодировка» - укажите UTF-8
Установите флаг «Включить рисование линий VT100 даже в режиме UTF-8»
Перейдите в раздел «Сессия» - «Журнал». Тут можно настроить вывод в файл:
Перейдите в раздел "Сеанс"
9. Необходимые данные:
Имя хоста (или IP-адрес)- IP адрес АТС
Порт - порт для подключения по SSH по умолчанию 22
Введите имя сессии и сохраните ее настройки
В дальнейшем используйте действие «Загрузить» для использования сохраненной ранее сессии
Выполните действие «Соединиться» для подключения к АТС и введите пароль SSH
Перед подключением вам необходимо разрешить авторизацию по паролю в веб-интерфейсе MikoPBX, а так же задать пароль для подключения: для этого перейдите "Общие настройки" -> "SSH"
После ввода пароля SSH, у вас откроется меню АТС
Для открытия консоли перейдите в "[9] Console(Shell)"
Скачайте программу для подключения по SSH. Это можно сделать на официальном сайте по
Задача: На АТС заведено несколько провайдеров А,Б,В,Г… Вызов поступает на MikoPBX через провайдера А. При наборе мобильного номера сотрудника вызов должен также идти через провайдера А. Провайдер должен поддерживать более одного одновременного вызова.
Перейдите в раздел Система → Кастомизация системных файлов
Откройте для редактирования конфигурационный файл extensions.conf.
Установите режим «Добавлять в конец файла». В черное окно добавьте следующий фрагмент кода:
Для каждого провайдера необходимо описать исходящий маршрут
Заполните для сотрудников мобильные номера см. документацию
Ограничьте использование исходящих маршрутов для пользователей, используйте модуль «Группы пользователей»
Теперь если выходящий вызов направить на мобильный сотрудника, к примеру через IVR меню, то вызов будет направлен через того же провайдера, через которого пришел
ВНИМАНИЕ: Инструкции актуальны только для MikoPBX 2022.2.96+
Скачайте установщик программы WinSCP с официального сайта по ссылке
Установите программу
В случае, если ранее вы подключались к MikoPBX по SSH соединению с помощью PuTTYб программа сразу предложит импортировать соединение
Если же подключения не было - нужно заполнять данные вручную
Имя хоста - IP адрес MikoPBX Порт - порт для подключения по SSH по умолчанию это 22 Имя пользователя - всегда нужно указывать root Пароль - SSH пароль от Вашей MikoPBX
Перед подключением вам необходимо разрешить авторизацию по паролю в веб-интерфейсе MikoPBX, а также задать пароль для подключения: для этого перейдите "Общие настройки" -> "SSH"
Для подключения нажмите "Войти"
После успешного подключения у вас откроется корневая папка MikoPBX
Перейдите к редактированию файла "modules.conf"
Добавьте в конец файла следующий код:
Перейдите к редактированию файла "extensions.conf"
Добавьте в конец файла следующий код:
В карточке сотрудника, в поле «Расширенные настройки» - «Дополнительные параметры» установите значение
Если сотрудник будет занят, то звонящему будет проигран файл beep (короткий гудок), затем вместо гудков будет проигрываться музыка, пока сотрудник не ответит на вызов
device_state_busy_at - это то количество разговоров, при котором следует считать сотрудника «занятым», в этом случае начнут работать правила «Настройки маршрутизации», описанные в карточке сотрудника.
В случае некорректной работы решения задачи, измените код в extensions.conf на:
Обязательное требование: необходим доступ в интернет! ПК где запускается MikoPBX должен имеет доступ к следующим адресам: lic.miko.ru:443 lm.miko.ru:443
Убедитесь, что наши ресурсы включены в список доверенных в антивирусе / брандмауэре или прочем софте.
Если Вы испытываете проблемы при подключении MikoPBX, и в логах отображаются ошибки, связанные с лицензированием SaaS, то Вам необходимо выполнить следующие проверки:
Если Вы используете Прокси сервер, то отключите проксирование запросов на lic.miko.ru:443 и lm.miko.ru:443 по https протоколу.
Выполните команды:
Выполните команды:
Выполните команды:
Выполните команду:
Перейдите в раздел
Проверьте, открывается ли у Вас сайт или .
Подключитесь к АТС с помощью SSH-клиента по .
Результат выполнения выше описанных проверок пришлите нам через .
Перейдите в раздел Система → Кастомизация системных файлов.
Откройте для редактирования конфигурационный файл extensions.conf.
Установите режим "Добавлять в конец файла" и вставьте следующий код:
Белый список номеров иногда требуется описать для конкретных провайдеров:
ID-ПРОВАЙДЕРА - значение, которое вы можете найти в адресной строке в момент конфигурации провайдера
При настройке входящей маршрутизации часто возникает ситуация, когда провайдер предоставляет учетную одну запись SIP для нескольких купленных номеров телефонов.
К примеру у МИКО есть номера телефонов:
+7(495)229-30-42
+7(499)638-25-84
В интерфейсе MikoPBX создана только одна учетная запись «Провайдер телефонии». Каждый номер телефона необходимо направить на свой маршрут, к примеру на различные IVR.
Тут к приходит на помощь DID номер, который провайдер может передавать при входящих звонках. Зная DID номер, можно для провайдера описать несколько входящие маршрутов, с различными DID, что позволит решить описанную выше задачу.
Для анализа звонков я обычно использую «приложение Sngrep». Вот пример запроса от провайдера при входящем:
При получении такого пакета, MikoPBX проанализирует первую строку с ключевым словом «INVITE», значение «84996382584» и будет являться DID номером.
На практике, не всегда все так просто. К примеру я встречал провайдера, который присылает следующий INVITE:
В этом случае в строке «INVITE» описывается логин учетной записи, в вот DID уже описывается в заголовке «To». Для корректной настройки достаточно в разделе Кастомизация системных файлов добавить в конец файла «extensions.conf» следующие строки:
функция «PJSIP_HEADER» считывает значение заголовка «To»
функция «PJSIP_PARSE_URI» получает из значения заголовка поле «user», которое соответствует значению DID
Gosub перемещает канал в начало, для повторной инициализации маршрута
SIP-1622040384 - это ID учетной записи провайдера MikoPBX, можно подсмотреть в адресной строке браузера при редактировании учетной записи
Такое встречается при использовании сервиса roistat. Сервис при входящем может прислать следующий запрос:
Корректного DID нет ни в INVITE, ни в поле To, но при этом появился новый заголовок «x-roistat-phone».
Для корректной настройки достаточно в разделе Кастомизация системных файлов добавить в конец файла «extensions.conf» следующие строки:
функция «PJSIP_HEADER» считывает значение заголовка «x-roistat-phone»
Gosub перемещает канал в начало, для повторной инициализации маршрута
Получение номера, на который позвонил клиент из поля «Diversion»:
Получение номера, на который позвонил клиент из заголовка «CALLED_DID»:
Подключитесь к вашей АТС по SSH (инструкция)
Выполните команду:
Воспроизведите Вашу ситуацию, выполните телефонный звонок. Далее нажмите в SSH консоли CTRL + С. Работа приложения tcpdump будет завершена.
Подключитесь к АТС с помощью WinSCP (инструкция)
Лог вызова /tmp/capturefilename.pcap отправляйте в техническую поддержку
Такая необходимость может возникнуть во многих случаях, К примеру когда клиент устал ждать на линии, можно предложить ему оставить голосовое сообщение, соединить с известным клиенту внутренним номером.
Перейдите во вкладку "Кастомизация системных файлов"
Откройте для редактирования файл "queues.conf"
В черном окне найдите секцию очереди, которую необходимо настроить
Выберите режим "Добавлять в конец файла". Добавьте аналогичную секцию с приставкой (+) :
В данном примере мы описали контекст internal, разрешен набор всех внутренних номеров. Можно указать контекст IVR меню, в формате ivr<ВнутреннийНомерIVR>
При подключении к MikoPBX более одного провайдера может сложится ситуация, что номер телефона клиентов поступает в различном формате:
В 7и значном виде - 2293042
Через «+», к пример +79257184444
Через «8», к примеру 89257184444
Появляется необходимость привести все к одному формату.
Перейдите в раздел Маршрутизация → Провайдеры телефонии. Откройте для редактирования учетную запись провайдера для редактирования. Скопируйте в адресной строке ID провайдера, через которого абоненты звонят Вам в компанию. Обращаем Ваше внимание, что в нашем примере используется единственный провайдер. Если у Вас настроено подключение нескольких провайдеров, то ниже описанные действия необходимо выполнить для каждого провайдера.
В нашем примере ID провайдера принимает вид: SIP-1687947415
Перейдите в раздел Система → Кастомизация системных файлов.
Откройте для редактирования конфигурационный файл extensions.conf.
Выберите режим "Добавлять в конец файла". В черное окно добавьте следующий фрагмент кода:
В выше приведенном фрагменте кода Вам необходимо составить правильное наименование контекста. Формат создаваемого контекста:
ID-ПРОВАЙДЕРА - значение, которое вы сохранили на первом шаге данной инструкции. В нашем примере это SIP-1687947415.
Обращаем Ваше внимание, если у Вас в MikoPBX подключено несколько провайдеров, выше описанный фрагмент кода нужно составить для каждого провайдера, учитывая уникальность ID каждого из провайдеров.
Если необходимо добавить нормализацию для всех провайдеров сразу, то достаточно описать контекст «add-trim-prefix-clid-custom». Пример, все 10ти значным АОН добавить 7ку:
В MikoPBX в разделе Маршрутизация → Нерабочее время настроены правила маршрутизации вызовов в нерабочее время. Данные правила распространяются на все вызовы, независимо от того на какой номер компании позвонил клиент. Необходимо для провайдера Zadarma настроить индивидуальное нерабочее время. Рабочее время для данного провайдера: с 9.00 до 18.00 по МСК.
Перейдите в раздел Модули → Приложения диалпланов. Создайте новое приложение (диалплан Asterisk) по инструкции. Параметры приложения принимают вид:
Программный код созданного приложения:
Команда ExecIfTime выполняет указанное приложение Asterisk, если текущее время соответствует заданной спецификации времени. Если нам позвонят с 9:00 до 18:00 в любой будний день (с понедельника по пятницу), то мы перенаправляем вызов (команда Goto) на номер 2003. 2003 - это номер IVR-меню.
Иначе вызов направится сотруднику с внутренним номером 201.
Настраиваем правила входящей маршрутизации для созданного провайдера. Переходим в раздел Маршрутизация → Входящие маршруты. Направляем все входящие вызовы на созданное приложение.
Найдите и скопируйте ID-провайдера. Чтобы это сделать - перейдите в конфигурацию необходимого провайдера. В нашем примере - это SIP-1687941868
Перейдите в раздел Система -> Кастомизация системных файлов
Откройте для редактирования конфигурационный файл extensions.conf.
Установите режим «Добавлять в конец файла». В черное окно добавьте следующий фрагмент кода:
В выше приведенном фрагменте кода Вам необходимо составить правильное наименование контекста. Формат создаваемого контекста:
ID-ПРОВАЙДЕРА - значение, которое вы сохранили на втором шаге данной инструкции. В нашем примере это SIP-1687941868.
Рабочее время с 9.00 до 18.00, следовательно необходимо задать два интервала для нерабочего времени: 00:00-09:00 и 18:00-23:59.
Более подробно разберём команду ExecIfTime. Эта команда выполняет указанное приложение Asterisk, если текущее время соответствует заданной спецификации времени. В нашем случае команда выполняет проигрывание звукового файла, расположенного в директории /offload/asterisk/sounds/other/out_work_times в MikoPBX. Синтаксис команды:
times - Диапазоны времени в 24-часовом формате
weekdays - Дни недели (mon, tue, wed, thu, fri, sat, sun)
mdays - Дни месяца (1-31)
months - Месяцы (jan, feb, mar, apr и т. д.)
appname[(appargs)] - команда Asterisk с указанием параметров вызова
В нашем примере указаны диапазон времени, диапазон дней недели. Вместо указания дней месяцев и месяцев введены *. Этот символ означает «для всех остальных случаев».
Установка в Yandex cloud произвольного образа MikoPBX
Для начала зарегистрируйтесь в сервисе Yandex Cloud.
Приступим к настройке
Откройте Все сервисы / Инфраструктура и сеть / Compute Cloud
Перейдите в раздел Виртуальные машины
На вкладке выберите Создать ВМ
Введите имя виртуальной машины, например vm-mikopbx
Укажите зону доступности
Укажите параметры вычислительных ресурсов виртуальной машины, исходя из ожидаемой нагрузки на АТС и вашего бюджета. Для тестовой машины можно указать Гарантированная доля vCPU - 20%, RAM - 1 Гб
Перед созданием виртуальной машины необходимо предварительно загрузить образ MikoPBX в облачное хранилище
Откройте Все сервисы / Инфраструктура и сеть / Object Storage
На вкладке Object Storage выберите Создать бакет
Введите имя нового бакета, например mikopbx-imgs
Укажите макс. размер 1 Гб
Для других полей используйте значения по умолчанию
Завершив ввод значений, нажмите кнопку Создать бакет
Откройте созданный бакет mikopbx-imgs
На открывшейся вкладке выберите Загрузить объекты
Выберите файл из дистрибутива MikoPBX с расширением .raw
Нажмите кнопку Загрузить
После завершения загрузки откройте загруженный объект
Выберите Получить ссылку и скопируйте ссылку на образ
Откройте Все сервисы / Инфраструктура и сеть / Compute Cloud
Перейдите в раздел Образы
На вкладке выберите Загрузить образ
Введите имя образа, например mikopbx-img
В поле Ссылка на образ в Object Storage укажите скопированную ранее ссылку на образ АТС
Нажмите кнопку Загрузить
Вернемся к выбору образа на вкладке Все сервисы / Инфраструктура и сеть / Compute Cloud / Виртуальные машины
В разделе Выбор образа/загрузочного диска выберите Свой образ / Выбрать / Наполнение - Образ / mikopbx-img
В разделе Диски и файловые хранилища скорректируйте размер загрузочного диска до 1 Гб
Для развертывания АТС используйте два диска:
диск объемом 1 Гб для основной системы
диск объемом 50+ Гб для хранения записей разговоров
В разделе Диски и файловые хранилища выберите Добавить диск
На открытой вкладке введите имя диска для хранения данных, например storage-mikopbx
Укажите тип диска HDD
Укажите размер диска не менее 50 Гб
Наполнение - Пустой
Для других полей на вкладке используйте значения по умолчанию
Нажмите кнопку Добавить
В разделе Сетевые настройки выберите существующую или создайте новую облачную сеть
В поле Подсеть в выпадающем меню выберите Добавить подсеть
На открытой вкладке введите имя подсети, например local-mikopbx
В поле CIDR укажите диапазон адресов, например 172.16.32.0/24
Для других полей на вкладке используйте значения по умолчанию
Нажмите кнопку Создать
Публичный адрес и Внутренний IPv4-адрес оставьте в положении Автоматически
В разделе Доступ укажите Сервисный аккаунт
Введите Логин и SSH-ключ, предварительно сгенерированный по инструкции
В разделе Дополнительные настройки установите флажок Разрешить доступ к серийной консоли
Завершив ввод значений, нажмите кнопку Создать ВМ
Дождитесь запуска созданной виртуальной машины, обычно первый запуск занимает 6-8 минут. Статус Running, еще не означает что система полностью развернулась
Откройте созданную виртуальную машину и перейдите в раздел Серийная консоль
Скопируйте внешний адрес созданной виртуальной машины и введите его в строке браузера
Для входа используйте указанные во вкладке Серийная консоль логин и пароль
Имя хоста - это имя машины. Если значение не указано, то используется имя mikopbx.local.
Существует два способа настроить IP-адрес в MikoPBX:
DHCP (Dynamic Host Configuration Protocol) - это протокол, который позволяет автоматически настраивать IP-адрес. Рекомендуется использовать этот способ, если вы не хотите заниматься ручной настройкой. Просто включите опцию "Использовать DHCP для получения настроек сети" и система автоматически получит IP-адрес от DHCP сервера.
Ручная настройка - если вы не хотите использовать DHCP или хотите задать IP-адрес вручную, вы можете выполнить ручную настройку сети. Для этого вам понадобятся некоторые знания о топологии сети. В поле IP-адрес введите желаемый IP-адрес, а рядом с ним укажите маску подсети в формате CIDR. Например, /24 соответствует маске подсети 255.255.255.0.
"VLAN ID" - Кроме того, MikoPBX поддерживает виртуальные сетевые интерфейсы, известные как VLAN. Эта функция особенно полезна, если у вас есть только один физический сетевой интерфейс, но вам требуется использовать несколько виртуальных интерфейсов. С помощью VLAN можно создать виртуальные интерфейсы, которые работают поверх физического интерфейса. Преимуществом использования VLAN является возможность направлять телефонные разговоры через него, в то время как сетевое оборудование может осуществлять отдельную обработку трафика VLAN, обеспечивая стабильное соединение.
Важно отметить, что количество сетевых интерфейсов в MikoPBX не ограничено, и вы можете настроить и использовать несколько интерфейсов в соответствии с вашими потребностями.
"Сетевой интерфейс с доступом в интернет" - это основной интерфейс, через который MikoPBX будет получать доступ к внешним адресам, то есть адресам вне вашей локальной сети.
Если вы не указали адрес DNS-сервера, MikoPBX будет использовать сервер 8.8.8.8 по умолчанию. DNS-серверы отвечают за преобразование доменных имен в IP-адреса, позволяя устройствам находить нужные ресурсы в сети.
В зависимости от топологии вашей сети, вам потребуется выполнить определенные настройки MikoPBX. Вариант, когда АТС находится за сетевым маршрутизатором, является наиболее распространенным. Это означает, что MikoPBX подключена к вашей локальной сети, и для доступа к интернету используется маршрутизатор. Другой вариант - АТС находится на публичном IP, то есть имеет прямой доступ к интернету без промежуточного маршрутизатора.
В обоих случаях необходимо настроить MikoPBX соответствующим образом, чтобы обеспечить правильное функционирование и доступ к внешним ресурсам.
Если АТС находится за маршрутизатором, то необходимо установить галку «Эта станция расположена за NAT маршрутизатором»
Если нам известен внешний адрес станции (ip или доменное имя)и проброшены порты АТС во внешний мир, то имеет смысл заполнить поля «Внешний IP адрес Вашего маршрутизатора» или «Внешнее имя хоста вашего маршрутизатора».
Всем адресам, которые не являются для АТС локальными, станция будет представляться внешним адресом:
Если «Внешний IP адрес Вашего маршрутизатора» пустое, а «Внешнее имя хоста вашего маршрутизатора» заполнено, то АТС будет представляться именно этим полем (Внешнее имя).
Внешний IP-адрес обязателен для заполнения. Если указано доменное имя - то приоритет за ним и Внешний IP адрес не используется.
Когда вы включаете опцию «Эта станция расположена за NAT маршрутизатором», важно указать внешний адрес или имя хоста вашего маршрутизатора. Это необходимо для правильной настройки связи между внешней сетью и вашей АТС. Помимо этого, на самом маршрутизаторе необходимо выполнить проброс портов SIP 5060 и RTP 10000-10200 на локальный адрес АТС. Проброс портов позволяет маршрутизатору правильно направлять сетевой трафик SIP и RTP к вашей АТС.
Однако, если ваш провайдер позволяет вам регистрироваться без использования NAT и у вас нет необходимости подключать внешних абонентов, то вы можете не включать опцию «Эта станция расположена за NAT маршрутизатором». Даже если ваша АТС находится за NAT-маршрутизатором, но вы не нуждаетесь во внешних подключениях, эта опция не обязательна.
Важно учитывать требования вашего провайдера и особенности вашей сети при выборе и настройке этой опции.
Перейдите в раздел Система → Кастомизация системных файлов.
Откройте для редактирования файл /etc/static-routes.
Выберите режим «Заменять полностью» и вставьте правило. Например, route add -net 54.246.198.136 netmask 255.255.255.255 gw 172.16.32.15 dev eth0
Для указания операционной системе, какой сетевой интерфейс (в данном случае eth0) использовать для поиска IP-адреса 54.246.198.136, а также для указания шлюза (gateway) для направления запроса (в данном случае 172.16.32.15), мы задаем соответствующие значения в настройках сетевого правила.
Маска подсети "255.255.255.255" указывает, что данное правило будет применимо только к конкретному IP-адресу 54.246.198.136. Если вам необходимо создать правило для группы адресов, например, для всей подсети 54.246.198.0, то фактически это охватывает диапазон адресов от 54.246.198.1 до 54.246.198.254.
Таким образом, указывая сетевой интерфейс и шлюз в сетевых настройках, вы определяете, какую сеть и через какой маршрут направлять соответствующие запросы и коммуникацию. Это важно для настройки сетевого взаимодействия и обеспечения правильной маршрутизации трафика в вашей сети.
Нажмите "Сохранить"