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

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

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

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

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

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

Установка MikoPBX

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

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

• Установка .

• Установка .

• Установка .

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

Первый вход в веб-интерфейс

После установки Вам необходимо перейти в web-интерфейс MikoPBX для дальнейшей настройки системы. Для того, чтобы это сделать - найдите IP-адрес станции в консоли MikoPBX:

В данном примере - IP-адрес 172.25.233.36. Для перехода в web-интерфейс введите этот IP в адресную строку вашего браузера:

После первой авторизации, система попросит Вас поменять пароль.

Настройки внутри web-интерфейса:

Настройки сети и сетевого экрана

Для стабильной работы АТС необходимо настроить сеть через раздел Сеть и Firewall → Сетевые интерфейсы. Ознакомится с подробной инструкцией по данным настройкам можно .

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

Настройка защиты от взлома (Fail2Ban)

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

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

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

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

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

Настройка входящей и исходящей маршрутизации

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

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

Маркетплейс и модули

Маркетплейс позволяет расширить стандартный функционал системы с помощью модулей:

• Подробнее про Модули в MikoPBX Вы можете прочитать в .

• Про регистрацию в Маркетплейсе MikoPBX Вы можете прочитать в .

Предисловие

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

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

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

Пример расчета необходимой пропускной способности канала для различных кодеков на 30 одновременных звонков. АТС поддерживает наиболее популярные кодеки:

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

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

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

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

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

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

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

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

yc resource-manager folder list

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

1. Список зон

Описываем зону в параметре zone

1. Запускаем инстанс

1. Список инстансов обновится

Используйте EXTERNAL IP для входа и ID в качестве пароля для пользователя admin web интерфейса

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Сотрудники

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

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

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

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

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

IVR меню

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

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

Конференции

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

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

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

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

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

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

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

Назначение

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

Создание правила

Чтобы добавить новое правило нажмите на кнопку Добавить интервал времени.

Откроется форма создания нового правила.

В ней есть возможность указать:

• Период - календарный период отсутствия сотрудников в офисе. Например, на время новогодних или майских праздников

• Дни недели - конкретные дни недели, для которых будет выполняться данное правило

• Период времени - период времени отсутствия сотрудников в течении суток.

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

Кнопкой с ластиком можно очистить поля, напротив которых эта кнопка располагается.

Применять только к определенным входящим маршрутам

Активировав эту функцию, сверху у вас появится новое меню "Ограничения по маршрутам"

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

Примеры правил

Данным правилом указываются звонки с конца рабочего дня (19:00) и до начала рабочего дня (9:00).

Данным правилом указываются звонки по выходным дням: в субботу и воскресенье.

Подготовка

1. Подготовьте ПК с двумя дисками одинакового объема

2. Загрузите машину в режиме

3. Подключитесь к машине через

Сборка RAID 1

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

1. Будут отображены имена дисков. В моем случае это.

1. Затираем суперблоки на дисках.

1. Чистим старые метаданные.

1. Создаем RAID1.

1. На вопрос «Continue creating array?» отвечаем утвердительно "y".

2. Далее можно начать установку . При выборе диска следует указать md0

Полезные статьи

Grub

Ниже приведен пример с АТС, установленной на виртуальную машину 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 — это интерфейс для настройки брандмауэра (Firewall) системы. Здесь администраторы могут создавать и управлять правилами фильтрации сетевого трафика, контролируя доступ к MikoPBX и защищая ее от несанкционированного доступа и сетевых угроз. Настройка сетевого экрана обеспечивает безопасность телефонной системы, предотвращая потенциальные атаки и обеспечивая стабильную работу в сетевой инфраструктуре организации.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Дата и время

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

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

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

Доступ к AMI

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

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

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

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

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

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

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

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

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

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

1. Выберите данные, которые Вы хотите перенести, дождитесь окончания процесса.

1. Выполните загрузку Вашего архива, нажав на соответствующий элемент в разделе "Модуль резервного копирования":

1. На новом хосте (сервере) Вашей MikoPBX выполните восстановление из архива, нажав на элемент "Загрузите файл для восстановления"

