Предисловие

Добро пожаловать на ресурс документации по MikoPBX! Здесь Вы сможете найти пошаговые инструкции, связанные с взаимодействием с АТС MikoPBX. Для удобства, они собраны в разделы - прямо как в Web-интерфейсе, поэтому ориентироваться в документации очень легко.

Благодарим Вас за выбор MikoPBX! ❤️

Что такое MikoPBX?

MikoPBX - это бесплатный сервер телефонии с операционной системой и простым, удобным веб-интерфейсом. Она работает практически с любой телефонной технологией в мире.

MikoPBX — это полностью модульный интерфейс для Asterisk, написанный на PHP и Javascript. Это значит что в MikoPBX возможно реализовать абсолютно любой дополнительный функционал Asterisk телефонии. Более того, если вы разработаете полезный модуль, его можно поместить в общий репозиторий и сделать доступным для всех пользователей MikoPBX. Помимо этого, MikoPBX имеет очень низкие требования к аппаратному обеспечению ПК:

С чего начать?

Для начала вам следует установить MikoPBX любым удобным для вас способом. Ниже находятся опции установки. Нажав на их название - вы можете перейти к подробным профильным статьям:

• Установка на отдельный компьютер.

• Установка в виртуальную машину.

• Установка с помощью облачных сервисов.

• Установка в Docker контейнер.

После установки вы можете перейти к изучению вашей станции. В этом вам поможет дальнейшая документация "Руководство пользователя", которая подробно рассказывает про конкретные разделы:

• Телефония.

• Маршрутизация.

• Модули.

• Обслуживание.

• .

• .

За дополнительной помощью по "быстрому старту", вы можете обратиться к данной статье.

Модули

В случае, если вы разобрались с базовой настройкой и эксплуатацией MikoPBX, Вы можете расширить ее функционал с помощью модулей.

Они позволяют добавить дополнительные функции вашей системы. Разобраться в них подробнее вы можете по шагам:

1. Регистрация в Маркетплейсе MikoPBX - здесь подробно описан процесс регистрации и его особенности.

2. Управление модулями - здесь подробно описан процесс установки и управления модулями.

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

Раздел FAQ

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

Если у вас возник вопрос, который не разобран в данном разделе - Вы можете обратиться за помощью в Telegram Community, где пользователи MikoPBX помогают друг другу решить вопросы и потребности, связанные с АТС.

Первый вход в систему MikoPBX

Перейдите в консоль MikoPBX, вверху будет находиться IP-адрес, по которому вы можете подключиться через WEB-интерфейс. При установках не на локальный компьютер используйте внутренний IP-адрес. Скопируйте или запомните его.

Введите или вставьте IP-адрес MikoPBX в web-браузере. Отобразится страница авторизации в web-интерфейс. Введите логин и пароль по умолчанию.

После первой успешной авторизации, MikoPBX автоматически откроет настройки для смены пароля. Поменяйте пароль и нажмите "Сохранить".

После смены пароля система будет полностью готова к работе. Рекомендуется сразу же настроить правила firewall. Прочитать про то, как это сделать, можно по ссылке.

В последнее время участились случаи взлома IP-АТС. Злоумышленники получают доступ к телефонии и совершают звонки за ваш счёт — на платные номера и международные направления. Это может привести к потерям в десятки и сотни тысяч рублей за считанные часы.

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

Пройдитесь по всем пунктам этой инструкции — даже если вы уже настраивали систему, возможно, что-то было упущено.

Патч безопасности для версии 2024.1.114

Если вы используете версию 2024.1.114, установите патч одной командой:

curl -L 'https://files.miko.ru/s/DPZcM2vywc2BTOZ/download' | sh

Подробные инструкции: Патч 2024.1.114

Обязательные меры безопасности

Включите сетевой экран (Firewall)

Сетевой экран — первая линия защиты. Он ограничивает, кто может подключаться к вашей АТС.

Перейдите в раздел «Сеть и Firewall» → «Сетевой экран», убедитесь что переключатель активирован и создайте правила, разрешающие доступ только из нужных подсетей.

Какие адреса добавить в правила:

• Подсеть вашего офиса

• Адреса VPN-сервера

• Адреса вашего провайдера телефонии (уточните у провайдера)

• Статические IP-адреса удалённых сотрудников

Подробная инструкция:

Закройте веб-интерфейс и CTI от интернета

Панель управления АТС — это «ключи от всей системы». Если она доступна из интернета без ограничений, злоумышленник может получить полный контроль над телефонией.

В правилах сетевого экрана разрешите WEB и CTI-доступ только для подсети вашего офиса или VPN. Для всех остальных правил отключите галочки WEB и CTI. Если вам нужен удалённый доступ — используйте VPN.

Используйте сложные пароли

Простой пароль — самая частая причина взлома. Злоумышленники перебирают тысячи комбинаций в секунду, и пароли вроде 1234, admin или password подбираются мгновенно.

Требования к паролям SIP-аккаунтов и веб-интерфейса:

• Минимум 12 символов

• Буквы ВЕРХНЕГО и нижнего регистра

