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

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

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

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

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

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

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

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

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

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

Пример расчета необходимой пропускной способности канала для различных кодеков на 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. Для удобства, они собраны в разделы - прямо как в Web-интерфейсе, поэтому ориентироваться в документации очень легко.

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

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

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

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

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

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

• Установка .

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

• В разделе «Сеть и Firewall» → «Сетевые интерфейсы»

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

• .

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

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

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

2. Выполните авторизацию на портале https://vscale.io

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

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

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

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

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

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

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

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

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

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

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

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

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

Установка MikoPBX в Google Cloud может быть выполнена двумя способами: из образа в маркетплейсе Google Cloud или из образа на основе загруженного файла из дистрибутива MikoPBX. Первый способ обеспечивает быстрое и простое развертывание стандартной версии 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 — это интерфейс для управления техническими аспектами системы и обеспечения ее стабильной работы. Здесь администраторы могут выполнять задачи по резервному копированию и восстановлению данных, обновлению программного обеспечения, мониторингу состояния системы и управлению журналами событий. Этот раздел помогает поддерживать работоспособность телефонной системы, своевременно обнаруживать и устранять возможные проблемы.

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

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

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

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

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

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

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

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

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

Выберите Install / Repair (или нажмите на клавиатуре цифру 8) и нажмите «Enter».

Вам нужна команда "Update to version ****.*.**". Нажмите на клавиатуре цифру 2, затем нажмите «Enter». Начнется установка обновления. Когда она завершится, АТС перезагрузится.

После перезагрузки АТС сообщения "The system loaded in Recovery mode" уже не будет, что означает, что АТС загрузилась с жесткого диска, а не с виртуального оптического привода. Вверху зеленым шрифтом будет обозначена установленная версия обновления.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Перед началом загрузите образ диска с расширением .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!"

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

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

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

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

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

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

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

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

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

В данной инструкции в качестве примера, запись образа будет произведена на 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. Система успешно загружена, но не подключен диск для хранения записей разговоров. Для его подключения, передвигаясь стрелочками на клавиатуре, перейдите в пункт "[6] Data storage" и нажмите Enter.

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

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

Нажмите Enter.

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

Для перехода в Web-интерфейс, введите IP-адрес Вашей 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". Далее перейдите к разделу .

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

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

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

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

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

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

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

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

В данной инструкции в качестве примера, запись образа будет произведена на 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 в строку браузера. Используйте стандартные данные для авторизации.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

1. Перейдите в раздел Облачная платформа -> Образы.

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

1. Укажите:

• Имя образа - любое желаемое название для вашего образа.

• ОС - Linux

• Источник - Файл

Все остальное - по умолчанию.

Нажмите создать и дождитесь окончания процесса.

1. Перейдите в раздел Облачная платформа -> Серверы

1. Нажмите "Создать сервер":

1. В конфигурации вашей ВМ укажите:

• Имя - произвольное название.

• Пул - такой же, как у раннее созданного образа.

• Источник - выберите раннее загруженный образ.

• Диски: Здесь вам необходимо указать размер для первого диска (он же - системный диск) - 5Гб (минимально возможный в Selectel). А так же создайте новый диск, используя кнопку "Добавить". Укажите размер. Для диска, который используется для записи разговоров - рекомендуемое значение >50Гб. Типы дисков - "Базовый HDD"

• Сеть - "Приватная + 1 публичный IP"

1. Нажмите "Создать сервер".

После создания, сразу остановите запуск сервера.

1. Перейдите в раздел Облачная платформа -> Сеть.

1. Перейдите в конфигурацию сети "Nat":

1. Перейдите в раздел Подсети -> Автоматические сетевые настройки.

1. Включите переключатель "DHCP-сервер".

1. Вернитесь к разделу Облачная платформа -> Серверы. Далее - в созданный сервер.

2. Включите сервер:

1. Перейдите в раздел "Syslog":

Произведите подключение по:

External IP Address - внешний IP-адрес вашей MikoPBX. Скопируйте и вставьте его в адресную строку.

Web credentials - данные для входа в WEB-интерфейс. Введите логин и пароль.

Назначение

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Для обновления контейнера 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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

1. Откройте почту. В левом нижнем углу перейдите в "Настройки" → "Все настройки" → "Безопасность" → "Пароли для внешних приложений."

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

1. На следующей странице добавьте название для создаваемого пароля - это поможет для его идентификации в будущем. В нашем примере - "SMTP для MikoPBX".

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

1. Выберите тип протокола - "Только отправка писем в Почте".

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

1. Скопируйте пароль и введите его, когда будете входить с почтой Mail в почтовую программу.

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

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

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

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

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

• SMTP логин - Ваш адрес электронной почты.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

1. Перейдите в консоль DigitalOcean ().

2. Перейдите в раздел "Manage" -> "Spaces Object Storage". Нажмите "Create a Spaces Bucket" для создания нового бакета.

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

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

Авторизуйтесь на платформе

MikoPBX в Google Cloud Маркетплейс:

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

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

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

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

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

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

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

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

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

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