После этого Ваша система будет восстановлена из архива. Данный способ идеально подходит для переноса небольшого объёма данных.

Способ 1

1. Перейдите в раздел «Общие настройки» -> "Удаление настроек системы"

1. В поле ввода вставьте текст "удалить всё", нажмите "Сохранить"

Способ 2

1. Откройте консольное меню MikoPBX. С клавиатуры введите 9 для перехода в консоль АТС.

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

1. После выполнения данных команд MikoPBX перезагрузится. Вход в web-интерфейс происходит с логином (admin) и паролем (admin) по умолчанию.

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

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

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

Перед началом вам необходимо скачать актуальный образ MikoPBX с расширением .raw. Сделать это можно по .

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Вариант №1: Перенос с помощью резервного копирования

Описание:

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

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

Настройка Резервного копирования по расписанию

Для начала нам необходимо настроить резервное копирование по расписанию для MikoPBX, с которой необходимо перенести данные.

При публикации АТС на публичном IP адресе возникает задача по защите АТС от сканеров, вредителей, кто пытается подобрать пароли к SIP учетным записям АТС. Если установлен простой числовой пароль, то он будет подобран очень быстро, что повлечет убытки.

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

1. Перейдите в раздел "Кастомизация системных файлов"

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Proxmox LXC — это легковесные контейнеры в составе платформы виртуализации Proxmox VE, работающие на базе технологии LXC (Linux Containers). Они позволяют запускать изолированные Linux-системы с минимальным потреблением ресурсов по сравнению с полноценными виртуальными машинами.

Загрузка шаблона контейнера

1. Перейдите в "local" хранилище, далее "CT Templates". Нажмите "Download from URL" для перехода к диалогу загрузки шаблона из URL.

1. Перейдите на с релизами и скопируйте ссылку на скачивание файла-шаблона с расширением "lxc.tar.gz".

1. Вставьте ссылку в поле "URL", нажмите "Query URL". Если Вы скопировали правильную ссылку, то в поле "File name" будет подставлено название файла с расширением "lxc.tar.gz".

Нажмите "Download" для начала загрузки.

После окончания загрузки, Вы увидите надпись "TASK OK".

Создание LXC контейнера

1. Нажмите "Create CT" в правой верхней части интерфейса для создания нового контейнера.

1. Заполните все базовые параметры контейнера:

• Hostname - укажите название для сервиса.

• Password - укажите пароль для входа в Web-интерфейс MikoPBX.

• SSH public keys - сгенерируйте и вставьте Ваш ssh-ключ. Далее Вы сможете использовать его для подключения к станции по SSH. Подробнее про генерацию ключей и SSH подключение можно прочитать .

Нажмите "Next".

1. Выберите ранее загруженный шаблон в разделе "Template".

Нажмите "Next".

1. Далее укажите размер системного диска. Рекомендуемое значение - 1 ГБ.

Нажмите "Add" для добавления нового диска.

1. Укажите размер второго диска: на нем будут храниться записи разговоров. Рекомендуемый размер - не менее 50 ГБ. Так же укажите путь к диску - "/storage".

Нажмите "Add" для добавления нового диска.

1. Укажите размер третьего диска для хранения конфигурации. Рекомендуемый размер - 0.5 ГБ. Так же укажите путь к диску - "/cf".

Нажмите "Next".

1. На следующей вкладке укажите количество ядер, которые будут использованы. Для небольшой компании можно указать 1-2 ядра (подробнее в ).

Нажмите "Next".

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

Нажмите "Next".

1. В следующем разделе, выберите Ваши параметры сети. В нашем случае используется DHCP для получения IPv4. Firewall здесь можно не включать, но необходимо настроить его позже в MikoPBX (подробнее можно прочитать в ).

Нажмите "Next".

1. В разделе с настройкой параметров DNS нажмите "Next".

Вы увидите итоговую конфигурацию контейнера. Нажмите "Finish".

Первый запуск

1. Перейдите в окно управления созданного контейнера, нажав на его название. Нажмите на кнопку "Start" для запуска.