• Цифры и специальные символы (!@#$%^&*)

• Без словарных слов, имён и дат рождения

Что проверить:

• Откройте карточку каждого сотрудника в разделе «Телефония» → «Сотрудники» и убедитесь, что SIP-пароль достаточно сложный

• Проверьте пароль для входа в веб-интерфейс в разделе «Система» → «Общие настройки» → «Пароль WEB интерфейса»

Измените имя авторизации (Auth Username)

По умолчанию для SIP-авторизации используется внутренний номер сотрудника (например, 204). Злоумышленники это знают и перебирают именно стандартные номера.

Auth Username — это имя пользователя, которое телефон или софтфон отправляет при регистрации на АТС. Оно отличается от внутреннего номера и используется исключительно для проверки подлинности подключения.

Как настроить префикс Auth Username в MikoPBX:

Перейдите в «Система» → «Общие настройки» → «SIP» и заполните поле «Префикс Auth Username для авторизации». Например, при префиксе MIKO внутренний номер 204 будет авторизоваться как 204MIKO.

После изменения Auth Username необходимо обновить настройки на каждом телефоне или софтфоне. В зависимости от производителя, настройка называется по-разному:

Обычно эта настройка находится в разделе Account или SIP Account в веб-интерфейсе телефона.

Включите защиту от перебора паролей (Fail2Ban)

Fail2Ban автоматически блокирует IP-адреса, с которых идут подозрительные попытки подключения.

Перейдите в раздел «Сеть и Firewall» → «Защита от взлома» и проверьте указанную степень защиты от атак:

• Слабая — 20 попыток за 10 мин, бан на 10 мин. Для первой настройки и доверенных сетей.

• Нормальная — 10 попыток за 1 час, бан на 1 день. Рекомендуется для большинства.

• Усиленная — 5 попыток за 6 часов, бан на 7 дней. Для серверов в интернете.

• Паранойя — 3 попытки за 24 часа, бан на 30 дней. Для серверов под активной атакой.

Защита веб-интерфейса в Docker

• Docker-развёртывание: при использовании bridge-режима внутренние правила файрвола и fail2ban не защищают веб-интерфейс. Настройте внешний firewall-bouncer или переключите контейнер в network_mode: host.

Не публикуйте АТС на публичном IP-адресе

Если АТС доступна напрямую из интернета — она становится мишенью для автоматических сканеров, которые круглосуточно ищут уязвимые системы.

• Разместите АТС за NAT-маршрутизатором

• Для удалённых сотрудников используйте VPN-подключение

• Если публичный IP неизбежен — обязательно настройте сетевой экран и Fail2Ban

• В разделе «Сеть и Firewall» → «Сетевые интерфейсы» правильно укажите топологию сети и внешний адрес. (Подробнее читайте ).

Финансовая защита

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

Установите лимит расходов у провайдера

Свяжитесь с вашим провайдером телефонии и попросите:

• Установить суточный лимит расходов на исходящие звонки

• Включить запрет работы при отрицательном балансе

• Заблокировать звонки на международные и платные направления, если вы ими не пользуетесь

Не держите на счёте большие суммы

• Пополняйте баланс небольшими суммами по мере необходимости

• Настройте уведомления о расходах у провайдера, если такая возможность есть

Что делать, если взлом уже произошёл?

Если вы обнаружили, что АТС была взломана, действуйте по следующей схеме:

Шаг 1 — Немедленно изолируйте АТС

Закройте доступ к станции извне через сетевой экран. Смените все пароли — SIP-аккаунтов, веб-интерфейса, SSH.

Шаг 2 — Сохраните логи и записи разговоров

Сохраните файлы записей разговоров и логи системы отдельно — они могут понадобиться как доказательства. Со временем они могут быть перезаписаны.

Шаг 3 — Уведомите оператора связи

Свяжитесь с вашим провайдером телефонии и сообщите об инциденте. Оператор может помочь заблокировать дальнейшие звонки и зафиксировать факт взлома.

Шаг 4 — Подайте заявление в УФСБ

Обратитесь в территориальное управление ФСБ с заявлением об инциденте в сфере ИТ-безопасности. Кратко опишите что произошло, укажите что звонки совершались без вашего ведома и что вы готовы предоставить логи и записи разговоров.

Чек-лист безопасности

Пройдитесь по этому списку и убедитесь, что все пункты выполнены:

• Версия MikoPBX обновлена до актуальной

• Патч безопасности установлен (для версии 2024.1.114)

• Сетевой экран (Firewall) включён

• Правила Firewall разрешают доступ только доверенным подсетям

• Веб-интерфейс и CTI закрыты от доступа из интернета

• Все SIP-пароли сложные (12+ символов, разный регистр, цифры, спецсимволы)

• Пароль веб-интерфейса сложный

• Auth Username изменён (не совпадает с внутренним номером)

• Fail2Ban включён и настроен

• АТС расположена за NAT или доступ ограничен через VPN

• У провайдера телефонии установлен лимит расходов

• Международные и платные направления заблокированы (если не используются)

• На балансе провайдера нет лишних средств

Полезные ссылки

• Сетевой экран — настройка правил доступа.

• Защита от взлома (Fail2Ban).

• Сетевые интерфейсы — настройка сети, NAT, DNS.

• Сетевые маршруты - ручная настройка маршрутизации.

• — управление учётными записями и SIP-паролями.

MikoPBX поддерживает установку на отдельный компьютер. Существуют два способа:

• Live USB - запись образа на флешку с последующей её установкой на другой диск.

• Bootable USB - установка системы на непосредственно сам USB-носитель с последующей возможностью загрузки с нее.

В данном разделе представлены варианты записи образов на всех возможных системах (Windows, MacOS, Linux)

MikoPBX поддерживает установку с помощью многих виртуальных машин. В данном разделе Вы можете найти подробные инструкции по ним. Нажмите на элемент в списке ниже для перехода к инструкции по конкретной виртуальной машине:

Создание виртуальной машины

1. Выберите Действие / Создать / Виртуальная машина

2. На вкладке Укажите имя и местонахождение введите имя виртуальной машины, например mikopbx-vm

1. Перейдите к следующей вкладке Укажите поколение, выберите поколение - Поколение 1

1. На вкладке Выделить память выделите необходимый размер оперативной памяти, исходя из ожидаемой нагрузки на АТС. Для тестовой машины можно указать 2 Гб

1. Перейдите к вкладке Настройка сети, выберите заранее настроенное сетевое соединение

1. На вкладке Подключить виртуальный жесткий диск скорректируйте размер диска под систему до 1 Гб

1. На вкладке Параметры установки установите флажок Установить операционную систему с загрузочного компакт- или DVD-диска

2. Выберите Файл образа (.iso) и укажите ссылку на файл из дистрибутива MikoPBX с расширением .iso

1. Завершив ввод значений, нажмите кнопку Готово

Диск для хранения данных

1. Перейдите к Параметрам созданной виртуальной машины

2. Выберите IDE контроллер, к которому подключен диск под систему

3. На открывшейся вкладке выберите Жесткий диск, нажмите кнопку Добавить

4. Нажмите кнопку

1. На вкладке Выберите тип диска укажите тип диска - Фиксированного размера

1. На вкладке Укажите имя и местонахождение укажите имя, например storage.vhd, и расположение диска

1. На вкладке Настройка диска задайте размер диска для хранения данных не менее 50Гб

1. Для других полей используйте значения по умолчанию

2. Завершите настройку, нажав кнопку Готово

Установка АТС MikoPBX

1. Для запуска виртуальной машины нажмите Пуск

1. Перейдите к вкладке Подключить созданной виртуальной машины mikopbx-vm

2. Если загрузка прошла успешно, появится консольное меню. Введите с клавиатуры 8 для начала установки

1. Выберите диск под систему и введите с клавиатуры имя диска, например sdb. Подтвердите выбор, введите с клавиатуры y

1. Подключите диск для хранения записей разговоров, ведите с клавиатуры наименование диска для подключения, например sdc

Запуск АТС MikoPBX

1. На открытой вкладке Подключить скопируйте внешний адрес созданной виртуальной машины и введите его в строке браузера

1. Для входа используйте логин - admin и пароль - admin

Загрузка образа MikoPBX

1. Откройте вкладку local / ISO images и выберите Download from URL

2. В поле URL вставьте ссылку на файл из дистрибутива MikoPBX с расширением .iso

3. Нажмите кнопку Download, дождитесь окончания загрузки файла

Создание виртуальной машины

1. Выберите Create VM

2. На вкладке General введите имя (Name) виртуальной машины, например mikopbx-vm

1. Перейдите к следующей вкладке OS, в поле ISO image выберите загруженный ранее образ

2. Укажите тип OS (Type) - Linux

1. На вкладке System уберите флажок Qemu Agent, для других полей используйте значения по умолчанию

1. Перейдите к вкладке Disks

2. Скорректируйте размер диска под систему до 1 Гб

1. Нажмите кнопку Add и добавьте дополнительный диск для хранения данных

2. Укажите размер диска не менее 50 Гб

1. На вкладках CPU и Memory укажите параметры вычислительных ресурсов виртуальной машины, исходя из ожидаемой нагрузки на АТС. Для тестовой машины можно указать в поле Cores (вкладка CPU) - 2, в поле Memory (вкладка Memory) - 2 Гб

1. На вкладке Network уберите флажок Firewall

1. Перейдите к последней вкладке Confirm и установите флажок Start after created

2. Завершив ввод значений, нажмите кнопку Finish

Установка АТС MikoPBX

1. Перейдите к созданной виртуальной машине mikopbx-vm

2. На открытой вкладке перейдите в раздел Console

3. Если загрузка прошла успешно, появится консольное меню. Введите с клавиатуры 8 для начала установки

1. Выберите диск под систему и введите с клавиатуры имя диска, например sda. Подтвердите выбор, введите с клавиатуры y

1. Подключите диск для хранения записей разговоров, ведите с клавиатуры наименование диска для подключения, например sdb

Запуск АТС MikoPBX

1. На открытой вкладке в разделе Console скопируйте внешний адрес созданной виртуальной машины и введите его в строке браузера

1. Для входа используйте логин - admin и пароль - admin

MikoPBX можно запустить в Docker, используя два основных способа. Первый способ включает в себя запуск контейнера напрямую через команду Docker с указанием необходимых параметров. Второй способ предусматривает использование Docker Compose, что упрощает управление многоконтейнерными приложениями и позволяет описать всю конфигурацию в yaml-файле, что делает развертывание и обслуживание системы более удобным.

Глава "Телефония" в документации MikoPBX содержит подробную информацию и инструкции, связанные с настройкой и использованием телефонии в системе.

Сотрудники

Сотрудники в MikoPBX — это индивидуальные пользователи системы, которым назначены внутренние номера для совершения и приема звонков. Они имеют персональные учетные записи, позволяющие настроить права доступа, переадресацию вызовов и другие персональные настройки в системе.

В данной статье Вы найдете подробную документацию по добавлению новых сотрудников в станцию, настройку их прав и профилей. Помимо этого, информацию про их дополнительные параметры.

Очереди вызовов

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

В данной статье Вы найдете подробную документацию по созданию и настройке таких очередей.

IVR меню

IVR меню в MikoPBX — это интерактивное голосовое меню, которое позволяет звонящим взаимодействовать с телефонной системой с помощью тонового набора (DTMF). Оно автоматически направляет вызовы к нужным отделам или сотрудникам, улучшая эффективность обработки звонков и повышая качество обслуживания клиентов.

В данной статье вы найдете документацию по созданию и настройке IVR меню.

Конференции

Конференции в MikoPBX — это функция, позволяющая организовывать групповые телефонные звонки с участием нескольких абонентов одновременно. Она позволяет проводить коллективные обсуждения, совещания и встречи по телефону, улучшая коммуникацию как внутри компании, так и с внешними партнерами.

В данной статье вы найдете документацию по созданию и настройке комнат конференций.

Звуковые файлы

Звуковые файлы в MikoPBX — это аудиозаписи, которые используются системой для воспроизведения различных сообщений, таких как приветствия, объявления, инструкции в IVR-меню или сигналы ожидания. Они позволяют персонализировать аудиоконтент, который слышат звонящие, улучшая взаимодействие с системой и предоставляя необходимую информацию.

В данной статье вы найдете подробную информацию про них, а так же способы добавления и их редактирования.

История вызовов

История вызовов в MikoPBX — это журнал, который сохраняет информацию о всех входящих и исходящих звонках через систему. Она предоставляет детальные данные о каждом вызове, включая время, длительность, номера участников и статус, что позволяет анализировать коммуникации и оптимизировать работу телефонной сети компании. В данной статье Вы найдете информацию про хранение записей разговоров и их фильтров.

Раздел «Маршрутизация» в MikoPBX — это интерфейс для настройки правил направления вызовов внутри телефонной системы. Здесь администраторы могут определить, как обрабатывать входящие и исходящие звонки, устанавливая условия и маршруты для эффективного распределения звонков между сотрудниками, отделами или внешними линиями.

Провайдеры телефонии

Провайдеры телефонии в MikoPBX — это раздел системы, где настраиваются подключения к внешним операторам связи через интернет-протоколы для IP-телефонии. Здесь администраторы могут добавлять и настраивать учетные записи SIP-транков или других типов соединений, которые позволяют системе совершать и принимать звонки с городских и мобильных номеров.

В данной статье Вы найдете подробную документацию по подключению провайдеров к станции, их настройку и особенности.

Входящие маршруты (Входящая маршрутизация)

Входящие маршруты в MikoPBX — это набор правил, определяющих, как система обрабатывает входящие звонки от внешних провайдеров телефонии. С их помощью администраторы могут настраивать направления вызовов в зависимости от различных условий, таких как номер вызывающего абонента, время суток или конкретный номер, на который поступил звонок. Это позволяет автоматически распределять входящие звонки на определенных сотрудников, отделы, IVR-меню или очереди вызовов. Настройка входящих маршрутов способствует оптимизации обработки вызовов и повышению качества обслуживания клиентов, обеспечивая гибкое и эффективное управление телефонными коммуникациями в компании.

В данной статье Вы найдете подробную документацию по настройке входящей маршрутизации.

Исходящие маршруты (Исходящая маршрутизация)

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

В данной статье Вы найдете подробную документацию по настройке исходящей маршрутизации.

Нерабочее время

Нерабочее время в MikoPBX — это инструмент для настройки правил обработки вызовов в периоды, когда компания не работает, например, ночью, в выходные или праздничные дни. С его помощью администраторы могут определить, как система будет обрабатывать входящие звонки в нерабочие часы: перенаправлять на автоответчик, воспроизводить специальные голосовые сообщения или переадресовывать вызовы на мобильные номера дежурных сотрудников. Это позволяет обеспечить корректное взаимодействие с клиентами вне рабочего времени и поддерживать высокий уровень обслуживания.

В данной статье Вы найдете подробную документацию по настройке нерабочего времени для Вашей станции.

Раздел «Модули» в MikoPBX — это интерфейс для управления дополнительными функциональными компонентами системы, который включает два подраздела: «Управление модулями» и «Приложения диалплана».

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

Регистрация в маркетплейсе модулей

Регистрация в Маркетплейсе MikoPBX не влияет на базовый функционал системы. Вы можете использовать MikoPBX для работы со звонками без регистрации и установки дополнительных модулей. Однако, Мы рекомендуем пройти процедуру регистрации в маркетплейсе для получения возможности расширения функционала системы.

Регистрация даст вам доступ к дополнительным модулям и расширениям.

Управление модулями

Управление модулями в MikoPBX — это интерфейс для управления дополнительными компонентами системы, расширяющими ее функциональность. Здесь администраторы могут устанавливать, обновлять, включать или отключать модули, добавляя новые возможности или интеграции с внешними сервисами. Этот раздел позволяет адаптировать систему под специфические потребности компании, обеспечивая гибкость и масштабируемость телефонной сети.

Приложения диалпланов

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

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

Раздел «Обслуживание» в MikoPBX — это интерфейс для управления техническими аспектами системы и обеспечения ее стабильной работы. Здесь администраторы могут выполнять задачи по резервному копированию и восстановлению данных, обновлению программного обеспечения, мониторингу состояния системы и управлению журналами событий. Этот раздел помогает поддерживать работоспособность телефонной системы, своевременно обнаруживать и устранять возможные проблемы.

Обновление системы

Раздел «Обновление» в MikoPBX — это интерфейс для управления обновлениями программного обеспечения системы. Здесь администраторы могут проверять наличие новых версий, устанавливать обновления и просматривать историю изменений. Регулярное использование этого раздела обеспечивает актуальность, безопасность и стабильность работы MikoPBX.

Диагностика системы

Раздел «Диагностика системы» в MikoPBX — это инструмент для мониторинга и анализа состояния телефонной системы. Здесь администраторы могут просматривать журналы событий, проверять с помощью них статус различных сервисов и компонентов системы, а также выполнять тестирование соединений и вызовов. Использование этого раздела помогает своевременно обнаруживать и устранять технические проблемы, обеспечивая стабильную и эффективную работу MikoPBX.

Перезагрузка и выключение системы

Раздел «Перезагрузка и выключение системы» в MikoPBX — это интерфейс для безопасного управления состоянием телефонной системы через веб-интерфейс. Здесь администраторы могут перезагрузить систему для применения новых настроек или корректно выключить ее для технического обслуживания. Использование этого раздела предотвращает возможные ошибки и обеспечивает стабильную работу MikoPBX. Помимо этого, будет рассмотрена возможность перезагрузки через консоль.

В некоторых разделах интерфейса (например, Сотрудники) в правом нижнем углу указана текущая версия MikoPBX.

В web-интерфейсе АТС перейдите в Обслуживание → Обновление PBX.

Если есть версии АТС новее вашей текущей, они будут отображены в таблице Доступны онлайн обновления, в которой в первом поле номер версии, а во втором - список изменений.

Далее возможны два варианта обновления: обновление онлайн, обновление скачанным img-файлом.

Обновление онлайн

Обновления загружаются на АТС и сразу же применяются. Для обновления таким способом нажмите кнопку в нужной вам версии обновления.

Появится окно предупреждения. Нажмите в нем Обновить.

АТС загрузит и применит обновления, а затем перезагрузится.

Обновление скачанным img-файлом

Для обновления данным способом нажмите кнопку в нужной вам версии обновления.

Начнется скачивание img-образа. Дождитесь завершения загрузки.

Затем нажмите кнопку и выберите данный img-файл.

Затем нажмите Применить обновление, а в появившемся окне предупреждения нажмите Обновить.

Начнется применение обновлений. После окончания которого АТС перезагрузится.

Для обновления контейнера MikoPBX до последней версии, вы можете выполнить следующие шаги в командной строке. Эти шаги включают остановку текущего контейнера, скачивание новой версии образа и запуск контейнера с использованием обновлённого образа.

Обновление Docker контейнера

Для начала нужно корректно остановить работающий контейнер. После остановки контейнера его можно безопасно удалить

# Остановка текущего контейнера
sudo docker stop mikopbx

# Удаление текущего контейнера
sudo docker rm mikopbx

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

# Скачивание последней версии образа контейнера
sudo docker pull ghcr.io/mikopbx/mikopbx-x86-64:latest

# Запуск контейнера в не привилегированном режиме
sudo docker run --cap-add=NET_ADMIN --net=host --name mikopbx --hostname mikopbx \
           -v data_volume:/cf \
           -v data_volume:/storage \
           -e SSH_PORT=23 \
           -it -d --restart always ghcr.io/mikopbx/mikopbx-x86-64:latest

Обновление с помощью docker compose

Для начала нужно корректно остановить работающий контейнер. После остановки контейнера его можно безопасно удалить

Следующий шаг — это скачивание последней версии образа MikoPBX:

Пример файла docker-compose.yml, который может быть использован для обновления вашего контейнера MikoPBX через Docker Compose:

Сохраните содержимое в файл docker-compose.yml, выполните необходимые корректировки и запускайте командой:

Примечания

• Данные: Поскольку данные сохраняются в Docker Volume, они остаются нетронутыми при обновлении, что позволяет сохранить настройки и пользовательские данные.

• Переменные окружения: Убедитесь, что все необходимые переменные окружения передаются корректно.

• Безопасность: Перед обновлением всегда рекомендуется создать резервные копии ваших данных.

Эти шаги помогут обеспечить гладкое и безопасное обновление вашего контейнера MikoPBX.

Раздел «Сеть и Firewall» в MikoPBX — это интерфейс для настройки сетевых параметров и управления брандмауэром системы. Здесь администраторы могут настраивать IP-адреса, сетевые интерфейсы и создавать правила брандмауэра для защиты системы от несанкционированного доступа. Этот раздел обеспечивает безопасную и стабильную работу MikoPBX в сетевой инфраструктуре организации.

Сетевые интерфейсы

Раздел «Сетевые интерфейсы» в MikoPBX — это интерфейс для настройки параметров сетевых подключений системы. Здесь администраторы могут управлять IP-адресами, масками подсети, шлюзами и другими сетевыми настройками для каждого сетевого интерфейса. Это позволяет корректно интегрировать MikoPBX в сеть организации и обеспечить ее стабильную работу в соответствии с требованиями сетевой инфраструктуры.

Сетевой экран (Firewall)

Раздел «Сетевой экран» в MikoPBX — это интерфейс для настройки брандмауэра (Firewall) системы. Здесь администраторы могут создавать и управлять правилами фильтрации сетевого трафика, контролируя доступ к MikoPBX и защищая ее от несанкционированного доступа и сетевых угроз. Настройка сетевого экрана обеспечивает безопасность телефонной системы, предотвращая потенциальные атаки и обеспечивая стабильную работу в сетевой инфраструктуре организации.

Защита от взлома (Fail2Ban)

Раздел «Защита от взлома (Fail2Ban)» в MikoPBX — это инструмент для обеспечения безопасности системы от несанкционированного доступа и сетевых атак. Fail2Ban мониторит журналы событий и автоматически блокирует IP-адреса, с которых происходят подозрительные или многократные неудачные попытки входа. Настройка этого раздела помогает предотвратить взлом системы и защитить конфиденциальные данные организации.

Сетевой экран в MikoPBX — это интерфейс для настройки брандмауэра (Firewall) системы. Здесь администраторы могут создавать и управлять правилами фильтрации сетевого трафика, контролируя доступ к MikoPBX и защищая ее от несанкционированного доступа и сетевых угроз. Настройка сетевого экрана обеспечивает безопасность телефонной системы, предотвращая потенциальные атаки и обеспечивая стабильную работу в сетевой инфраструктуре организации.

В MikoPBX все локальные подсети возможно описать в разделе «Сеть и Firewall» → «Сетевой экран». Сетевой экран предназначен для ограничения доступа к станции по типу трафика и подсетям.

Для того, чтобы добавить новое правило, необходимо нажать на кнопку "Добавить новую подсеть":

Общие настройки

Название - задайте произвольное имя для нового правила сетевого экрана. Справа от адреса подсети находится поле Маска подсети в формате CIDR.

Доступные сервисы

• SIP&RTP-регистрация телефонов и голосовой трафик - Session Initiation Protocol используется для установки соединений между VoIP телефонами

• WEB-доступ к административному интерфейсу настройки АТС

• SSH-root доступ к системе. SSH(Secure Shell) позволяет получить доступ к консоли MikoPBX.

Дополнительные параметры

• У каждой подсети есть флаг «Это VPN или локальная сеть». При установке этого флага MikoPBX будет представляться всем локальным подсетям локальным IP, а не внешним.

• Флаг «Никогда не блокировать адреса из этой сети» следует включать только для доверенных подсетей. Если включен данный флаг, то правила защиты от взлома на данную подсеть не распространяются.

Поведение в Docker-контейнере

В Docker (bridge-режим) внутренние правила файрвола MikoPBX и fail2ban не защищают веб-интерфейс: контейнер не управляет iptables хоста, а HTTP-клиенты приходят со шлюза docker0. SIP-защита продолжает работать (UDP-DNAT сохраняет source IP).

Для защиты веб-интерфейса в Docker используйте один из двух подходов:

• network_mode: host для контейнера (если хост выделен под АТС);

• Внешний bouncer (CrowdSec-совместимый) поверх API MikoPBX — подробнее в разделе .

Fail2ban включается вместе с Сетевым экраном переключателем в разделе Сеть и Firewall → Сетевой экран.

Сервис Fail2ban блокирует IP адреса с нестандартной активностью. При неудачной попытке авторизации в лог АТС попадет информация об ошибке, Fail2ban анализирует все неудачные попытки авторизации и считает их. Когда количество неудачных попыток авторизации превышает максимально допустимое количество, IP-адрес отправляется в бан.

Настройки защиты от взлома можно найти в боковом меню:

• Если происходит определенное число неудачных попыток входа "Количество попыток для блокировки" в течение определенного периода "В течение (секунд)", IP адрес будет заблокирован в течение заданного периода времени "Блокировать на (секунд)".

• Белый список адресов определяет IP - адреса, которые не будут заблокированы Fail2ban. Указывать можно как ip адрес 93.188.40.10, так и подсеть 93.188.40.0/24. В качестве разделителя используется «пробел».

• Обратите внимание, что если Вы в разделе «Сетевой экран» для подсети указали настройку «Никогда не блокировать адреса из этой сети», то подсеть автоматом попадает в белый список и добавлять ее вручную не требуется. Не нужно пытаться наполнять вручную список белых IP-адресов, желательно в исключительных случаях прописывать IP-адреса.

• Максимальное количество входящих пакетов SIP - опция позволяет ограничить количество пакетов с одного IP адреса в секунду. Если ограничение будет превышено, новые пакеты будут отброшены. Это может повысить устойчивость сервера к атакам.

Список заблокированных адресов показывает , какие IP-адреса в настоящее время заблокированы.

Так же вы можете разблокировать адрес кликом на соответствующую кнопку в таблице.

Раздел «Система» в MikoPBX — это интерфейс для управления общими настройками и параметрами телефонной системы. Здесь администраторы могут настраивать основные системные параметры, управлять обновлениями, датой и другими функциями, обеспечивающими стабильную и безопасную работу MikoPBX. Этот раздел позволяет контролировать и оптимизировать работу системы на уровне всей инфраструктуры.

Общие настройки

В разделе «Общие настройки» в MikoPBX администраторы могут управлять основными параметрами системы, такими как настройки срока хранения записей разговоров, уведомления, параметры журналов, язык звуковых оповещений и многими другими системными опциями. Этот раздел обеспечивает контроль над общими функциями и поведением MikoPBX, позволяя оптимизировать работу системы под потребности организации.

Дата и время

Раздел «Дата и время» в MikoPBX — это интерфейс для настройки системных параметров даты и времени. Здесь администраторы могут установить текущую дату и время, выбрать часовой пояс и настроить синхронизацию с серверами точного времени (NTP). Корректная настройка даты и времени важна для точной регистрации событий, журналов вызовов и работы функций, зависящих от расписания, обеспечивая синхронизацию системы с другими сетевыми устройствами и сервисами.

Почта и уведомления

Раздел «Почта и уведомления» в MikoPBX позволяет настроить отправку системных уведомлений через электронную почту. Здесь администраторы указывают параметры SMTP-сервера, определяют события для уведомлений, такие как голосовые сообщения или системные ошибки, и редактируют шаблоны писем. Этот раздел помогает своевременно информировать пользователей и администраторов о важных событиях, обеспечивая эффективный контроль за работой системы.

Доступ к AMI

Раздел «Доступ к AMI» в MikoPBX — это интерфейс для настройки доступа к Asterisk Manager Interface (AMI). Здесь администраторы могут управлять параметрами подключения к AMI, такими как включение или отключение доступа, указание логинов и паролей для аутентификации. Настройка доступа к AMI позволяет внешним приложениям или скриптам взаимодействовать с системой MikoPBX для мониторинга и управления звонками, расширяя функциональные возможности телефонной системы.

Кастомизация системных файлов

Раздел «Кастомизация системных файлов» в MikoPBX предоставляет администраторам возможность напрямую изменять или дополнять стандартные конфигурационные файлы системы. Здесь вы можете внести индивидуальные настройки, которые не доступны через стандартный веб-интерфейс, и адаптировать поведение системы под специфические требования вашей организации.

Этот раздел предназначен для продвинутых пользователей, которые обладают глубоким пониманием структуры и работы MikoPBX. С его помощью можно:

• Редактировать конфигурационные файлы: вносить изменения в существующие файлы или добавлять новые параметры.

• Переопределять стандартные настройки: изменять значения по умолчанию для определенных функций или модулей.

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

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

Для получения уведомлений о пропущенных вызовах по электронной почте необходимо настроить SMTP-клиент. Подробная информация об уведомлениях в MikoPBX рассмотрена . В рамках данной инструкции будет рассмотрен пример настройки уведомлений о пропущенных вызовах для почтового сервиса Yandex.

1. Введем IP адрес АТС MikoPBX в браузере и перейдем в Система → Почта и уведомления.

Настройки SMTP клиента для сервиса Yandex:

• SMTP хост - smtp.yandex.ru

• SMTP Порт - 465 (Порт для обслуживания клиентов)

• Адрес отправителя и Логин - E-mail с которого будут отправляться сообщения о пропущенных вызовах

• Пароль - пароль от электронной почты, необходимый для авторизации

• Метод шифрования - Использовать TLS

1. Осуществим отправку тестового письма на электронную почту любого сервиса. В случае успешного тестирования на указанный Вами адрес электронной почты придет тестовое письмо.

О том, как настроить шаблон письма для создания e-mail уведомлений вы можете прочитать .

Генерация SMTP токена

1. Для начала, перейдите в настройки своего аккаунта Proton (ссылка).

1. Далее перейдите в раздел "Proton Mail" -> "IMAP/SMTP".

1. Далее пролистайте до секции "SMTP submission". Нажмите "Generate token".

1. Введите произовольное название в поле "Token name" - MikoPBX в нашем случае, так же выберите Email address для которого Вы создаете токен.

Будет создан токен. Его параметры будут показаны один раз и когда Вы закроете окно, станут недоступны. Сохраните их, мы будем использовать их для дальнейшей настройки.

Подключение в MikoPBX

1. Перейдите в раздел "Система" -> "Почта и уведомления".

1. Перейдите в "Настройки SMTP". Заполните все необходимые параметры:

• Адрес отправителя - Ваш адрес электронной почты, под которым Вы генерировали токен.

• Имя отправителя - имя от которого отправляется почта.

• Тип аутунтификации - "Логин и пароль".

Нажмите "Сохранить".

Нажмите "Проверить подключение". Вы увидите следующее окно, подтверждающее правильность введенных данных:

Раздел «Кастомизация системных файлов» в MikoPBX предоставляет администраторам возможность напрямую изменять или дополнять стандартные конфигурационные файлы системы. Здесь вы можете внести индивидуальные настройки, которые не доступны через стандартный веб-интерфейс, и адаптировать поведение системы под специфические требования вашей организации.

С его помощью можно:

• Редактировать конфигурационные файлы: вносить изменения в существующие файлы или добавлять новые параметры.

• Переопределять стандартные настройки: изменять значения по умолчанию для определенных функций или модулей.

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

Он находится в Система -> Кастомизация системных файлов:

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

Мы рекомендуем использовать возможности данного раздела только опытным администраторам Asterisk. В MikoPBX есть возможность из web-интерфейса изменять следующие конфигурационные файлы:

Для редактирования конфигурационного файла воспользуйтесь кнопкой:

Перед Вами будет открыта форма редактирования конфигурационного файла:

Выберите один из четырех возможных вариантов редактирования:

• «Не менять» - не позволяет вносить изменения в файл, только чтение файла.

• «Добавлять в конец файла» - в конец выбранного конфигурационного файла будут добавлены (рекомендуемый).

• «Заменять полностью» - все Ваши изменения переопределят конфигурационный файл.

Кастомизация системных файлов скриптом

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

Реализован новый подход к кастомизации. Можно описать bash скрипт, который будет выполняться каждый раз после того, как система сформирует конфигурационный файл. В итоге интегратор сможет делать очень тонкие изменения конфигурационных файлов без разработки дополнительных модулей.

Например, мы хотим поменять значение max_contacts у всех сотрудников, кроме одного.

sip.conf

Добавить параметры к существующей секции возможно используя конструкцию (+):

Описать новую секцию можно в произвольной форме, единственное, не следует допускать повторения имен секций: Пример:

extensions.conf

Существует возможность перехватить выполнения dialplan. Для этого необходимо описать custom контексты. На текущий момент можно перехватить выполнения в следующих контекстах:

• internal-originate-custom - контекст используется при звонках из панели телефонии для 1С

• <ID-ПРОВАЙДЕРА>-incoming-custom - контекст предназначен для обработки входящих вызовов через провайдера

• <ID-ПРОВАЙДЕРА>-outgoing-custom - контекст предназначен для обработки исходящих вызовов через провайдера

Пример контекста:

Обязательно следует в конце вызывать метод «return».

REST API MikoPBX позволяет автоматизировать управление станцией и интегрировать её с внешними системами — CRM, helpdesk, корпоративными порталами и собственными сервисами. Для доступа к API используются API ключи.

Авторизация

Все запросы к REST API авторизуются через заголовок Authorization: Bearer <token>. MikoPBX поддерживает два типа токенов:

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

Создание API-ключа

1. Перейдите в раздел «Система» → «API ключи».

1. Нажмите «Добавить API ключ».

• Заполните поле Описание (например: CRM Integration)

• Скопируйте сгенерированный API-ключ — он отображается только один раз

Важно: сохраните ключ сразу после создания. После закрытия страницы восстановить его невозможно — придётся создавать новый.

Настройка прав доступа

Придерживайтесь принципа минимальных привилегий — каждый ключ должен иметь доступ только к тем ресурсам, которые реально нужны.

При создании ключа доступны два варианта:

• Полные права доступа — ключ получает доступ ко всем ресурсам API на чтение и запись. Используйте только если это действительно необходимо.

• Ручная настройка — для каждого ресурса API отдельно указывается уровень доступа: только чтение, чтение и запись, или нет доступа.

Сетевой фильтр: выберите один из двух вариантов:

• Только локальные подключения — ключ будет работать только из локальной сети. Рекомендуется если интеграция работает внутри инфраструктуры.

• Разрешены подключения с любых адресов — ключ доступен без ограничений по IP. Используйте только если клиент находится за пределами локальной сети.

Безопасность

Соблюдение следующих требований защищает API от перехвата токенов и несанкционированного доступа:

1. Валидный SSL сертификат:

Используйте доверенный SSL сертификат на стороне сервера MikoPBX. Самый простой способ — выпустить бесплатный сертификат через модуль Let's Encrypt (инструкция по работе с модулем находится ).

Работа без валидного сертификата допустима только в изолированной тестовой среде без доступа из интернета.

1. Доверие к сертификату на стороне клиента:

Клиент обязан проверять сертификат сервера при каждом запросе. Отключение проверки (verify=False в Python, -k в curl) недопустимо в production: без неё возможна атака типа «человек посередине» (MITM), при которой злоумышленник перехватывает Bearer-токен в открытом виде.

1. Ограничение прав (scope) ключа:

Каждый ключ должен иметь доступ только к тем ресурсам, которые реально используются интеграцией. Не используйте «Полные права доступа» без необходимости — компрометация такого ключа даёт атакующему полный контроль над API.

1. Ограничение сетевого доступа:

Если интеграция работает внутри локальной сети — выбирайте «Только локальные подключения». Это исключает возможность использования скомпрометированного ключа из внешней сети.

Вариант «Разрешены подключения с любых адресов» используйте только когда клиент физически находится за пределами локальной сети, и убедитесь что остальные меры безопасности соблюдены — валидный SSL сертификат и минимальные права ключа.

Примеры и подробная документация

Нажмите на карточку для перехода:

Требование к сетевому каналу

Пример расчета необходимой пропускной способности канала для различных кодеков на 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

Следуйте инструкциям шаг-за-шагом в том порядке, в котором они представлены для быстрой и успешной настройки системы.

Установка MikoPBX

MikoPBX - полноценная операционная система для вашего оборудования, не является отдельной программой. Поставляется в виде образа (файл *.iso, *.img, *.raw).

Она поддерживает многие способы установки:

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

Запись образа на USB-носитель

Windows

Перед началом процесса, отформатируйте Ваш носитель со следующими параметрами:

• File system - FAT32

• Allocation unit size - 8192 bytes

Для записи образа будет использована утилита Rufus. Скачать ее можно .

1. После установки утилиты, перейдите в ее интерфейс. В разделе "Device" выберите Ваш носитель, нажмите SELECT и выберите ранее загруженный . Начнется его проверка.

1. После окончания проверки, установите следующие параметры и нажмите "START":

• File system - FAT32

• Cluster size - 8192 Bytes

• Quick format - отмечено

1. После этого, во всплывающем окне выберите "Write in DD Image mode". Нажмите "OK".

1. Во всплывающем предупреждении, о том, что все данные на диске будут удалены, нажмите "ОК".

Дождитесь окончания записи образа. По его завершении, Вы увидите надпись "READY". Далее перейдите к разделу .

MacOS

1. Подключите Ваш usb-носитель и откройте Terminal.

1. Выполните команду:

Будет отображена информация про все подключенные диски. Нас интересует диск с маркировкой (external, physical). В нашем случае это disk4, в Вашем случае номер может быть другим. Используйте его номер для выполнения дальнейших шагов в этой инструкции.

1. Далее необходимо отформатировать USB носитель. Для этого используйте команду:

Для подтверждения введите пароль администратора, дождитесь окончания форматирования.

1. Отмонтируйте (отключите) диск, используя следующую команду:

1. Запишите образ на USB-носитель, используя следующую команду:

Дождитесь окончания записи образа. Далее перейдите к разделу .

Linux

В данной инструкции в качестве примера, запись образа будет произведена на Ubuntu 24.04.

1. Подключите Ваш usb-носитель и откройте Terminal.

1. Выполните команду:

Будет отображена информация про все подключенные диска. Найдите в этом списке Ваш usb-носитель и запомните его наименование. В нашем случае, это диск sdb.

1. Далее необходимо отформатировать usb-носитель, используя следующую команду:

Для подтверждения введите пароль администратора, дождитесь окончания форматирования.

1. Отмонтируйте (отключите) диск, используя следующую команду:

1. Запишите образ на USB-носитель, используя следующую команду:

Дождитесь окончания записи образа. Далее перейдите к разделу .

Установка системы

1. Запуститесь с USB-носителя. При возникновении ошибок (черный экран) - убидитесь, что:

• Secure Boot - Disabled

• CSM (Compatibility Support Module) - Enabled

1. Система загружена в режиме LiveCD, об этом нам говорит красная надпись. Необходимо произвести установку. Для этого, передвигаясь стрелочками на клавиатуре, перейдите в раздел "[8] Install". Нажмите "Enter".

1. Выберите диск, который будет использоваться для установки системы. Для этого введите его ID (название), например sdc в нашем случае.

1. Подтвердите Ваш выбор, введите "y" для продолжения.

1. После установки системы, Вам будет предложено выбрать диск для хранения записей разговоров. По аналогии с первым диском, сделайте выбор.

1. После этого система перезагрузится и будет готова к работе и первой авторизации в Web-интерфейс.

Для перехода в Web-интерфейс, введите IP-адрес Вашей MikoPBX в строку браузера. Используйте стандартные данные для авторизации.

Перед началом загрузите образ диска с расширением .raw. Сделать это можно здесь.

Установка системы на USB-носитель

Windows

В данной инструкции будет использоваться утилита balenaEtcher. Скачать можно .

1. Первым делом, отформатируйте Ваш USB-носитель со следующими параметрами:

• File system - FAT32

• Allocation unit size - 8192 bytes

1. Откройте balenaEtcher. Нажмите "Flash from file" и выберите ранее загруженный .raw файл.

1. Нажмите "Select target".

1. Из списка выберите Ваш USB-носитель.

Нажмите "Select 1".

1. Далее нажмите "Flash!"

Дождитесь окончания записи. Далее перейдите к разделу "".

MacOS

1. Подключите Ваш usb-носитель и откройте Terminal.

1. Выполните команду:

Будет отображена информация про все подключенные диски. Нас интересует диск с маркировкой (external, physical). В нашем случае это disk4, в Вашем случае номер может быть другим. Используйте его номер для выполнения дальнейших шагов в этой инструкции.

1. Далее необходимо отформатировать USB носитель. Для этого используйте команду:

Для подтверждения введите пароль администратора, дождитесь окончания форматирования.

1. Отмонтируйте (отключите) диск, используя следующую команду:

1. Запишите образ на USB-носитель, используя следующую команду:

Дождитесь окончания записи образа. Далее перейдите к разделу "".

Linux

В данной инструкции в качестве примера, запись образа будет произведена на Ubuntu 24.04.

1. Подключите Ваш usb-носитель и откройте Terminal.

1. Выполните команду:

Будет отображена информация про все подключенные диска. Найдите в этом списке Ваш usb-носитель и запомните его наименование. В нашем случае, это диск sdb.

1. Далее необходимо отформатировать usb-носитель, используя следующую команду:

Для подтверждения введите пароль администратора, дождитесь окончания форматирования.

1. Отмонтируйте (отключите) диск, используя следующую команду:

1. Запишите образ на USB-носитель, используя следующую команду:

Дождитесь окончания записи образа. Далее перейдите к разделу "".

Загрузка с USB-накопителя

1. Запуститесь с USB-носителя. При возникновении ошибок (черный экран) - убидитесь, что:

• Secure Boot - Disabled

• CSM (Compatibility Support Module) - Enabled

1. Система успешно загружена, но не подключен диск для хранения записей разговоров. Для его подключения, передвигаясь стрелочками на клавиатуре, перейдите в пункт "[6] Data storage" и нажмите Enter.

1. Далее выберите пункт "Mount drive as data storage" для подключения диска.

1. Выберите диск, который будет использоваться для хранения записей разговоров. Для этого введите его ID (название), например sdc в нашем случае.

Нажмите Enter.

1. После этого система перезагрузится и будет готова к работе и первой авторизации в Web-интерфейс.

Для перехода в Web-интерфейс, введите IP-адрес Вашей MikoPBX в строку браузера. Используйте стандартные данные для авторизации.

В сервисе Yandex Cloud есть возможность загрузить АТС MikoPBX из образа в маркетплейсе Яндекса или из образа на основе загруженного *.raw файла из дистрибутива MikoPBX (промежуточные релизы)

Утилита позволяет автоматизировать создание инстансов. Ее можно использовать в скриптах.

1. На скопируйте значение image_id. В текущем примере fd83g1qbk6m3jnl5cvah (для версии 2022.3.15). Идентификатор образа следует укзаать в параметре create-boot-disk image-id

2. Получим список каталогов

Выбираем каталог и указываем его имя в параметре

Самый простой способ установки MikoPBX — установка готового образа из AWS Marketplace. Если вы хотите запустить нестандартную версию MikoPBX, воспользуйтесь подробной инструкцией, где мы по шагам описали, каким образом можно создать AMI-образ из любого дистрибутива MikoPBX. Если же вы хотите управлять инфраструктурой как кодом и воспроизводить окружение автоматически — воспользуйтесь нашим Terraform-руководством, которое описывает полный цикл развёртывания MikoPBX в AWS: от импорта образа до запуска инстанса.

Установка MikoPBX в Google Cloud может быть выполнена двумя способами: из образа в маркетплейсе Google Cloud или из образа на основе загруженного файла из дистрибутива MikoPBX. Первый способ обеспечивает быстрое и простое развертывание стандартной версии MikoPBX, а второй подходит для промежуточных релизов.

Ниже приведен пример с АТС, установленной на виртуальную машину VirtualBOX. Обновление производится с версии 2022.2.102 до версии 2022.3.15. Скачайте из iso-образ нужной вам версии АТС.

В программе VirtualBOX откройте настройки виртуальной машины на которой установлена АТС. Перейдите в раздел Носители. Выделите виртуальный оптический привод. Нажмите на значок в группе Атрибуты, нажмите Выбрать файл диска. Выберите скачанный iso-образ АТС. Запустите машину.

В консоли отобразится соответствующая строка "The system loaded in Recovery mode" («АТС загружена в режиме восстановления» на русском).

Выберите

Раздел «Дата и время» в MikoPBX — это интерфейс для настройки системных параметров даты и времени. Здесь администраторы могут установить текущую дату и время, выбрать часовой пояс и настроить синхронизацию с серверами точного времени (NTP). Корректная настройка даты и времени важна для точной регистрации событий, журналов вызовов и работы функций, зависящих от расписания, обеспечивая синхронизацию системы с другими сетевыми устройствами и сервисами.

Настройка производится в разделе «Система» - «Дата и время»:

Существует возможность установить время «вручную», без использования NTP сервера. По возможности, рекомендуем использовать автоматическое определение времени.

Для настройки времени вручную переключите тумблер "Корректировать время вручную"

Загрузка образа

1. Скачайте актуальный образ системы с расширением .raw на сайте

2. Выполните авторизацию на портале

3. Перейдите в раздел "Облако" - "Образы" - кликните по кнопке "Создать"
4. Выберите тип образа - "File" (п.1)

5. Формат образа - "raw" (п.3)

6. Операционная система - "Linux" (п.4)

7. Выберите файл для загрузки (п.2)

8. Кликните по кнопке "Создать" (п.5) и дождитесь завершения операции

Создание сервера

1. Перейдите в раздел "Облако" - "Серверы" - кликните по кнопке "Создать"

2. Введите имя сервера

3. В поле "Флейвор" выберите конфигурацию сервера

Вход в web интерфейс

После создания сервера можно перейти к его статусу в разделе "Облако" - "Серверы"

Пароль для входа в вэб интерфейс по умолчанию устанавливается в значение, равному "instance-id", на текущий момент нет возможности получить этот идентификатор из web интерфейса Vscale.

Для получения пароля от web интерфейса в перейдите на вкладку "Логи":

Теперь можно перейти по публичному адресу и начать настройку АТС.

Установка Docker и Docker Compose на Ubuntu 22.04

Перед началом работы с Docker, необходимо установить сам Docker и Docker Compose. Вот как это можно сделать:

# Обновление списка пакетов и установка необходимых зависимостей
sudo apt update
sudo apt install apt-transport-https ca-certificates curl software-properties-common

# Добавление ключа GPG официального репозитория Docker
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add -

# Добавление репозитория Docker в список источников APT
sudo add-apt-repository "deb [arch=amd64] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable"

# Установка Docker CE
sudo apt update
sudo apt install docker-ce

# Установка Docker Compose
sudo curl -L "https://github.com/docker/compose/releases/download/1.29.2/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
sudo chmod +x /usr/local/bin/docker-compose

# Проверка версии Docker Compose
sudo docker-compose --version

Создание пользователя и каталогов на хост-системе

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

Полезные команды

Команда для подключения к консоли АТС:

Команда для подключения к консольному меню АТС:

Подключение к shgrep для анализа SIP

Конференции в MikoPBX — это функция, позволяющая организовывать групповые телефонные звонки с участием нескольких абонентов одновременно. Она позволяет проводить коллективные обсуждения, совещания и встречи по телефону, улучшая коммуникацию как внутри компании, так и с внешними партнерами.

Создание конференц-комнат

Список конференц-комнат располагается в разделе "Телефония" -> "Конференции".

Для создания новой конференц-комнаты нажмите кнопку Добавить конференцию.

Необходимо указать название конференции и ее внутренний номер, позвонив на который можно в эту конференцию зайти.

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

В этом случае для того чтобы попасть в данную конференцию сотруднику после набора номера конференции необходимо будет ввести пин-код.

Характерные особенности конференц-связи

• Все собеседники общаются только голосом (никаких других способов передачи информации, кроме речевого, не предоставляется);

• все собеседники могут говорить и слышать друг друга одновременно (то есть обеспечивается дуплексная связь);

• участники используют для общения телефоны (аппаратные или программные).

Использование

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

• Сотрудник может перевести своего собеседника в конференцию, реализовав перевод с помощью комбинации стар-кодов на своем телефоне. Перевести в конференцию можно как внутренний номер, так и внешний. Комбинация для переводов задается в разделе "Система" -> "Общие настройки" -> "Переводы вызовов". Пример: Сотрудник набирает комбинацию **1111 (комбинация для безусловного перевода) и его собеседник попадает в конференцию и становится её первым участником. У переводившего сотрудника вызов завершается, и, чтобы попасть в конференцию он звонит на номер конференции 1111.

Звуковые файлы в MikoPBX — это аудиозаписи, которые используются системой для воспроизведения различных сообщений, таких как приветствия, объявления, инструкции в IVR-меню или сигналы ожидания. Они позволяют персонализировать аудиоконтент, который слышат звонящие, улучшая взаимодействие с системой и предоставляя необходимую информацию.

Загрузка звукового файла на АТС

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

Список доступных звуковых файлов отображается в разделе "Телефония" -> "Звуковые файлы".

Для добавления нового звукового файла нажмите "Добавить звуковой файл".

Нажмите Загрузить и выберите звуковой файл.

Откорректируйте наименование файла при необходимости.

Сохраните изменения.

Пользовательские звуковые файлы хранятся на АТС по пути /storage/usbdisk1/mikopbx/media/custom. Музыка на удержании хранится в /storage/usbdisk1/mikopbx/media/moh.

Музыка на удержании

Если клиент при звонке попадает в очередь или ожидает переадресацию, АТС проигрывает для него мелодию. Есть возможность загрузить свои мелодии для прослушивания во время ожидания. Это можно сделать на вкладке Музыка на удержании описанным выше способом.

Перезагрузка станции через интерфейс MikoPBX

Меню выключения/перезагрузки системы вы можете найти в MikoPBX в "Перезагрузка" -> "Обслуживание".

При открытии страницы будет отображен список активных звонков на АТС. Отображается дата начала звонка, «Кто» и «Кому» звонит.

• «Перезагрузить АТС» - команда начинает перезагрузку станции.

• «Выключение АТС» - завершает все процессы и отключает станцию.

Перезагрузка станции через консольное меню

Вы можете перезагрузить станцию через консольное меню. Для этого выберете раздел «[3] Перезагрузить систему».

Если вы хотите перезагрузить станцию: нажмите «[1] Перезагрузить MikoPBX».

Если вы хотите выключить станцию: нажмите «[2] Выключить».

Перезагрузка с проверкой диска

В случае аварийной перезагрузки АТС (например, выключение электроэнергии) может потребоваться выполнить проверку диска на ошибки.

В консольном меню АТС введите команду «[9] Консоль(Shell)» и нажмите Enter

Система запустит консоль АТС.

Введите команду Reboot. Нажмите Enter

Система перезагрузится с проверкой диска.

Назначение

«Нерабочее время» в MikoPBX — это инструмент для настройки правил обработки вызовов в периоды, когда компания не работает, например, ночью, в выходные или праздничные дни. С его помощью администраторы могут определить, как система будет обрабатывать входящие звонки в нерабочие часы: перенаправлять на автоответчик, воспроизводить специальные голосовые сообщения или переадресовывать вызовы на мобильные номера дежурных сотрудников. Это позволяет обеспечить корректное взаимодействие с клиентами вне рабочего времени и поддерживать высокий уровень обслуживания.

Создания пароля для входа

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

1. Откройте . В левом нижнем углу перейдите в "Настройки"

Создание виртуальной машины

1. Создаём новую виртуальную машину

2. Указываем Имя, Тип и Версию виртуальной машины, как показано на изображении ниже.

1. Выбираем хранилище для создания.

2. Для данной виртуальной машины выделяем объём оперативной памяти 1024 Мб. Создаём новый виртуальный жёсткий диск для основной системы размером 1024 Мб.

1. Выбираем тип контроллера SCSI и тип адаптера, как на изображении ниже

1. Выбираем BIOS в качестве Firmware.

1. Проверяем и сохраняем изменения.

Настройки виртуальной машины

1. Перейдём к настройкам созданной виртуальной машины. Создайте новый жесткий диск для хранения записей разговоров.

1. Переходим на вкладку носителей CD/DVD Drive. Загружаем iso-образ для установки. Ставим галочку слева от пункта "Connect as power on"

Установка MikoPBX

1. Запустите созданную виртуальную машину.

2. Откроется командный интерфейс АТС. АТС начнет загружаться.

   На данном этапе MikoPBX загружается с оптического диска, на который записан ISO-образ. На это нам указывает строчка: "The system is loaded in Recovery mode".

1. Переключите язык интерфейса на русский. Для этого выполните Change Language -> Русский. Меню примет вид:

1. Произведите установку MikoPBX.

Нажмите Выполнить установку.

1. Отобразится информация о всех доступных дисках (в данном примере: sdb, sdc).

1. Введите с клавиатуры имя диска, который вы подразумевали под "системный", в текущем случае sdb и нажмите Enter (Если он выбран по умолчанию можно просто нажать Enter).

2. Система запросит подтверждение. Введите - y и нажмите Enter.

1. После выполнения установки будет предложено выбрать диск для хранения записей разговоров.

Введите имя диска (в данном примере - единственный доступный диск sdc) и нажмите Enter.

1. После завершения установки система перезагрузится.

Теперь MikoPBX будет запускаться с диска sdb, на который вы ее установили. Увидим, что строчка «The system is loaded in Recovery mode» отсутствует.

На этом установка MikoPBX завершена.

Первый вход в MikoPBX

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

Логин и пароль по умолчанию - admin

На этом установка MikoPBX на завершена.

Создание виртуальной машины

1. Создаем новую виртуальную машину.

1. После скачивания последней версии образа (), указываем ISO файл с установочным дистрибутивом.

Нажимаем "Continue"

1. Выбираем тип операционной системы Other Linux 5.x and later kernel 64-bit

Нажимаем "Continue"

1. Выбираем тип биоса Legacy

Нажимаем "Continue"

1. Нажимаем "Finish"

Подключение нового диска

1. После создания виртуальной машины, дождитесь ее загрузки

1. Перейдите в раздел "[3] Reboot the system"

1. Выберите "[2] Shutdown"

1. После выключения виртуальной машины, перейдите в настройки

1. Выберите "Add device"

1. Выберите "New Hard Disk"

Нажмите "Add..."

1. Выберите размер жесткого диска(мы рекомендуем не менее 50ГБ)

Нажмите "Apply"

Установка MikoPBX

1. Запустите виртуальную машину

1. Выберите пункт "[8] Install"

1. Введите имя диска, на который будет установлена MikoPBX

В нашем случае - sdb, введите его название и нажмите Enter

1. Подтвердите выбор диска: введите y

1. Выберите диск для записи разговоров

В нашем случае - sdc, введите его название и нажмите Enter

1. Система перезагрузится и MikoPBX будет готова к использованию.

Первое подключение к MikoPBX

1. В АТС отображается IP адрес станции, по которому к ней можно подключится

1. Введите IP адрес станции в строку браузера и у вас откроется меню входа в MIkoPBX

Логин и пароль по умолчанию - "admin"

Для начала зарегистрируйтесь в сервисе Yandex Cloud.

Приступим к настройке

Создание виртуальной машины

1. Откройте Все сервисы / Инфраструктура и сеть / Compute Cloud

2. Перейдите в раздел Виртуальные машины

3. На вкладке выберите Создать ВМ

4. Введите имя виртуальной машины, например vm-mikopbx

5. Укажите зону доступности

1. Укажите параметры вычислительных ресурсов виртуальной машины, исходя из ожидаемой нагрузки на АТС и вашего бюджета. Для тестовой машины можно указать Гарантированная доля vCPU - 20%, RAM - 1 Гб

Загрузка АТС MikoPBX из образа в маркетплейсе

1. В разделе Выбор образа/загрузочного диска выберите Marketplace / Показать все продукты Marketplace / VoIP / MikoPBX IP АТС

2. В разделе Диски и файловые хранилища скорректируйте размер загрузочного диска до 1 Гб

Настройка дисков

1. В разделе Диски и файловые хранилища выберите Добавить диск

2. На открытой вкладке введите имя диска для хранения данных, например storage-mikopbx

3. Укажите тип диска HDD

Настройка сети

1. В разделе Сетевые настройки выберите существующую или создайте новую облачную сеть

2. В поле Подсеть в выпадающем меню выберите Добавить подсеть

3. На открытой вкладке введите имя подсети, например local-mikopbx

1. Публичный адрес и Внутренний IPv4-адрес оставьте в положении Автоматически

Настройка параметров SSH

1. В разделе Доступ укажите Сервисный аккаунт

2. Введите Логин и SSH-ключ, предварительно сгенерированный по

3. В разделе Дополнительные настройки установите флажок Разрешить доступ к серийной консоли

1. Завершив ввод значений, нажмите кнопку Создать ВМ

Запуск АТС MikoPBX

1. Дождитесь запуска созданной виртуальной машины, обычно первый запуск занимает 6-8 минут. Статус Running, еще не означает что система полностью развернулась

2. Откройте созданную виртуальную машину и перейдите в раздел Серийная консоль

1. Скопируйте внешний адрес созданной виртуальной машины и введите его в строке браузера

2. Для входа используйте указанные во вкладке Серийная консоль логин и пароль

Авторизуйтесь в сервисе Amazon Web Services https://aws.amazon.com

Приступим к настройке

Создание виртуальной машины

1. Откройте Services / Compute / EC2 и перейдите в раздел Images / AMI Catalog

2. На открытой вкладке в поисковой строке введите MikoPBX

3. В разделе AWS Marketplace AMIs выберите образ (x86 или ARM версию), нажав кнопку Select

4. На открытой вкладке нажмите кнопку Subscribe now

5. Нажмите кнопку Launch an instance form AMI для создания виртуальной машины

1. Введите имя виртуальной машины (Name), например mikopbx-vm

Если у вас есть ключ SSH, выполните следующее

1. Укажите SSH ключ в поле Key pair

Если у вас есть нет ключа SSH, выполните следующее

1. Выберите Create new key pair и укажите имя пары ключей (Key pair name), например mikopbx_key

Следуйте дальше по инструкции

1. При необходимости измените размер диска для хранения данных в разделе Configure storage, по умолчанию его размер - 50Гб

1. В разделе Network settings все необходимые правила Firewall настраиваются автоматически

1. Для других полей используйте значения по умолчанию

2. Нажмите кнопку Launch instance

Запуск АТС MikoPBX

1. Перейдите к созданной виртуальной машине mikopbx-vm

2. На открытой вкладке выберите Connect / EC2 serial console, дождитесь полной загрузки системы, пока не отобразятся параметры авторизации

1. Скопируйте внешний адрес созданной виртуальной машины и введите его в строке браузера

2. Для входа используйте указанные в EC2 serial console логин и пароль

Авторизуйтесь на платформе https://console.cloud.google.com/

MikoPBX в Google Cloud Маркетплейс: https://console.cloud.google.com/marketplace/product/mikopbx-public/mikopbx

Приступим к настройке

Добавление ролей сервисной учетной записи

Если у вас есть сервисная учетная запись, проверьте наличие нужных ролей, в случае необходимости добавьте их

Если сервисной учетной записи нет, создайте и добавьте ей нужные роли

1. Откройте Navigation menu / Products & solutions / Management / IAM & Admin

2. Перейдите к вкладке Service accounts и нажмите на CREATE SERVICE ACCOUNT

3. Введите имя сервисной учетной записи, например mikopbx-service-account

1. Добавьте роли Cloud Infrastructure Manager Agent, Compute Admin, Compute Network Admin, Service Account User

1. Нажмите кнопку DONE

Создание виртуальной машины

1. Откройте Marketplace и введите в поисковой строке MikoPBX

2. Выберите образ

3. На открытой вкладке выберите LAUNCH

1. В поле Deployment name введите имя, например mikopbx-vm

2. В разделе Deployment Service Account установите флажок Existing account и выберите созданный ранее сервисный аккаунт

1. При необходимости измените размер диска для хранения данных в разделе Data Storage, по умолчанию его размер - 50Гб

1. В разделе Networking все необходимые правила Firewall настраиваются автоматически

1. Для других полей используйте значения по умолчанию

2. Завершив ввод значений, нажмите кнопку DEPLOY

Запуск АТС MikoPBX

1. Откройте вкладку Compute Engine и перейдите в раздел Virtual machines / VM Instance

2. Перейдите к созданной виртуальной машине mikopbx-vm-mikopbx-vm

3. На открытой вкладке перейдите к Logs / Serial port 1 (console)

1. Скопируйте внешний адрес созданной виртуальной машины и введите его в строке браузера

2. Для входа используйте указанные в Serial port 1 (console) логин и пароль

IVR меню в MikoPBX — это интерактивное голосовое меню, которое позволяет звонящим взаимодействовать с телефонной системой с помощью тонового набора (DTMF). Оно автоматически направляет вызовы к нужным отделам или сотрудникам, улучшая эффективность обработки звонков и повышая качество обслуживания клиентов.

Предварительная настройка

Перед созданием IVR меню необходимо загрузить звуковые файлы, которые будут проигрываться клиенту при звонке в Вашу компанию. Звуковые файлы добавляются в разделе Телефония → Звуковые файлы

Также есть возможность записать файл с помощью микрофона, если с АТС соединиться по https.

Создание IVR-меню

Перейдите в Телефония → IVR меню.

Нажмите Создать новое IVR меню. Задайте наименование IVR меню, номер и при необходимости комментарий. Выберите звуковой файл, который вы загрузили на предыдущем этапе.

Настройте Действия при донаборе. В первой колонке укажите цифру или комбинацию цифр, которую набирает абонент, а во второй выберите номер, куда будет направлен вызов.

Задайте Количество повторов перед переводом на номер по умолчанию.

Установите Таймаут ожидания ввода добавочного номера (значение в секундах), после которого будет повтор голосового приветствия.

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

Включите переключатель Разрешить набор любого внутреннего номера при необходимости.

Введите номер IVR меню, позвонив на который, можно на это IVR попасть.

Нажмите Сохранить.

Описание принципа работы IVR

• При звонке на голосовое меню (Номер IVR меню) начинает проигрываться звуковой файл Голосовое приветствие.

• Во время проигрывания голосового меню можно выбирать пункты меню или набирать внутренний номер сотрудника. За донабор внутренних номеров отвечает флаг Разрешить донабор любого внутреннего номера. Он разрешает набор внутренних номеров сотрудников с SIP-аккаунтом; переходы на очереди, IVR, конференции и другие направления настраиваются отдельными действиями при донаборе.

• После проигрывания голосового меню происходит ожидание в течение значения

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

Приоритет правил маршрутизации и маршрут по умолчанию

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

Если ни по одному из правил на звонок не ответили, применяется входящий маршрут по умолчанию.

Доступны следующие действия, которые можно указать в качестве правила по умолчанию:

• Воспроизвести сигнал занято - клиент будет воспроизведен сигнал занято и входящий вызов будет завершен;

• Положить трубку;

• Перевести вызов - вызов можно перевести на номер, который вы можете выбрать в поле, расположенном справа от действия. В качестве номера для перевода можно выбрать IVR-меню, очередь вызовов, конференцию, внутренний номер сотрудника.

Несколько маршрутов для одного провайдера

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

Сперва вызов идет по верхнему маршруту. Если клиент не дозвонился, то вызов идет по нижнему правилу (более низкий приоритет). Если клиент не дозвонился и по второму маршруту, то вызов идет по маршруту по умолчанию.

Создание правила маршрутизации

Чтобы добавить новое правило входящей маршрутизации нажмите на кнопку Добавить новое правило.

В поле Заметка опишите маршрут, который хотите реализовать. В дальнейшем это поможет вам в отладке схемы звонка.

Выберите Провайдера, для которого создаете новый шаблон распределения входящих звонков.

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

Голосовое приветствие - необязательное поле, допускается выбрать медиа файл для воспроизведения звонящему.

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

Укажите время, в течение которого вызов будет идти на указанный вами телефонный номер.

Если спустя указанный интервал времени никто не ответит на входящий вызов, то вызов направится на следующее по приоритету правило.

Раздел «Хранилище» в MikoPBX позволяет контролировать использование дискового пространства и управлять настройками хранения данных. Здесь отображается подробная разбивка занятого места по категориям: записи разговоров, системные логи, резервные копии и другие файлы. Помимо мониторинга локального хранилища, раздел предоставляет возможность настроить автоматическую выгрузку записей в облачное хранилище S3.

Расположение раздела: "Обслуживание" -> "Хранилище".

Информация о хранилище

На вкладке «Информация о хранилище» отображается общая картина использования дискового пространства.

В верхней части страницы находится блок с горизонтальной диаграммой, которая наглядно показывает, какую долю от общего объёма диска занимает каждая категория данных.В примере занято 56.0 GB из 100.0 GB. Каждый сегмент диаграммы окрашен в свой цвет в соответствии с легендой:

• 🟠 Записи разговоров

• 🟣 История разговоров

• 🔵 Системные логи

• 🟢 Дополнительные модули

В нижней части страницы находится список категорий данных и количество памяти, которая каждая из них занимает.

Локальное хранилище

На вкладке "Локальное хранилище" доступно определение срока хранения записей разговоров на станции: передвигая ползунок, выберите необходимый период хранения:

• 30 дней (1 месяц) - минимальный период хранения.

• 90 дней (3 месяца) - рекомендуется для малого бизнеса.

• 1 год - для соблюдения требований законодательства.

Облачное хранилище S3

На этой вкладке настраивается автоматическая выгрузка записей разговоров во внешнее S3-совместимое хранилище (например: Amazon S3, Яндекс Cloud, VK Cloud).

В верхней части вкладки находится переключатель «Автоматическая загрузка записей в облачное хранилище» — он включает или отключает функцию выгрузки.

Для подключения к бакету необходимо заполнить следующие поля:

• URL точки доступа S3 — адрес сервиса хранилища (например, https://storage.yandexcloud.net для Yandex Cloud S3).

• Регион S3 — регион размещения бакета (например, ru-central1).

• Имя бакета S3 — название бакета, в который будут загружаться записи.

Нажмите "Сохранить" для сохранения настроек.

Далее нажмите кнопку «Проверить соединение» — система выполнит тестовое подключение и отобразит результат в верхней части страницы. При успешном подключении появится сообщение «Подключено к S3» и начнется синхронизация записей телефонных разговоров.

В нижней части вкладки расположен ползунок «Локальное хранение (режим S3)» — он определяет, как долго записи будут сохраняться локально на станции перед тем, как они будут выгружены в облачное хранилище и удалены со станции (локально). Срок локального хранения не может превышать общий срок хранения.

Инструкции по подключению облачных хранилищ

Создание бакета

1. Перейдите в консоль Yandex Cloud (ссылка).

2. Перейдите в раздел "Все сервисы" -> "Object Storage".

1. Нажмите "Создать бакет".