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...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Описание MikoPBX и разделов, которые вы сможете найти в документации. Вступление в документацию.
Добро пожаловать на ресурс документации по MikoPBX! Здесь вы сможете найти пошаговые инструкции, связанные с взаимодействием с АТС MikoPBX. Для вашего удобства, они собраны в разделы - прямо как в WEB-интерфейсе, поэтому ориентироваться в документации очень легко.
Благодарим вас за выбор MikoPBX!
MikoPBX - это бесплатный сервер телефонии с операционной системой и простым, удобным веб-интерфейсом. Она работает практически с любой телефонной технологией в мире.
MikoPBX — это полностью модульный интерфейс для Asterisk, написанный на PHP и Javascript. Это значит что в MikoPBX возможно реализовать абсолютно любой дополнительный функционал Asterisk телефонии. Более того, если вы разработаете полезный модуль, его можно поместить в общий репозиторий и сделать доступным для всех пользователей MikoPBX. Помимо этого, MikoPBX имеет очень низкие требования к аппаратному обеспечению ПК:
5 - 10
1 GHz x86-64, 512 MB RAM
До 25
3 GHz x86-64, 1 GB RAM
Более 25
2 CPUs 3 GHz x86-64, 2 GB RAM или больше
Для начала вам следует установить MikoPBX любым удобным для вас способом. Ниже находятся опции установки. Нажав на их название - вы можете перейти к подробным профильным статьям:
Установка на отдельный компьютер.
Установка в виртуальную машину.
Установка с помощью облачных сервисов.
Установка в Docker контейнере.
После установки вы можете перейти к изучению вашей станции. В этом вам поможет дальнейшая документация "Руководство пользователя", которая подробно рассказывает про конкретные разделы:
За дополнительной помощью по "быстрому старту", вы можете обратиться к данной статье.
В случае, если вы разобрались с базовой настройкой и эксплуатацией MikoPBX, Вы можете расширить ее функционал с помощью модулей.
Они позволяют добавить дополнительные функции вашей системы. Разобраться в них подробнее вы можете по шагам:
Регистрация в Маркетплейсе MikoPBX - здесь подробно описан процесс регистрации и его особенности.
Управление модулями - здесь подробно описан процесс установки и управления модулями.
Документация по конкретным модулям - в этом разделе вы найдете подробное описание каждого модуля, а так же шаги по его настройки и использованию.
В данной секции Вы можете найти ответы на интересующие вас вопросы, а так же решения, которые помогут вам расширить функционал базовых функций. Данная секция, так же, как и основная разделена на разделы для удобства поиска интересующих вас тем.
Если у вас возник вопрос, который не разобран в данном разделе - Вы можете обратиться за помощью в Telegram Community, где пользователи MikoPBX помогают друг другу решить вопросы и потребности, связанные с АТС.
Установка MikoPBX с помощью VMware ESXi.
Создаём новую виртуальную машину
Указываем Имя, Тип и Версию виртуальной машины, как показано на изображении ниже.
Выбираем хранилище для создания.
Для данной виртуальной машины выделяем объём оперативной памяти 1024 Мб. Создаём новый виртуальный жёсткий диск для основной системы размером 1024 Мб.
Выбираем тип контроллера 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 с помощью HyperV.
Выберите Действие / Создать / Виртуальная машина
На вкладке Укажите имя и местонахождение введите имя виртуальной машины, например mikopbx-vm
Перейдите к следующей вкладке Укажите поколение, выберите поколение - Поколение 1
На вкладке Выделить память выделите необходимый размер оперативной памяти, исходя из ожидаемой нагрузки на АТС. Для тестовой машины можно указать 2 Гб
Перейдите к вкладке Настройка сети, выберите заранее настроенное сетевое соединение
На вкладке Подключить виртуальный жесткий диск скорректируйте размер диска под систему до 1 Гб
На вкладке Параметры установки установите флажок Установить операционную систему с загрузочного компакт- или DVD-диска
Выберите Файл образа (.iso) и укажите ссылку на файл из дистрибутива MikoPBX с расширением .iso
Завершив ввод значений, нажмите кнопку Готово
Для развертывания АТС используйте два диска:
диск объемом 1 Гб для основной системы
диск объемом 50+ Гб для хранения записей разговоров
Перейдите к Параметрам созданной виртуальной машины
Выберите IDE контроллер, к которому подключен диск под систему
На открывшейся вкладке выберите Жесткий диск, нажмите кнопку Добавить
Нажмите кнопку Создать
На вкладке Выбор формата диска выберите формат - VHD
На вкладке Выберите тип диска укажите тип диска - Фиксированного размера
На вкладке Укажите имя и местонахождение укажите имя, например storage.vhd, и расположение диска
На вкладке Настройка диска задайте размер диска для хранения данных не менее 50Гб
Для других полей используйте значения по умолчанию
Завершите настройку, нажав кнопку Готово
Для запуска виртуальной машины нажмите Пуск
Перейдите к вкладке Подключить созданной виртуальной машины mikopbx-vm
Если загрузка прошла успешно, появится консольное меню. Введите с клавиатуры 8 для начала установки
Выберите диск под систему и введите с клавиатуры имя диска, например sdb. Подтвердите выбор, введите с клавиатуры y
Подключите диск для хранения записей разговоров, ведите с клавиатуры наименование диска для подключения, например sdc
После появления сообщения “Press any key within 30 seconds to boot from LiveCD…” не нажимайте никаких кнопок. В этом случае система загрузится с жесткого диска.
На открытой вкладке Подключить скопируйте внешний адрес созданной виртуальной машины и введите его в строке браузера
Для входа используйте логин - admin и пароль - admin
В данной статье Вы сможете найти инструкции по установке MikoPBX с помощью различных облачных сервисов.
MikoPBX поддерживает установку с помощью многих облачных сервисов. В данном разделе Вы можете найти подробные инструкции по ним. Нажмите на элемент в списке ниже для перехода к инструкции по конкретной виртуальной машине:
Варианты установки MikoPBX в Yandex Cloud
В сервисе Yandex Cloud есть возможность загрузить АТС MikoPBX из образа в маркетплейсе Яндекса или из образа на основе загруженного *.raw файла из дистрибутива MikoPBX (промежуточные релизы)
Установка 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 с помощью VK Cloud
Для начала авторизуйтесь на сайте
Приступим к настройке
Откройте Виртуальные сети / Сети
На вкладке Сети выберите Создать
Введите имя новой сети, например 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 с помощью 1С:Облачная инфраструктура
Для начала авторизуйтесь на сайте
Приступим к настройке
Откройте Виртуальные сети / Сети
На вкладке Сети выберите Создать
Введите имя новой сети, например 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 в Yandex Cloud с помощью утилиты yc
Утилита Yandex Cloud позволяет автоматизировать создание инстансов. Ее можно использовать в скриптах.
На странице продукта скопируйте значение image_id. В текущем примере fd83g1qbk6m3jnl5cvah (для версии 2022.3.15). Идентификатор образа следует укзаать в параметре create-boot-disk image-id
Получим список каталогов
Выбираем каталог и указываем его имя в параметре folder-name
Список зон
Описываем зону в параметре zone
Запускаем инстанс
Список инстансов обновится
Используйте EXTERNAL IP для входа и ID в качестве пароля для пользователя admin web интерфейса
Установка MikoPBX с помощью Hetzner Cloud
Установка в 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 с помощью AWS
Самый простой способ установки MikoPBX - установка готового образа из AWS Marketplace, если вы хотите запустить нестандартную версию MikoPBX, то воспользуйтесь подробной инструкцией, где мы по шагам описали каким образом можно создать AMI образ из любого дистрибутива MikoPBX.
Установка MikoPBX с помощью VMware Fusion.
Создаем новую виртуальную машину.
После скачивания последней версии образа (ссылка), указываем 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"
В данной статье Вы сможете найти инструкции по установке MikoPBX с помощью различных виртуальных машин.
MikoPBX поддерживает установку с помощью многих виртуальных машин. В данном разделе Вы можете найти подробные инструкции по ним. Нажмите на элемент в списке ниже для перехода к инструкции по конкретной виртуальной машине:
Установка MikoPBX в AWS с помощью произвольного образа
Авторизуйтесь в сервисе 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
Установка MikoPBX с помощью образа из AWS Маркетплейса
Авторизуйтесь в сервисе Amazon Web Services https://aws.amazon.com
MikoPBX в AWS Маркетплейс: https://aws.amazon.com/marketplace/pp/prodview-ota6fb2tftuhw
Приступим к настройке
Для быстрого и удобного поиска в сервисе Amazon используйте панель поиска
Откройте Services / Compute / EC2 и перейдите в раздел Images / AMI Catalog
На открытой вкладке в поисковой строке введите MikoPBX
В разделе AWS Marketplace AMIs выберите образ MikoPBX, нажав кнопку Select
На открытой вкладке нажмите кнопку Subscribe now
Нажмите кнопку 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Гб
В разделе Network settings все необходимые правила Firewall настраиваются автоматически
Для других полей используйте значения по умолчанию
Нажмите кнопку Launch instance
Перейдите к созданной виртуальной машине mikopbx-vm
На открытой вкладке выберите Connect / EC2 serial console, дождитесь полной загрузки системы, пока не отобразятся параметры авторизации
Скопируйте внешний адрес созданной виртуальной машины и введите его в строке браузера
Для входа используйте указанные в EC2 serial console логин и пароль
Обязательно выполните настройку Firewall на самой АТС MikoPBX
Варианты установки MikoPBX в Google Cloud
Установка MikoPBX в Google Cloud может быть выполнена двумя способами: из образа в маркетплейсе Google Cloud или из образа на основе загруженного файла из дистрибутива MikoPBX. Первый способ обеспечивает быстрое и простое развертывание стандартной версии MikoPBX, а второй подходит для промежуточных релизов.
Установка MikoPBX в Google Cloud с помощью Маркетплейса
Авторизуйтесь на платформе
MikoPBX в Google Cloud Маркетплейс:
Приступим к настройке
Для быстрого и удобного поиска на платформе Google Cloud используйте панель поиска
Если у вас есть сервисная учетная запись, проверьте наличие нужных ролей, в случае необходимости добавьте их
Если сервисной учетной записи нет, создайте и добавьте ей нужные роли
Откройте Navigation menu / Products & solutions / Management / IAM & Admin
Перейдите к вкладке Service accounts и нажмите на CREATE SERVICE ACCOUNT
Введите имя сервисной учетной записи, например mikopbx-service-account
Нажмите кнопку CREATE AND CONTINUE
Добавьте роли Cloud Infrastructure Manager Agent, Compute Admin, Compute Network Admin, Service Account User
Нажмите кнопку DONE
Откройте Marketplace и введите в поисковой строке MikoPBX
На открытой вкладке выберите LAUNCH
В поле Deployment name введите имя, например mikopbx-vm
В разделе Deployment Service Account установите флажок Existing account и выберите созданный ранее сервисный аккаунт
Для развертывания АТС используйте два диска:
диск объемом 1 Гб для основной системы
диск объемом 50+ Гб для хранения записей разговоров
При необходимости измените размер диска для хранения данных в разделе Data Storage, по умолчанию его размер - 50Гб
В разделе Networking все необходимые правила Firewall настраиваются автоматически
Для других полей используйте значения по умолчанию
Завершив ввод значений, нажмите кнопку DEPLOY
Откройте вкладку Compute Engine и перейдите в раздел Virtual machines / VM Instance
Перейдите к созданной виртуальной машине mikopbx-vm-mikopbx-vm
На открытой вкладке перейдите к Logs / Serial port 1 (console)
Скопируйте внешний адрес созданной виртуальной машины и введите его в строке браузера
Для входа используйте указанные в Serial port 1 (console) логин и пароль
Установка MikoPBX с помощью Microsoft Azure.
Для начала авторизуйтесь на портале Microsoft Azure
Приступим к настройке
Для быстрого и удобного поиска на портале 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
Откройте созданную виртуальную машину и перейдите в раздел Подключение
В выпадающем меню Дополнительные способы подключения выберите Серийная консоль
Скопируйте внешний адрес созданной виртуальной машины и введите его в строке браузера
Для входа используйте указанные во вкладке Последовательная консоль логин и пароль
Установка MikoPBX с помощью Vscale
Скачайте актуальный образ системы с расширением .raw на
Выполните авторизацию на портале
Перейдите в раздел "Облако" - "Образы" - кликните по кнопке "Создать"
Выберите тип образа - "File" (п.1)
Формат образа - "raw" (п.3)
Операционная система - "Linux" (п.4)
Выберите файл для загрузки (п.2)
Кликните по кнопке "Создать" (п.5) и дождитесь завершения операции
Перейдите в раздел "Облако" - "Серверы" - кликните по кнопке "Создать"
Введите имя сервера
В поле "Флейвор" выберите конфигурацию сервера
Выберите загруженный ранее образ MikoPBX
Настройте два диска, первый на 5Гб, второй на 50Гб
В разделе "Сеть" - "Публичный IP" - выберите "Создать новый публичный IP"
В разделе "Доступ" задайте сложный пароль
Кликните по кнопке "Создать сервер" и дождитесь завершения операции
После создания сервера можно перейти к его статусу в разделе "Облако" - "Серверы"
Пароль для входа в вэб интерфейс по умолчанию устанавливается в значение, равному "instance-id", на текущий момент нет возможности получить этот идентификатор из web интерфейса Vscale.
Для получения пароля от web интерфейса в перейдите на вкладку "Логи":
Теперь можно перейти по публичному адресу и начать настройку АТС.
Установка MikoPBX с помощью Selectel
В данной инструкции мы пошагово произведем установку MikoPBX с помощью облачной платформы Selectel.
Перед началом вам необходимо скачать актуальный образ MikoPBX с расширением .raw. Сделать это можно по .
Перейдите в раздел Облачная платформа -> Образы.
Нажмите "Создать образ".
Укажите:
Имя образа - любое желаемое название для вашего образа.
ОС - Linux
Источник - Файл
Файл - выберите раннее загруженный файл с расширением .iso
Все остальное - по умолчанию.
Нажмите создать и дождитесь окончания процесса.
Перейдите в раздел Облачная платформа -> Серверы
Нажмите "Создать сервер":
В конфигурации вашей ВМ укажите:
Имя - произвольное название.
Пул - такой же, как у раннее созданного образа.
Источник - выберите раннее загруженный образ.
Конфигурация - желаемое "железо" исходя из ваших потребностей.
Диски: Здесь вам необходимо указать размер для первого диска (он же - системный диск) - 5Гб (минимально возможный в Selectel). А так же создайте новый диск, используя кнопку "Добавить". Укажите размер. Для диска, который используется для записи разговоров - рекомендуемое значение >50Гб. Типы дисков - "Базовый HDD"
Сеть - "Приватная + 1 публичный IP"
Нажмите "Создать сервер".
После создания, сразу остановите запуск сервера.
Перейдите в раздел Облачная платформа -> Сеть.
Перейдите в конфигурацию сети "Nat":
Перейдите в раздел Подсети -> Автоматические сетевые настройки.
Включите переключатель "DHCP-сервер".
Вернитесь к разделу Облачная платформа -> Серверы. Далее - в созданный сервер.
Включите сервер:
Перейдите в раздел "Syslog":
Произведите подключение по:
External IP Address - внешний IP-адрес вашей MikoPBX. Скопируйте и вставьте его в адресную строку.
Web credentials - данные для входа в WEB-интерфейс. Введите логин и пароль.
Выберите образ
Подготовка к установке MikoPBX в Docker-контейнер
Перед началом работы с Docker, необходимо установить сам Docker и Docker Compose. Вот как это можно сделать:
Перед созданием контейнера на хостовой машине необходимо создать пользователя и группу с ограничеными правами, а также папку для хранения настроек конфигурации и записей разговоров.
Команда для подключения к консоли АТС:
Команда для подключения к консольному меню АТС:
Подключение к shgrep для анализа SIP
Варианты установки MikoPBX в Docker контейнере
«Host система» должна быть запущена на базе Linux 5+. Тестировалось на Debian 11 и Ubuntu-21.04, Ubuntu Server 22.04 LTS
MikoPBX можно запустить в Docker, используя два основных способа. Первый способ включает в себя запуск контейнера напрямую через команду Docker с указанием необходимых параметров. Второй способ предусматривает использование Docker Compose, что упрощает управление многоконтейнерными приложениями и позволяет описать всю конфигурацию в yaml-файле, что делает развертывание и обслуживание системы более удобным.
Описание раздела телефонии MikoPBX
Глава "Телефония" в документации MikoPBX содержит подробную информацию и инструкции, связанные с настройкой и использованием телефонии в системе.
Сотрудники в MikoPBX — это индивидуальные пользователи системы, которым назначены внутренние номера для совершения и приема звонков. Они имеют персональные учетные записи, позволяющие настроить права доступа, переадресацию вызовов и другие персональные настройки в системе.
В данной статье Вы найдете подробную документацию по добавлению новых сотрудников в станцию, настройку их прав и профилей. Помимо этого, информацию про их дополнительные параметры.
Очереди вызовов в MikoPBX — это функция, позволяющая распределять входящие звонки между группой операторов, удерживая вызовы в очереди до момента, когда оператор станет доступен. Это обеспечивает эффективное управление большим потоком звонков и улучшает качество обслуживания клиентов.
В данной статье Вы найдете подробную документацию по созданию и настройке таких очередей.
IVR меню в MikoPBX — это интерактивное голосовое меню, которое позволяет звонящим взаимодействовать с телефонной системой с помощью нажатия клавиш или голосовых команд. Оно автоматически направляет вызовы к нужным отделам или сотрудникам, улучшая эффективность обработки звонков и повышая качество обслуживания клиентов.
В данной статье вы найдете документацию по созданию и настройке IVR меню.
Конференции в MikoPBX — это функция, позволяющая организовывать групповые телефонные звонки с участием нескольких абонентов одновременно. Она позволяет проводить коллективные обсуждения, совещания и встречи по телефону, улучшая коммуникацию как внутри компании, так и с внешними партнерами.
В данной статье вы найдете документацию по созданию и настройке комнат конференций.
Звуковые файлы в MikoPBX — это аудиозаписи, которые используются системой для воспроизведения различных сообщений, таких как приветствия, объявления, инструкции в IVR-меню или сигналы ожидания. Они позволяют персонализировать аудиоконтент, который слышат звонящие, улучшая взаимодействие с системой и предоставляя необходимую информацию.
В данной статье вы найдете подробную информацию про них, а так же способы добавления и их редактирования.
История вызовов в MikoPBX — это журнал, который сохраняет информацию о всех входящих и исходящих звонках через систему. Она предоставляет детальные данные о каждом вызове, включая время, длительность, номера участников и статус, что позволяет анализировать коммуникации и оптимизировать работу телефонной сети компании. В данной статье Вы найдете информацию про хранение записей разговоров и их фильтров.
Установка MikoPBX с помощью Docker
Для работы с MikoPBX в контейнере необходимо установить docker и docker compose, а также создать пользователя и папки для хранения настроек конфигурации и записей разговоров по инструкции
Для запуска контейнера с вашим приложением воспользуйтесь следующими командами:
Чтобы убедиться, что ваше приложение MikoPBX запостилось и работает в Docker-контейнере, можно выполнить следующие шаги после его запуска. Эти шаги помогут проверить состояние контейнера и просмотреть его логи.
Сначала нужно удостовериться, что контейнер успешно запущен и работает. Для этого используем команду docker ps
, которая покажет список запущенных контейнеров и их статус.
Эта команда выведет информацию о всех активных контейнерах. Убедитесь, что контейнер mikopbx
присутствует в списке и его статус указывает на то, что он запущен и работает (например, статус up).
После подтверждения того, что контейнер запущен, следующим шагом будет просмотр логов для проверки, что приложение загрузилось без ошибок и функционирует нормально. Команда docker logs
позволит вам увидеть вывод, который генерирует ваше приложение.
Просмотрите вывод команды на наличие сообщения, подобного указанному ниже. Это сообщение свидетельствует о том, что MikoPBX успешно загружена и готова к использованию:
Если отображается процесс запуска MikoPBX то необходимо подождать и повторить команду sudo docker logs mikopbx
При старте контенер не имеет информации об адресе хостовой системы, потому необходимо открыть внешний адрес хостовой системы, в данном случае Ubuntu в браузере. https://<IP адрес хост системы>
Войдите в веб-интерфейс, используя логин admin
и пароль admin
, чтобы убедиться, что веб-интерфейс доступен и функционирует корректно.
Флаг NET_ADMIN необходим для возможности работы системы проактивной защиты fail2ban и фаервола iptables внутри контейнера. При срабатывании блокировки доступа, например при вводе неверного пароля, доступ с IP адреса злоумышленника будет заблокирован.
Если необходимо использовать «Модуль резервного копирования», то контейнер следует запускать с флагом –privileged. Когда MikoPBX запускается в контейнере, резервное копирование можно также выполнять архивированием каталогов cf и storage вручную . В этом случае привелегированный режим можно не использовать, но в момент копирования контейнер должен быть остановлен.
Флаг –net=host указывает на то, что NAT между хостом и контейнером не будет использоваться. MikoPBX будет подключена напрямую к сети хостовой машины. Все порты, которые должен занять контейнер будут заняты и на хост машине. Если на хост машине, какой-то из портов недоступн, то при загрузке MikoPBX возникнут ошибки. Подробнее в документации к Docker...
При необходимости можно скорректировать стандартный набор портов, которые использует MikoPBX. Это можно сделать объявляя переменные окружения при запуске контейнера.
Помимо использования нашего официального реестра, вам может понадобиться вариант создания контейнера из образа, например для бета версии. В составе опубликованных релизов и предрелизов поставляется tar архив, который мы используем для создания контейнера.
Пример кода, для его использования:
Ниже перечислены некоторые переменные окружения, которые позволят скорректировать используемые 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 интерфейс
Полный список всех возможных параметров настроек доступен в исходном коде по ссылке.
Установка MikoPBX с помощью docker compose
Для работы с MikoPBX в контейнере необходимо установить docker и docker compose, а также создать пользователя и папки для хранения настроек конфигурации и записей разговоров по инструкции
Вот пример файла docker-compose.yml
, который может быть использован для управления вашим контейнером MikoPBX через Docker Compose:
Сохраните содержимое в файл docker-compose.yml, выполните необходимые корректировки и запускайте MikoPBX коммандой:
Также можно оганизовать запуск нескольких контенеров MikoPBX на одном хосте, но здесь надо учитывать особенности работы Docker с портами, если не использовать режим –net=host то это приведет к высокой нагрузке на процессор хостовой системы, т.к. Docker создает для каждого выделенного порта отдельное правило в Iptables.
С включенным режимом –net=host вам необходимо вручную следить за распределением доступных портов между запускаемыми контейнерами и встроенными приложениями. Например, для запуска двух контейнеров с MikoPBX на одном хосте, можно использовать следующий конфигурационный файл:
Сохраните содержимое в файл docker-compose.yml, выполните необходимые корректировки и запускайте 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
Для входа в веб-интерфейс первой АТС MikoPBX используйте логин admin
и пароль mikopbx-first-password
Для входа в веб-интерфейс второй АТС MikoPBX используйте логин admin
и пароль mikopbx-second-password
В каждой машине должен быть включен режим NAT, указывая что контейнер находится за маршрутизатором в настройках сетевого интерфейса. Если станции будут использоваться внутри локальной сети, то в поле внешнего IP прописваем локальный IP адрес хостовой машины, в противном случе ее публичный IP адрес.
Важное замечание! Один из наших контейнеров использует проброс с SIP порта с изменением его значения 5060 -> 6060. В данном случае, для корректной работы системы, необходимо добавить внешнее значение SIP порта в настройках NAT в разделе сетевых интерфейсов MikoPBX. Эту настройку также можно сделать задав соответвующее значение переменной окружения EXTERNAL_SIP_PORT=6060 в файле docker-compose.
На этом настройка завершена, можно настраивать учетные записи и выполнять звонки.
Ниже перечислены некоторые переменные окружения, которые позволят скорректировать используемые 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 интерфейс
Полный список всех возможных параметров настроек доступен в исходном коде по ссылке.
Добавление/создание звуковых файлов в MikoPBX
Звуковые файлы в MikoPBX — это аудиозаписи, которые используются системой для воспроизведения различных сообщений, таких как приветствия, объявления, инструкции в IVR-меню или сигналы ожидания. Они позволяют персонализировать аудиоконтент, который слышат звонящие, улучшая взаимодействие с системой и предоставляя необходимую информацию.
Поддерживаемый формат файлов mp3 и wav
Звуковые файлы в MikoPBX используются в различных сценариях звонков и интерактивных голосовых меню (в IVR меню, в Нерабочем времени, в Очередях вызовов и для разных системных оповещений, а также В музыке на удержании) для воспроизведения голосового приветствия или оповещения клиента.
Список доступных звуковых файлов отображается в разделе "Телефония" -> "Звуковые файлы".
Для добавления нового звукового файла нажмите "Добавить звуковой файл".
Нажмите Загрузить и выберите звуковой файл.
Откорректируйте наименование файла при необходимости.
Сохраните изменения.
При работе по протоколу https есть возможность записать звуковой файл с использованием микрофона. При работе по https должен использоваться доверенный сертификат.
Звуковые файлы хранятся на АТС по пути /storage/usbdisk1/mikopbx/media/custom
Функция доступна начиная с версии 2020.2.XXX
Если клиент при звонке попадает в очередь или ожидает переадресацию, АТС проигрывает для него мелодию. Есть возможность загрузить свои мелодии для прослушивания во время ожидания. Это можно сделать на вкладке Музыка на удержании описанным выше способом.
Создание и настройка конференций в MikoPBX
Конференции в MikoPBX — это функция, позволяющая организовывать групповые телефонные звонки с участием нескольких абонентов одновременно. Она позволяет проводить коллективные обсуждения, совещания и встречи по телефону, улучшая коммуникацию как внутри компании, так и с внешними партнерами.
Список конференц-комнат располагается в разделе "Телефония" -> "Конференции".
Для создания новой конференц-комнаты нажмите кнопку Добавить конференцию.
Необходимо указать название конференции и ее внутренний номер, позвонив на который можно в эту конференцию зайти.
Для того чтобы в конференцию не могли зайти сотрудники, для которых это обсуждение не предназначено, можно защитить конференц-комнату паролем. Для этого заполните поле cr_pinCode. В это поле можно вводить только цифры, минимум одна цифра.
В этом случае для того чтобы попасть в данную конференцию сотруднику после набора номера конференции необходимо будет ввести пин-код.
Все собеседники общаются только голосом (никаких других способов передачи информации, кроме речевого, не предоставляется);
все собеседники могут говорить и слышать друг друга одновременно (то есть обеспечивается дуплексная связь);
участники используют для общения телефоны (аппаратные или программные).
Каждый участник конференции звонит на номер конференции. Первый участник слышит музыку на удержании до тех пор, пока к конференции не присоединится хотя бы еще один участник.
Сотрудник может перевести своего собеседника в конференцию, реализовав перевод с помощью комбинации стар-кодов на своем телефоне. Перевести в конференцию можно как внутренний номер, так и внешний. Комбинация для переводов задается в разделе "Система" -> "Общие настройки" -> "Переводы вызовов". Пример: Сотрудник набирает комбинацию **1111 (комбинация для безусловного перевода) и его собеседник попадает в конференцию и становится её первым участником. У переводившего сотрудника вызов завершается, и, чтобы попасть в конференцию он звонит на номер конференции 1111.
Максимальное количество участников конференции не ограничено.
Создание и настройка IVR меню в MikoPBX
IVR меню в MikoPBX — это интерактивное голосовое меню, которое позволяет звонящим взаимодействовать с телефонной системой с помощью нажатия клавиш или голосовых команд. Оно автоматически направляет вызовы к нужным отделам или сотрудникам, улучшая эффективность обработки звонков и повышая качество обслуживания клиентов.
Перед созданием IVR меню необходимо загрузить звуковые файлы, которые будут проигрываться клиенту при звонке в Вашу компанию. Звуковые файлы добавляются в разделе Телефония → Звуковые файлы
Также есть возможность записать файл с помощью микрофона, если с АТС соединиться по https.
Перейдите в Телефония → IVR меню.
Нажмите Создать новое IVR меню. Задайте наименование IVR меню, номер и при необходимости комментарий. Выберите звуковой файл, который вы загрузили на предыдущем этапе.
Настройте Действия при донаборе. В первой колонке укажите добавочный номер, а во второй настройте правило адресации.
Задайте Количество повторов перед переводом на номер по умолчанию.
Установите Таймаут ожидания ввода добавочного номера (значение в секундах), после которого будет повтор голосового приветствия.
Номер по умолчанию необходим для случая, если клиент не ввел добавочный номер (к примеру не было технической возможности).
Включите переключатель Разрешить набор любого внутреннего номера при необходимости.
Введите номер IVR меню, позвонив на который, можно на это IVR попасть.
Нажмите Сохранить.
При звонке на голосовое меню (Номер IVR меню) начинает проигрываться звуковой файл Голосовое приветствие.
Во время проигрывания голосового меню можно набирать добавочный номер сотрудника. За эту возможность отвечает флаг Разрешить донабор любого внутреннего номера. IVR позволяет разрешить донабор любого внутреннего номера: очереди, IVR, внутреннего номер сотрудника.
После проигрывания голосового меню происходит ожидание в течении Таймаут ожидания ввода добавочного номера для набора добавочного. Общее время для набора номера = Длительность звукового файла + Таймаут ожидания ввода добавочного номера.
Если общее время для набора номера истекло происходит повторное голосовое оповещение и ожидание в течении таймаута, то есть следующая попытка IVR.
Если пользователь некорректно набирает номер или вообще ничего не набирает, то также происходит повторное голосовое оповещение и ожидание в течении таймаута - следующая попытка IVR.
Максимальное количество попыток задается в параметре Количество повторов, перед переводом на номер по умолчанию.
Как только попытки превысят указанное значение, происходит переадресация на Номер по умолчанию.
Создание и настройка очередей вызовов.
Очереди позволяют:
Распределять телефонные звонки между группой сотрудников (агентов): Вы можете создать очередь вызовов и добавить в нее несколько сотрудников. Когда поступает звонок, система автоматически направляет его к доступному сотруднику в очереди, обеспечивая более равномерное распределение нагрузки и повышая эффективность обработки вызовов.
Удерживать клиента на линии, если все сотрудники заняты: Если все сотрудники в очереди заняты обработкой других вызовов, клиент будет удерживаться на линии, пока не освободится один из сотрудников. Это помогает избежать потери вызовов и обеспечивает более качественное обслуживание клиентов.
Оповещать клиента о позиции в очереди и приблизительном времени ожидания: При нахождении клиента в очереди система может предоставлять информацию о его текущей позиции в очереди и ориентировочное время ожидания. Это помогает удержать клиента в курсе ситуации и улучшает его опыт общения.
Передавать на телефон сотрудника имя очереди, вместе с номером клиента: Когда сотрудник принимает вызов из очереди, на его телефоне отображается не только номер клиента, но и имя соответствующей очереди. Это помогает сотруднику более эффективно обрабатывать вызовы и предоставлять персонализированное обслуживание.
Для настройки очередей вызовов в MikoPBX следует перейти в раздел "Телефония" и выбрать "Очереди вызовов". Здесь вы сможете создать и настроить свои очереди в соответствии с требованиями вашего бизнеса и потребностями обслуживания клиентов.
Длительность вызова на очередь по умолчанию равна 300 секундам. После истечения этого времени вызов будет завершен. Для обхода этого ограничения следует настроить Сценарий 1 (см. далее инструкции Маршрутизация звонков при сбоях).
Для добавления новой очереди выполните действие Создать новую очередь.
Укажите Название очереди - при настройке маршрутизации вы будете ориентироваться на него.
Заполните описание в поле Заметка - оно будет доступно в списке очередей.
В разделе Операторы очереди можно добавить произвольное число сотрудников (агентов очереди) и указать стратегию распределения вызовов.
Варианты стратегии:
Вызываются все доступные участники до тех пор, пока кто-то из них не ответит на вызов (по умолчанию);
Вызывается первый свободный участник, который дольше всех не вызывался из этой очереди;
Вызывается первый свободный участник, который обработал наименьшее количество вызовов из данной очереди;
Случайным образом вызывается не занятый участник, обрабатывающий очередь;
Циклическое распределение с памятью. Запоминается последний участник, ответивший на вызов;
Вызов поступает на каждого участника очереди по порядку.
В этом разделе можно дополнительно указать:
Номер телефона для этой очереди - по этому номеру можно позвонить на очередь с любого внутреннего номера сотрудника. Также на этот номер можно перевести вызов.
Краткое название очереди - для отображения перед CallerID абонента на телефонном аппарате, например consult.
Время попытки дозвона агенту - время в секундах, в течение которого вызов будет идти на одного агента очереди. По завершении этого времени вызов агенту сохраняется в историю звонков как пропущенный. По завершении времени попытки дозвона до одного агента вызов направится на следующего агента согласно выбранной стратегии.
Время отдыха агента после обработки вызова, перед тем как начать принимать новые звонки - время в секундах, которое отсчитывается с момента завершения разговора агентом очереди до момента поступления нового телефонного звонка агенту.
Получать новые звонки во время разговора - переключатель включает / отключает возможность принятия новых звонков во время текущего разговора.
Что абонент слышит во время ожидания - во время ожидания ответа на свой звонок клиент может слышать музыку на удержании или сигнал вызова.
Фоновая музыка (MOH) - можно указать уникальный звуковой файл для воспроизведения клиенту во время ожидания, к примеру рекламные материалы.
Оповещать о текущей позиции в очереди - если все операторы (агенты очереди) заняты, то включив этот переключатель, можно оповестить клиента о его позиции в очереди. Если активирована опция Дополнительный звуковой анонс, то этот анонс дополнит информацию о позиции.
Оповещать о расчетном времени ожидания - если все операторы (агенты очереди) заняты, то включив этот переключатель, можно оповестить клиента о примерном времени ожидания ответа на вызов. Если активирована опция Дополнительный звуковой анонс, то этот анонс дополнит информацию о расчетном времени.
Дополнительный звуковой анонс - звуковое сообщение проигрывается только если все участники очереди заняты.
Время в секундах для периодического повтора всех оповещений - описывает c каким интервалом произносить оповещение о позиции в очереди, времени ожидания и анонс.
Сценарий 1 - в данном сценарии можно настроить максимально допустимое время ожидания клиента в очереди. Если в течение заданного времени никто из агентов очереди не смог ответить клиенту, то можно задать номер, на который будет в дальнейшем перенаправлен вызов.
Сценарий 2 - если в очереди нет агентов (то есть в данный момент ни один агент не зарегистрирован на АТС), то можно указать номер, на который будет переведен вызов клиента.
В данных сценариях в качестве номера переадресации можно выбрать не только внутренний номер, а также конференцию, очередь, IVR, приложение диалплана служебный номер.
Длительность вызова на очередь по умолчанию равна 300 секундам. Если необходим больший интервал, то задайте в Сценарий 1, большую длительность и укажите резервный номер.
Подключение и настройка провайдеров телефонии в MikoPBX
«Провайдеры телефонии» в MikoPBX — это раздел системы, где настраиваются подключения к внешним операторам связи через интернет-протоколы для IP-телефонии. Здесь администраторы могут добавлять и настраивать учетные записи SIP-транков или других типов соединений, которые позволяют системе совершать и принимать звонки с городских и мобильных номеров.
Чтобы совершать или принимать внешние телефонные звонки по телефонной сети общего пользования или Интернет, вы должны создать, по крайней мере, одну учетную запись провайдера. Каждая технология имеет свой тип учетной записи. Для добавления новой учетной записи или изменения существующей, перейдите в "Маршрутизация" -> "Провайдеры телефонии":
Обзор провайдеров содержит список всех доступных поставщиков услуг. Зеленый значок перед именем поставщика означает, что MikoPBX зарегистрировала этого провайдера, и Вы можете начать работу с этим провайдером. С помощью переключателя слева можно включать использование провайдера и отключать соответственно:
Для подключения новой учетной записи провайдера нажмите Подключить SIP или Подключить IAX в зависимости по типа подключаемой учетной записи:
В общих настройках 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 соответственно.
В этом поле вы можете изменять конфигурационные файлы Asterisk.
Переопределять можно практически все параметры. К примеру при использовании chan_pjsip провайдер описывается следующими секциями:
Для переопределения полей в секциях следует заполнить поле Дополнительные параметры следующим образом:
Для завершения настройки нажмите Сохранить.
Бывают случаи, когда необходимо подключить несколько учетных записей одного поставщика услуг связи. В этом случае настройки Хост или IP адрес и Порт соединения SIP могут оказаться одинаковыми для всех учетных записей.
Asterisk такую ситуацию обыгрывает по-своему. АТС не сможет корректно «приземлить» вызов на нужного провайдера и вызов оборвется.
В качестве решения, в старых версиях АТС можно было для какой учетной записи описать дополнительные входящие маршруты и заполнить поле Дополнительный номер (DID) значением Логин. И так для каждой учетной записи требовалось создать некоторое количество дополнительных маршрутов, равное количеству аккаунтов провайдера.
Поле Логин в большинстве случаев при входящем звонке будет использоваться в качестве номера назначения Дополнительный номер (DID). И, учитывая, что выходящие маршруты для всех Логин будут описаны, вызов будет корректно обработан телефонной станцией.
Этот вариант используется при подключении большинства провайдеров.
Необходимость регистрации возникает в случае, когда провайдер не может знать, с какого IP-адреса будет подключаться клиент, к примеру, когда АТС расположена за NAT. Сервер провайдера обычно на публичном IP-адресе.
Входящая регистрация
Этот вариант актуален для работы некоторых FXO / GSM шлюзов - когда внешнее устройство должно подключиться к вашей АТС по логину и паролю.
Также этот вариант актуален, когда удаленное устройство находится за NAT и MikoPBX не может знать его IP адрес.
Аутентификация по IP адресу, без пароля
Актуально для безопасных частных сетей. Так к примеру Ростелеком часто ведет свой сетевой кабель и подключает клиента к своей локальной сети.
АТС и провайдер в данном случае должны находиться в одной и той же сети.
Подключение, настройка и управление модулями
Дополнительные модули позволяют расширить возможности функционала основной системы. В данной инструкции вы сможете найти информацию про управление модулями, а так же про установку приложений с помощью встроенного Marketplace.
Для использования платных и бесплатных модулей, необходимо зарегистрировать копию MikoPBX и бесплатно получить лицензионный ключ. Инструкцию по тому, как это сделать - вы можете найти .
Подробные инструкции по настройке и эксплуатации каждого модуля вы можете найти .
Найти раздел Управления модулями вы можете в "Модули" -> "Маркетплейс модулей".
Все установленные модули находятся в списке, в одноимённой вкладке:
Есть возможность загрузить свой модуль, используя кнопку "Загрузить новый модуль". Необходимо загружать файлы .zip. После загрузки модуль появится в списке на вкладке "Установленные модули"
Так же есть возможность перейти в настройки любого модуля для дальнейшей его конфигурации:
Помимо этого, можно включить/отключить модуль.
Из интерфейса установленного модуля можно быстро перейти к его документации, нажав на знак вопроса справа от короткого описания модуля:
Существует возможность вынести любой модуль в боковое меню для быстрого доступа к нему, что может быть полезно, если вам требуется постоянный доступ к настройки модуля для изменения параметров или его состояния.
Для того, чтобы это сделать - выполните дальнейшую инструкцию:
Перейдите в настройки модуля, который Вы хотите вывести в боковое меню, нажав на элемент редактирования справа от версии модуля:
Нажмите на значок настроек справа от статуса состояния модуля для перехода к настройкам отображения модуля в боковом меню:
В данном разделе вы можете:
Переключить отображение модуля в боковом меню - "Показывать модуль в боковом меню".
Выбрать раздел в котором он будет отображаться - в примере выбран раздел "Модули".
Так же можно указать произвольное название модуля.
После завершения настройки - нажмите "Сохранить".
В данном разделе вы можете установить модули от MIKO, а так же от производителей-партнеров.
Напротив каждого модуля есть кнопка для его скачивания и установки. Так же здесь отображена базовая информация по модулю с коротким описанием каждого модуля.
Слева от названия модуля вы можете найти значок, по которому можно понять платный ли он или бесплатный. Например, на изображении выше модуль "REST API Автоинформатор" - платный, а модуль "Генератор SSL сертификатов через Let's Encrypt" - бесплатный.
У каждого платного модуля есть испытательный период - 2 недели. За этот период вы можете попробовать функционал модуля и принять решение о покупке. Для покупки модуля - напишите на почту [email protected]
Существует возможность перейти в карточку модуля, нажав на его название в интерфейсе маркетплейса.
Здесь вы можете найти версию актуального релиза, информацию про разработчика, платный ли модуль или бесплатный. Тут же находятся 3 раздела:
Здесь вы можете найти изображения про функционал и настройки модуля. Помимо этого - базовое описание модуля, а так же раздел "Полезные ссылки", где располагается ссылка на подробную документацию по настройке и эксплуатации модуля.
В данном разделе вы можете найти историю версий модуля, с подробным описанием изменений, а также минимально совместимой версии MikoPBX для корректной его работы. Так же вы можете установить конкретную версию модуля, нажав на синий элемент под общим ее описанием.
Здесь вы можете ознакомиться с пользовательским лицензионным соглашением для каждого модуля расширения.
В случае покупки модуля, вам будет выдан купон. Для его активации перейдите в Модули -> Маркетплейс модулей:
Далее перейдите в раздел "Управление лицензией"
В поле "Активация купона" введите ваш купон, далее нажмите "Активировать купон"
Ключ защиты всегда начинается с MIKO-. Купон для изменения состава продуктов всегда начинается с MIKOUPD-
Настройка правил нерабочего времени
«Нерабочее время» в MikoPBX — это инструмент для настройки правил обработки вызовов в периоды, когда компания не работает, например, ночью, в выходные или праздничные дни. С его помощью администраторы могут определить, как система будет обрабатывать входящие звонки в нерабочие часы: перенаправлять на автоответчик, воспроизводить специальные голосовые сообщения или переадресовывать вызовы на мобильные номера дежурных сотрудников. Это позволяет обеспечить корректное взаимодействие с клиентами вне рабочего времени и поддерживать высокий уровень обслуживания.
Чтобы добавить новое правило нажмите на кнопку Добавить интервал времени.
Откроется форма создания нового правила.
В ней есть возможность указать:
Период - календарный период отсутствия сотрудников в офисе. Например, на время новогодних или майских праздников
Дни недели - конкретные дни недели, для которых будет выполняться данное правило
Период времени - период времени отсутствия сотрудников в течении суток.
Применять только к определенным входящим маршрутам - можно активировать эту функцию и с помощью нее выбирать на какие входящие маршруты будет распространяться данное правило. (Подробнее ниже)
Действие с входящим вызовом - можно выбрать проиграть звуковой файл или перевести вызов. Перевести вызов можно на конференцию, IVR меню, очередь, внутренний номер сотрудника или служебные номера завершения вызова.
В поле Комментарий можно заметку, с описанием созданного правила, чтобы по данному описанию можно было быстро сориентироваться о сущности данного правила.
Активировав эту функцию, сверху у вас появится новое меню "Ограничения по маршрутам"
Здесь вы можете выбрать к каким конкретно маршрутам будет применяться создаваемое вами правило.
Данным правилом указываются звонки с конца рабочего дня (19:00) и до начала рабочего дня (9:00).
Данным правилом указываются звонки по выходным дням: в субботу и воскресенье.
Описание и настройка входящей маршрутизации
В данном разделе необходимо создать правила и шаблоны распределения входящих звонков для созданных в MikoPBX провайдеров. Правила входящих звонков описывают маршрут звонка с момента его поступления в АТС до момента его завершения. Вы можете создавать неограниченное количество правил входящей маршрутизации. Для одного провайдера можно создать несколько правил.
Дополнительные примеры настройки входящей маршрутизации доступны в .
Правила располагаются в списке в порядке их приоритета. Если за указанный в правиле интервал времени никто не ответит на входящий вызов, то вызов направится на следующее по приоритету правило. Правила можно перемещать в списке вверх-вниз, то есть изменять их приоритет, перетаскивая их за стрелки.
Если ни по одному из правил на звонок не ответили, применяется входящий маршрут по умолчанию.
Доступны следующие действия, которые можно указать в качестве правила по умолчанию:
Воспроизвести сигнал занято - клиент будет воспроизведен сигнал занято и входящий вызов будет завершен;
Положить трубку;
Перевести вызов - вызов можно перевести на номер, который вы можете выбрать в поле, расположенном справа от действия. В качестве номера для перевода можно выбрать IVR-меню, очередь вызовов, конференцию, внутренний номер сотрудника.
Для одного провайдера можно описать несколько входящих маршрутов.
Сперва вызов идет по верхнему маршруту. Если клиент не дозвонился, то вызов идет по нижнему правилу (более низкий приоритет). Если клиент не дозвонился и по второму маршруту, то вызов идет по маршруту по умолчанию.
Чтобы добавить новое правило входящей маршрутизации нажмите на кнопку Добавить новое правило.
В поле Заметка опишите маршрут, который хотите реализовать. В дальнейшем это поможет вам в отладке схемы звонка.
Выберите Провайдера, для которого создаете новый шаблон распределения входящих звонков.
Дополнительный номер DID - это номер, на который вам позвонил клиент. Это не обязательное поле и его следует заполнять, если необходимо более точно маршрутизировать вызовы.
На следующем шаге необходимо указать на какой телефонный номер будет направлен входящий вызов от клиента. В качестве телефонного номера могут выступать номера IVR-меню, очереди вызовов, конференции, внутренние номера сотрудников.
Укажите время, в течение которого вызов будет идти на указанный вами телефонный номер.
Если спустя указанный интервал времени никто не ответит на входящий вызов, то вызов направится на следующее по приоритету правило.
Описание раздела Модули в MikoPBX
Раздел «Модули» в MikoPBX — это интерфейс для управления дополнительными функциональными компонентами системы, который включает два подраздела: «Управление модулями» и «Приложения диалплана».
Управление этими подразделами позволяет настроить MikoPBX максимально гибко и эффективно, расширяя функциональность телефонной системы и адаптируя ее под уникальные требования организации.
Регистрация в Маркетплейсе MikoPBX не влияет на базовый функционал системы. Вы можете использовать MikoPBX для работы со звонками без регистрации и установки дополнительных модулей. Однако, Мы рекомендуем пройти процедуру регистрации в маркетплейсе для получения возможности расширения функционала системы.
Регистрация даст вам доступ к дополнительным модулям и расширениям.
Управление модулями в MikoPBX — это интерфейс для управления дополнительными компонентами системы, расширяющими ее функциональность. Здесь администраторы могут устанавливать, обновлять, включать или отключать модули, добавляя новые возможности или интеграции с внешними сервисами. Этот раздел позволяет адаптировать систему под специфические потребности компании, обеспечивая гибкость и масштабируемость телефонной сети.
Приложения диалпланов в MikoPBX — это набор инструментов, которые позволяют настраивать индивидуальные сценарии обработки звонков внутри системы. С их помощью вы можете определить последовательность действий, которую система выполнит при поступлении или совершении вызова. Это может включать перенаправление звонка на определенный внутренний номер, воспроизведение специальных аудиосообщений, запрос дополнительной информации у звонящего или выполнение других функций.
Используя приложения диалпланов, вы можете гибко настроить логику работы телефонной системы под потребности вашего бизнеса, не углубляясь в сложное программирование. Это облегчает создание сложных сценариев обработки вызовов, позволяя улучшить эффективность коммуникаций и повысить уровень обслуживания клиентов.
Просмотр и фильтр истории вызовов в MikoPBX
История вызовов в MikoPBX — это журнал, который сохраняет информацию о всех входящих и исходящих звонках через систему. Она предоставляет детальные данные о каждом вызове, включая время, длительность, номера участников и статус, что позволяет анализировать коммуникации и оптимизировать работу телефонной сети компании. Располагается в разделе "Телефония" -> "История вызовов".
История вызовов в MikoPBX позволяет:
Отобразить все вызовы;
Отобразить вызовы по отбору;
Визуально отобразить пропущенные вызовы из общего списка звонков;
Скачать/прослушать запись разговора.
Каждый элемент списка содержит информацию о:
номере телефона звонящего абонента (Кто);
номере телефона, на который звонили (Кому);
дате и времени свершения звонка (Дата звонка);
длительности разговора (Длительность) - время голосового приветствия не учитывается.
Вызовы, отмеченные красным цветом, являются пропущенными. Длительность разговора для пропущенных вызовов равна нулю, такие вызовы невозможно прослушать.
Для каждой записи истории звонков доступна возможность прослушивания и скачивания записи разговоров. Записи разговоров скачиваются локально на ПК в формате .mp3.
Каждая строка вызова содержит полную информацию об участниках разговора.
На скриншоте выше отображено следующее:
Вызов поступил на номер 79255283744;
На вызов ответила Белкина;
Белкина осуществила консультативный перевод на Шевченко;
Шевченко продолжила разговор с клиентом.
Для применения отбора нужно после ввода в поле значения нажать Enter.
В строке поиска истории вызовов можно реализовать следующие отборы:
1) Отбор по номеру телефона
В строке поиска можно ввести как внутренний номер сотрудника, так и номер клиента (внешний).
2) Отбор по двум номерам телефона
В строке поиска через пробел можно ввести два номера телефона. Если ввести "74952293042 302", то будут отображены все отвеченные вызовы между двумя номерами. Отвеченные вызовы - это вызовы, имеющие длительность разговора больше 0 секунд, время голосового приветствия не учитывается.
3) Отбор по дате
При открытии истории звонков, журнал по умолчанию формируется на текущую дату. Установите нужный вам период и нажмите Применить.
4) Отбор по linkedid
Описания раздела маршрутизации MikoPBX
Раздел «Маршрутизация» в MikoPBX — это интерфейс для настройки правил направления вызовов внутри телефонной системы. Здесь администраторы могут определить, как обрабатывать входящие и исходящие звонки, устанавливая условия и маршруты для эффективного распределения звонков между сотрудниками, отделами или внешними линиями.
Провайдеры телефонии в MikoPBX — это раздел системы, где настраиваются подключения к внешним операторам связи через интернет-протоколы для IP-телефонии. Здесь администраторы могут добавлять и настраивать учетные записи SIP-транков или других типов соединений, которые позволяют системе совершать и принимать звонки с городских и мобильных номеров.
В данной статье Вы найдете подробную документацию по подключению провайдеров к станции, их настройку и особенности.
Входящие маршруты в MikoPBX — это набор правил, определяющих, как система обрабатывает входящие звонки от внешних провайдеров телефонии. С их помощью администраторы могут настраивать направления вызовов в зависимости от различных условий, таких как номер вызывающего абонента, время суток или конкретный номер, на который поступил звонок. Это позволяет автоматически распределять входящие звонки на определенных сотрудников, отделы, IVR-меню или очереди вызовов. Настройка входящих маршрутов способствует оптимизации обработки вызовов и повышению качества обслуживания клиентов, обеспечивая гибкое и эффективное управление телефонными коммуникациями в компании.
В данной статье Вы найдете подробную документацию по настройке входящей маршрутизации.
Исходящие маршруты в MikoPBX — это набор правил и настроек, определяющих, как система обрабатывает исходящие звонки от сотрудников к внешним номерам. С их помощью администраторы могут управлять направлением вызовов через различные провайдеры телефонии или линии связи в зависимости от определенных условий, таких как набранный номер, префиксы, время суток или права доступа пользователя. Это позволяет оптимизировать затраты на связь, распределять нагрузку между каналами и применять политики безопасности, ограничивая или разрешая определенные типы вызовов. Настройка исходящих маршрутов обеспечивает гибкость и контроль над исходящей телефонной связью, способствуя эффективной работе коммуникационной системы компании.
В данной статье Вы найдете подробную документацию по настройке исходящей маршрутизации.
Нерабочее время в MikoPBX — это инструмент для настройки правил обработки вызовов в периоды, когда компания не работает, например, ночью, в выходные или праздничные дни. С его помощью администраторы могут определить, как система будет обрабатывать входящие звонки в нерабочие часы: перенаправлять на автоответчик, воспроизводить специальные голосовые сообщения или переадресовывать вызовы на мобильные номера дежурных сотрудников. Это позволяет обеспечить корректное взаимодействие с клиентами вне рабочего времени и поддерживать высокий уровень обслуживания.
В данной статье Вы найдете подробную документацию по настройке нерабочего времени для Вашей станции.
Описание процесса регистрации
Регистрация в Маркетплейсе MikoPBX не влияет на базовый функционал системы. Вы можете использовать MikoPBX для работы со звонками без регистрации и установки дополнительных модулей. Однако, Мы рекомендуем пройти процедуру регистрации в маркетплейсе для получения возможности расширения функционала системы.
Регистрация даст вам доступ к дополнительным модулям и расширениям. Есть бесплатные модули, который мы вынесли из базового функционала для упрощения первоначальной настройки, а также платные модули от нас и других разработчиков. Если вы разработчик, то можете связаться с нами, написав на почту [email protected] для получения инструкций о том, как разработать собственный модуль и добавить его в Marketplace.
Сама MikoPBX - бесплатное решение и не требует никакой регистрации. Отсутствие лицензии никак не влияет на звонки. Вы в любой момент можете зарегистрироваться, а также отменить регистрацию в Marketplace.
Для начала регистрации в маркетплейсе вам необходимо перейти во вкладку "Модули" -> "Маркетплейс модулей":
В случае, если у Вас не выполнена регистрация в Маркетплейсе, раздел будет выглядеть вот так:
В случае переноса MikoPBX на другой хост или восстановлении из бекапа, необходимо выполнить сброс привязок лицензий на модули в личном кабинете lm.mikopbx.com
При регистрации выдается 1 ключ на компанию. Это значит, что если Вы используйте несколько станций MikoPBX в своей компании - вам достаточно будет одной регистрации.
Нажмите синюю кнопку "Регистрация в маркетплейсе" для начала регистрации:
Лицензионный ключ используется для хранения всех ваших лицензий от любых продуктов МИКО. Если у вас уже есть ключ, вы можете просто вписать его в одноименное поле. Если ключ у вас был, но вы его забыли, вы можете поискать письмо в вашей электронной почте входящие письма по адресу [email protected]
Получить новый ключ можно автоматически, заполнив регистрационную форму ниже:
Название организации - введите имя вашей компании/организации.
Адрес электронной почты контактного лица - введите адрес электронной почты вышей компании/организации.
Контактное лицо - введите данные контактного лица.
Телефон контактного лица (необязательно).
Уникальный идентификатор компании (ИНН, ИИН, УНП и т.д.) (необязательно).
Нажмите "Зарегистрироваться"
В случае успешной регистрации, вы увидите следующий экран:
Уведомление об успешной регистрации системы.
Наведите курсор на поле с лицензионным ключом, если вам необходимо его увидеть или скопировать. По умолчанию значение ключа размыто.
Для управления лицензией перейдите в раздел Маркетплейс -> Управление лицензией. Нажмите на одноименный элемент:
Для управления лицензией введите ваш лицензионный ключ в поле "Введите ваш лицензионный ключ или активированный ранее купон":
Нажмите "Login"
Вы попадете в систему, где находятся 9 секций:
Перейдите в раздел "Монитор сессий":
Слева для каждой привязки в колонке Информация есть кнопка i, которая позволяет посмотреть подробную информацию о хосте, к которому привязана лицензия.
Для каждой привязки в колонке "Действие" есть кнопка "Сброс", которая позволяет сбросить активную привязку лицензии от хоста.
При регистрации может возникать проблема отсутствии у MikoPBX связи с интернетом, а именно с отсутствием связи с серверами lic.miko.ru и lic.mikopbx.com по порту 443(https)
Решение: проверить доступ к станции из интернета, проверить настройки firewall и общего доступа к вышеупомянутым ресурсам.
MikoPBX переодически обращается к серверам лицензирования для проверки установленных модулей. Если лицензия на модуль недоступна, то он будет отключен, а рядом с названием модуля появится соответствующая иконка в виде перечеркнутого ключа.
Описание и настройка исходящей маршрутизации
Исходящие маршруты в MikoPBX — это набор правил и настроек, определяющих, как система обрабатывает исходящие звонки от сотрудников к внешним номерам. С их помощью администраторы могут управлять направлением вызовов через различные провайдеры телефонии или линии связи в зависимости от определенных условий, таких как набранный номер, префиксы, время суток или права доступа пользователя. Это позволяет оптимизировать затраты на связь, распределять нагрузку между каналами и применять политики безопасности, ограничивая или разрешая определенные типы вызовов. Настройка исходящих маршрутов обеспечивает гибкость и контроль над исходящей телефонной связью, способствуя эффективной работе коммуникационной системы компании.
В данной статье Вы найдете подробную документацию по настройке исходящей маршрутизации.
Вы можете создавать неограниченное количество правил исходящей маршрутизации. Для одного провайдера можно создать несколько правил.
Дополнительные примеры настройки исходящей маршрутизации доступны в разделе FAQ.
Чтобы добавить новое правило исходящей маршрутизации нажмите на кнопку Добавить новое правило.
Название правила можно задавать произвольным.
В заметке можно описать маршрут звонка, который хотите реализовать, в дальнейшем это может помочь вам в отладке.
Приведенный на картинке выше пример означает следующее: если набранный номер начинается с "7" или "8", и остальная часть номера состоит 10 цифр.
Если набираемый номер подходит под правила нескольких маршрутов, то вызов будет производится в порядке описания маршрутов, поочередно, пока вызов не будет отвечен, или пока подходящие маршруты не закончатся.
Преобразовать номер - данная настройка предназначена для удаления префикса номера и замены его на нужный префикс.
В приведенном примере в начале номера не отсекаются цифры и не добавляются цифры.
Выберите из списка провайдера, для которого настроили исходящую маршрутизацию и сохраните изменения.
Например, номер +74952293042 должен быть преобразован к номеру 84952293042.
Реализация правила выглядит следующим образом:
Например, номера 84952293042 и 74952293042 должны быть преобразованы к номеру +74952293042.
Реализация правила выглядит следующим образом:
Например, номера 4952293042 и 4996382584 должны быть преобразованы к номеру 84952293042 и 84996382584 соответственно.
Реализация правила выглядит следующим образом:
Например, номера 84952293042 и 74996382584 должны быть преобразованы к номеру 2293042 и 6382584 соответственно.
Реализация правила выглядит следующим образом:
Описание раздела Обслуживание в MikoPBX
Раздел «Обслуживание» в MikoPBX — это интерфейс для управления техническими аспектами системы и обеспечения ее стабильной работы. Здесь администраторы могут выполнять задачи по резервному копированию и восстановлению данных, обновлению программного обеспечения, мониторингу состояния системы и управлению журналами событий. Этот раздел помогает поддерживать работоспособность телефонной системы, своевременно обнаруживать и устранять возможные проблемы.
Раздел «Обновление» в MikoPBX — это интерфейс для управления обновлениями программного обеспечения системы. Здесь администраторы могут проверять наличие новых версий, устанавливать обновления и просматривать историю изменений. Регулярное использование этого раздела обеспечивает актуальность, безопасность и стабильность работы MikoPBX.
Раздел «Диагностика системы» в MikoPBX — это инструмент для мониторинга и анализа состояния телефонной системы. Здесь администраторы могут просматривать журналы событий, проверять с помощью них статус различных сервисов и компонентов системы, а также выполнять тестирование соединений и вызовов. Использование этого раздела помогает своевременно обнаруживать и устранять технические проблемы, обеспечивая стабильную и эффективную работу MikoPBX.
Раздел «Перезагрузка и выключение системы» в MikoPBX — это интерфейс для безопасного управления состоянием телефонной системы через веб-интерфейс. Здесь администраторы могут перезагрузить систему для применения новых настроек или корректно выключить ее для технического обслуживания. Использование этого раздела предотвращает возможные ошибки и обеспечивает стабильную работу MikoPBX. Помимо этого, будет рассмотрена возможность перезагрузки через консоль.
Вариант обновления из web-интерфейса
В некоторых разделах интерфейса (например, Сотрудники) в правом нижнем углу указана текущая версия MikoPBX.
В web-интерфейсе АТС перейдите в Обслуживание → Обновление PBX.
Если есть версии АТС новее вашей текущей, они будут отображены в таблице Доступны онлайн обновления, в которой в первом поле номер версии, а во втором - список изменений.
Рекомендуем проводить обновления последовательно, «не перепрыгивая» через релизы.
Далее возможны два варианта обновления: обновление онлайн, обновление скачанным img-файлом.
Появится окно предупреждения. Нажмите в нем Обновить.
АТС загрузит и применит обновления, а затем перезагрузится.
Следует сразу заметить, что данным способом можно выполнить не только обновление, но и откат на более прежнюю версию.
Начнется скачивание img-образа. Дождитесь завершения загрузки.
Затем нажмите Применить обновление, а в появившемся окне предупреждения нажмите Обновить.
Начнется применение обновлений. После окончания которого АТС перезагрузится.
Описание возможностей раздела
Меню выключения/перезагрузки системы вы можете найти в MikoPBX в "Перезагрузка" -> "Обслуживание".
При открытии страницы будет отображен список активных звонков на АТС. Отображается дата начала звонка, «Кто» и «Кому» звонит.
Пока есть активные вызовы перезагрузка и отключение не будут доступны через web интерфейс.
«Перезагрузить АТС» - команда начинает перезагрузку станции.
«Выключение АТС» - завершает все процессы и отключает станцию.
Вы можете перезагрузить станцию через консольное меню. Для этого выберете раздел «[3] Перезагрузить систему».
Если вы хотите перезагрузить станцию: нажмите «[1] Перезагрузить MikoPBX».
Если вы хотите выключить станцию: нажмите «[2] Выключить».
В случае аварийной перезагрузки АТС (например, выключение электроэнергии) может потребоваться выполнить проверку диска на ошибки.
В консольном меню АТС введите команду «[9] Консоль(Shell)» и нажмите Enter
Система запустит консоль АТС.
Введите команду Reboot
. Нажмите Enter
Система перезагрузится с проверкой диска.
Создание и настройка приложений диалплана
Приложения диалпланов - это программируемые голосовые приложения на 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 — это интерфейс для настройки параметров сетевых подключений системы. Здесь администраторы могут управлять IP-адресами, масками подсети, шлюзами и другими сетевыми настройками для каждого сетевого интерфейса. Это позволяет корректно интегрировать MikoPBX в сеть организации и обеспечить ее стабильную работу в соответствии с требованиями сетевой инфраструктуры.
Раздел находится в "Сеть и Firewall" -> "Сетевые интерфейсы":
Имя хоста - это имя машины. Если значение не указано, то используется имя 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.
Таким образом, указывая сетевой интерфейс и шлюз в сетевых настройках, вы определяете, какую сеть и через какой маршрут направлять соответствующие запросы и коммуникацию. Это важно для настройки сетевого взаимодействия и обеспечения правильной маршрутизации трафика в вашей сети.
Нажмите "Сохранить"
Описание и настройка Firewall правил в MikoPBX
Сетевой экран в MikoPBX — это интерфейс для настройки брандмауэра (Firewall) системы. Здесь администраторы могут создавать и управлять правилами фильтрации сетевого трафика, контролируя доступ к MikoPBX и защищая ее от несанкционированного доступа и сетевых угроз. Настройка сетевого экрана обеспечивает безопасность телефонной системы, предотвращая потенциальные атаки и обеспечивая стабильную работу в сетевой инфраструктуре организации.
В 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, а не внешним.
Флаг «Никогда не блокировать адреса из этой сети» следует включать только для доверенных подсетей. Если включен данный флаг, то правила защиты от взлома на данную подсеть не распространяются.
В данном разделе производится настройка 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-адреса в настоящее время заблокированы.
Так же вы можете разблокировать адрес кликом на соответствующую иконку в таблице
Описание настроек основных параметров системы
В данном разделе производится настройка основных параметров системы. Данные параметры рекомендуется настраивать сразу после установки АТС.
Название 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
В данном разделе происходит настройка часов и календаря
Раздел «Дата и время» в MikoPBX — это интерфейс для настройки системных параметров даты и времени. Здесь администраторы могут установить текущую дату и время, выбрать часовой пояс и настроить синхронизацию с серверами точного времени (NTP). Корректная настройка даты и времени важна для точной регистрации событий, журналов вызовов и работы функций, зависящих от расписания, обеспечивая синхронизацию системы с другими сетевыми устройствами и сервисами.
Настройка производится в разделе «Система» - «Дата и время»:
Существует возможность установить время «вручную», без использования NTP сервера. По возможности, рекомендуем использовать автоматическое определение времени.
Для настройки времени вручную переключите тумблер "Корректировать время вручную"
Описание раздела "Система" в MikoPBX
Раздел «Система» в MikoPBX — это интерфейс для управления общими настройками и параметрами телефонной системы. Здесь администраторы могут настраивать основные системные параметры, управлять обновлениями, датой и другими функциями, обеспечивающими стабильную и безопасную работу MikoPBX. Этот раздел позволяет контролировать и оптимизировать работу системы на уровне всей инфраструктуры.
В разделе «Общие настройки» в MikoPBX администраторы могут управлять основными параметрами системы, такими как настройки срока хранения записей разговоров, уведомления, параметры журналов, язык звуковых оповещений и многими другими системными опциями. Этот раздел обеспечивает контроль над общими функциями и поведением MikoPBX, позволяя оптимизировать работу системы под потребности организации.
Раздел «Дата и время» в MikoPBX — это интерфейс для настройки системных параметров даты и времени. Здесь администраторы могут установить текущую дату и время, выбрать часовой пояс и настроить синхронизацию с серверами точного времени (NTP). Корректная настройка даты и времени важна для точной регистрации событий, журналов вызовов и работы функций, зависящих от расписания, обеспечивая синхронизацию системы с другими сетевыми устройствами и сервисами.
Раздел «Почта и уведомления» в MikoPBX позволяет настроить отправку системных уведомлений через электронную почту. Здесь администраторы указывают параметры SMTP-сервера, определяют события для уведомлений, такие как голосовые сообщения или системные ошибки, и редактируют шаблоны писем. Этот раздел помогает своевременно информировать пользователей и администраторов о важных событиях, обеспечивая эффективный контроль за работой системы.
Раздел «Доступ к AMI» в MikoPBX — это интерфейс для настройки доступа к Asterisk Manager Interface (AMI). Здесь администраторы могут управлять параметрами подключения к AMI, такими как включение или отключение доступа, указание логинов и паролей для аутентификации. Настройка доступа к AMI позволяет внешним приложениям или скриптам взаимодействовать с системой MikoPBX для мониторинга и управления звонками, расширяя функциональные возможности телефонной системы.
Раздел «Кастомизация системных файлов» в MikoPBX предоставляет администраторам возможность напрямую изменять или дополнять стандартные конфигурационные файлы системы. Здесь вы можете внести индивидуальные настройки, которые не доступны через стандартный веб-интерфейс, и адаптировать поведение системы под специфические требования вашей организации.
Этот раздел предназначен для продвинутых пользователей, которые обладают глубоким пониманием структуры и работы MikoPBX. С его помощью можно:
Редактировать конфигурационные файлы: вносить изменения в существующие файлы или добавлять новые параметры.
Переопределять стандартные настройки: изменять значения по умолчанию для определенных функций или модулей.
Добавлять собственные скрипты или модули: расширять функциональность системы путем интеграции пользовательских решений.
Важно отметить, что неправильное изменение системных файлов может привести к нестабильной работе или сбоям системы. Поэтому рекомендуется создавать резервные копии перед внесением изменений и тщательно проверять корректность настроек.
Настройка почты для сервиса Yandex
Для получения уведомлений о пропущенных вызовах по электронной почте необходимо настроить SMTP-клиент. Подробная информация об уведомлениях в MikoPBX рассмотрена . В рамках данной инструкции будет рассмотрен пример настройки уведомлений о пропущенных вызовах для почтового сервиса Yandex.
по настройки smtp. Для большей безопасности следует использовать «». Не используйте основной пароль от почтового ящика.
Введем IP адрес АТС MikoPBX в браузере и перейдем в Система → Почта и уведомления.
Настройки SMTP клиента для сервиса Yandex:
SMTP хост - smtp.yandex.ru
SMTP Порт - 465 (Порт для обслуживания клиентов)
Адрес отправителя и Логин - E-mail с которого будут отправляться сообщения о пропущенных вызовах
Пароль - пароль от электронной почты, необходимый для авторизации
Метод шифрования - Использовать TLS
Осуществим отправку тестового письма на электронную почту любого сервиса. В случае успешного тестирования на указанный Вами адрес электронной почты придет тестовое письмо.
Настройка почты для сервиса Mail.ru
Для большей безопасности следует использовать «». Не используйте основной пароль от почтового ящика.
Для получения уведомлений о пропущенных вызовах по электронной почте необходимо настроить SMTP-клиент. Подробная информация об уведомлениях в MikoPBX рассмотрена . В рамках данной инструкции будет рассмотрен пример настройки уведомлений о пропущенных вызовах для почтового сервиса Mail.
Введем IP адрес АТС MikoPBX в браузере и перейдем в Система → Почта и уведомления.
Настройки SMTP клиента для сервиса Mail:
SMTP хост - smtp.mail.ru
SMTP Порт - 465 (Порт для обслуживания клиентов)
Адрес отправителя и Логин - E-mail с которого будут отправляться сообщения о пропущенных вызовах
Пароль - пароль от электронной почты, необходимый для авторизации
Метод шифрования - Использовать TLS
Возвращаемся в Система → Почта и уведомления. Осуществим отправку тестового письма на электронную почту любого сервиса. В случае успешного тестирования на указанный Вами адрес электронной почты придет тестовое письмо.
Инструкции по подключению наиболее популярных поставщиков услуг можно найти в .
Тип учетной записи - тип регистрации учетной записи провайдера. .
Альтернатива инструкции . Такой подход был не очевиден.
В данном разделе происходит основное управление модулями: их подключение, настройка, а так же загрузка своих, "кастомных" модулей. Документацию по разработке своих модулей вы можете найти .
Кнопкой с ластиком можно очистить поля, напротив которых эта кнопка располагается.
linkedid - уникальный идентификатор звонка. Данным отбором удобно пользоваться, если необходимо найти вызов, исходя из данных . Для применения этого отбора: 1. Откройте журнал звонков 1С; 2. Выделите нужную строку; 3. Нажмите Подробнее во встроенном плеере (или вызвав контекстное меню на данной строке); 4. Скопируйте поле Идентификатор; 5. Вставьте это значение в строку поиска истории вызовов MikoPBX и нажмите Enter.
Вы попадете на :
Задайте шаблон для исходящих звонков. Подробнее про шаблоны номеров .
Примеры преобразования номеров приведены , а так же .
Будьте внимательны! Если система установлена на тот же диск, где хранятся записи разговоров, то могут быть сложности с обновлением.
Обновления загружаются на АТС и сразу же применяются. Для обновления таким способом нажмите кнопку в нужной вам версии обновления.
Для обновления данным способом нажмите кнопку в нужной вам версии обновления.
Затем нажмите кнопку и выберите данный img-файл.
Как создать ключ для авторизации по SSH и добавить его на сервер? Подробности читайте .
Вы можете использовать модуль для создания самоподписанного сертификата.
О том, как настроить шаблон письма для создания e-mail уведомлений вы можете прочитать .
О том, как настроить шаблон письма для создания e-mail уведомлений вы можете прочитать .
[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-ти, вхождение от одного и более раз
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 кнопки
ВНИМАНИЕ: Все данные на дисках будут уничтожены.
Подготовьте ПК с двумя дисками одинакового объема
Загрузите машину в режиме LiveCD или LiveUSB
Подключитесь к машине через SSH
Выполните в консоли команду.
Будут отображены имена дисков. В моем случае это.
Затираем суперблоки на дисках.
Чистим старые метаданные.
Создаем RAID1.
На вопрос «Continue creating array?» отвечаем утвердительно "y".
Далее можно начать установку по инструкции . При выборе диска следует указать md0
TODO: Необходимо править grub.cfg файл. Иначе, не факт, что при сбое одного из дисков, система загрузится.
Увеличить размер диска позволяют некоторый виртуальные машины
Перед работами обязательно выполните резервное копирование данных!
Для выполнения предложенных далее команд потребуется Подключение к АТС с помощью SSH-клиента.
Диск для хранения данных обычно монтируется в каталог «/storage/usbdisk1». Из примера выше видно, что на текущий момент доступно 4.5G из 4.9G.
Перед началом работ следует отмонтировать диск. Для этого запустите скрипт:
Убедитесь, что диск для хранения данных более не смонтирован:
Для начала удалим существующий раздел. Эта операция НЕ удаляет данные на диске, просто правит таблицу разделов.
Запускаем редактор разделов:
Система запросит ввести команду, вводим «d» и жмем Enter:
Система запросит выбрать раздел к удалению, он один, вводим номер раздела «1» и жмем Enter:
Сохраняем таблицу разделов, вводим команду «w» и жмем Enter:
Запускаем редактор разделов:
Система запросит ввести команду, вводим «n» и жмем Enter:
Далее указываем команду «p», раздел будет первичным, жмем Enter:
Вводим номер создаваемого раздела «1», жмем Enter:
Далее система запросит ввести номера первого и последнего сектора «First sector» / «Last sector», ждем Enter, ничего не вводим и соглашаемся со значениями «по умолчанию».
Размер раздела должен соответствовать размеру диска.
Запускаем команду проверки:
Пример результата работы команды:
Запускаем команду:
Пример вывода команды:
При загрузке система автоматически смонтирует диск для хранения данных:
В ряде случаев необходимо предусмотреть сохранение записей разговоров на сетевой диск. В этом примере покажем как подключить к MikoPBX общий каталог windows.
Обратите внимание: если сетевой каталог будет не доступен, возможны сбои в работе АТС.
Создадим каталог для хранения скрипта
Создадим файл скрипта
Вставьте содержимое скрипта
Нажмите сочетание клавиш «CTRL+D» два раза для завершения создания файла
Предоставьте права на исполнение
В переменных скрипта «HOST,USER,PASS» следует описать параметры подключения к общему каталогу
Скрипт необходимо доавить в cron для автоматического подключения общей папки
Перейдите в раздел «Система» - «Кастомизация системных файлов»
Добавьте в конец файла «/var/spool/cron/crontabs/root» следующее правило
Протестируйте работу АТС, убедитесь, что записи разговоров сохраняются на сетевой диск.
Если АТС работает за NAT и серый публичный IP адрес изменился, то АТС не сможет получить входящий вызов пока не пройдет регистрация на стороне провайдера, по умолчанию это может занять от 2х до 6 мин.
Попробуем это поправить.
Подключитесь к АТС по ssh.
Создайте новый файл скрипта командой:
Система запросит ввод с клавиатуры, вставьте содержимое скрипта:
Нажмите CTRL + D
для завершения ввода.
Добавьте правка на исполнение:
Перейдите в web интерфейс MikoPBX "Система
" - "Кастомизация системных файлов
"
Добавьте задачу в конец файла /var/spool/cron/crontabs/root
:
Теперь каждую минуту будет выполняться проверка на изменение публичного адреса, если адрем изменился, то будет выполнена перерегистрация всех провайдеров.
В системном логе system/messages
отобразиться информационное сообщение об изменении IP.
000063
Приложение считывает внутренний номер сотрудника, используемое для вызова приложения, и озвучивает его сотруднику, т.е. сотруднику озвучивается его внутренний номер на АТС
000064
0000MILLI - Генерирует постоянный звуковой сигнал частотой 1000 Гц. Используется для проверки качества соединения.
10003246
Приложение Echo посылает полученные аудиосигналы обратно пользователю, чтобы можно было определить длительность задержки. В общем, Вы слышите, что Вы говорите. Приложение в основном используется для тестирования.
Описание возможностей раздела "Кастомизация системных файлов"
Раздел «Кастомизация системных файлов» в MikoPBX предоставляет администраторам возможность напрямую изменять или дополнять стандартные конфигурационные файлы системы. Здесь вы можете внести индивидуальные настройки, которые не доступны через стандартный веб-интерфейс, и адаптировать поведение системы под специфические требования вашей организации.
С его помощью можно:
Редактировать конфигурационные файлы: вносить изменения в существующие файлы или добавлять новые параметры.
Переопределять стандартные настройки: изменять значения по умолчанию для определенных функций или модулей.
Добавлять собственные скрипты или модули: расширять функциональность системы путем интеграции пользовательских решений.
Он находится в Система -> Кастомизация системных файлов:
Важно отметить, что неправильное изменение системных файлов может привести к нестабильной работе или сбоям системы. Поэтому рекомендуется создавать резервные копии перед внесением изменений и тщательно проверять корректность настроек.
Мы рекомендуем использовать возможности данного раздела только опытным администраторам Asterisk. В MikoPBX есть возможность из web-интерфейса изменять следующие конфигурационные файлы:
Наименование файла
Описание
asterisk.conf
Общие (глобальные) настройки Asterisk. В файле конфигурации asterisk.conf Вы определяете следующее: -Местоположение, права доступа и владельца сокета, которые используется для подключения удаленной консоли управления сервером. Местоположение различных директорий, используемых сервером Asterisk для определения местоположения файлов конфигурации, библиотек, скриптов и место, где будут создаваться лог фалы. Параметры командной строки запуска сервера, используемые по умолчанию.
cel.conf
Лог событий канала. В отличии от CDR, сохраняет все события имевшие место в канале.
extensions.conf
План набора (dialplan) Asterisk. В нем определяется обработка и маршрутизация входящих и исходящих вызовов. Этот файл управляет поведением всех соединений, проходящих через Вашу АТС.
features.conf
В файле назначаются пользовательские коды и опции абонентских функций Asterisk, такие как: перевод вызова (transfer); перехват вызова (pickup); запись по требованию (record on demand); таймауты набора и переадресации (digit timeout); паркинг (park) и др.
http.conf
Встроенный http сервер Asterisk
iax.conf
В файле Вы описываете ваши соединения по протоколу IAX.
indications.conf
Национализация тональных сигналов
logger.conf
Настройка логов Asterisk. В данном файле настраивается логирование событий Asterisk в файлы, консоль и syslog linux. Для применения настроек выполните команду «logger reload» в консоли (CLI) Asterisk.
manager.conf
Настройка интерфейса AMI (Asterisk Manager Interface)
modules.conf
Параметры загрузки модулей Asterisk.
musiconhold.conf
Параметры музыки на удержание в IVR
queues.conf
Очередь входящих вызовов Asterisk. Подробное описание стратегии вызовов. Penalty, timeout, member и все доступные параметры.
rtp.conf
Глобальные настройки RTP - медиа-портов и протокола
sip.conf
Файл отвечает за настройку внутренних и внешних каналов SIP в Asterisk.
voicemail.conf
Настройки уведомлений по E-mail
jail.local
Настройки Fail2ban
msmtp.conf
Настройки SMTP-клиента
Перед Вами будет открыта форма редактирования конфигурационного файла:
Выберите один из четырех возможных вариантов редактирования:
«Не менять» - не позволяет вносить изменения в файл, только чтение файла.
«Добавлять в конец файла» - в конец выбранного конфигурационного файла будут добавлены (рекомендуемый).
«Заменять полностью» - все Ваши изменения переопределят конфигурационный файл.
Режим "Script" - читайте далее.
Существуют сценарии, когда нужно выполнить более сложные модификации системных файлов, чем простое добавление текста в конец конфигурационного файла. Например, нужно выполнить переопределение параметров PJSIP учетных записей, но хочется сохранить возможность настройки системы через веб интерфейс.
Реализован новый подход к кастомизации. Можно описать bash скрипт, который будет выполняться каждый раз после того, как система сформирует конфигурационный файл. В итоге интегратор сможет делать очень тонкие изменения конфигурационных файлов без разработки дополнительных модулей.
Например, мы хотим поменять значение max_contacts у всех сотрудников, кроме одного.
Добавить параметры к существующей секции возможно используя конструкцию (+):
Описать новую секцию можно в произвольной форме, единственное, не следует допускать повторения имен секций: Пример:
Дорабатывайте dialplan с осторожностью - есть большая вероятность нарушить работу АТС!
Существует возможность перехватить выполнения dialplan. Для этого необходимо описать custom контексты. На текущий момент можно перехватить выполнения в следующих контекстах:
internal-originate-custom - контекст используется при звонках из панели телефонии для 1С
<ID-ПРОВАЙДЕРА>-incoming-custom - контекст предназначен для обработки входящих вызовов через провайдера
<ID-ПРОВАЙДЕРА>-outgoing-custom - контекст предназначен для обработки исходящих вызовов через провайдера
all_peers-custom - контекст используется при прямом исходящем звонке с телефона
outgoing-custom - контекст используется при наборе внешнего номера, ДО выбора исходящего маршрута
add-trim-prefix-clid-custom - этот контекст используется при обработке входящих вызовов, лучшим образом подходит для нормализации входящего номера телефона, добавить / отсечь префикс
internal-users-custom - в этом контексте обрабатываются вызовы на внутренние номера
public-direct-dial-custom - контекст обработки входящих вызовов БЕЗ авторизации
Пример контекста:
Обязательно следует в конце вызывать метод «return».
Некоторые примеры использования custom-контекстов:
Настройка исходящего AOH для сотрудника
Вариант обновления из консоли MikoPBX
Ниже приведен пример с АТС, установленной на виртуальную машину VirtualBOX. Обновление производится с версии 2022.2.102 до версии 2022.3.15. Скачайте из репозитория iso-образ нужной вам версии АТС.
В программе VirtualBOX откройте настройки виртуальной машины на которой установлена АТС. Перейдите в раздел Носители. Выделите виртуальный оптический привод. Нажмите на значок в группе Атрибуты, нажмите Выбрать файл диска. Выберите скачанный iso-образ АТС. Запустите машину.
В консоли отобразится соответствующая строка "The system loaded in Recovery mode" («АТС загружена в режиме восстановления» на русском).
Выберите Install / Repair (или нажмите на клавиатуре цифру 8) и нажмите «Enter».
Вам нужна команда "Update to version ****.*.**". Нажмите на клавиатуре цифру 2, затем нажмите «Enter». Начнется установка обновления. Когда она завершится, АТС перезагрузится.
После перезагрузки АТС сообщения "The system loaded in Recovery mode" уже не будет, что означает, что АТС загрузилась с жесткого диска, а не с виртуального оптического привода. Вверху зеленым шрифтом будет обозначена установленная версия обновления.
Описание функций раздела
Раздел «Диагностика системы» в MikoPBX — это инструмент для мониторинга и анализа состояния телефонной системы. Использование этого раздела помогает своевременно обнаруживать и устранять технические проблемы, обеспечивая стабильную и эффективную работу MikoPBX.
Расположение раздела: "Обслуживание" -> "Системные логи"
Содержит 3 вкладки: просмотр логов, информация о системе, захват сетевых пакетов. Далее в статье будет подробно разобрана каждая из них.
Раздел позволяет просмотреть файлы логов для детального анализа работы АТС
Для начала работы - выберите файл.
Установите лимит строк для выборки.
Установите офсет - значение сдвига в выборке.
Установите фильтр по вхождению строки в выборку.
Доступны следующие возможности:
Допустим необходимо проанализировать прохождение исходящего звонка на номер 74952293042
Выберите файл для анализа asterisk/verbose.
В качестве фильтра установите номер телефона 74952293042.
В поле лимит укажите значение с запасом, к примеру 2000, иначе могут быть выданы не все записи лога.
В последней строке выборке следует найти идентификатор:
В данном примере ID = C-0000000f.
Повторяем запрос лога, но уже с фильтром C-0000000f.
Будет получен весь лог прохождения dialplan.
Полученные данные можно отправить специалисту технической поддержки.
Данная вкладка отображает следующую информацию:
Сетевые настройки
Нагрузка на CPU
Потребляемая оперативная память
Настройки iptables
Данный раздел позволяет произвести детальный анализ ошибок в работе АТС.
Вы можете запустить сбор сетевых пакетов, проходящих через сетевой интерфейс.
Для запуска процесса нажмите кнопку "Старт".
Воспроизведите вашу проблему: совершите звонок или иное действие, приводящее к сбою / ошибке.
Нажмите кнопку "Остановить и скачать".
Сетевые пакеты будут автоматически сохранены в архив MikoPBXLogs_log-tcpdump-XXXXXXXXXX. Также они должны автоматически сохраниться в папку Загрузки вашего браузера.
Если в папке Загрузки архив найти не удалось , можете подключиться к АТС через WinSCP и скачать его из директории /storage/usbdisk1/mikopbx/tmp - файл log-tcpdump-XXXXXXXXXX.zip
Существует возможность воспользоваться поиском в WinSCP: в поле имени искомого файла ввести "log-tcpdump*", а в каталоге поиска ввести "/storage".
Вы можете скачать все накопленные на АТС системные логи. Для этого нажмите кнопку "Скачать все системные логи".
Системные логи будут автоматически сохранены в архив MikoPBXLogs_log-sys-XXXXXXXXXX.zip. Логи автоматически должны сохраниться в папку Загрузки вашего браузера. Так же данный архив с логами можно получить из каталога /storage/usbdisk1/mikopbx/tmp, подключившись к АТС при помощи WinSCP. Файл - log-sys-XXXXXXXXXX.zip
Будьте внимательны! При большом объеме звонков или прочей сетевой «нагрузки» на АТС логи могут занять довольно много места на диске.
С помощью SSH-клиента
С помощью утилиты Wireshark
С помощью приложения tcpdump
При публикации АТС на публичном IP адресе возникает задача по защите АТС от сканеров, вредителей, кто пытается подобрать пароли к SIP учетным записям АТС. Если установлен простой числовой пароль, то он будет подобран очень быстро, что повлечет убытки.
Для базовой защиты от сканеров обязательно следует включить fail2ban. Дополнительно, можно более тонко настроить правила iptables.
Перейдите в раздел "Кастомизация системных файлов"
Перейдите к редактированию файла /etc/firewall_additional
Установите режим "Добавлять в конец файла", вставьте следующий код:
Добавленное правило позволит блокировать все входящие запросы по UDP протоколу, которые содержат подстроку «friendly-scanner»
Более полный пример набора правил:
Это обезопасит от большинства сканеров, которые при запросе упоминаю User-Agent.
Настройка почты для сервиса gmail
Всегда используйте «Пароли приложений» для авторизации. См. инструкции. Инструкции по настройке smtp от Gmail
Для получения уведомлений о пропущенных вызовах по электронной почте необходимо настроить SMTP-клиент. Подробная информация об уведомлениях в MikoPBX рассмотрена здесь. В рамках данной инструкции будет рассмотрен пример настройки уведомлений о пропущенных вызовах для почтового сервиса Gmail.
Введем IP адрес АТС MikoPBX в браузере и перейдем в Система → Почта и уведомления.
Настройки SMTP клиента для сервиса Gmail:
SMTP хост - smtp.gmail.com
SMTP Порт - 465 (Порт для обслуживания клиентов)
Адрес отправителя и Логин - E-mail с которого будут отправляться сообщения о пропущенных вызовах
Пароль - пароль от электронной почты, необходимый для авторизации
Метод шифрования - Использовать TLS
Сохраним введённые настройки и перейдем к настройке Вашего почтового аккаунта. Особенностью сервиса Gmail является то, что к Вашему аккаунту автоматически запрещен доступ ненадежным приложениям, к которым относится MikoPBX, поэтому необходимо вручную разрешить доступ к данным приложениям (инструкции по настройке размещены здесь).
Возвращаемся в Система → Почта и уведомления. Осуществим отправку тестового письма на электронную почту любого сервиса. В случае успешного тестирования на указанный Вами адрес электронной почты придет тестовое письмо.
О том, как настроить шаблон письма для создания E-mail уведомления вы можете прочитать здесь.
Настройка доступа к AMI
Asterisk Manager Interface (AMI) - мощный и удобный программный интерфейс (API) Asterisk для управления системой из внешних программ. Благодаря AMI внешние программы могут осуществлять соединения с Asterisk посредством TCP протокола, инициировать выполнение команд, считывать результат их выполнения, а так же получать уведомления о происходящих событиях в реальном времени. AMI часто используют для интеграции с бизнес-процессами и системами, программным обеспечением CRM (Customer Relationship Managment — управление взаимодействия с клиентами). Управление Asterisk часто осуществляется из консоли CLI, но при использовании AMI не требуется прямой доступ к серверу, на котором запущен Asterisk. AMI — это наиболее простой инструмент, который в руках разработчика может оказаться очень мощным и гибким средством для интеграции с другими программными продуктами. Он дает возможность разработчикам использовать информацию, генерируемую Asterisk, в реальном масштабе времени.
Первое что необходимо сделать, это включить AMI и завести пользователя, с помощью которого клиентская программа будет аутентифицироваться. «Система» - «Доступ к AMI»
Для добавления новой учетной записи необходимо указать Имя пользователя и Пароль. Кроме того, необходимо задать Сетевой фильтр, т.е. из какой подсети разрешено подключение к пользователю AMI. Вы можете разрешить подключения с любых адресов, либо указать конкретную сеть, настройку который Вы произвели в разделе "Сеть и Firewall" → "Сетевой экран".
Права пользователя AMI, устанавливаемые в секции [user] конфигурационного файла /etc/asterisk/manager.conf
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 на другой сервер
Существует несколько способов для переноса MikoPBX на другой хост (сервер). Каждый из них имеет свои положительные моменты и особенности. Всю краткую информацию по каждому из вариантов Вы можете изучить далее в этом разделе.
Описание:
Создаётся резервная копия текущей конфигурации MikoPBX, которая затем загружается на новый сервер. Этот способ подходит для небольших объемов данных.
Плюсы:
Простота в настройке.
Позволяет сохранить текущую конфигурацию.
Особенности:
Может быть ненадёжен при больших объемах данных.
Требует промежуточного хранения резервной копии (например, на локальном диске или облаке).
Описание:
Резервная копия автоматически создаётся и сохраняется сразу на целевой сервер через протокол SFTP. Этот способ особенно эффективен для больших объемов данных.
Плюсы:
Подходит для больших объемов данных.
Позволяет минимизировать ручные действия.
Обеспечивает прямой перенос данных между серверами.
Особенности:
Требует настроек SFTP на обоих серверах.
Необходим доступ к данным текущего пользователя SSH для корректной работы.
Описание:
Используется команда rsync
для синхронизации данных напрямую между старым и новым серверами. Этот метод удобен для опытных пользователей.
Плюсы:
Быстрая синхронизация даже для больших объемов данных.
Сохранение прав доступа и структуры каталогов.
Не требует создания промежуточных резервных копий.
Особенности:
Требует базовых знаний работы с командной строкой.
Возможны ошибки при настройке (например, указание неправильных путей).
Серверы должны быть одновременно доступны в сети.
Вариант переноса данных с использованием rsync (предпочтительный)
В данной статье будет разобран вариант переноса данных на новый хост с помощью rsync. Данный вариант - перенос с использованием генерируемого ключа для ssh-авторизации (предпочтительный). Этот способ является самым надёжным из представленных в разделе, поэтому и является рекомендуемым к использованию.
Для начала нам необходимо установить SSH соединение с новой MikoPBX. Прочитать как сделать это, можно в этой статье.
Далее переходим в консоль ([9] Console). Первым делом необходимо создать директорию для хранения файла со скриптом. Используйте следующую команду:
Перейдите в созданную директорию:
Создадим файл "transfer-rsync.sh" для хранения скрипта:
Далее необходимо заполнить файл содержимым (скриптом). Ознакомиться с ним Вы можете по ссылке.
На данном этапе необходимо сделать файл исполняемым. Для этого используйте следующую команду:
Запустите скрипт, используя команду:
Для начала будет предложено ввести необходимые данные о вашей старой станции MikoPBX:
IP-адрес вашей старой станции
Имя для ssh-авторизации
Порт для ssh-авторизации
Далее будет предложено сгенерировать новый ключ. В случае, если ранее вы этого не делали, введите "y" для подтверждения. Если ранее вы уже генерировали ключ для доступа ко второй MikoPBX - введите "n":
Будет создан новый ключ. Вам необходимо скопировать его и вставить в web-Интерфейсе старой MikoPBX. Сделать это нужно в разделе "Общие настройки" -> "SSH" -> Поле "SSH Authorized keys"
После того, как вы сохранили ключ на старой MikoPBX, подождите несколько секунд и нажмите любую клавишу для продолжения выполнения скрипта.
Будет произведен перенос всех данных на новый хост. Это может занять некоторое время.
После переноса обязательно проверяйте целостность всех данных, перед тем, как сбрасывать старую MikoPBX!
При работе с поставщиками услуг связи периодически могут возникать проблемы. К примеру сервер поставщика не отвечает / не доступен. В рамках данной статьи будет предложен механизм оповещения на email системного администратора.
Для работы оповещений потребуется настроить SMTP клиент. См. инструкции в разделе «Почта и уведомления»
Создайте новое «Приложение диалплана».
Укажите название - например, Provider Monitoring, короткий номер для приложения, к примеру 99, а так жу выберите «Тип кода» - «PHP AGI Скрипт»
Перейдите во вкладку "Программный код":
Вставьте код:
Сохраните изменения и скопируйте идентификатор приложения из адресной строки браузера, он имеет вид «DIALPLAN-APP-9С060381»
Перейдите в раздел Система → Кастомизация системных файлов, откройте для редактирования файл /var/spool/cron/crontabs/root
Выберите режим «Добавлять в конец файла», внизу в черное поле для редактирования вставьте следующий код:
Скорректируйте имя файла согласно вашему идентификатору приложения «DIALPLAN-APP-9С060381»
Сохраните изменения.
Готово!
MikoPBX установлена на отдельно выделенный сервер по инструкции. В качестве дополнительного диска для хранения записей разговоров (диск storage) подключен 4-ый раздел основного диска (/dev/sda4), где установлена MikoPBX. Свободное место на 4-ом разделе диска закончилось. Необходимо подключить к MikoPBX в качестве диска storage отдельный диск (/dev/sdb) и перенести на него все записи разговоров, которые ранее хранились на 4-ом разделе основного диска.
Подключитесь к MikoPBX через SSH-клиент по инструкции
Перейдите в консоль - для этого выберите: [9] Console (Shell)
Отключаем storage диск «sda4»:
Перейдите в раздел «Общие настройки» -> "Удаление настроек системы"
В поле ввода вставьте текст "удалить всё", нажмите "Сохранить"
Откройте консольное меню MikoPBX. С клавиатуры введите 9 для перехода в консоль АТС.
Введите последовательно две команды:
После выполнения данных команд MikoPBX перезагрузится. Вход в web-интерфейс происходит с логином (admin) и паролем (admin) по умолчанию.
Описание вариантов подключения к АТС по SSH
SSH (Secure Shell) — это протокол для безопасного удалённого подключения к серверам и управления ими. Он используется для выполнения команд, передачи файлов и администрирования систем через зашифрованный канал. SSH помогает защитить данные от перехвата, обеспечивая аутентификацию и шифрование между клиентом и сервером. Это основной инструмент для разработчиков, системных администраторов и DevOps-инженеров при работе с удалёнными машинами.
Далее будет рассмотренно два разных способа подключения к MikoPBX по SSH протоколу:
Подключение с помощью пароля через сторонние приложения (в данной статье в примере - putty)
Подключение с помощью ключей, что и будет рассмотренно далее с примером на Windows, Linux (MacOS)
В данной инструкции будет описано подключение по SSH с помощью Putty
Скачайте программу для подключения по SSH. Это можно сделать на официальном сайте по ссылке
Запустите скаченную программу. У вас откроется главное меню.
Перейдите в раздел «Соединение» - «Данные»
«Имя пользователя для автовхода» укажите root
«Строка типа терминала» укажите xterm-256color
Перейдите в раздел «Кодировка»
«Кодировка» - укажите UTF-8
Установите флаг «Включить рисование линий VT100 даже в режиме UTF-8»
Перейдите в раздел «Сессия» - «Журнал». Тут можно настроить вывод в файл:
Перейдите в раздел "Сеанс"
9. Необходимые данные:
Имя хоста (или IP-адрес)- IP адрес АТС
Порт - порт для подключения по SSH по умолчанию 22
Введите имя сессии и сохраните ее настройки
В дальнейшем используйте действие «Загрузить» для использования сохраненной ранее сессии
Выполните действие «Соединиться» для подключения к АТС и введите пароль SSH
Перед подключением вам необходимо разрешить авторизацию по паролю в веб-интерфейсе MikoPBX, а так же задать пароль для подключения: для этого перейдите "Общие настройки" -> "SSH"
После ввода пароля SSH, у вас откроется меню АТС
Для открытия консоли перейдите в "[9] Console(Shell)"
При добавлении на АТС нового Сотрудника на АТС заводится учетная запись SIP с числовым внутренним номером. В ряде случаев, в целях безопасности есть необходимость изменить имя для авторизации этого сотрудника.
При настройке SIP Клиентов часто можно увидеть два ключевых параметра:
Username - обычно равен ID учетной записи, в случае с MikoPBX равен внутреннему номеру
Auth Username - имя пользователя для авторизации. В случае MikoPBX равен внутреннему номеру
Для изменения имени авторизации:
Откройте учетную запись сотрудника на редактирование
Перейдите к «Расширенным настройкам» → «Дополнительные параметры SIP»
Добавьте следующие строчки:
Вместо MIKO204 укажите имя для авторизации, желательно использовать и буквы и цифры
Бывают случаи, когда при телефонном звонке очень тихо слышно клиента и на телефонном аппарате / софтфоне нет возможности повысить уровень громкости. Опишем способ, который может помочь в решении проблемы:
Перейдите в раздел "Система" -> "Кастомизация системных файлов"
Откройте на редактирование modules.conf
Добавьте в конец файла
Сохраните изменения
Откройте на редактирование файл extensions.conf
Добавьте следующий код в конец файла:
Сохраните изменения.
Откройте на редактирование файл features.conf
Добавьте в конец файла следующий код:
Сохраните изменения.
Громкость по умолчанию станет выше, значение 5 вместо 0. При желании сотрудник может набрать #1 для увеличения громкости или #0 для уменьшения.
Вариант переноса MikoPBX на другой хост
Данный способ заключается в создании резервной копии текущей конфигурации MikoPBX, её переносе и восстановлении на новом сервере. Он прост в реализации, подходит для небольших систем. Этот метод удобен для пользователей с минимальным техническим опытом.
Для начала нужно выполнить резервное копирование Вашей прошлой системы. Подробнее прочитать про это Вы можете в данной статье.
Выберите данные, которые Вы хотите перенести, дождитесь окончания процесса.
Выполните загрузку Вашего архива, нажав на соответствующий элемент в разделе "Модуль резервного копирования":
На новом хосте (сервере) Вашей MikoPBX выполните восстановление из архива, нажав на элемент "Загрузите файл для восстановления"
После этого Ваша система будет восстановлена из архива. Данный способ идеально подходит для переноса небольшого объёма данных.
Вариант переноса MikoPBX на другой хост
Второй способ предполагает настройку автоматического резервного копирования с сохранением данных напрямую на целевой сервер через SFTP. Этот метод особенно удобен для переноса большего объёма данных, так как исключает необходимость промежуточного хранения резервной копии.
Для начала нам необходимо настроить резервное копирование по расписанию для MikoPBX, с которой необходимо перенести данные.
Перейдите в модуль "Резервное копирование":
Перейдите во вкладку "Расписание архивации":
Далее настраиваем параметры архивации по расписанию:
Адрес сервера - адрес Вашей новой станции MikoPBX.
Протокол - SFTP
Порт - 22
Имя пользователя - имя пользователя для SSH подключения к вашей новой станции.
Пароль - пароль для SSH подключения к вашей новой станции.
Путь на сервере - "/storage/usbdisk1/mikopbx/backup/"
Прочитать про SSH подключение Вы можете в этой статье. Для начала резервного копирования сразу после сохранения настроек - выберите параметр "Начать создание копии сразу после сохранения настроек". Так же вы можете выбрать необходимые данные для переноса в соответствующем разделе.
Дождитесь завершения резервного копирования и отключите старую машину.
При успешном переносе данных, Ваша резервная копия появится в разделе модуля на новом хосте:
Выполните восстановление из копии на вашем новом хосте, для этого:
Перейдите в раздел настроек резервной копии, нажав на соответствующий элемент:
Выберите данные, которые Вам необходимо перенести и нажмите "Восстановить из архива":
Это статья про первый вход в MikoPBX. Здесь вы найдете процесс первого входа в систему и некоторые рекомендации по первоначальной настройки после входа.
Перейдите в консоль MikoPBX, вверху будет находиться IP-адрес, по которому вы можете подключиться через WEB-интерфейс. При установках не на локальный компьютер используйте внутренний IP-адрес. Скопируйте или запомните его.
Введите или вставьте IP-адрес MikoPBX в web-браузере. Отобразится страница авторизации в web-интерфейс. Введите логин и пароль по умолчанию.
Данные по умолчанию:
Логин - admin
Пароль - admin
После первой успешной авторизации, MikoPBX автоматически откроет настройки для смены пароля. Поменяйте пароль и нажмите "Сохранить".
Данная инструкция подробно расскажет о пути начала работы с MikoPBX и поможет вам быстро разобраться с настройкой системы.
Следуйте инструкциям шаг-за-шагом в том порядке, в котором они представлены для быстрой и успешной настройки системы.
MikoPBX - полноценная операционная система для вашего оборудования, не является отдельной программой. Поставляется в виде образа (файл *.iso, *.img, *.raw).
Она поддерживает многие способы установки:
Установка .
Установка .
Установка .
Установка в .
Перейдите по ссылке к интересующему Вас способу установки и произведите её по данным инструкциям.
После установки Вам необходимо перейти в web-интерфейс MikoPBX для дальнейшей настройки системы. Для того, чтобы это сделать - найдите IP-адрес станции в консоли MikoPBX:
В данном примере - IP-адрес 172.25.233.36. Для перехода в web-интерфейс введите этот IP в адресную строку вашего браузера:
Если в логах Вам не даны логин и пароль, используйте данные по-умолчанию:
Username: admin
Password: admin
После первой авторизации, система попросит Вас поменять пароль.
На данном этапе необходимо задать правила маршрутизации для входящих и исходящих вызовов: как будут обрабатываться звонки, идущие через определенного провайдера:
Для создания правил маршрутизации Вам так же могут понадобиться следующие функции:
Маркетплейс позволяет расширить стандартный функционал системы с помощью модулей:
На этом основная настройка MikoPBX завершена! Для более глубокого изучения возможностей MikoPBX рекомендуем обратиться к общей документации.
В данной статье Вы сможете найти инструкции по установке MikoPBX на отдельный компьютер.
Протестировано на:
Intel NUC DCCP847DYE
Intel NUC D54250WUKH
Большинство современных ПК поддерживают загрузку с USB устройства. MikoPBX может быть запущена с USB устройства.
Обратите внимание! Минимальная емкость USB диска - 600MB
Режим Bootable USB предназначен для работы АТС с USB диска (флэш карты). Используйте для установки файл *.img
Режим Live USB предназначен для установки или восстановления системы. Используйте для установки файл *.iso
Для создания загрузочного USB диска рекомендуем использовать приложение imageUSB. Скачать можно по . Альтернатива - используйте
Загрузите и установите приложение.
Запустите ImageUSB
Выполните действие «Refresh drives». Выберите USB диск, далее выберите файл образа. Выполните действие «Write»
Дождитесь окончания записи, далее подключите USB диск к ПК. Перезагрузите ПК для загрузки с диска.
Будьте внимательны при выборе устройства к форматированию. Изменения не обратимы!
Откройте приложение «Terminal» (Терминал)
Подключите USB диск
Выполните команду:
Будет отображена информация о всех подключенных дисках
В текущем примере имя устройства USB «/dev/disk3». Cравним вывод команды «diskutil list» до и после подключения устройства.
Форматируем диск. Потребуется ввести пароль администратора
Отключим устройство следующей командой
Запишем образ на USB носитель
Дождитесь окончания записи, далее подключите USB диск к ПК. Перезагрузите ПК для загрузки с диска.
Установка MikoPBX с помощью VirtualBox
Используйте для установки на VirtualBOX версии АТС MikoPBX ниже 2024.1.114
Версия 2024.1.114 временно не поддерживает установку на 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 на завершена.
Установка MikoPBX с помощью VMware Workstation Pro
В текущей инструкции будет описан процесс создания и настройки виртуальной машины в VMware Workstation Pro, а так же процесс установки MikoPBX.
Скачать установщик VMware Workstation Pro можно .
Используйте для установки на VMware Workstation Pro версии АТС MikoPBX отличные от 2024.1.114
Версия 2024.1.114 временно не поддерживает установку с помощью VMware Workstation Pro!
Перейдите в интерфейс VMware WorkStation Pro. Нажмите кнопку "Create a New Virtual Machine" для создания новой виртуальной машины.
В интерфейсе создания виртуальной машины укажите тип виртуальной машины: "Typical (recommended)". Далее, нажмите - "Next >".
Выберите "Linux" в поле "Guest operating system". В качестве "Version" - "Debian 11.x 64-bit". Нажмите "Next >"
Укажите желаемое имя для виртуальной машины в поле "Virtual machine name:". Так же есть возможность указать локацию для этой виртуальной машины на вашем компьютере: используйте поле "Location". Нажмите "Next >".
Укажите размер для первого (системного) жесткого диска: рекомендуемое значение - 1Гб. Выберите "Split virtual disk into multiple files". Нажмите "Next >".
Отобразится итоговая конфигурация виртуальной машины. Нажмите "Finish". Произойдет создание виртуальной машины.
Далее мы создадим и подключим второй жесткий диск, который будет использоваться для хранения записей разговоров.
Перейдите в настройки раннее созданной виртуальной машины.
Нажмите "Add..." для добавления нового элемента системы.
Выберите "Hard Disk" в разделе "Hardware types". Нажмите "Next >"
Выберите "Virtual disk type" - "SCSI". Нажмите "Next >".
Выберите "Create a new virtual disk". Нажмите "Next >".
Выберите размер диска: рекомендованное значение - не менее 50 Гб. Так же выберите параметр "Split virtual disk into multiple files". Нажмите "Next >"
Укажите произвольное название для жесткого диска. Нажмите "Finish"
В настройках перейдите в раздел "Network Adapter". Выберите "Network connection" - "Bridged: Connected directly to the physical network". Нажмите "OK"
Произведите запуск виртуальной машины.
Откроется командный интерфейс MikoPBX. АТС начнет загружаться. На данном этапе MikoPBX загружается с оптического диска, на который записан ISO-образ. На это нам указывает строчка: "The system is loaded in Recovery mode".
Выбрать пункт меню - клавиша Enter.
Переключите язык интерфейса на русский. Для этого выполните "[1] Change Language" -> "[2] Русский".
Далее произведем установку MikoPBX. Перейдите в пункт "[8] Install".
Отобразится информация о всех доступных дисках (в данном примере: sdb, sdc). Системой предложен диск по умолчанию, в нашем случае - sdb. Если вы согласны с предложенным диском, который будет использоваться в качестве системного - нажмите Enter. В противном случае напишите название другого диска.
Все данные на диске, куда устанавливается MikoPBX, будут потеряны.
Далее система выдаст предупреждения. Для подтверждение операции - введите "y" и нажмите Enter.
После выполнения установки будет предложено выбрать диск для хранения записей разговоров. Введите имя диска (в данном примере - единственный доступный диск sdc) и нажмите Enter.
После завершения установки система перезагрузится.
Теперь MikoPBX будет запускаться с диска sdb, на который вы ее установили. Увидим, что строчка «The system is loaded in Recovery mode» отсутствует. Это значит, что установка MikoPBX совершена успешно.
Для того, чтобы открыть веб-интерфейс MikoPBX вам надо вписать в строку браузера IP-адрес вашей виртуальной машины, найти его вы можете в консоли.
Впишите IP-адрес в адресную строку вашего браузера. Произведите первый вход в MikoPBX по стандартному логину и паролю.
При первом входе в WEB-интерфейс MikoPBX используйте стандартные данные:
Логин: admin
Пароль: admin
Для редактирования конфигурационного файла воспользуйтесь кнопкой:
1. Cкачать полученную выборку в виде файла
2. Обновить выборку
3. Автоматическое обновление выборки
Более подробную информацию об Общих настройках в разделе
После смены пароля система будет полностью готова к работе. Рекомендуется сразу же настроить правила firewall. Прочитать про то, как это сделать, можно по .
Для стабильной работы АТС необходимо настроить сеть через раздел Сеть и Firewall → Сетевые интерфейсы. Ознакомится с подробной инструкцией по данным настройкам можно .
В MikoPBX все локальные подсети возможно описать в разделе Сеть и Firewall → Сетевой экран. Сетевой экран предназначен для ограничения доступа к станции по типу трафика и подсетям. Выполните настройку по .
Fail2ban блокирует IP адреса с нестандартной активностью, он способен снизить скорость неудачных попыток аутентификации, позволяет защитить Вашу АТС от взлома. Инструкцию, которая поможет в настройке можно найти .
После окончания первоначальной настройки АТС, Вы можете перейти к созданию учетных записей ваших сотрудников. В этом вам поможет .
После добавления сотрудников, Вам необходимо подключить провайдеров к вашей станции. Инструкцию про этот раздел вы можете найти . Инструкции с примерами настройки реальных провайдеров вы можете найти .
Подробнее про Модули в MikoPBX Вы можете прочитать в .
Про регистрацию в Маркетплейсе MikoPBX Вы можете прочитать в .
1. Скачайте программу VirtualBox по и установите ее.
Перемещаться по пунктам меню можно .
Также можно выбирать пункт меню нажав на соответствующую пункту цифру.
Далее выберите источник установки "Installer disc image file (iso):", выберите файл образа диска с расширением .iso. Скачать дистрибутив вы можете по . После выбора нажмите "Next >" для продолжения.
Перемещаться по пунктам меню можно .
Также можно выбирать пункт меню нажав на соответствующую пункту цифру.
В данной статье вы сможете найти системные требования для MikoPBX.
Пример расчета необходимой пропускной способности канала для различных кодеков на 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Мб места на диске. Для диска хранения записей разговоров рекомендуемый размер - не менее 50 гигабайт.
Установка MikoPBX с помощью Proxmox.
Откройте вкладку local / ISO images и выберите Download from URL
В поле URL вставьте ссылку на файл из дистрибутива MikoPBX с расширением .iso
Нажмите кнопку Download, дождитесь окончания загрузки файла
Выберите Create VM
На вкладке General введите имя (Name) виртуальной машины, например mikopbx-vm
Перейдите к следующей вкладке OS, в поле ISO image выберите загруженный ранее образ
Укажите тип OS (Type) - Linux
На вкладке System уберите флажок Qemu Agent, для других полей используйте значения по умолчанию
Для развертывания АТС используйте два диска:
диск объемом 1 Гб для основной системы
диск объемом 50+ Гб для хранения записей разговоров
Перейдите к вкладке Disks
Скорректируйте размер диска под систему до 1 Гб
Нажмите кнопку Add и добавьте дополнительный диск для хранения данных
Укажите размер диска не менее 50 Гб
На вкладках CPU и Memory укажите параметры вычислительных ресурсов виртуальной машины, исходя из ожидаемой нагрузки на АТС. Для тестовой машины можно указать в поле Cores (вкладка CPU) - 2, в поле Memory (вкладка Memory) - 2 Гб
На вкладке Network уберите флажок Firewall
Перейдите к последней вкладке Confirm и установите флажок Start after created
Завершив ввод значений, нажмите кнопку Finish
Перейдите к созданной виртуальной машине mikopbx-vm
На открытой вкладке перейдите в раздел Console
Если загрузка прошла успешно, появится консольное меню. Введите с клавиатуры 8 для начала установки
Выберите диск под систему и введите с клавиатуры имя диска, например sda. Подтвердите выбор, введите с клавиатуры y
Подключите диск для хранения записей разговоров, ведите с клавиатуры наименование диска для подключения, например sdb
После появления сообщения “Press any key within 30 seconds to boot from LiveCD…” не нажимайте никаких кнопок. В этом случае система загрузится с жесткого диска.
На открытой вкладке в разделе Console скопируйте внешний адрес созданной виртуальной машины и введите его в строке браузера
Для входа используйте логин - admin и пароль - admin
Установка MikoPBX в облако Google Cloud с помощью произвольного образа
Авторизуйтесь на платформе
Приступим к настройке
Для быстрого и удобного поиска на платформе 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, для этого
Выберите свой проект 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) логин и пароль
Откройте страницу IAM
Настройка почты и уведомлений
Раздел «Почта и уведомления» в MikoPBX позволяет настроить отправку системных уведомлений через электронную почту. Здесь администраторы указывают параметры SMTP-сервера, определяют события для уведомлений, такие как голосовые сообщения или системные ошибки, и редактируют шаблоны писем. Этот раздел помогает своевременно информировать пользователей и администраторов о важных событиях, обеспечивая эффективный контроль за работой системы.
Для получения уведомлений о пропущенных вызовах и сообщениях голосовой почты по электронной почте необходимо настроить 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)
Чтобы указать параметр, нужно использовать конструкцию вида ИМЯ_ПАРАМЕТРА.
Нажмите Сохранить для завершения настройки.
Настройка сотрудников и основных телефонных номеров
Сотрудники в MikoPBX — это индивидуальные пользователи системы, которым назначены внутренние номера для совершения и приема звонков. Они имеют персональные учетные записи, позволяющие настроить права доступа, переадресацию вызовов и другие персональные настройки в системе.
В разделе Сотрудники представлен список внутренних учетных записей сотрудников. Слева от сотрудника отображается статус авторизованного устройства. Если устройство успешно авторизовано под данной внутренней учетной записью, то кружок отображается зеленым цветом, иначе серым.
В строке поиска можно найти необходимый контакт. Поиск можно осуществлять по имени сотрудника, внутреннему номеру, мобильному номеру, адресу электронной почты.
На форме также есть возможность сортировки списка сотрудников по имени, внутреннему номеру, мобильному номеру, адресу электронной почты. Имеются кнопки копирования пароля для SIP учетной записи в буфер обмена, редактирования учетной записи и её удаления.
Для добавления нового сотрудника необходимо нажать кнопку Добавить сотрудника.
На вкладке Основные параметры задаются общие настройки внутренней учетной записи сотрудника:
ФИО пользователя - допускается использование кириллицы. Это значение будет использоваться при подстановке CALLERID(name) абонента, будет отображаться в соответствующем поле экрана телефона.
Внутренний номер - он же используется в качестве Логин при подключении телефона.
Мобильный номер - используется для дополнительной маршрутизации.
Адрес электронной почты - используется для email оповещений.
Пароль для SIP
Установите сложные пароли на учетные записи (пароль для SIP)! Пароль должен удовлетворять следующим требованиям:
длина пароля должна быть длиннее восьми символов;
пароль должен содержать буквы ВЕРХНЕГО и нижнего регистра;
пароль должен содержать цифры и специальные знаки: «-», «_», «[]», «{}», «@», «;».
Открываются путем нажатия на раскрывающийся список Расширенные настройки.
В поле Переопределение строки набора введите правило набора мобильного номера для Вашего провайдера. Например, в основных настройках номер мобильного телефона указан в формате 89164577878, согласно правилам исходящей маршрутизации для провайдера звонок возможен только на номера, начинающиеся с 7. Следовательно в поле Переопределение строки набора следует указать номер 79164577878.
Количество вызовов, при котором номер считается «занятым». В таком статусе начинают работать правила маршрутизации. Это описание не распространяется на очередь вызовов.
Настройка определяет, как DTMF-сигналы передаются через SIP.
Позволяет указать используемый транспортный протокол для данной учетной записи.
Подсеть, которая описана в разделе Cетевой экран. Указывает на разрешенную подсеть для этой учетной записи. Подключение из прочих подсетей будет вызывать ошибку авторизации.
Дополнительные параметры SIP учетки
Данное поле служит для изменения/переопределения конфигурационных файлов asterisk.
Переопределять можно практически все параметры. К примеру при использовании chan_pjsip SIP аккаунт сотрудника описывается следующими секциями:
Для переопределения полей в секциях следует заполнить поле Дополнительные параметры следующим образом:
На данной вкладке вы можете настроить правила переадресации вызовов в случае, если сотрудник не может ответить на звонок, занят или недоступен.
Период времени в секундах определяет, сколько времени будет продолжаться попытка вызова на внутреннюю учетную запись сотрудника. Если в течение этого времени сотрудник не сможет ответить на вызов, вы можете указать на какой номер следует направить вызов дальше. По умолчанию, вызов будет переадресован на мобильный номер сотрудника.
Кроме того, вы можете указать номера, на которые следует направить вызов в случае занятости и недоступности сотрудника. Таким образом, если сотрудник занят или недоступен, вызов будет переадресован на указанные номера.
Вы можете настроить эти параметры в соответствии с вашими предпочтениями и требованиями.
Настройка телеграмм как SIP софтфон
Yealink T19
Yealink T21
Yealink T28
Snom D120
Вариант обновления для MikoPBX в Docker контейнере
Для обновления контейнера MikoPBX до последней версии, вы можете выполнить следующие шаги в командной строке. Эти шаги включают остановку текущего контейнера, скачивание новой версии образа и запуск контейнера с использованием обновлённого образа.
Для начала нужно корректно остановить работающий контейнер. После остановки контейнера его можно безопасно удалить
Для запуска нового контейнера с использованием последней версии образа и теми же настройками, что и ранее (включая монтирование томов и прочие параметры сети), воспользуйтесь следующими командами:
Для начала нужно корректно остановить работающий контейнер. После остановки контейнера его можно безопасно удалить
Следующий шаг — это скачивание последней версии образа MikoPBX:
Пример файла docker-compose.yml
, который может быть использован для обновления вашего контейнера MikoPBX через Docker Compose:
Сохраните содержимое в файл docker-compose.yml
, выполните необходимые корректировки и запускайте командой:
Данные: Поскольку данные сохраняются в Docker Volume, они остаются нетронутыми при обновлении, что позволяет сохранить настройки и пользовательские данные.
Переменные окружения: Убедитесь, что все необходимые переменные окружения передаются корректно.
Безопасность: Перед обновлением всегда рекомендуется создать резервные копии ваших данных.
Эти шаги помогут обеспечить гладкое и безопасное обновление вашего контейнера MikoPBX.
Описание раздела Сеть и Firewall в MikoPBX
Раздел «Сеть и Firewall» в MikoPBX — это интерфейс для настройки сетевых параметров и управления брандмауэром системы. Здесь администраторы могут настраивать IP-адреса, сетевые интерфейсы и создавать правила брандмауэра для защиты системы от несанкционированного доступа. Этот раздел обеспечивает безопасную и стабильную работу MikoPBX в сетевой инфраструктуре организации.
Раздел «Сетевые интерфейсы» в MikoPBX — это интерфейс для настройки параметров сетевых подключений системы. Здесь администраторы могут управлять IP-адресами, масками подсети, шлюзами и другими сетевыми настройками для каждого сетевого интерфейса. Это позволяет корректно интегрировать MikoPBX в сеть организации и обеспечить ее стабильную работу в соответствии с требованиями сетевой инфраструктуры.
Раздел «Сетевой экран» в MikoPBX — это интерфейс для настройки брандмауэра (Firewall) системы. Здесь администраторы могут создавать и управлять правилами фильтрации сетевого трафика, контролируя доступ к MikoPBX и защищая ее от несанкционированного доступа и сетевых угроз. Настройка сетевого экрана обеспечивает безопасность телефонной системы, предотвращая потенциальные атаки и обеспечивая стабильную работу в сетевой инфраструктуре организации.
Раздел «Защита от взлома (Fail2Ban)» в MikoPBX — это инструмент для обеспечения безопасности системы от несанкционированного доступа и сетевых атак. Fail2Ban мониторит журналы событий и автоматически блокирует IP-адреса, с которых происходят подозрительные или многократные неудачные попытки входа. Настройка этого раздела помогает предотвратить взлом системы и защитить конфиденциальные данные организации.
Данная статья содержит пошаговые инструкции по обновлению MikoPBX на более новую версию.
Перед обновлением обязательно сделайте резервную копию настроек АТС. Делается это при помощи .