1. Далее перейдите во вкладку "Console". Дождитесь загрузки системы и найдите IP-адрес Web-интерфейса.

Введите его в адресную строку Вашего браузера. Далее произведите первую авторизацию в MikoPBX.

В данной иснтрукции будет произведена установка на UTM. Перед ее началом скачайте файл образа диска с расширением ".iso". Сделать это можно по ссылке.

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

1. Перейдите в UTM. Нажмите "Create a New Virtual Machine" для создания новой виртуальной машины.

1. В качестве типа виртуальной машины выберите "Virtualize".

1. В качестве типа операционной системы выберите "Preconfigured" - "Linux".

1. Выберите ранее загруженный файл образа диска в разделе "Boot ISO Image". Для этого нажмите на "Browse...".

1. Далее укажите характеристики Вашей виртуальной машины. В нашем случае будут использованы 2 ГБ ОЗУ и 2 ядра процессора.

1. Далее укажите размер для системного диска. В нашем случае - 1 Гб.

1. Нажмите Continue.

1. Будет отображена итоговая конфигурация виртуальной машины. Задайте ей желаемое имя (поле "Name"). И нажмите "Save".

Подключение диска для хранения данных

1. Перейдите в настройки ВМ. Для этого нажмите правой кнопкой мыши по её названию, далее "Edit".

1. Перейдите в "Drives". Нажмите "New..."

1. Создайте новый диск со следующими параметрами:

• Interface - VirtlO

• Size - не менее 50Гб (в этой документации для тестовой машины будет использовано 10Гб)

Нажмите "Create".

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

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

1. После загрузки Вы увидите надпись PBX is running in Live or Recovery mode. Это означает, что система загружена из образа диска в Live режиме. Необходимо произвести установку системы. Для этого перейдите к разделу "[8] Install on Hard Drive".

1. Выберите диск для установки системы. В нашем случае доступны диски vda и vdb, для установки выбираем диск vda.

1. Подтвердите выбор: введите "y" с клавиатуры и нажмите Enter.

1. Далее выберите диск для хранения записей разговоров. В нашем случае единственный оставшийся размером 10 Гб.

После этого система будет перезагружена и доступна в обычном режиме (надпись "PBX is running in Live or Recovery mode" пропадет).

Введите этот IP-адрес в строку браузера для перехода в Веб-интерфейс.

Для начала зарегистрируйтесь в сервисе 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. Для входа используйте указанные во вкладке Серийная консоль логин и пароль

Авторизуйтесь на платформе 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) логин и пароль

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

Чем она полезна

История вызовов в MikoPBX позволяет:

• Отобразить все вызовы;

• Отобразить вызовы по отбору;

• Визуально отобразить пропущенные вызовы из общего списка звонков;

Каждый элемент списка содержит информацию о:

• номере телефона звонящего абонента (Кто);

• номере телефона, на который звонили (Кому);

• дате и времени свершения звонка (Дата звонка);

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

Для каждой записи истории звонков доступна возможность прослушивания и скачивания записи разговоров. Записи разговоров скачиваются локально на ПК в формате .mp3.

Каждая строка вызова содержит полную информацию об участниках разговора.

На скриншоте выше отображено следующее:

1. Вызов поступил на номер 79255283744;

2. На вызов ответила Белкина;

3. Белкина осуществила консультативный перевод на Шевченко;

Отборы

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

1) Отбор по номеру телефона

В строке поиска можно ввести как внутренний номер сотрудника, так и номер клиента (внешний).

2) Отбор по двум номерам телефона

В строке поиска через пробел можно ввести два номера телефона. Если ввести "74952293042 302", то будут отображены все отвеченные вызовы между двумя номерами. Отвеченные вызовы - это вызовы, имеющие длительность разговора больше 0 секунд, время голосового приветствия не учитывается.

3) Отбор по дате

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

4) Отбор по linkedid

linkedid - уникальный идентификатор звонка. Данным отбором удобно пользоваться, если необходимо найти вызов, исходя из данных . Для применения этого отбора: 1. Откройте журнал звонков 1С; 2. Выделите нужную строку; 3. Нажмите Подробнее во встроенном плеере (или вызвав контекстное меню на данной строке); 4. Скопируйте поле Идентификатор; 5. Вставьте это значение в строку поиска истории вызовов MikoPBX и нажмите Enter.

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

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

• Использовать оповещения - позволяет включить/отключить все оповещения на email, включая голосовую почту.

• Отправлять уведомления о пропущенных вызовах - позволяет включить/отключить уведомления о пропущенных вызовах.

• Единый Email для уведомлений о пропущенных вызовах - общий адрес электронной почты для отправки уведомлений о пропущенных внешних вызовах (если у сотрудника не указан email, используется этот общий адрес).

• Отправлять уведомления о голосовых сообщениях - позволяет включить/отключить уведомления о голосовых сообщениях.

• Единый Email для уведомлений о голосовых сообщениях - общий адрес электронной почты для отправки уведомлений о голосовых сообщениях (приоритет: 1. Личный email сотрудника; 2. Указанный email в этом поле)

• Отправлять уведомления о входах в систему - позволяет включить/отключить уведомления о входах в систему.

• Отправлять системные уведомления - позволяет включить/отключить отправку системных уведомлений.

• Email системного администратора - адрес, на который будут отправляться системные уведомления.

Настройки SMTP

• Адрес отправителя, Имя отправителя - от имени этого адреса и имени будут отправляться электронные письма.

• Тип аутентификации:

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

Аунтефикация по логину и паролю

• SMTP логин, SMTP пароль - параметры авторизации.

• SMTP хост - адрес почтового сервера.

• SMTP порт - порт почтового сервера.

Аунтефикация с OAuth2

• SMTP логин - параметры авторизации.

• Провайдер OAuth2 - почтовый сервис, через который выполняется OAuth-аутентификация (например, Microsoft/Outlook, Google/Gmail).

• Идентификатор приложения (Client ID) - уникальный идентификатор приложения, созданного в панели управления выбранного OAuth-провайдера. Используется для того, чтобы провайдер понимал, какое именно приложение запрашивает доступ к почтовому ящику.

Как подключить?

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

• Аутентификация по логину и паролю:

• Аутентификация oAuth2:

Создание приложения в Yandex

1. Авторизуйтесь в Ваш аккаунт Яндекс и далее перейдите на страницу создания приложения. Нажмите "Создать".

1. В диалоговом окне выберите опцию "Для атворизации пользователей". Нажмите "Перейти к созданию".

1. Далее заполните необходимую информацию:

• Название - произвольное.

• Иконка сервиса - произвольное изображение.

• Почта для связи - почта на которую будут приходить уведомления об авторизации.

Нажмите "Продолжить".

1. Далее выберите в качестве платформы "Веб-сервисы". В поле "Redirect URl" вставьте следующую ссылку:

Замените 192.168.100.60 на ip-адрес Вашей станции.

Нажмите "Продолжить".

1. Далее на странице "Права доступа к данным пользователей" в разделе "Дополнительные" впишите "smtp" и выберите доступ "Отправка писем через Яндекс.Почту по протоколу SMTP".

1. На следующей странице нажмите "Всё верно, создать приложение".

После создания приложения будет выведены ClientID и Client Secret. Далее они понадобятся нам для настройки внутри web-интерфейса MikoPBX.

Настройки внутри MikoPBX

1. Перейдите в Web-интерфейс MikoPBX. Далее "Система" -> "Почта и уведомления" -> "Настройки SMTP".

Заполните все необходимые данные:

• Адрес отправителя, Имя отправителя - Ваша почта и от какого имени будут отправляться письма.

• Тип аутентификации - OAuth2.

• SMTP логин - Ваша почта.

Все остальные настройки оставьте по умолчанию. Более подробное описание Вы можете найти в главное статье о параметрах почты ().

После этого нажмите "Сохранить"!

1. Нажмите "Подключить через OAuth2". Войдите в Ваш аккаунт Яндекс. После авторизации, нажмите "Log in as...".

1. При успешной авторизации Вы увидите соответствующее окно.