Only this pageAll pages
Powered by GitBook
Couldn't generate the PDF for 234 pages, generation stopped at 100.
Extend with 50 more pages.
1 of 100

Russian

Loading...

Loading...

Loading...

Loading...

Установка

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Руководство пользователя

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Часто задаваемые вопросы

Интеграция с 1С

Перехват на ответственного

Loading...

Отменить перехват на ответственного для конкретного провайдера

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Виртуальные машины

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

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

VMware ESXi
VMware Fusion
VirtualBOX
VMware Workstation Pro
Hyper-V
Proxmox

Руководство по MikoPBX

Описание MikoPBX и разделов, которые вы сможете найти в документации. Вступление в документацию.

Предисловие

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

Что такое MikoPBX?

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

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

Одновременные звонки
Минимально рекомендуемая конфигурация

5 - 10

1 GHz x86-64, 512 MB RAM

До 25

3 GHz x86-64, 1 GB RAM

Более 25

2 CPUs 3 GHz x86-64, 2 GB RAM или больше

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

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

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

Модули

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

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

Раздел FAQ

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

Знакомство с MikoPBX

Это статья про первый вход в MikoPBX. Здесь вы найдете процесс первого входа в систему и некоторые рекомендации по первоначальной настройки после входа.

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

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

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

Данные по умолчанию:

Логин - admin

Пароль - admin

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

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

Установка .

Установка .

Установка .

Установка в .

.

.

.

.

.

.

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

- здесь подробно описан процесс регистрации и его особенности.

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

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

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

Более подробную информацию об Общих настройках в разделе

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

❤️
на отдельный компьютер
в виртуальную машину
с помощью облачных сервисов
Docker контейнере
Телефония
Маршрутизация
Модули
Обслуживание
Сеть и Firewall
Система
данной статье
Регистрация в Маркетплейсе MikoPBX
Управление модулями
Документация по конкретным модулям
Telegram Community
Системных настроек.
ссылке

Отдельный компьютер

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

Протестировано на:

  • Intel NUC DCCP847DYE

  • Intel NUC D54250WUKH

Большинство современных ПК поддерживают загрузку с USB устройства. MikoPBX может быть запущена с USB устройства.

Обратите внимание! Минимальная емкость USB диска - 600MB

  • Режим Bootable USB предназначен для работы АТС с USB диска (флэш карты). Используйте для установки файл *.img

  • Режим Live USB предназначен для установки или восстановления системы. Используйте для установки файл *.iso

Используем Windows

  1. Загрузите и установите приложение.

  2. Запустите ImageUSB

  1. Выполните действие «Refresh drives». Выберите USB диск, далее выберите файл образа. Выполните действие «Write»

  1. Дождитесь окончания записи, далее подключите USB диск к ПК. Перезагрузите ПК для загрузки с диска.

Используем OSX

Будьте внимательны при выборе устройства к форматированию. Изменения не обратимы!

  1. Откройте приложение «Terminal» (Терминал)

  2. Подключите USB диск

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

diskutil list

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

В текущем примере имя устройства USB «/dev/disk3». Cравним вывод команды «diskutil list» до и после подключения устройства.

  1. Форматируем диск. Потребуется ввести пароль администратора

sudo diskutil eraseDisk FAT32 NONAME  MBRFormat /dev/disk3;
  1. Отключим устройство следующей командой

sudo diskutil unmountDisk /dev/disk3;
  1. Запишем образ на USB носитель

sudo dd if=1.0.64-9.0-svn-mikopbx-x86-64-cross-linux.img of=/dev/disk3 bs=1m;

Дождитесь окончания записи, далее подключите USB диск к ПК. Перезагрузите ПК для загрузки с диска.

VMware Workstation Pro

Установка MikoPBX с помощью VMware Workstation Pro

В текущей инструкции будет описан процесс создания и настройки виртуальной машины в VMware Workstation Pro, а так же процесс установки MikoPBX.

Используйте для установки на VMware Workstation Pro версии АТС MikoPBX отличные от 2024.1.114

Версия 2024.1.114 временно не поддерживает установку с помощью VMware Workstation Pro!

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

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

  1. В интерфейсе создания виртуальной машины укажите тип виртуальной машины: "Typical (recommended)". Далее, нажмите - "Next >".

  1. Выберите "Linux" в поле "Guest operating system". В качестве "Version" - "Debian 11.x 64-bit". Нажмите "Next >"

  1. Укажите желаемое имя для виртуальной машины в поле "Virtual machine name:". Так же есть возможность указать локацию для этой виртуальной машины на вашем компьютере: используйте поле "Location". Нажмите "Next >".

  1. Укажите размер для первого (системного) жесткого диска: рекомендуемое значение - 1Гб. Выберите "Split virtual disk into multiple files". Нажмите "Next >".

  1. Отобразится итоговая конфигурация виртуальной машины. Нажмите "Finish". Произойдет создание виртуальной машины.

Создание и подключение второго диска

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

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

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

  1. Выберите "Hard Disk" в разделе "Hardware types". Нажмите "Next >"

  1. Выберите "Virtual disk type" - "SCSI". Нажмите "Next >".

  1. Выберите "Create a new virtual disk". Нажмите "Next >".

  1. Выберите размер диска: рекомендованное значение - не менее 50 Гб. Так же выберите параметр "Split virtual disk into multiple files". Нажмите "Next >"

  1. Укажите произвольное название для жесткого диска. Нажмите "Finish"

Указание сетевого интерфейса для виртуальной машины

В настройках перейдите в раздел "Network Adapter". Выберите "Network connection" - "Bridged: Connected directly to the physical network". Нажмите "OK"

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

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

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

Выбрать пункт меню - клавиша Enter.

  1. Переключите язык интерфейса на русский. Для этого выполните "[1] Change Language" -> "[2] Русский".

  2. Далее произведем установку MikoPBX. Перейдите в пункт "[8] Install".

  3. Отобразится информация о всех доступных дисках (в данном примере: sdb, sdc). Системой предложен диск по умолчанию, в нашем случае - sdb. Если вы согласны с предложенным диском, который будет использоваться в качестве системного - нажмите Enter. В противном случае напишите название другого диска.

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

  1. Далее система выдаст предупреждения. Для подтверждение операции - введите "y" и нажмите Enter.

  2. После выполнения установки будет предложено выбрать диск для хранения записей разговоров. Введите имя диска (в данном примере - единственный доступный диск sdc) и нажмите Enter.

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

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

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

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

Впишите IP-адрес в адресную строку вашего браузера. Произведите первый вход в MikoPBX по стандартному логину и паролю.

При первом входе в WEB-интерфейс MikoPBX используйте стандартные данные:

  • Логин: admin

  • Пароль: admin

VMware ESXi

Установка MikoPBX с помощью VMware ESXi.

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

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

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

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

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

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

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

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

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

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

Для такого диска, мы рекомендуем указывать размер не менее, чем 50 ГБ

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

Установка MikoPBX

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

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

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

Выбрать пункт меню - клавиша Enter.

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

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

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

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

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

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

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

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

Ориентировочно, 1 час разговора занимает 14Мб места на диске.

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

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

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

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

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

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

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

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

VMware Fusion

Установка MikoPBX с помощью VMware Fusion.

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

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

Нажимаем "Continue"

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

Нажимаем "Continue"

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

Нажимаем "Continue"

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

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

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

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

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

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

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

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

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

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

Нажмите "Apply"

1 час записи разговоров занимает примерно 14мб на диске.

Установка MikoPBX

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

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

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

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

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

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

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

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

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

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

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

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

Proxmox

Установка MikoPBX с помощью Proxmox.

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

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

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

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

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

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

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

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

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

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

Для развертывания АТС используйте два диска:

  • диск объемом 1 Гб для основной системы

  • диск объемом 50+ Гб для хранения записей разговоров

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

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

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

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

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

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

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

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

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

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

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

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

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

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

После появления сообщения “Press any key within 30 seconds to boot from LiveCD…” не нажимайте никаких кнопок. В этом случае система загрузится с жесткого диска.

Запуск АТС MikoPBX

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

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

Hyper-V

Установка MikoPBX с помощью HyperV.

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

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

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

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

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

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

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

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

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

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

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

Для развертывания АТС используйте два диска:

  • диск объемом 1 Гб для основной системы

  • диск объемом 50+ Гб для хранения записей разговоров

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

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

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

  4. Нажмите кнопку Создать

  5. На вкладке Выбор формата диска выберите формат - VHD

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

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

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

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

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

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

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

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

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

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

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

После появления сообщения “Press any key within 30 seconds to boot from LiveCD…” не нажимайте никаких кнопок. В этом случае система загрузится с жесткого диска.

Запуск АТС MikoPBX

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

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

Облачные сервисы

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

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

Для создания загрузочного USB диска рекомендуем использовать приложение imageUSB. Скачать можно по . Альтернатива - используйте

Скачать установщик VMware Workstation Pro можно .

Далее выберите источник установки "Installer disc image file (iso):", выберите файл образа диска с расширением .iso. Скачать дистрибутив вы можете по . После выбора нажмите "Next >" для продолжения.

Перемещаться по пунктам меню можно .

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

Перемещаться по пунктам меню можно .

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

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

ссылке
balenaEtcher
на сайте
ссылке
клавишами управления курсором
буквенно-цифровом блоке клавиатуры
клавишами управления курсором
буквенно-цифровом блоке клавиатуры
ссылка
Yandex Cloud
VK Cloud
1С:Облачная инфраструктура
AWS
Microsoft Azure
Google Cloud
Hetzner cloud (Empty)
Vscale
Selectel
DigitalOcean

Hetzner cloud (Empty)

Установка MikoPBX с помощью Hetzner Cloud

VK Cloud

Установка MikoPBX с помощью VK Cloud

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

Добавление локальной подсети

  1. Откройте Виртуальные сети / Сети

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

  3. Введите имя новой сети, например pbx_network

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

  5. Завершив ввод значений, нажмите кнопку Добавить сеть

Добавление ssh-rsa ключа

  1. Перейдите к своему аккаунту

  2. В выпадающем меню выберите Ключевые пары

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

  1. Выберите Импортировать ключ

  2. Введите название ключа и укажите ключ в поле Публичный ключ

  3. Нажмите кнопку Импортировать ключ

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

  1. Выберите Создать ключ

  2. Введите название ключа, например mikopbx_ssh_key

  3. Нажмите кнопку Создать ключ

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

  1. Откройте Облачные вычисления / Образы

  2. На вкладке Образы выберите Создать образ

  3. Укажите источник - Файл

  4. Выберите файл из дистрибутива MikoPBX с расширением .raw

  5. Введите название образа, например mikopbx_image

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

Создание инстанса

  1. Откройте Облачные вычисления / Виртуальные машины

  2. На вкладке Виртуальные машины выберите Создать инстанс

  3. Введите имя виртуальной машины, например mikopbx_vm

  4. В поле Категория виртуальной машины выберите Все актуальные типы виртуальных машин

  5. Укажите Тип виртуальной машины, исходя из ожидаемой нагрузки на АТС. Для тестовой машины можно указать STD2-1-1

  6. Выберите Зону доступности

  1. Укажите Тип диска - HDD

  2. В качестве Операционной системы выберите mikopbx_image

  1. Перейдите к следующему шагу Настройки сети

  2. Выберите созданную Сеть pbx_network

  3. Выберите созданный Ключ виртуальной машины mikopbx_ssh_key

  4. Включите переключатель Назначить внешний IP

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

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

  3. Как только инстанс будет создан, сразу остановите его запуск

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

Для развертывания АТС используйте два диска:

  • диск объемом 1 Гб для основной системы

  • диск объемом 50+ Гб для хранения записей разговоров

  1. Откройте Облачные вычисления / Диски

  2. На вкладке Диски выберите Создать диск

  3. Введите название диска, например mikopbx_storage_disk

  4. Укажите Источник - Пустой диск

  5. Укажите Тип диска - Сетевой HDD-диск (ceph-hdd)

  6. Выберите Зону доступности такую же, как и у инстанса

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

  1. Включите переключатель Подключить диск к инстансу

  2. Выберите созданный инстанс mikopbx_vm

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

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

  1. Откройте Облачные вычисления / Виртуальные машины

  2. Запустите созданный инстанс mikopbx_vm

Firewall

  1. Откройте Виртуальные сети / Настройки firewall

  2. На вкладке Настройки firewall выберите Добавить

  3. Введите имя группы правил, например mikopbx_rules

  4. Нажмите кнопку Создать группу

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

  2. Выберите Тип - Все протоколы и все порты

  3. Укажите Удаленный адрес - Все IP-адреса

  4. Нажмите кнопку Сохранить правило

  1. В разделе Виртуальные машины с группой правил mikopbx_rules выберите Добавить виртуальную машину

  2. Выберете созданную виртуальную машину mikopbx_vm и нажмите Добавить группу правил

Обязательно выполните настройку Firewall на самой АТС MikoPBX

Запуск АТС MikoPBX

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

  2. Откройте Облачные вычисления / Виртуальные машины

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

  4. На открытой вкладке перейдите в раздел Логи

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

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

Произвольный образ

Установка в Yandex cloud произвольного образа MikoPBX

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

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

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

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

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

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

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

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

Загрузка АТС MikoPBX из произвольного образа

Перед созданием виртуальной машины необходимо предварительно загрузить образ MikoPBX в облачное хранилище

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

  2. На вкладке Object Storage выберите Создать бакет

  3. Введите имя нового бакета, например mikopbx-imgs

  4. Укажите макс. размер 1 Гб

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

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

  1. Откройте созданный бакет mikopbx-imgs

  2. На открывшейся вкладке выберите Загрузить объекты

  3. Выберите файл из дистрибутива MikoPBX с расширением .raw

  4. Нажмите кнопку Загрузить

  1. После завершения загрузки откройте загруженный объект

  2. Выберите Получить ссылку и скопируйте ссылку на образ

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

  4. Перейдите в раздел Образы

  5. На вкладке выберите Загрузить образ

  6. Введите имя образа, например mikopbx-img

  7. В поле Ссылка на образ в Object Storage укажите скопированную ранее ссылку на образ АТС

  8. Нажмите кнопку Загрузить

Вернемся к выбору образа на вкладке Все сервисы / Инфраструктура и сеть / Compute Cloud / Виртуальные машины

  1. В разделе Выбор образа/загрузочного диска выберите Свой образ / Выбрать / Наполнение - Образ / mikopbx-img

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

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

Для развертывания АТС используйте два диска:

  • диск объемом 1 Гб для основной системы

  • диск объемом 50+ Гб для хранения записей разговоров

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

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

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

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

  5. Наполнение - Пустой

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

  7. Нажмите кнопку Добавить

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

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

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

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

  4. В поле CIDR укажите диапазон адресов, например 172.16.32.0/24

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

  6. Нажмите кнопку Создать

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

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

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

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

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

Запуск АТС MikoPBX

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

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

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

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

Магазин приложений

Установка MikoPBX в Yandex Cloud из Marketplace

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

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

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

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

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

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

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

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

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

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

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

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

Для развертывания АТС используйте два диска:

  • диск объемом 1 Гб для основной системы

  • диск объемом 50+ Гб для хранения записей разговоров

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

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

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

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

  5. Наполнение - Пустой

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

  7. Нажмите кнопку Добавить

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

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

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

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

  4. В поле CIDR укажите диапазон адресов, например 172.16.32.0/24

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

  6. Нажмите кнопку Создать

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

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

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

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

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

Запуск АТС MikoPBX

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

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

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

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

1С:Облачная инфраструктура

Установка MikoPBX с помощью 1С:Облачная инфраструктура

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

Добавление локальной подсети

  1. Откройте Виртуальные сети / Сети

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

  3. Введите имя новой сети, например pbx_network

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

  5. Завершив ввод значений, нажмите кнопку Добавить сеть

Добавление ssh-rsa ключа

  1. Перейдите к своему аккаунту

  2. В выпадающем меню выберите Ключевые пары

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

  1. Выберите Импортировать ключ

  2. Введите название ключа и укажите ключ в поле Публичный ключ

  3. Нажмите кнопку Импортировать ключ

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

  1. Выберите Создать ключ

  2. Введите название ключа, например mikopbx_ssh_key

  3. Нажмите кнопку Создать ключ

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

  1. Откройте Облачные вычисления / Образы

  2. На вкладке Образы выберите Создать образ

  3. Укажите источник - Файл

  4. Выберите файл из дистрибутива MikoPBX с расширением .raw

  5. Введите название образа, например mikopbx_image

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

Создание инстанса

  1. Откройте Облачные вычисления / Виртуальные машины

  2. На вкладке Виртуальные машины выберите Создать инстанс

  3. Введите имя виртуальной машины, например mikopbx_vm

  4. В поле Категория виртуальной машины выберите Все актуальные типы виртуальных машин

  5. Укажите Тип виртуальной машины, исходя из ожидаемой нагрузки на АТС. Для тестовой машины можно указать STD2-1-1

  6. Выберите Зону доступности

  1. Укажите Тип диска - HDD

  2. В качестве Операционной системы выберите mikopbx_image

  1. Перейдите к следующему шагу Настройки сети

  2. Выберите созданную Сеть pbx_network

  3. Выберите созданный Ключ виртуальной машины mikopbx_ssh_key

  4. Включите переключатель Назначить внешний IP

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

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

  3. Как только инстанс будет создан, сразу остановите его запуск

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

Для развертывания АТС используйте два диска:

  • диск объемом 1 Гб для основной системы

  • диск объемом 50+ Гб для хранения записей разговоров

  1. Откройте Облачные вычисления / Диски

  2. На вкладке Диски выберите Создать диск

  3. Введите название диска, например mikopbx_storage_disk

  4. Укажите Источник - Пустой диск

  5. Укажите Тип диска - Сетевой HDD-диск (ceph-hdd)

  6. Выберите Зону доступности такую же, как и у инстанса

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

  1. Включите переключатель Подключить диск к инстансу

  2. Выберите созданный инстанс mikopbx_vm

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

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

  1. Откройте Облачные вычисления / Виртуальные машины

  2. Запустите созданный инстанс mikopbx_vm

Firewall

  1. Откройте Виртуальные сети / Настройки firewall

  2. На вкладке Настройки firewall выберите Добавить

  3. Введите имя группы правил, например mikopbx_rules

  4. Нажмите кнопку Создать группу

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

  2. Выберите Тип - Все протоколы и все порты

  3. Укажите Удаленный адрес - Все IP-адреса

  4. Нажмите кнопку Сохранить правило

  1. В разделе Виртуальные машины с группой правил mikopbx_rules выберите Добавить виртуальную машину

  2. Выберете созданную виртуальную машину mikopbx_vm и нажмите Добавить группу правил

Обязательно выполните настройку Firewall на самой АТС MikoPBX

Запуск АТС MikoPBX

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

  2. Откройте Облачные вычисления / Виртуальные машины

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

  4. На открытой вкладке перейдите в раздел Логи

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

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

Коммандная строка YC

Установка MikoPBX в Yandex Cloud с помощью утилиты yc

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

yc resource-manager folder list

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

  1. Список зон

yc compute zone list 

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

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

yc compute instance create \
	--folder-name apor-test-catalog \
	--name test\
	--zone ru-central1-c \
	--cores 2 \
	--memory 2gb \
	--create-boot-disk image-id=fd83g1qbk6m3jnl5cvah \
	--ssh-key ~/.ssh/id_rsa.pub \
	--public-ip \
	--create-disk name=storage-test-mikopbx,size=20,auto-delete=1
  1. Список инстансов обновится

yc compute instance list                 
+----------------------+-----------------+---------------+---------+-----------------+-------------+
|          ID          |      NAME       |    ZONE ID    | STATUS  |   EXTERNAL IP   | INTERNAL IP |
+----------------------+-----------------+---------------+---------+-----------------+-------------+
| ef38gedvuug8qvv4l74p | test            | ru-central1-c | RUNNING | 51.250.39.55    | 10.130.0.6  |
+----------------------+-----------------+---------------+---------+-----------------+-------------+

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

AWS

Варианты установки MikoPBX с помощью AWS

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

Google Cloud подробная инструкция

Установка MikoPBX в облако Google Cloud с помощью произвольного образа

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

Для быстрого и удобного поиска на платформе Google Cloud используйте панель поиска

Создание хранилища

  1. Откройте Navigation menu / Products & solutions / Storage / Cloud Storage

  2. На вкладке Cloud Storage выберите Create

  3. Введите имя хранилища, например miko-images

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

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

  1. Откройте созданное хранилище miko-images

  2. На открывшейся вкладке выберите UPLOAD FILES

  3. Загрузите файл из дистрибутива MikoPBX с расширением .vhd

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

Подключение Cloud Build API

  1. Откройте Navigation menu / APIs & Services / Library / Google Enterprise API / Cloud Build API

  2. На открывшейся вкладке выберите ENABLE

Проверьте роли учетной записи службы Cloud Build, для этого

  1. Выберите свой проект Google Cloud

  2. Установите флажок Include Google-provided role grants

  3. В таблице найдите строку с адресом электронной почты, заканчивающимся на @cloudbuild.gserviceaccount.com

  4. Выберите Править (Edit principal)

  5. Роли, которые должны быть предоставлены учетной записи службы Cloud Build, - Сompute Admin и Service Account User

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

Подключение Compute Engine API

  1. Откройте Navigation menu / APIs & Services / Library / Google Enterprise API / Compute Engine API

  2. На открывшейся вкладке выберите ENABLE

Создание образа

  1. Откройте Navigation menu / Products & solutions / Compute / Compute Engine

  2. Перейдите в раздел Storage / Images

  3. Выберите CREATE IMAGE для создания нового образа

  4. Введите имя образа (Name), например mikopbx-new-image

  5. Укажите тип источника (Source) - Virtual disk (VMDK, VHD)

  6. Выберите Virtual disk file по ссылке BROWSE, Browse / miko-images / .vhd

  7. Уберите флажок Install guest packages

  8. В поле Operating system on virtual disk укажите - No operating system. Data only.

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

  10. Завершив ввод значений, нажмите кнопку Create и дождитесь окончания создания образа

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

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

  2. Выберите CREATE INSTANCE

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

  1. В таблице Machine configuration / General purpose выберите Series - N1

  1. В разделе Machine type в выпадающем меню выберите Shared-core / f1-micro

Для развертывания АТС используйте два диска:

  • диск объемом 1 Гб для основной системы

  • диск объемом 50+ Гб для хранения записей разговоров

  1. В разделе Boot disk выберите CHANGE

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

  3. В поле Image выберите созданный ранее образ mikopbx-new-image

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

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

  1. В разделе Advanced options / Disks выберите ADD NEW DISK

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

  3. Укажите размер диска (Size) не менее 50Гб

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

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

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

  1. В разделе Advanced options / Security / MANAGE ACCESS выберите ADD ITEM

  2. Укажите его в поле SSH key

Если у вас есть нет ключа SSH, сразу перейдите к пункту 18

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

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

Настройка портов для входящих соединений

  1. Откройте Navigation menu / VPC network / Firewall

  2. Выберите CREATE FIREWALL RULE для создания нового правила для входящего соединения

  3. Введите имя нового правила (Name), например internal-allow

  1. Укажите Direction of traffic - Ingress

  2. Укажите Targets

  3. Из выпадающего меню в поле Source filter выберите IPV4 ranges и в поле Source IPv4 ranges укажите 0.0.0.0/0

  1. В разделе Protocols and ports установите флажок TCP (Ports - 0-65535) и флажок UDP (Ports - 0-65535)

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

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

Обязательно выполните настройку Firewall на самой АТС MikoPBX

Запуск АТС MikoPBX

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

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

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

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

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

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

Установка MikoPBX в Google Cloud с помощью Маркетплейса

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

Для быстрого и удобного поиска на платформе Google Cloud используйте панель поиска

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Для развертывания АТС используйте два диска:

  • диск объемом 1 Гб для основной системы

  • диск объемом 50+ Гб для хранения записей разговоров

  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) логин и пароль

AWS Маркетплейс

Установка MikoPBX с помощью образа из AWS Маркетплейса

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

Для быстрого и удобного поиска в сервисе Amazon используйте панель поиска

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

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

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

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

  4. Нажмите кнопку 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 Гб для основной системы

  • диск объемом 50+ Гб для хранения записей разговоров

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

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

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

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

Запуск АТС MikoPBX

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

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

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

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

Обязательно выполните настройку Firewall на самой АТС MikoPBX

Microsoft Azure

Установка MikoPBX с помощью Microsoft Azure.

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

Для быстрого и удобного поиска на портале Azure используйте панель поиска

Создание группы ресурсов

  1. Откройте Меню / Все службы / Общие / Группы ресурсов

  2. На вкладке Группы ресурсов выберите Создать

  3. Введите имя группы, например MikoPBX_group

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

  5. Завершив ввод значений, нажмите кнопку Просмотр и создание, затем кнопку Создать

Создание учетной записи хранения

  1. Откройте Меню / Все службы / Интернет вещей / Учетные записи хранения

  2. На вкладке Учетные записи хранения выберите Создать

  3. Укажите созданную группу ресурсов MikoPBX_group

  4. Введите имя учетной записи, например pbximgs

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

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

Настройка созданной учетной записи хранения

  1. Перейдите к карточке созданной учетной записи хранения pbximgs

  2. На открытой вкладке перейдите в меню Хранилище данных / Контейнеры

  3. Добавьте новый контейнер

  4. Введите имя контейнера, например imgs

  5. Нажмите кнопку Создать

  1. Откройте созданный контейнер imgs

  2. На открывшейся вкладке выберите Отправка

  3. Выберите файл из дистрибутива MikoPBX с расширением .vhd

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

Создание образа

  1. Откройте Меню / Все службы / Вычисление / Образы

  2. На вкладке Образы выберите Создать, создадим новый образ на основе загруженного *.vhd файла

  3. Укажите группу ресурсов MikoPBX_group

  4. Введите уникальное имя для образа, например MikoPBX_Azure

  1. Укажите тип ОС - Linux

  2. Укажите поколение виртуальных машин - Поколение 1

  3. Выберите BLOB-объект хранилища по ссылке Обзор, Обзор / pbximgs / imgs / *.vhd

  4. Укажите тип учетной записи - HDD (цен. категория "Стандартный")

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

  6. Завершив ввод значений, нажмите кнопку Просмотр и создание, затем кнопку Создать

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

  1. Откройте Меню / Все службы / Вычисление / Виртуальные машины

  2. На вкладке Виртуальные машины выберите Создать / Виртуальная машина Azure

  3. Укажите группу ресурсов MikoPBX_group

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

  1. Выберите созданный ранее образ, Посмотреть все образы / Другие элементы / Мои изображения / MikoPBX_Azure

  2. Укажите размер машины (совокупность параметров ЦП / ОЗУ не менее 1Гб / HDD)

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

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

  1. Выберите источник открытого ключа SSH - Использовать существующий открытый ключ

  2. Укажите его в поле открытый ключ SSH

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

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

  2. Укажите имя пары ключей, например mikopbx_key

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

  1. В поле тип лицензии укажите Другое

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

Для развертывания АТС используйте два диска:

  • диск объемом 1 Гб для основной системы

  • диск объемом 50+ Гб для хранения записей разговоров

  1. Перейдите на вкладку Диски

  2. Укажите тип диска ОС

  3. Установите флажок Удалить с виртуальной машиной

  1. Создайте новый диск данных

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

  3. Для других полей используйте значения по умолчанию, нажмите кнопку ОК

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

Настройка портов для входящих соединений

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

  2. На вкладке выберите Создание правила для порта / Правило входящего порта

  3. Укажите диапазоны портов назначения - 0 - 65535

  4. Выберите протокол TCP

  1. Укажите имя, например TCP

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

  3. Завершив ввод значений, нажмите кнопку Добавить

  1. Аналогично создайте правило для UDP. Укажите диапазоны портов назначения - 0 - 65535, протокол UDP и имя

Обязательно выполните настройку Firewall на самой АТС MikoPBX

Запуск АТС MikoPBX

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

  2. В выпадающем меню Дополнительные способы подключения выберите Серийная консоль

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

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

Google Cloud

Варианты установки MikoPBX в Google Cloud

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

Для начала авторизуйтесь на сайте

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

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

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

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

Для начала авторизуйтесь на сайте

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

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

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

Откройте страницу IAM

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

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

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

Авторизуйтесь в сервисе Amazon Web Services

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

В разделе AWS Marketplace AMIs выберите образ , нажав кнопку Select

Для начала авторизуйтесь на портале Microsoft Azure

https://cloud.vk.com
Yandex Cloud
инструкции
Yandex Cloud
инструкции
https://cloudinf.1c.ru
Yandex Cloud
странице продукта

Установка докера и cоздание пользователя и каталогов

Подготовка к установке MikoPBX в Docker-контейнер

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

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

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

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

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

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

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

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

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

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

# Создание нового пользователя (например, www-user) без прав суперпользователя
sudo adduser --disabled-password --gecos "" www-user

# Создание каталогов для хранения данных
sudo mkdir -p /var/spool/mikopbx/cf
sudo mkdir -p /var/spool/mikopbx/storage

# Назначение прав созданному пользователю на каталоги
sudo chown -R www-user:www-user /var/spool/mikopbx/

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

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

sudo docker exec -it mikopbx sh

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

sudo docker exec -it mikopbx /etc/rc/console_menu

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

sudo docker exec -it mikopbx sngrep
https://console.cloud.google.com/
https://console.cloud.google.com/projectselector2/iam-admin/iam
https://console.cloud.google.com/
https://console.cloud.google.com/marketplace/product/mikopbx-public/mikopbx
MikoPBX
https://aws.amazon.com
https://aws.amazon.com/marketplace/pp/prodview-ota6fb2tftuhw
MikoPBX
https://portal.azure.com/

В Docker контейнере

Варианты установки MikoPBX в Docker контейнере

«Host система» должна быть запущена на базе Linux 5+. Тестировалось на Debian 11 и Ubuntu-21.04, Ubuntu Server 22.04 LTS

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

Alibaba cloud

Установка MikoPBX с помощью сервиса Alibaba cloud

Инструкция актуальна для версии 2024.2.135 и новее!

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

Загрузка образа в Alibaba cloud

Создание Bucket

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

  1. Нажмите "Create Bucket" для создания нового Bucket'а:

  1. Заполните следующие данные:

  • "Bucket name" - произвольное название для хранилища.

  • "Region" - выберите регион, где будет храниться ваш образ

Регион у хранилища для образа и регион виртуальной машины должны совпадать!

Нажмите "OK".

  1. Перейдите в созданный bucket, нажав на его название в разделе "Buckets":

  1. Нажмите "Upload object" и загрузите ранее скаченный файл образа диска в формате .raw (все параметры оставьте по умолчанию).

  1. После того, как файл образа диска будет загружен, Вам необходимо скопировать ссылку на него. Для этого нажмите "View Details" справа от названия файла, в открывшемся меню скопируйте ссылку из поля "URL".

Создание образа

  1. Нажмите "Import Image" для испорта образа из хранилища (Bucket):

  1. В открывшейся вкладке выберите "Linux Operating System" и нажмите "Next".

  2. Введите/выберите следующие параметры для образа:

  • "Image File URL" - вставьте ранее скопированную ссылку на загруженный файл образа диска.

  • "Image Name" - введите произвольное, уникальное название для Вашего образа.

  • "OS Type" - linux

  • "OS Version" - Others Linux

  • "Architecture" - 64-bit OS

  • Уберите галочку с чек-бокса "Check After Import".

Нажмите "OK" для создания образа. Дождитесь его создания (при завершении в поле Status вы увидите надпись Available)

Создание пары SSH-ключей

Далее необходимо создать и добавить связку SSH ключей в Alibaba Cloud.

  1. В ESS Консоли перейдите в раздел "Network Security" -> "Key Pairs":

  1. Нажмите "Create SSH Key Pair".

  • "Name" - произвольное название для создаваемой связки ключей

  • "Creation Mode" - Import

  • "Public Key" - вставьте Ваш публичный ключ, сгенерированный ранее

  • "Resource Group" - выберите Вашу ресурсную группу в облаке

Нажмите "OK" для создания связки ключей в облаке

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

Перед созданием виртуальной машины так же нужно создать и группу правил (firewall).

  1. Перейдите в раздел "Network & Security" -> "Security Groups"

  1. Нажмите "Create Security Group":

  1. Укажите следующие параметры для группы правил:

  • "Security Group" - введите произвольное название для группы правил.

  • "Network" - выберите вашу сеть. Если она не созданна - нажмите "Create VPC" справа от поля.

  • "Security Group" - Basic Security Group.

  • "Resource Group" - выбрите Вашу группу ресурсов.

  • Разрешите все входящие подключения (пример на скриншоте ниже). Все исходящие подключения разрешены по умолчанию.

Нажмите "Create Security Group".

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

  1. Перейдите в раздел "Instances & Images" -> "Instances":

  1. Нажмите "Create Instance" для создания новой виртуальной машины.

  1. Выберите параметры для вашей виртуальной машины:

  • "Billing Method" - выберите вариант оплаты ВМ.

  • "Region", "Network and Zone" - выберите параметры региона и зоны, подходящие Вам.

  • "Instance" - выберите конфигурацию Вашей виртуальной машины.

  1. Выберите параметры для вашей виртуальной машины:

  • "Image" - выберите "Custom Images" -> Загруженный ранее образ

  • "Storage" - выберите тип и размер "System Disk". 20 Гб - минимально возможный в Alibaba Cloud.

  • Добавьте второй диск, нажав "Add Data Disk". Укажите его тип и размер.

Рекомендуемый размер диска для хранения записей разговора - не менее 50ГБ. В данной инструкции, в качестве примера, используется диск размером 30ГБ.

  1. Выберите параметры сети для Вашей ВМ. Группа правил будет назначена автоматически (ранее созданная):

  1. Нажмите "Create Order".

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

В разделе "Instances" перейдите к созданной виртуальной машине, нажав на ее название.

Подключение из встроенной в облако консоли

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

  1. Выберите "VNC". Произойдет подключение в новой вкладке Вашего браузера.

Подключение по SSH

Введите следующую команду для SSH-подключения:

ssh -i C:\Users\username\.ssh\id_ed25519 root@ip-adress

Замените C:\Users\username\.ssh\id_ed25519 на путь к ssh-ключам; root- на Ваше имя для ssh-авторизации (если оно было изменено при создании ВМ); ip-adress - на Внешний адрес MikoPBX.

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

Первая авторизация в WEB-интерфейсе

На главной странице виртуальной машины находятся несколько важных параметров для авторизации в WEB-интерфейсе.

Вставьте IP-адрес в адресную строку браузера - Вы попадете на страницу авторизации в web-интерфейс MikoPBX.

Данные для входа:

  • Username - admin

  • Password - ID Вашей виртуальной машины

Vultr

Установка MikoPBX с помощью сервиса Vultr

Инструкция актуальна для версии 2024.2.138 и новее!

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

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

Загрузка файла в хранилище

Для начала необходимо загрузить образ в облачную платформу.

  1. Перейдите в раздел "Cloud Storage" -> "Object Storage":

  1. Необходимо создать новое хранилище. Для этого нажмите "Add Object Storage":

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

  2. Перейдите в созданное хранилище, нажав на его название:

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

  1. В информации о хранилище, будут указаны данные для S3 подключения.

  1. Далее необходимо подключиться к хранилищу через WinSCP. Для этого, перейдем в его интерфейс. Выберите "New Site":

  1. Укажите следующие параметры:

  • "File protocol" - Amazon S3.

  • "Encryption" - TLS/SSL Implict encryption.

  • "Port number" - 443.

  • "Host Name", "Access key ID", "Secret access key" - параметры из информации о хранилище.

Нажмите "Login".

  1. Загрузите файл образа диска в хранилище.

  1. Вернитесь в интерфейс Vultr, перейдите в директорию Вашего Bucket'а.

  1. Нажмите на три точки справа от названия файла. Перейдите в раздел "Change Access". Разрешите доступ, переключив тумблер.

Импорт образа

  1. Нажмите на три точки справа от названия файла. Скопируйте URL.

  1. Перейдите в раздел "Orchestration" -> "ISOs":

  1. Нажмите "Add ISO":

  1. Вставьте ссылку на ранее загруженный файл, нажмите "Upload".

Добавление связки SSH-ключей

  1. Перейдите в раздел "Account" -> "SSH Keys". Нажмите "Add SSH Key"

  1. В интерфейсе добавления пары SSH-ключей введите произвольное название, а так же вставьте сгенерированный ключ.

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

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

  1. Перейдите в раздел "Products" -> "Compute":

  1. Нажмите "Deploy Server":

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

  1. Перейдите далее.

  • Выберите "ISO/iPXE" -> Ранее загрузочный образ.

  • Так же выберите ранее созданную пару SSH-ключей.

Нажмите "Deploy".

Создание второго диска

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

  1. Перейдите в раздел "Cloud Storage" -> "Block Storage":

  1. Нажмите "Add Block Storage":

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

Рекомендуемый размер диска для хранения записей разговоров - не менее 50Гб.

  1. Перейдите в раздел управления созданным диском. Прикрепите диск к созданной виртуальной машине используя пункт "Attach to:"

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

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

  1. Перейдите в консоль, нажав на соответствующий элемент.

  1. Вы попадете во встроенную консоль.

  1. Перейдите в "[8] Install".

  2. Выберите диск, который будет использован в качестве системного. Подтвердите действия - введите "y" и нажмите "Enter":

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

  2. Перейдите в настройки виртуальной машины "Settings", далее в "Custom ISO". Нажмите "Remove ISO".

На данном этапе система установлена и готова к работе!

Подключение к WEB-интерфейсу

  1. В адресную строку введите IP-адрес Вашей виртуальной машины. Найти его Вы можете в консоли MikoPBX.

  1. Введите следующие данные для авторизации:

  • Логин - admin

  • Пароь - ID-виртуальной машины. Оно имеет вид "150dd137-a0e2-45f6-baf9-ddc15a600d60", найти его Вы можете в адресной строке (скриншот ниже)

IVR меню

Создание и настройка IVR меню в MikoPBX

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  • После проигрывания голосового меню происходит ожидание в течении Таймаут ожидания ввода добавочного номера для набора добавочного. Общее время для набора номера = Длительность звукового файла + Таймаут ожидания ввода добавочного номера.

  • Если общее время для набора номера истекло происходит повторное голосовое оповещение и ожидание в течении таймаута, то есть следующая попытка IVR.

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

  • Максимальное количество попыток задается в параметре Количество повторов, перед переводом на номер по умолчанию.

  • Как только попытки превысят указанное значение, происходит переадресация на Номер по умолчанию.

Сотрудники

Настройка сотрудников и основных телефонных номеров

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

Список сотрудников

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

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

На форме также есть возможность сортировки списка сотрудников по имени, внутреннему номеру, мобильному номеру, адресу электронной почты. Имеются кнопки копирования пароля для SIP учетной записи в буфер обмена, редактирования учетной записи и её удаления.

Добавление сотрудника

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

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

На вкладке Основные параметры задаются общие настройки внутренней учетной записи сотрудника:

  • ФИО пользователя - допускается использование кириллицы. Это значение будет использоваться при подстановке CALLERID(name) абонента, будет отображаться в соответствующем поле экрана телефона.

  • Внутренний номер - он же используется в качестве Логин при подключении телефона.

  • Мобильный номер - используется для дополнительной маршрутизации.

  • Адрес электронной почты - используется для email оповещений.

  • Пароль для SIP

Установите сложные пароли на учетные записи (пароль для SIP)! Пароль должен удовлетворять следующим требованиям:

  • длина пароля должна быть длиннее восьми символов;

  • пароль должен содержать буквы ВЕРХНЕГО и нижнего регистра;

  • пароль должен содержать цифры и специальные знаки: «-», «_», «[]», «{}», «@», «;».

Расширенные параметры учетной записи

Открываются путем нажатия на раскрывающийся список Расширенные настройки.

Переопределение строки набора

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

Максимальное количество параллельных звонков

Количество вызовов, при котором номер считается «занятым». В таком статусе начинают работать правила маршрутизации. Это описание не распространяется на очередь вызовов.

Режим DTMF

Настройка определяет, как DTMF-сигналы передаются через SIP.

Транспортный протокол

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

Сетевой фильтр

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

Дополнительные параметры SIP учетки

Данное поле служит для изменения/переопределения конфигурационных файлов asterisk.

Переопределять можно практически все параметры. К примеру при использовании chan_pjsip SIP аккаунт сотрудника описывается следующими секциями:

[***]
type = aor
max_contacts = 10
; ----

[***]
type = auth
; ----

[***]
type = endpoint
context = all_peers
; ----

[acl_***] 
deny = 0.0.0.0/0.0.0.0
permit = 0.0.0.0/0.0.0.0
; ----

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

[acl]
; описываем параметры доступа из различных подсетей [acl_***]

[auth]
; описываем параметры авторизации для исходящих звонков

[aor]
; Правка секции AOR для endpoint

[endpoint]
; Правка параметров endpoint

Настройки маршрутизации

На данной вкладке вы можете настроить правила переадресации вызовов в случае, если сотрудник не может ответить на звонок, занят или недоступен.

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

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

Вы можете настроить эти параметры в соответствии с вашими предпочтениями и требованиями.

Документации по подключению софтфонов

  • Настройка телеграмм как SIP софтфон

Документации по подключению телефонов

  • Yealink T19

  • Yealink T21

  • Yealink T28

  • Snom D120

Запуск MikoPBX с помощью docker compose

Установка MikoPBX с помощью docker compose

Для работы с MikoPBX в контейнере необходимо установить docker и docker compose, а также создать пользователя и папки для хранения настроек конфигурации и записей разговоров по инструкции

Запуск с помощью docker compose

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

docker-compose.yml
services:
  mikopbx:
    container_name: "mikopbx"
    image: "ghcr.io/mikopbx/mikopbx-x86-64"
    network_mode: "host"
    cap_add:
      - NET_ADMIN
    entrypoint: "/sbin/docker-entrypoint"
    hostname:  "mikopbx-in-a-docker"
    volumes:
      - /var/spool/mikopbx/cf:/cf
      - /var/spool/mikopbx/storage:/storage
    tty: true
    environment:
      - ID_WWW_USER=${ID_WWW_USER}
      - ID_WWW_GROUP=${ID_WWW_GROUP}
      # Изменение имени станции через переменные окружения
      - PBX_NAME=MikoPBX-in-Docker
      # Изменение стандартного порта SSH на 23
      - SSH_PORT=23
      # Изменение стандартного порта WEB на 8080
      - WEB_PORT=8080
      # Изменение стандартного порта WEB HTTPS на 8443
      - WEB_HTTPS_PORT=8443

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

export ID_WWW_USER=$(id -u www-user)
export ID_WWW_GROUP=$(id -g www-user)
sudo docker compose -f docker-compose.yml up

Запуск нескольких MikoPBX на одном хосте

Режим без изоляции сети хоста от контейнеров (–net=host)

Также можно оганизовать запуск нескольких контенеров MikoPBX на одном хосте, но здесь надо учитывать особенности работы Docker с портами, если не использовать режим –net=host то это приведет к высокой нагрузке на процессор хостовой системы, т.к. Docker создает для каждого выделенного порта отдельное правило в Iptables.

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

docker-compose.yml
services:
  mikopbx-first:
    container_name: "mikopbx-first"
    image: "ghcr.io/mikopbx/mikopbx-x86-64"
    network_mode: "host"
    entrypoint: "/sbin/docker-entrypoint"
    hostname:  "mikopbx-in-docker-first"
    volumes:
      - /var/spool/mikopbx/first/cf:/cf
      - /var/spool/mikopbx/first/storage:/storage
    tty: true
    environment:
      - ID_WWW_USER=${ID_WWW_USER}
      - ID_WWW_GROUP=${ID_WWW_GROUP}
      - PBX_NAME=MikoPBXFirst
      - PBX_FIREWALL_ENABLED=0
      - PBX_FAIL2BAN_ENABLED=0
      - SSH_PORT=123
      - WEB_PORT=8080
      - WEB_HTTPS_PORT=8443
      - SIP_PORT=5060
      - TLS_PORT=5061
      - RTP_PORT_FROM=10000
      - RTP_PORT_TO=10800
      - IAX_PORT=4569
      - AMI_PORT=5038
      - AJAM_PORT=8088
      - AJAM_PORT_TLS=8089
      - BEANSTALK_PORT=4229
      - REDIS_PORT=6379
      - GNATS_PORT=4223
mikopbx-second:
    container_name: "mikopbx-second"
    image: "ghcr.io/mikopbx/mikopbx-x86-64"
    network_mode: "host"
    tty: true
    entrypoint: "/sbin/docker-entrypoint"
    hostname:  "mikopbx-in-docker-second"
    volumes:
      - /var/spool/mikopbx/second/cf:/cf
      - /var/spool/mikopbx/second/storage:/storage
    environment:
      - ID_WWW_USER=${ID_WWW_USER}
      - ID_WWW_GROUP=${ID_WWW_GROUP}
      - PBX_NAME=MikoPBXSecond
      - PBX_FIREWALL_ENABLED=0
      - PBX_FAIL2BAN_ENABLED=0
      - SSH_PORT=2223
      - WEB_PORT=8081
      - WEB_HTTPS_PORT=9443
      - SIP_PORT=6060
      - TLS_PORT=6061
      - RTP_PORT_FROM=20000
      - RTP_PORT_TO=20800
      - IAX_PORT=5569
      - AMI_PORT=6038
      - AJAM_PORT=9088
      - AJAM_PORT_TLS=9089
      - BEANSTALK_PORT=5229
      - REDIS_PORT=7379
      - GNATS_PORT=5223

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


export ID_WWW_USER=$(id -u www-user)
export ID_WWW_GROUP=$(id -g www-user)
sudo docker compose -f docker-compose.yml up

Режим сетевого моста (–net=bridge)

Существует вариант запуска контейнеров с MikoPBX в режиме –net=bridge, но как описано выше для использования этого режима необходимо или существенно ограничить диапазон RTP портов, или открывать к ним доступ на хостовой машине не используя возможности Docker.

Для этого вам необходимо написать небольшой скрипт, для определения имени текущего мостового интерфейса и IP адреса каждого контейнера, и после запуска docker compose добавить необходимые правила iptables для диапазона RTP портов следующим образом:

start-multiple-mikopbx.sh
#!/bin/bash

COMPOSE_FILE="$1"

if [ -z "$COMPOSE_FILE" ]; then
    echo "Usage: $0 path/to/docker-compose.yaml"
    exit 1
fi

# Получим идентификатор пользователя для запуска контейнера
export ID_WWW_USER=$(id -u www-user)
export ID_WWW_GROUP=$(id -g www-user)

# Оставновим текущие контейнеры, если они запущены
docker compose -f "$COMPOSE_FILE" down

# Удалим их
docker compose -f "$COMPOSE_FILE" rm

# Запускаем контейнеры в фоне
docker compose -f "$COMPOSE_FILE" up -d
sleep 60

# Создадим метку для правил IPTABLES
IPTABLES_COMMENT="mikopbx-custom-rule"

# Определим идентификатор проекта, он используется при создании сетевого моста
project_prefix=$(cat "$COMPOSE_FILE" | yq e '.x-project-name' -)

# Если префикс не задан, устанавливаем значение по умолчанию
if [ -z "$project_prefix" ]; then
    project_prefix="default_prefix"
fi

# Функция для получения IP адреса контейнера
function get_container_ip() {
    docker inspect -f '{{range .NetworkSettings.Networks}}{{.IPAddress}}{{end}}' "$1"
}

# Функция для получения имени мостового интерфейса
function get_bridge_name() {
    local network_name="$1"
    local prefix="$2"
    local network_id=$(docker network inspect "${prefix}_${network_name}" -f '{{.Id}}')

    if [ -z "$network_id" ]; then
        echo "Error: Network ${prefix}_${network_name} not found."
        return 1
    fi

    local bridge_name=$(ip link show type bridge | grep -o "br-${network_id:0:12}\b")
    echo $bridge_name
}

echo "Delete tagged iptables rules"
# Удаляем все правила iptables промаркированные нашим комментарием
iptables -S | grep "$IPTABLES_COMMENT" | sed 's/-A /-D /' | while read rule; do
        echo "Delete rule $rule"
        iptables $rule
done

# Удаляем все NAT правила iptables промаркированные нашим комментарием
iptables -S -t nat | grep "$IPTABLES_COMMENT" | sed 's/-A /-D /' | while read rule; do
     echo "Delete rule $rule"
     iptables -t nat $rule
done

# Парсим docker-compose файл и получаем все необходимые параметры.
echo "Parsing docker-compose file and configuring iptables rules"
cat "$COMPOSE_FILE" | yq e '.services[] | select(.environment[] | test("RTP_PORT_FROM")) | {"container_name": .container_name, "environment": .environment, "network": .networks[0]}' -o=json | jq -c '.' | while read -r service; do
    container_name=$(echo $service | jq -r '.container_name')
    network_name=$(echo $service | jq -r '.network')
    bridge_name=$(get_bridge_name "$network_name" "$project_prefix")
    container_ip=$(get_container_ip "$container_name")

    RTP_PORT_FROM=$(echo $service | jq -r '.environment[] | select(contains("RTP_PORT_FROM")) | split("=")[1]')
    RTP_PORT_TO=$(echo $service | jq -r '.environment[] | select(contains("RTP_PORT_TO")) | split("=")[1]')

    echo "Configuring iptables for $container_name ($container_ip) on $bridge_name from port $RTP_PORT_FROM to $RTP_PORT_TO"

    iptables -A DOCKER -t nat ! -i "$bridge_name" -p udp -m udp --dport $RTP_PORT_FROM:$RTP_PORT_TO -j DNAT --to-destination $container_ip:$RTP_PORT_FROM-$RTP_PORT_TO -m comment --comment "$IPTABLES_COMMENT"
    iptables -A DOCKER -d $container_ip/32 ! -i "$bridge_name" -o "$bridge_name" -p udp -m udp --dport $RTP_PORT_FROM:$RTP_PORT_TO -j ACCEPT -m comment --comment "$IPTABLES_COMMENT"
    iptables -A POSTROUTING -t nat -s $container_ip/32 -d $container_ip/32 -p udp -m udp --dport $RTP_PORT_FROM:$RTP_PORT_TO -j MASQUERADE -m comment --comment "$IPTABLES_COMMENT"

    echo "Don't forget to open UDP ports $RTP_PORT_FROM to $RTP_PORT_TO on external firewall if it exists"
done

echo "iptables configuration completed successfully."

Опишем несколько контейнеров в файле docker-compose.yaml, определим разные порты для веб интерфейса, SIP портов и диапазоны RTP портов, чтобы они не пересекались.

docker-compose.yaml

services:
  mikopbx-first:
    container_name: "mikopbx-first"
    image: "ghcr.io/mikopbx/mikopbx-x86-64"
    entrypoint: "/sbin/docker-entrypoint"
    hostname:  "mikopbx-in-docker-first"
    volumes:
      - /var/spool/mikopbx/first/cf:/cf
      - /var/spool/mikopbx/first/storage:/storage
    tty: true
    cap_add:
      - net_admin
    networks:
      - network-bridge1
    environment:
      - ID_WWW_USER=${ID_WWW_USER}
      - ID_WWW_GROUP=${ID_WWW_GROUP}
      - PBX_NAME=MikoPBXFirst
      - RTP_PORT_FROM=10000 # UPD дипазон 10000-10800 на хосте будет направлен в контейнер
      - RTP_PORT_TO=10800
      - WEB_ADMIN_PASSWORD=mikopbx-first-password
      - ENABLE_USE_NAT=1
      - PBX_FIREWALL_ENABLED=1
      - PBX_FAIL2BAN_ENABLED=1
    ports:
      - "8443:443"  # TCP порт 9443 на хосте направляется на порт 443 в контейнере
      - "5060:5060/udp"  # UDP порт 5060 на хосте направляется на порт 5060 в контейнере
  mikopbx-second:
    container_name: "mikopbx-second"
    image: "ghcr.io/mikopbx/mikopbx-x86-64"
    tty: true
    cap_add:
      - net_admin
    networks:
      - network-bridge2
    entrypoint: "/sbin/docker-entrypoint"
    hostname:  "mikopbx-in-docker-second"
    volumes:
      - /var/spool/mikopbx/second/cf:/cf
      - /var/spool/mikopbx/second/storage:/storage
    environment:
      - ID_WWW_USER=${ID_WWW_USER}
      - ID_WWW_GROUP=${ID_WWW_GROUP}
      - PBX_NAME=MikoPBXSecond
      - RTP_PORT_FROM=20000 # UPD дипазон 20000-20800 на хосте будет направлен в контейнер
      - RTP_PORT_TO=20800
      - EXTERNAL_SIP_PORT=6060 # Расскажем MikoPBX какой у нее внешнить SIP порт
      - WEB_ADMIN_PASSWORD=mikopbx-second-password
      - ENABLE_USE_NAT=1
      - PBX_FIREWALL_ENABLED=1
      - PBX_FAIL2BAN_ENABLED=1
    ports:
      - "9443:443"  # TCP порт 9443 на хосте направляется на порт 443 в контейнере
      - "6060:5060/udp"  # UDP порт 6060 на хосте направляется на порт 5060 в контейнере
x-project-name: mikopbx # Этот параметр обязательно должен присуствовать
networks:
  network-bridge1:
    driver: bridge
  network-bridge2:
    driver: bridge

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

mkdir -p /usr/src/mikopbx

Сохраняем файлы start-multiple-mikopbx.sh и docker-compose.yaml в эту папку.

Устанавливаем необходимые зависимости для работы скрипта.

sudo apt-get update
sudo apt-get install jq
sudo snap install yq

Переходим в нашу папку, добавляем права на выполнение и запускаем наш скрипт.

cd /usr/src/mikopbx
sudo chmod +x start-multiple-mikopbx.sh
sudo ./start-multiple-mikopbx.sh docker-compose.yaml

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

  • TCP/UDP порты 5060 и 6060 для SIP

  • UDP диапазоны 10000-10800 и 20000-20800 для передачи звука по RTP

  • TCP порты 8443 и 9443 для HTTPS протокола, для работы Web интерфейса.

Входим по очереди на каждую из станций по адресам:

  • https://<IP хостовой машины>:8443

  • https://<IP хостовой машины>:9443

Для входа в веб-интерфейс первой АТС MikoPBX используйте логин admin и пароль mikopbx-first-password

Для входа в веб-интерфейс второй АТС MikoPBX используйте логин admin и пароль mikopbx-second-password

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

Важное замечание! Один из наших контейнеров использует проброс с SIP порта с изменением его значения 5060 -> 6060. В данном случае, для корректной работы системы, необходимо добавить внешнее значение SIP порта в настройках NAT в разделе сетевых интерфейсов MikoPBX. Эту настройку также можно сделать задав соответвующее значение переменной окружения EXTERNAL_SIP_PORT=6060 в файле docker-compose.

На этом настройка завершена, можно настраивать учетные записи и выполнять звонки.

Переменные окружения для конфигурирования MikoPBX

Ниже перечислены некоторые переменные окружения, которые позволят скорректировать используемые MikoPBX порты и настройки.

  • SSH_PORT - порт для SSH (22)

  • WEB_PORT - порт для работы web интерфейса по протоколу HTTP (80)

  • WEB_HTTPS_PORT - порт для работы web интерфейса по протоколу HTTPS (443)

  • SIP_PORT - порт для подключения SIP клиента (5060)

  • TLS_PORT - порт для подключения SIP клиента с шифрованием (5061)

  • RTP_PORT_FROM - начало диапазона RTP портов, передача голоса (10000)

  • RTP_PORT_TO - конец диапазона RTP портов, передача голоса (10800)

  • IAX_PORT - порт для подключения IAX клиентов (4569)

  • AMI_PORT - порт AMI (5038)

  • AJAM_PORT - порт AJAM используется для подключения панели телефонии для 1С (8088)

  • AJAM_PORT_TLS - порт AJAM используется для подключения панели телефонии для 1С (8089)

  • BEANSTALK_PORT - порт для сервера очередей Beanstalkd (4229)

  • REDIS_PORT - порт для сервера Redis (6379)

  • GNATS_PORT - порт для сервера gnatsd (4223)

  • ID_WWW_USER - идентификатор пользователя www-user (можно задать выражением $(id -u www-user), где www-user имя НЕ root пользователя)

  • ID_WWW_GROUP - идентификатор группы www-user (можно задать выражением $(id -g www-user), где www-user имя НЕ root группы)

  • WEB_ADMIN_LOGIN - логин для доступа в Web интерфейс

  • WEB_ADMIN_PASSWORD - пароль для доступа в Web интерфейс

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

Создание и настройка очередей вызовов.

Очереди позволяют:

  1. Распределять телефонные звонки между группой сотрудников (агентов): Вы можете создать очередь вызовов и добавить в нее несколько сотрудников. Когда поступает звонок, система автоматически направляет его к доступному сотруднику в очереди, обеспечивая более равномерное распределение нагрузки и повышая эффективность обработки вызовов.

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

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

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

Для настройки очередей вызовов в MikoPBX следует перейти в раздел "Телефония" и выбрать "Очереди вызовов". Здесь вы сможете создать и настроить свои очереди в соответствии с требованиями вашего бизнеса и потребностями обслуживания клиентов.

Длительность вызова на очередь по умолчанию равна 300 секундам. После истечения этого времени вызов будет завершен. Для обхода этого ограничения следует настроить Сценарий 1 (см. далее инструкции Маршрутизация звонков при сбоях).

Основные параметры

Для добавления новой очереди выполните действие Создать новую очередь.

  • Укажите Название очереди - при настройке маршрутизации вы будете ориентироваться на него.

  • Заполните описание в поле Заметка - оно будет доступно в списке очередей.

Операторы очереди

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

Варианты стратегии:

  • Вызываются все доступные участники до тех пор, пока кто-то из них не ответит на вызов (по умолчанию);

  • Вызывается первый свободный участник, который дольше всех не вызывался из этой очереди;

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

  • Случайным образом вызывается не занятый участник, обрабатывающий очередь;

  • Циклическое распределение с памятью. Запоминается последний участник, ответивший на вызов;

  • Вызов поступает на каждого участника очереди по порядку.

Расширенные настройки

В этом разделе можно дополнительно указать:

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

  • Краткое название очереди - для отображения перед CallerID абонента на телефонном аппарате, например consult.

Настройки очереди для операторов

  • Время попытки дозвона агенту - время в секундах, в течение которого вызов будет идти на одного агента очереди. По завершении этого времени вызов агенту сохраняется в историю звонков как пропущенный. По завершении времени попытки дозвона до одного агента вызов направится на следующего агента согласно выбранной стратегии.

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

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

Настройки очереди для вызывающего абонента

  • Что абонент слышит во время ожидания - во время ожидания ответа на свой звонок клиент может слышать музыку на удержании или сигнал вызова.

  • Фоновая музыка (MOH) - можно указать уникальный звуковой файл для воспроизведения клиенту во время ожидания, к примеру рекламные материалы.

  • Оповещать о текущей позиции в очереди - если все операторы (агенты очереди) заняты, то включив этот переключатель, можно оповестить клиента о его позиции в очереди. Если активирована опция Дополнительный звуковой анонс, то этот анонс дополнит информацию о позиции.

  • Оповещать о расчетном времени ожидания - если все операторы (агенты очереди) заняты, то включив этот переключатель, можно оповестить клиента о примерном времени ожидания ответа на вызов. Если активирована опция Дополнительный звуковой анонс, то этот анонс дополнит информацию о расчетном времени.

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

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

Маршрутизация звонков при сбоях

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

  • Сценарий 2 - если в очереди нет агентов (то есть в данный момент ни один агент не зарегистрирован на АТС), то можно указать номер, на который будет переведен вызов клиента.

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

Длительность вызова на очередь по умолчанию равна 300 секундам. Если необходим больший интервал, то задайте в Сценарий 1, большую длительность и укажите резервный номер.

Запуск MikoPBX в контейнере

Установка MikoPBX с помощью Docker

Для работы с MikoPBX в контейнере необходимо установить docker и docker compose, а также создать пользователя и папки для хранения настроек конфигурации и записей разговоров по инструкции

Запуск контейнера Docker

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

# Получение образа контейнера
sudo docker pull ghcr.io/mikopbx/mikopbx-x86-64

# Запуск контейнера в не привилегированном режиме
sudo docker run --cap-add=NET_ADMIN --net=host --name mikopbx --hostname mikopbx \
           -v /var/spool/mikopbx/cf:/cf \
           -v /var/spool/mikopbx/storage:/storage \
           -e SSH_PORT=23 \
           -e ID_WWW_USER="$(id -u www-user)" \
           -e ID_WWW_GROUP="$(id -g www-user)" \
           -it -d --restart always ghcr.io/mikopbx/mikopbx-x86-64

Проверка работы

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

Шаг 1: Проверка статуса контейнера

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

sudo docker ps

Эта команда выведет информацию о всех активных контейнерах. Убедитесь, что контейнер mikopbx присутствует в списке и его статус указывает на то, что он запущен и работает (например, статус up).

Шаг 2: Просмотр логов контейнера

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

sudo docker logs mikopbx

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

++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
|               All services are fully loaded welcome                |
|                       MikoPBX 2024.1.60.                           |
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
|                        Web Interface Access                        |
|                                                                    |
| Local Network Address:                                             |
| https://10.0.0.4                                                   |
|                                                                    |
| Web credentials:                                                   |
|    Login: admin                                                    |
|    Password: admin                                                 |
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
| SSH access disabled!                                               |
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++

Если отображается процесс запуска MikoPBX то необходимо подождать и повторить команду sudo docker logs mikopbx

Шаг 3: Проверка доступа к веб-интерфейсу

При старте контенер не имеет информации об адресе хостовой системы, потому необходимо открыть внешний адрес хостовой системы, в данном случае Ubuntu в браузере. https://<IP адрес хост системы>

Войдите в веб-интерфейс, используя логин admin и пароль admin, чтобы убедиться, что веб-интерфейс доступен и функционирует корректно.

Особенности работы контейнизированной MikoPBX

  • Флаг NET_ADMIN необходим для возможности работы системы проактивной защиты fail2ban и фаервола iptables внутри контейнера. При срабатывании блокировки доступа, например при вводе неверного пароля, доступ с IP адреса злоумышленника будет заблокирован.

  • Если необходимо использовать «Модуль резервного копирования», то контейнер следует запускать с флагом –privileged. Когда MikoPBX запускается в контейнере, резервное копирование можно также выполнять архивированием каталогов cf и storage вручную . В этом случае привелегированный режим можно не использовать, но в момент копирования контейнер должен быть остановлен.

  • При необходимости можно скорректировать стандартный набор портов, которые использует MikoPBX. Это можно сделать объявляя переменные окружения при запуске контейнера.

Создание контейнера из tar архива

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

Пример кода, для его использования:

# Создаем контейнер из tar архива
sudo docker import \
  --change 'ENTRYPOINT ["/bin/sh", "/sbin/docker-entrypoint"]' \
  mikopbx-2024.1.114-x86_64.tar \
  "mikopbx:2024.1.114"

# Запускаем созданный контейнер
sudo docker run --cap-add=NET_ADMIN --net=host --name mikopbx --hostname mikopbx \
	 -v mikopbx_cf:/cf \
	 -v mikopbx_storage:/storage \
	 -e SSH_PORT=23 \
	 -e ID_WWW_USER="$(id -u www-user)" \
	 -e ID_WWW_GROUP="$(id -g www-user)" \
	 -it mikopbx:2024.1.114

Переменные окружения для конфигурирования MikoPBX

Ниже перечислены некоторые переменные окружения, которые позволят скорректировать используемые MikoPBX порты и настройки.

  • SSH_PORT - порт для SSH (22)

  • WEB_PORT - порт для работы web интерфейса по протоколу HTTP (80)

  • WEB_HTTPS_PORT - порт для работы web интерфейса по протоколу HTTPS (443)

  • SIP_PORT - порт для подключения SIP клиента (5060)

  • TLS_PORT - порт для подключения SIP клиента с шифрованием (5061)

  • RTP_PORT_FROM - начало диапазона RTP портов, передача голоса (10000)

  • RTP_PORT_TO - конец диапазона RTP портов, передача голоса (10800)

  • IAX_PORT - порт для подключения IAX клиентов (4569)

  • AMI_PORT - порт AMI (5038)

  • AJAM_PORT - порт AJAM используется для подключения панели телефонии для 1С (8088)

  • AJAM_PORT_TLS - порт AJAM используется для подключения панели телефонии для 1С (8089)

  • BEANSTALK_PORT - порт для сервера очередей Beanstalkd (4229)

  • REDIS_PORT - порт для сервера Redis (6379)

  • GNATS_PORT - порт для сервера gnatsd (4223)

  • ID_WWW_USER - идентификатор пользователя www-user (можно задать выражением $(id -u www-user), где www-user имя НЕ root пользователя)

  • ID_WWW_GROUP - идентификатор группы www-user (можно задать выражением $(id -g www-user), где www-user имя НЕ root группы)

  • WEB_ADMIN_LOGIN - логин для доступа в Web интерфейс

  • WEB_ADMIN_PASSWORD - пароль для доступа в Web интерфейс

Входящие маршруты

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Подключение и настройка провайдеров телефонии в MikoPBX

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

Чтобы совершать или принимать внешние телефонные звонки по телефонной сети общего пользования или Интернет, вы должны создать, по крайней мере, одну учетную запись провайдера. Каждая технология имеет свой тип учетной записи. Для добавления новой учетной записи или изменения существующей, перейдите в "Маршрутизация" -> "Провайдеры телефонии":

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

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

Настройка SIP провайдера

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

В общих настройках SIP провайдера укажите следующие настройки:

Название провайдера - произвольное удобное вам наименование. Оно будет отображаться в списках выбора в соответствующих меню.

Хост или IP адрес - может быть либо URL либо IP-адресом

Логин и Пароль, который предоставляет ваш провайдер

Режим DTMF - определяет, как DTMF сигналы передаются через SIP. Cуществуют различные стандарты, используемые для передачи DTMF SIP-провайдерам. Попробуйте использовать различные стандарты для того, чтобы найти режим, который подойдет вам. inband передает нажатия клавиш в качестве «тона». Для использования этого стандарта вам необходим аудио кодек высокого качества. Auto, rfc и info передают нажатия клавиш в SIP кодирование.

Расширенные настройки SIP провайдера

Дополнительные адреса провайдера

В этом разделе следует перечислить все адреса поставщика услуг связи, с которых могут приходит входящие звонки. Доступ для этих адресов к портам SIP и RTP будет автоматически открыт на firewall.

Порт соединения SIP

По умолчанию принимает значение 5060. SIP протокол описывает, каким образом клиентское приложение (например, софтфон) может запросить начало соединения у другого, возможно, физически удалённого клиента, находящегося в той же сети, используя его уникальное имя. Протокол определяет способ согласования между клиентами об открытии каналов обмена на основе других протоколов, которые могут использоваться для непосредственной передачи информации (например, RTP).

Транспортный протокол

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

Outbound proxy

Это SIP прокси сервер провайдера для обработки запросов. Реальный SIP сервер, может отличаться от этого адреса. Outbound proxy принимает на себя первичные запросы и перенаправляет на нужный сервер.

Режим NAT

Режим NAT - Это механизм в сетях TCP/IP, позволяющий преобразовывать IP-адреса транзитных пакетов.

  • force_rport,comedia опция заменяющая nat=yes;

  • force_rport даже если ни одного параметра rport не было указано, действовать, так, как если бы он был;

  • comedia отправлять RTP пакеты обратно к порту с которого они были получены, игнорируя требуемый порт в SDP заголовке;

  • auto_comedia если Asterisk сможет определить, что устройство находится за NAT, установить опцию comedia;

  • no не выполнять никакой специальной обработки NAT, кроме той что указана в RFC 3581.

Поддерживать NAT сессию

При включение этой опции Asterisk будет отправлять SIP Options пакеты. Это необходимо для поддержки NAT туннелирования на вашем маршрутизаторе.

Укажите частоту, с которой Asterisk будет отправлять SIP сообщение типа OPTIONS для проверки, что данное устройство работает и доступно для совершения вызовов.

Если данное устройство, не ответит в течение заданного периода (60 секунд по умолчанию), тогда Asterisk рассматривает это устройство как выключенное и недоступное для совершения вызовов.

Переопределение SIP заголовка "From"

Можно отключить использование поля fromuser заголовка SIP-пакета.

Параметры файла pjsip.conf fromuser и fromdomain используются для вызовов исходящих от Asterisk в сторону SIP устройства.

Можно переопределить:

  • имя пользователя в поле From в SIP пакетах (fromuser);

  • имя домена в поле From в SIP пакетах (fromdomain).

Для этого служат поля User и Domain соответственно.

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

В этом поле вы можете изменять конфигурационные файлы Asterisk.

Переопределять можно практически все параметры. К примеру при использовании chan_pjsip провайдер описывается следующими секциями:

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

Для завершения настройки нажмите Сохранить.

Несколько провайдеров на одном IP

Бывают случаи, когда необходимо подключить несколько учетных записей одного поставщика услуг связи. В этом случае настройки Хост или IP адрес и Порт соединения SIP могут оказаться одинаковыми для всех учетных записей.

Asterisk такую ситуацию обыгрывает по-своему. АТС не сможет корректно «приземлить» вызов на нужного провайдера и вызов оборвется.

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

Поле Логин в большинстве случаев при входящем звонке будет использоваться в качестве номера назначения Дополнительный номер (DID). И, учитывая, что выходящие маршруты для всех Логин будут описаны, вызов будет корректно обработан телефонной станцией.

Подробнее про тип регистрации

Исходящая регистрация

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

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

Входящая регистрация

Этот вариант актуален для работы некоторых FXO / GSM шлюзов - когда внешнее устройство должно подключиться к вашей АТС по логину и паролю.

Также этот вариант актуален, когда удаленное устройство находится за NAT и MikoPBX не может знать его IP адрес.

Аутентификация по IP адресу, без пароля

Актуально для безопасных частных сетей. Так к примеру Ростелеком часто ведет свой сетевой кабель и подключает клиента к своей локальной сети.

АТС и провайдер в данном случае должны находиться в одной и той же сети.

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

Добавление/создание звуковых файлов в MikoPBX

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

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

Поддерживаемый формат файлов mp3 и wav

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

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

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

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

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

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

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

Звуковые файлы хранятся на АТС по пути /storage/usbdisk1/mikopbx/media/custom

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

Функция доступна начиная с версии 2020.2.XXX

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

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

Просмотр и фильтр истории вызовов в MikoPBX

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

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

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

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

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

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

  • Скачать/прослушать запись разговора.

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

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

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

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

  • длительности разговора (Длительность) - время голосового приветствия не учитывается.

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

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

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

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

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

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

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

  4. Шевченко продолжила разговор с клиентом.

Отборы

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

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

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

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

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

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

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

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

4) Отбор по linkedid

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

Описания раздела маршрутизации MikoPBX

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

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

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

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


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

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

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


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

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

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


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

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

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

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

Для начала необходимо создать bucket для хранения образа. Для этого необходимо перейти в "OSS Management Console" ().

Вернитесь в ECS Console (). Перейдите в раздел "Images".

Далее необходимо сгенерировать пару SSH-ключей. Про то как это сделать - Вы можете прочитать . Далее заполните все необходимые данные:

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

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

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

Сгенерируйте пару SSH ключей .

Полный список всех возможных параметров настроек доступен в исходном коде .

Флаг –net=host указывает на то, что NAT между хостом и контейнером не будет использоваться. MikoPBX будет подключена напрямую к сети хостовой машины. Все порты, которые должен занять контейнер будут заняты и на хост машине. Если на хост машине, какой-то из портов недоступн, то при загрузке MikoPBX возникнут ошибки. Подробнее в

Полный список всех возможных параметров настроек доступен в исходном коде .

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

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

Тип учетной записи - тип регистрации учетной записи провайдера. .

Альтернатива инструкции . Такой подход был не очевиден.

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

github MikoPBX
ссылка
ссылка
здесь
здесь
в этом блоке статей
github MikoPBX
по инструкции
MicroSIP
Groundwire
Zoiper
Jitsi
PhonerLite
Linphone(MacOS)
Telephone(MacOS)
WebRTC с помощью SIPML5
Softphone.pro
Bria Solo
Установка докера и cоздание пользователя и каталогов
по ссылке
Установка докера и cоздание пользователя и каталогов
документации к Docker...
по ссылке
[REG-AUTH-***]
type = auth
; ----

[REG-***] 
type = registration
transport = transport-udp
; ----

[***-OUT]
type = auth
; ----

[***]
type = aor
max_contacts = 1
; ----

[***]
type = identify
; ----

[***]
type = endpoint
context = incoming
; ----
[registration-auth]
; описываем параметры авторизации для [REG-AUTH-***]

[registration]
; описываем параметры регистрации на удаленном сервере [REG-***]

[endpoint-auth]
; описываем параметры авторизации для исходящих звонков через провайдера

[identify]
; Секция отвечает за сопоставление регистрации и endpoint. При поступлении входящего звонка 
; согласно INVITE будет проведена проверка соответствия identify параметров с endpoint. 

[aor]
; Правка секции AOR для endpoint

[endpoint]
; Правка параметров endpoint
разделе FAQ
нашем FAQ
Регистрация нескольких учетных записей от одного провайдера
журнала звонков 1С
Провайдеры телефонии
Входящие маршруты
Исходящие маршруты
Нерабочее время
Подробнее про тип регистрации

Перехват на ответственного в панели телефонии 4.0 как в панели 1.0

Установка

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

Описание процесса регистрации

Общая информация

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

Регистрация даст вам доступ к дополнительным модулям и расширениям. Есть бесплатные модули, который мы вынесли из базового функционала для упрощения первоначальной настройки, а также платные модули от нас и других разработчиков. Если вы разработчик, то можете связаться с нами, написав на почту developers@mikopbx.com для получения инструкций о том, как разработать собственный модуль и добавить его в Marketplace.

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

Для начала регистрации в маркетплейсе вам необходимо перейти во вкладку "Модули" -> "Маркетплейс модулей":

В случае, если у Вас не выполнена регистрация в Маркетплейсе, раздел будет выглядеть вот так:

Процесс регистрации

В случае переноса MikoPBX на другой хост или восстановлении из бекапа, необходимо выполнить сброс привязок лицензий на модули в личном кабинете lm.mikopbx.com

При регистрации выдается 1 ключ на компанию. Это значит, что если Вы используйте несколько станций MikoPBX в своей компании - вам достаточно будет одной регистрации.

Нажмите синюю кнопку "Регистрация в маркетплейсе" для начала регистрации:

Лицензионный ключ используется для хранения всех ваших лицензий от любых продуктов МИКО. Если у вас уже есть ключ, вы можете просто вписать его в одноименное поле. Если ключ у вас был, но вы его забыли, вы можете поискать письмо в вашей электронной почте входящие письма по адресу lic@miko.ru

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

  • Название организации - введите имя вашей компании/организации.

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

  • Контактное лицо - введите данные контактного лица.

  • Телефон контактного лица (необязательно).

  • Уникальный идентификатор компании (ИНН, ИИН, УНП и т.д.) (необязательно).

Нажмите "Зарегистрироваться"

В случае успешной регистрации, вы увидите следующий экран:

  • Уведомление об успешной регистрации системы.

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

Управление лицензией

Для управления лицензией перейдите в раздел Маркетплейс -> Управление лицензией. Нажмите на одноименный элемент:

Для управления лицензией введите ваш лицензионный ключ в поле "Введите ваш лицензионный ключ или активированный ранее купон":

Нажмите "Login"

Вы попадете в систему, где находятся 9 секций:

Перейдите в раздел "Монитор сессий":

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

Для каждой привязки в колонке "Действие" есть кнопка "Сброс", которая позволяет сбросить активную привязку лицензии от хоста.

Возможные проблемы

Проблема при регистрации в Маркетплейсе

При регистрации может возникать проблема отсутствии у MikoPBX связи с интернетом, а именно с отсутствием связи с серверами lic.miko.ru и lic.mikopbx.com по порту 443(https)

Решение: проверить доступ к станции из интернета, проверить настройки firewall и общего доступа к вышеупомянутым ресурсам.

Иконка перечеркнутого ключа

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

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

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

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

Найти раздел Управления модулями вы можете в "Модули" -> "Маркетплейс модулей".

Установленные модули

Все установленные модули находятся в списке, в одноимённой вкладке:

Есть возможность загрузить свой модуль, используя кнопку "Загрузить новый модуль". Необходимо загружать файлы .zip. После загрузки модуль появится в списке на вкладке "Установленные модули"

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

Помимо этого, можно включить/отключить модуль.

Из интерфейса установленного модуля можно быстро перейти к его документации, нажав на знак вопроса справа от короткого описания модуля:

Быстрый доступ к модулю

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

Для того, чтобы это сделать - выполните дальнейшую инструкцию:

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

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

  1. В данном разделе вы можете:

  • Переключить отображение модуля в боковом меню - "Показывать модуль в боковом меню".

  • Выбрать раздел в котором он будет отображаться - в примере выбран раздел "Модули".

  • Так же можно указать произвольное название модуля.

После завершения настройки - нажмите "Сохранить".

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

В данном разделе вы можете установить модули от MIKO, а так же от производителей-партнеров.

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

Слева от названия модуля вы можете найти значок, по которому можно понять платный ли он или бесплатный. Например, на изображении выше модуль "REST API Автоинформатор" - платный, а модуль "Генератор SSL сертификатов через Let's Encrypt" - бесплатный.

У каждого платного модуля есть испытательный период - 2 недели. За этот период вы можете попробовать функционал модуля и принять решение о покупке. Для покупки модуля - напишите на почту sale@mikopbx.com

Карточка модуля

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

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

Описание модуля

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

История версий

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

Лицензионное соглашение

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

Активация купонов

В случае покупки модуля, вам будет выдан купон. Для его активации перейдите в Модули -> Маркетплейс модулей:

Далее перейдите в раздел "Управление лицензией"

В поле "Активация купона" введите ваш купон, далее нажмите "Активировать купон"

Ключ защиты всегда начинается с MIKO-. Купон для изменения состава продуктов всегда начинается с MIKOUPD-

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

Настройка правил нерабочего времени

Назначение

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

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

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

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

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

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

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

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

  • Применять только к определенным входящим маршрутам - можно активировать эту функцию и с помощью нее выбирать на какие входящие маршруты будет распространяться данное правило. (Подробнее ниже)

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

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

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

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

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

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

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

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

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

Создание и настройка приложений диалплана

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

Ниже вы увидите описание базовых приложений, включенных в MikoPBX:

Номер приложения
Описание приложения

000063

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

000064

0000MILLI - Генерирует постоянный звуковой сигнал частотой 1000 Гц. Используется для проверки качества соединения.

10003246

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

Создание приложений

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

Всего в несколько шагов Вы сможете создать свои собственные приложения. Во-первых, определите Название и Номер вызова для приложения, при необходимости заполните поле Комментарий. Возможный тип кода приложения:

  • PHP-AGI скрипт - AGI - это встроенный в Asterisk метод выполнения внешних скриптов (по аналогии с CGI для http серверов), который может расширить функциональность asterisk при помощи других языков программирования, в частности PHP. AGI скрипты могут управлять вызовом в плане набора, вызываются из файла: extensions.conf

  • Диалплан Asterisk - конфигурация плана набора содержится в файле конфигурации Asterisk - extensions.conf. Это один из самых важных конфигурационных файлов. В нем определяется обработка и маршрутизация входящих и исходящих вызовов. Этот файл управляет поведением всех соединений проходящих через Вашу АТС.

Внесем ясность: мы будем называть MikoPBX приложения - приложениями, планы набора Asterisk -функциями. Например, Answer(), NoOP(), Set() and Wait() - это функции. Эти отдельные целевые функции Asterisk, которые затем объединяются в MikoPBX для создания более мощных MikoPBX приложений. Опишите логические операции в текстовом поле Программный код. Обратите внимание, что в одной строке одновременно допускается только одна команда, например:

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

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

Описание Asterisk функций, которые Вы можете использовать в своих приложениях:

Наименование команды
Описание

answer

Перевести вызов в отвеченное состояние.

channel status

Возвращает статус подключенного канала.

control stream file

Отправка в канал заданного звукового файла, с возможностью управления его проигрывания (пауза/перемотка/возобновление проигрывания) с помощью получаемых от абонента DTMF цифр, если заданы. (Asterisk 1.2)

database del

Удаление ключа/значения из базы данных.

database deltree

Удаление дерева ключей/значений из базы данных.

database get

Получить значение из базы данных.

database put

Добавление/изменение значения в базе данных.

exec

Выполнение заданной Команды. (Команды - это функции, которые Вы используете при описании плана набора в файле extensions.conf ).

get data

Получить данные из канала.

get option

Ведет себя аналогично команде «STREAM FILE», но используется с заданным значением для таймаута. (Asterisk 1.2)

get variable

Получить значение переменной канала.

hangup

Разорвать соединение (Hangup) на текущем канале.

noop

Пустая команда. Ничего не делает.

receive char

Принимает один символ из канала, если он поддерживает эту возможность.

receive text

Принимает текстовую строку из канала, если он поддерживает эту возможность.

record file

Производит запись в заданный файл.

say alpha

Проговаривает заданную строку символов. (Asterisk 1.2)

say date

Проговаривает дату. (Asterisk 1.2)

say datetime

Проговаривает дату и время, согласно заданному формату. (Asterisk 1.2)

say digits

Проговаривает заданную строку цифр.

say number

Проговаривает заданный номер.

say phonetic

Проговаривает заданную строку символов.

say time

Проговаривает время.

send image

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

send text

Отправляет текст в канал, если он поддерживает эту возможность.

set autohangup

Автоматическое завершение соединение (Autohangup) на канале в заданное время.

set callerid

Установка callerid для текущего канала.

set context

Установка контекста для текущего канала.

set extension

Изменение екстеншена для текущего канала.

set music

Включение/Выключение музыки ожидания (Music on hold), например: «SET MUSIC ON default».

set priority

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

set variable

Установка переменной канала.

stream file

Отправка звукового файла в канал.

tdd mode

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

verbose

Запись сообщения в verbose log сервера asterisk.

wait for digit

Ожидание нажатия DTMF кнопки

Нажмите Сохранить для завершения настройки.

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

Описание функций раздела

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

Расположение раздела: "Обслуживание" -> "Системные логи"

Содержит 3 вкладки: просмотр логов, информация о системе, захват сетевых пакетов. Далее в статье будет подробно разобрана каждая из них.

Просмотр логов

Раздел позволяет просмотреть файлы логов для детального анализа работы АТС

  1. Для начала работы - выберите файл.

  2. Установите лимит строк для выборки.

  3. Установите офсет - значение сдвига в выборке.

  4. Установите фильтр по вхождению строки в выборку.

Доступны следующие возможности:

Пример. Анализ звонка

Допустим необходимо проанализировать прохождение исходящего звонка на номер 74952293042

  1. Выберите файл для анализа asterisk/verbose.

  2. В качестве фильтра установите номер телефона 74952293042.

  3. В поле лимит укажите значение с запасом, к примеру 2000, иначе могут быть выданы не все записи лога.

  4. В последней строке выборке следует найти идентификатор:

[2023-03-18 16:28:17] VERBOSE[21654][C-0000000f] app_stack.c: Spawn extension (SIP-1676196499-22-outgoing, 74952293042, 13) exited non-zero on 'PJSIP/302-0000001a'

В данном примере ID = C-0000000f.

  1. Повторяем запрос лога, но уже с фильтром C-0000000f.

  2. Будет получен весь лог прохождения dialplan.

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

Информация о системе

Данная вкладка отображает следующую информацию:

  • Сетевые настройки

  • Нагрузка на CPU

  • Потребляемая оперативная память

  • Настройки iptables

Захват сетевых пакетов

Данный раздел позволяет произвести детальный анализ ошибок в работе АТС.

Сбор сетевых пакетов

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

  1. Для запуска процесса нажмите кнопку "Старт".

  1. Воспроизведите вашу проблему: совершите звонок или иное действие, приводящее к сбою / ошибке.

  2. Нажмите кнопку "Остановить и скачать".

Сетевые пакеты будут автоматически сохранены в архив MikoPBXLogs_log-tcpdump-XXXXXXXXXX. Также они должны автоматически сохраниться в папку Загрузки вашего браузера.

Существует возможность воспользоваться поиском в WinSCP: в поле имени искомого файла ввести "log-tcpdump*", а в каталоге поиска ввести "/storage".

Скачать все системные логи

Вы можете скачать все накопленные на АТС системные логи. Для этого нажмите кнопку "Скачать все системные логи".

Системные логи будут автоматически сохранены в архив MikoPBXLogs_log-sys-XXXXXXXXXX.zip. Логи автоматически должны сохраниться в папку Загрузки вашего браузера. Так же данный архив с логами можно получить из каталога /storage/usbdisk1/mikopbx/tmp, подключившись к АТС при помощи WinSCP. Файл - log-sys-XXXXXXXXXX.zip

Будьте внимательны! При большом объеме звонков или прочей сетевой «нагрузки» на АТС логи могут занять довольно много места на диске.

Другие способы снятия лога:

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

Данная статья содержит пошаговые инструкции по обновлению MikoPBX на более новую версию.

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

Обновление из консоли MikoPBX

Вариант обновления из консоли MikoPBX

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


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

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


Доступ к AMI

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


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

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

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

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

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

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

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

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

Описание и настройка сетевых интерфейсов

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

Раздел находится в "Сеть и Firewall" -> "Сетевые интерфейсы":

Параметры

Имя хоста - это имя машины. Если значение не указано, то используется имя mikopbx.local.

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

Существует два способа настроить IP-адрес в MikoPBX:

  1. DHCP (Dynamic Host Configuration Protocol) - это протокол, который позволяет автоматически настраивать IP-адрес. Рекомендуется использовать этот способ, если вы не хотите заниматься ручной настройкой. Просто включите опцию "Использовать DHCP для получения настроек сети" и система автоматически получит IP-адрес от DHCP сервера.

  2. Ручная настройка - если вы не хотите использовать DHCP или хотите задать IP-адрес вручную, вы можете выполнить ручную настройку сети. Для этого вам понадобятся некоторые знания о топологии сети. В поле IP-адрес введите желаемый IP-адрес, а рядом с ним укажите маску подсети в формате CIDR. Например, /24 соответствует маске подсети 255.255.255.0.

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

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

Топология сети

"Сетевой интерфейс с доступом в интернет" - это основной интерфейс, через который MikoPBX будет получать доступ к внешним адресам, то есть адресам вне вашей локальной сети.

Если вы не указали адрес DNS-сервера, MikoPBX будет использовать сервер 8.8.8.8 по умолчанию. DNS-серверы отвечают за преобразование доменных имен в IP-адреса, позволяя устройствам находить нужные ресурсы в сети.

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

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

  • Если АТС находится за маршрутизатором, то необходимо установить галку «Эта станция расположена за NAT маршрутизатором»

  • Если нам известен внешний адрес станции (ip или доменное имя)и проброшены порты АТС во внешний мир, то имеет смысл заполнить поля «Внешний IP адрес Вашего маршрутизатора» или «Внешнее имя хоста вашего маршрутизатора».

Всем адресам, которые не являются для АТС локальными, станция будет представляться внешним адресом:

  • Если «Внешний IP адрес Вашего маршрутизатора» пустое, а «Внешнее имя хоста вашего маршрутизатора» заполнено, то АТС будет представляться именно этим полем (Внешнее имя).

Внешний IP-адрес обязателен для заполнения. Если указано доменное имя - то приоритет за ним и Внешний IP адрес не используется.

Когда вы включаете опцию «Эта станция расположена за NAT маршрутизатором», важно указать внешний адрес или имя хоста вашего маршрутизатора. Это необходимо для правильной настройки связи между внешней сетью и вашей АТС. Помимо этого, на самом маршрутизаторе необходимо выполнить проброс портов SIP 5060 и RTP 10000-10200 на локальный адрес АТС. Проброс портов позволяет маршрутизатору правильно направлять сетевой трафик SIP и RTP к вашей АТС.

Однако, если ваш провайдер позволяет вам регистрироваться без использования NAT и у вас нет необходимости подключать внешних абонентов, то вы можете не включать опцию «Эта станция расположена за NAT маршрутизатором». Даже если ваша АТС находится за NAT-маршрутизатором, но вы не нуждаетесь во внешних подключениях, эта опция не обязательна.

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

Ручная настройка сетевых маршрутов

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

  1. Откройте для редактирования файл /etc/static-routes.

  1. Выберите режим «Заменять полностью» и вставьте правило. Например, route add -net 54.246.198.136 netmask 255.255.255.255 gw 172.16.32.15 dev eth0

Для указания операционной системе, какой сетевой интерфейс (в данном случае eth0) использовать для поиска IP-адреса 54.246.198.136, а также для указания шлюза (gateway) для направления запроса (в данном случае 172.16.32.15), мы задаем соответствующие значения в настройках сетевого правила.

Маска подсети "255.255.255.255" указывает, что данное правило будет применимо только к конкретному IP-адресу 54.246.198.136. Если вам необходимо создать правило для группы адресов, например, для всей подсети 54.246.198.0, то фактически это охватывает диапазон адресов от 54.246.198.1 до 54.246.198.254.

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

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

Сетевой экран

Описание и настройка Firewall правил в MikoPBX

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

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

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

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

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

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

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

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

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

  • AMI-доступ к asterisk manager api через telnet. Asterisk Manager Interface (AMI) предоставляет доступ к Asterisk по TCP/IP протоколу.

  • AJAM - доступ к asterisk manager api, через http, https

  • ICMP-проверка связи командой ping

  • CTICLIENT-подключение панели телефонии для 1С

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

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

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

Дата и время

В данном разделе происходит настройка часов и календаря

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

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

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

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

Настройка E-mail уведомлений для почтового сервиса Yandex

Настройка почты для сервиса Yandex

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

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

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

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

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

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

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

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

Настройка E-mail уведомлений для почтового сервиса Mail.ru

Настройка почты для сервиса Mail.ru

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

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

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

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

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

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

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

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

Доступ к AMI

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

Asterisk Manager Interface (AMI) - мощный и удобный программный интерфейс (API) Asterisk для управления системой из внешних программ. Благодаря AMI внешние программы могут осуществлять соединения с Asterisk посредством TCP протокола, инициировать выполнение команд, считывать результат их выполнения, а так же получать уведомления о происходящих событиях в реальном времени. AMI часто используют для интеграции с бизнес-процессами и системами, программным обеспечением CRM (Customer Relationship Managment — управление взаимодействия с клиентами). Управление Asterisk часто осуществляется из консоли CLI, но при использовании AMI не требуется прямой доступ к серверу, на котором запущен Asterisk. AMI — это наиболее простой инструмент, который в руках разработчика может оказаться очень мощным и гибким средством для интеграции с другими программными продуктами. Он дает возможность разработчикам использовать информацию, генерируемую Asterisk, в реальном масштабе времени.

Первое что необходимо сделать, это включить AMI и завести пользователя, с помощью которого клиентская программа будет аутентифицироваться. «Система» - «Доступ к AMI»

Опции и права пользователя AMI

Права пользователя AMI, устанавливаемые в секции [user] конфигурационного файла /etc/asterisk/manager.conf

Сеть и Firewall

Описание раздела Сеть и Firewall в MikoPBX

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

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

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


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

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


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

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

Установка на MDADM RAID1

Подготовка

ВНИМАНИЕ: Все данные на дисках будут уничтожены.

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

Сборка RAID 1

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

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

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

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

  1. Создаем RAID1.

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

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

Grub

TODO: Необходимо править grub.cfg файл. Иначе, не факт, что при сбое одного из дисков, система загрузится.

Перенос с помощью резервного копирования по расписанию

Вариант переноса MikoPBX на другой хост

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

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

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

  1. Перейдите в модуль "Резервное копирование":

  1. Перейдите во вкладку "Расписание архивации":

  1. Далее настраиваем параметры архивации по расписанию:

  • Адрес сервера - адрес Вашей новой станции MikoPBX.

  • Протокол - SFTP

  • Порт - 22

  • Имя пользователя - имя пользователя для SSH подключения к вашей новой станции.

  • Пароль - пароль для SSH подключения к вашей новой станции.

  • Путь на сервере - "/storage/usbdisk1/mikopbx/backup/"

Прочитать про SSH подключение Вы можете в этой статье. Для начала резервного копирования сразу после сохранения настроек - выберите параметр "Начать создание копии сразу после сохранения настроек". Так же вы можете выбрать необходимые данные для переноса в соответствующем разделе.

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

Восстановление из копии на новом хосте

При успешном переносе данных, Ваша резервная копия появится в разделе модуля на новом хосте:

Выполните восстановление из копии на вашем новом хосте, для этого:

  1. Перейдите в раздел настроек резервной копии, нажав на соответствующий элемент:

  1. Выберите данные, которые Вам необходимо перенести и нажмите "Восстановить из архива":

Перенос MikoPBX на другой сервер

Разбор вариантов переноса MikoPBX на другой сервер

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

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

Описание:

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

Плюсы:

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

  • Позволяет сохранить текущую конфигурацию.

Особенности:

  • Может быть ненадёжен при больших объемах данных.

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


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

Описание:

Резервная копия автоматически создаётся и сохраняется сразу на целевой сервер через протокол SFTP. Этот способ особенно эффективен для больших объемов данных.

Плюсы:

  • Подходит для больших объемов данных.

  • Позволяет минимизировать ручные действия.

  • Обеспечивает прямой перенос данных между серверами.

Особенности:

  • Требует настроек SFTP на обоих серверах.

  • Необходим доступ к данным текущего пользователя SSH для корректной работы.


Вариант №3: Перенос с использованием rsync

Описание:

Используется команда rsync для синхронизации данных напрямую между старым и новым серверами. Этот метод удобен для опытных пользователей.

Плюсы:

  • Быстрая синхронизация даже для больших объемов данных.

  • Сохранение прав доступа и структуры каталогов.

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

Особенности:

  • Требует базовых знаний работы с командной строкой.

  • Возможны ошибки при настройке (например, указание неправильных путей).

  • Серверы должны быть одновременно доступны в сети.


Перенос с помощью резервного копирования

Вариант переноса MikoPBX на другой хост

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

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

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

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

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

Системные требования

В данной статье вы сможете найти системные требования для MikoPBX.

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

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

  • G.711 - 4.67 Mbps

  • GSM - 1.68 Mbps

  • G.722 - 4.67 Mbps

  • G.729 - 1.38 Mbps

Минимальные системные требования

Мы рекомендуем использовать два жестких диска для развертывания АТС.

  • Жесткий диск объемом 800 Mb для основной системы

  • Жесткий диск объемом 50+ Gb для записей разговоров

  • 1 (2 ядра) процессор x86-64

  • 2Gb оперативной памяти

  • Сетевой адаптер

ПК, с такими параметрами, в наших тестах, держит 38 одновременных входящих звонков при условиях:

  • К очереди подключено 10 агентов (все online)

  • Каждую секунду поступает новый звонок

  • Клиенту во время ожидания воспроизводится музыка (MOH)

  • На АТС не установлено доп. модулей

Ориентировочно, 1 час разговора занимает 14Мб места на диске. Для диска хранения записей разговоров рекомендуемый размер - не менее 50 гигабайт.

Вы попадете на :

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

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

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

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

1. Cкачать полученную выборку в виде файла

2. Обновить выборку

3. Автоматическое обновление выборки

Если в папке Загрузки архив найти не удалось , можете и скачать его из директории /storage/usbdisk1/mikopbx/tmp - файл log-tcpdump-XXXXXXXXXX.zip

С помощью

С помощью

С помощью

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

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

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

по настройки smtp. Для большей безопасности следует использовать «». Не используйте основной пароль от почтового ящика.

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

Для большей безопасности следует использовать «». Не используйте основной пароль от почтового ящика.

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

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

Для добавления новой учетной записи необходимо указать Имя пользователя и Пароль. Кроме того, необходимо задать Сетевой фильтр, т.е. из какой подсети разрешено подключение к пользователю AMI. Вы можете разрешить подключения с любых адресов, либо указать конкретную сеть, настройку который Вы произвели в разделе "Сеть и Firewall" → "".

Идентификатор прав
Чтение
Запись

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

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

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

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

Расчет ориентировочный, при использовании одного кодека на всех устройствах, подключенных к АТС. Подробнее .

сайт SaaS сервер лицензирования
здесь
здесь
здесь
подключиться к АТС через WinSCP
SSH-клиента
утилиты Wireshark
приложения tcpdump
репозитория
Общие настройки
Дата и время
Почта и уведомления
Доступ к AMI
Кастомизация системных файлов

System

Чтение общей информации о системе, например, уведомления о перезагрузке конфигурации

Позволяет пользователю выполнять Asterisk системы управления такими командами, как Restart, Reload, или Shutdown. Это разрешение также предоставляет пользователям возможность запускать системные команды за пределами Asterisk. Предоставление такого разрешения эквивалентно предоставлению доступа к командной оболочке, с правами пользователя / группы, под которыми запущен процесс Asterisk

Call

Чтение события о каналах в системе

Позволяет пользователю устанавливать информация на каналах

Log

Предоставляет пользователю доступ к чтению логов

Только чтение

Verbose

Предоставляет пользователю доступ к чтению подробных логов

Только чтение

Agent

Чтение событий статуса агентов из app_queue и chan_agent модулей

Позволяет пользователю выполнять действия для управления и получения состояния очередей и агентов

User

Доступа к пользовательским событиям, а также событиям Jabber / XMPP пользователей

Позволяет пользователю выполнять команду UserEvent, для создания пользовательских событий

Config

Только для записи

Позволяет пользователю получать, обновлять и перегружать файлы конфигурации

Command

Только для записи

Позволяет пользователю выполнять команды Asterisk CLI из AMI

Dtmf

Позволяет пользователю получать события DTMF

Только чтение

Reporting

Доступ к событиям качества звонка, таким как jitterbuffer или RTCP

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

Cdr

Чтение событий записи данных в CDR

Только чтение

Dialplan

Чтение событий установки переменных диалплана, создания "экстенов"

Только чтение

Originate

Только для записи

Разрешение пользователю выполнять команду Origitate, которая отправляет запрос на создание нового звонка

fdisk -l 
/dev/sda 
/dev/sdb
mdadm --zero-superblock --force /dev/sd{b,a} 
wipefs --all --force /dev/sd{b,a}
mdadm --create --metadata=0.90 --verbose /dev/md0 -l 1 -n 2 /dev/sd{b,a}
здесь
Документация Yandex
Пароли приложений
здесь
Пароли приложений
здесь
здесь
Сетевой экран
Сетевые интерфейсы
Сетевой экран
Защита от взлома
LiveCD или LiveUSB
SSH
по инструкции
Работа с mdadm в Linux для организации RAID
Перенос с помощью резервного копирования
Перенос с помощью резервного копирования по расписанию
Перенос с помощью rsync
данной статье
тут

Диагностика проблем

Закончилось место на доп. диске, увеличение размера диска

Увеличить размер диска позволяют некоторый виртуальные машины

Перед работами обязательно выполните резервное копирование данных!

Контроль свободного места на диске

~ # df -h
Filesystem                Size      Used Available Use% Mounted on
none                    281.3M    324.0K    281.0M   0% /dev
/dev/sda2               392.3M    384.6M      3.8M  99% /offload
/dev/sda3                14.1M    915.0K     12.9M   6% /cf
/dev/sdb1                 4.9G     71.0M      4.5G   2% /storage/usbdisk1

Диск для хранения данных обычно монтируется в каталог «/storage/usbdisk1». Из примера выше видно, что на текущий момент доступно 4.5G из 4.9G.

Отключение диска

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

~ # /sbin/freestorage

Убедитесь, что диск для хранения данных более не смонтирован:

~ # df -h
Filesystem                Size      Used Available Use% Mounted on
none                    281.3M    324.0K    281.0M   0% /dev
/dev/sda2               392.3M    388.3M         0 100% /offload
/dev/sda3                14.1M    915.0K     12.9M   6% /cf

Редактирование таблицы разделов

Удаление раздела

Для начала удалим существующий раздел. Эта операция НЕ удаляет данные на диске, просто правит таблицу разделов.

Запускаем редактор разделов:

# fdisk /dev/sdb

Система запросит ввести команду, вводим «d» и жмем Enter:

Command (m for help): d

Система запросит выбрать раздел к удалению, он один, вводим номер раздела «1» и жмем Enter:

Selected partition 1

Сохраняем таблицу разделов, вводим команду «w» и жмем Enter:

Command (m for help): w

Добавление большего раздела

Запускаем редактор разделов:

# fdisk /dev/sdb

Система запросит ввести команду, вводим «n» и жмем Enter:

Command (m for help): n

Далее указываем команду «p», раздел будет первичным, жмем Enter:

Command action p

Вводим номер создаваемого раздела «1», жмем Enter:

Partition number (1-4): 1

Далее система запросит ввести номера первого и последнего сектора «First sector» / «Last sector», ждем Enter, ничего не вводим и соглашаемся со значениями «по умолчанию».

Проверка нового раздела

Размер раздела должен соответствовать размеру диска.

~ # fdisk -l 
Disk /dev/sdb: 10 GB, 10737418240 bytes, 20971520 sectors
1305 cylinders, 255 heads, 63 sectors/track
Units: cylinders of 16065 * 512 = 8225280 bytes

Device  Boot StartCHS    EndCHS        StartLBA     EndLBA    Sectors  Size Id Type
/dev/sdb1    0,1,1       1023,254,63         63   20964824   20964762  9.9G 83 Linux

Проверка раздела на ошибки

Запускаем команду проверки:

e2fsck -f /dev/sdb1

Пример результата работы команды:

e2fsck 1.43.4 (31-Jan-2017)
Pass 1: Checking inodes, blocks, and sizes
Pass 2: Checking directory structure
Pass 3: Checking directory connectivity
Pass 4: Checking reference counts
Pass 5: Checking group summary information
/dev/sdb1: 35/655360 files (11.4% non-contiguous), 63423/2620595 blocks

Размер файловой системы раздела

Запускаем команду:

resize2fs /dev/sdb1

Пример вывода команды:

resize2fs 1.43.4 (31-Jan-2017)
The filesystem is already 2620595 (4k) blocks long.  Nothing to do!

Перезагрузка и монтирование

При загрузке система автоматически смонтирует диск для хранения данных:

~ # df -h
Filesystem                Size      Used Available Use% Mounted on
none                    281.3M    324.0K    281.0M   0% /dev
/dev/sda2               392.3M    384.6M      3.8M  99% /offload
/dev/sda3                14.1M    915.0K     12.9M   6% /cf
/dev/sdb1                 9.8G     73.3M      9.2G   1% /tmp/123

Сброс к заводским настройкам

Способ 1

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

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

Способ 2

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

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

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

Перенос с помощью rsync

Вариант переноса данных с использованием rsync (предпочтительный)

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

Схематично процесс переноса можно изобразить следующим образом:

Создание файла для хранения скрипта и наполнение его содержимым

  1. Далее переходим в консоль ([9] Console). Первым делом необходимо создать директорию для хранения файла со скриптом. Используйте следующую команду:

mkdir -p /storage/usbdisk1/transfer
  1. Перейдите в созданную директорию:

cd /storage/usbdisk1/transfer
  1. Создадим файл "transfer-rsync.sh" для хранения скрипта:

touch transfer-rsync.sh
curl -o /storage/usbdisk1/transfer/transfer-rsync.sh https://gist.githubusercontent.com/excla1mmm/c9891306b459cac0c7ea3c785ab0936e/raw/ec57ab60ee48112b4a16635e7b47955e5a044513/transfer-rsync.sh

Запуск и работа со скриптом

  1. На данном этапе необходимо сделать файл исполняемым. Для этого используйте следующую команду:

chmod +x transfer-rsync.sh
  1. Запустите скрипт, используя команду:

./transfer-rsync.sh
  1. Для начала будет предложено ввести необходимые данные о вашей старой станции MikoPBX:

  • IP-адрес вашей старой станции

  • Имя для ssh-авторизации

  • Порт для ssh-авторизации

  1. Далее будет предложено сгенерировать новый ключ. В случае, если ранее вы этого не делали, введите "y" для подтверждения. Если ранее вы уже генерировали ключ для доступа ко второй MikoPBX - введите "n":

  1. Будет создан новый ключ. Вам необходимо скопировать его и вставить в web-Интерфейсе старой MikoPBX. Сделать это нужно в разделе "Общие настройки" -> "SSH" -> Поле "SSH Authorized keys"

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

Будет произведен перенос всех данных на новый хост. Это может занять некоторое время.

После переноса обязательно проверяйте целостность всех данных, перед тем, как сбрасывать старую MikoPBX!

Yandex Cloud

Варианты установки MikoPBX в Yandex Cloud

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

Быстрое начало работы

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

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

Установка MikoPBX

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

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

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

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

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

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

Если в логах Вам не даны логин и пароль, используйте данные по-умолчанию:

Username: admin

Password: admin

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

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

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


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


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


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


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

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

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


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

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

На этом основная настройка MikoPBX завершена! Для более глубокого изучения возможностей MikoPBX рекомендуем обратиться к общей документации.

VirtualBOX

Установка MikoPBX с помощью VirtualBox

Используйте для установки на VirtualBOX версии АТС MikoPBX ниже 2024.1.114

Версия 2024.1.114 временно не поддерживает установку на VirtualBOX

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

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

3. Укажите Имя и Папку машины.

Тип - Linux.

Версия - Other Linux (64Bit).

Нажмите Далее.

  1. Укажите размер основной памяти - 1024 МБ, а так же количество процессоров - 2

Нажмите Далее.

5. Выберите Создать новый виртуальный жесткий диск. Введите размер диска 700 МБ, а так же поставьте галочку у пункта "Выделить место в полном размере"

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

6. Подтвердите создание виртуальной машины: нажмите кнопку Готово.

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

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

Для этого нажмите Настроить.

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

3. В появившемся окне нажмите Создать.

4. Формат жёсткого диска выберите - VDI (VirtualBox Disk Image).

Нажмите Далее.

5. Жёсткий диск должен быть фиксированного размера.

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

Нажмите Далее.

6. Укажите Имя создаваемого диска.

Установите Размер диска порядка 50 ГБ.

Нажмите Готово.

7. Выделите вновь созданный диск и нажмите Выбрать.

8. Созданный диск появиться в списке носителей.

9. Смонтируйте на оптический диск образ MikoPBX. Для этого в разделе Носители выделите оптический диск и в разделе Атрибуты нажмите кнопку выбора файла образа.

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

11. Выберите скачанный ISO-образ диска и нажмите Открыть.

12. Перейдите на вкладку «Сеть». Установите Тип подключения в значение Сетевой мост.

Нажмите ОК для сохранения всех произведенных настроек.

Установка MikoPBX

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

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

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

Выбрать пункт меню - клавиша Enter.

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

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

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

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

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

Диск, на который будет установлена MikoPBX, называется системным (SYSTEM). В качестве системного диска можно выбрать диск, размер которого превышает 500 Мб.

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

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

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

Ориентировочно, 1 час разговора занимает 14Мб места на диске.

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

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

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

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

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

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

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

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

Сброс пароля администратора из консоли MikoPBX

Действия для сброса данных из консоли MikoPBX

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

Сброс из консоли MikoPBX

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

В зависимости от способа установки, консоль может находиться:

  • При установке на физический сервер - на мониторе, подключенному к серверу.

  • При установке в виртуальную машину - в консоли управления виртуальной машиной.

  • При установке в облако - в серийной консоли облака (так же в консоли управления виртуальной машиной).

  • Способ сброса при установке в Docker-контейнер описан далее в текущей документации.

  1. Перейдите в раздел "[7] Reset password for the web interface".

  2. Введите "y" для подтверждения сброса логина и пароля.

  1. Авторизуйтесь в web-интерфейс по стандартным данным:

Стандартные данные для входа в web-интерфейс:

Логин: admin

Пароль: admin

Измените данные для входа после первой авторизации.

Сброс пароля в Docker-контейнере

  1. Перейдите в container-shell.

docker exec -it mikopbxcontaierNameOrID sh

Замените mikopbxcontaierNameOrID на название или ID вашего контейнера.

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

/etc/rc/console_menu
  1. Перейдите в раздел "[7] Reset password for the web interface".

  2. Введите "y" для подтверждения сброса логина и пароля.

  3. Авторизуйтесь в web-интерфейс по стандартным данным:

Стандартные данные для входа в web-интерфейс:

Логин: admin

Пароль: admin

Измените данные для входа после первой авторизации.

Подключение к АТС с помощью SSH

Описание вариантов подключения к АТС по SSH

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

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

  • Подключение с помощью пароля через сторонние приложения (в данной статье в примере - putty)

  • Подключение с помощью ключей, что и будет рассмотренно далее с примером на Windows, Linux (MacOS)



Закончилось место на доп. диске, перенос данных на новый диск

Постановка задачи

Решение

  1. Перейдите в консоль - для этого выберите: [9] Console (Shell)

  2. Отключите storage диск «sda4»:

/etc/rc/freestorage;
  1. Подключаем новый диск.

php -f /etc/rc/connect.storage;

Резервный интернет и перерегистрация провайдеров

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

Если АТС работает за NAT и серый публичный IP адрес изменился, то АТС не сможет получить входящий вызов пока не пройдет регистрация на стороне провайдера, по умолчанию это может занять от 2х до 6 мин.

Создание скрипта проверки IP

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

cat > /storage/usbdisk1/mikopbx/custom_modules/update_ip.sh

Система запросит ввод с клавиатуры, вставьте содержимое скрипта:

#!/bin/bash
# Файл для хранения предыдущего IP
IP_FILE="/tmp/last_ip.txt"
# Команда для получения текущего IP
CURRENT_IP=$(/usr/bin/curl -s https://checkip.amazonaws.com)
# Проверка, существует ли файл с предыдущим IP
if [ -f "$IP_FILE" ]; then
    LAST_IP=$(cat "$IP_FILE")
else
    LAST_IP=""
fi
# Сравнение текущего IP с предыдущим
if [ "$CURRENT_IP" != "$LAST_IP" ]; then
    /bin/busybox logger -t 'UpdateIP' "IP изменился: $LAST_IP -> $CURRENT_IP";
    echo "$CURRENT_IP" > "$IP_FILE"
    # Выполнение команды Asterisk
    /usr/sbin/asterisk -rx 'pjsip send register *all'
fi
  1. Нажмите CTRL + D для завершения ввода.

  2. Сделайте файл исполняемым:

chmod +x /storage/usbdisk1/mikopbx/custom_modules/update_ip.sh

Планирование сценария перерегистрации

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

  1. Откройте для редактирования файл /var/spool/cron/crontabs/root :

  1. Добавьте задачу в конец файла /var/spool/cron/crontabs/root

*/1 * * * * /storage/usbdisk1/mikopbx/custom_modules/update_ip.sh > /dev/null 2> /dev/null

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

В системном логе system/messages отобразиться информационное сообщение об изменении IP.

Хранение записей в общей папке windows

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

Обратите внимание: если сетевой каталог будет не доступен, возможны сбои в работе АТС.

  1. Создадим каталог для хранения скрипта

  1. Создадим файл скрипта

  1. Вставьте содержимое скрипта

  1. Нажмите сочетание клавиш «CTRL+D» два раза для завершения создания файла

  2. Предоставьте права на исполнение

  1. В переменных скрипта «HOST,USER,PASS» следует описать параметры подключения к общему каталогу

  2. Скрипт необходимо доавить в cron для автоматического подключения общей папки

  3. Перейдите в раздел «Система» - «Кастомизация системных файлов»

  4. Добавьте в конец файла «/var/spool/cron/crontabs/root» следующее правило

  1. Протестируйте работу АТС, убедитесь, что записи разговоров сохраняются на сетевой диск.

Подключение с помощью SSH (Linux/MacOS)

Подключение к MikoPBX по SSH с помощью Powershell (Terminal)

Создание и привязка ключа

  1. Для начала необходимо сгенерировать SSH ключ. Перейдите в терминал и введите следующую комманду для его генерации:

В данном случае будет сгенерирован ключ типа "ed25519" с комментарием "example.powershell@gmail.com" - это поможет идентифицировать его в будущем.

Помимо этого, можно указать путь, куда будет сохранён файл с ключами, по умолчанию это "~/.ssh/id_ed25519.pub". Для этого добавьте -f и укажите путь, например:

По умолчанию ключ сохраняется в Username/.ssh/id_ed25519.pub

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

  1. Перейдите в "Система" -> "Общие настройки" в web-интерфейсе MikoPBX.

  1. Вставьте ваш ключ в поле "SSH Authorized Keys":

Подключение с помощью SSH

Для подключения по SSH выполните следующую команду в Terminal:

Замените следующие данные, исходя из ваших параметров:

  • Путь к SSH ключу.

  • Подставьте IP вашей MikoPBX вместо mikopbxipadress.

Введите пароль от ssh. Произойдет подключение к консоли MikoPBX с помощью SSH:

Подключение с помощью SSH (Windows)

Подключение к MikoPBX по SSH с помощью Powershell (OpenSSH)

Создание и привязка ключа

  1. После установки необходимо проверить ее корректность. Для этого введите следующую команду в Powershell:

У Вас должна отобразиться версия OpenSSH:

В случае, если при вводе команды для проверки версии ничего не произошло, Вы можете ввести - Add-WindowsCapability -Online -Name OpenSSH.Client*

  1. Далее необходимо сгенерировать SSH ключ, для этого введем следующую команду:

В данном случае будет сгенерирован ключ типа "ed25519" с комментарием "example.powershell@gmail.com" - это поможет идентифицировать его в будущем.

Помимо этого, можно указать путь, куда будет сохранён файл с ключами, по умолчанию это "C:\Users<Username>.ssh\id_ed25519". Для этого добавьте -f и укажите путь, например:

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

  1. Введем команду для получения публичного Ssh-ключа:

Скопируйте его.

  1. Перейдите в web-интерфейс MikoPBX, во вкладку "Система" -> "Общие настройки":

  1. Перейдите в раздел "SSH" и вставьте публичный ключ в поле "SSH Authorized Keys" в формате:

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

Подключение с помощью SSH

Для подключения по SSH выполните следующую команду в Powershell:

Замените следующие данные, исходя из ваших параметров:

  • Путь к SSH ключу.

  • Подставьте IP вашей MikoPBX вместо mikopbxipadress.

Произойдет подключение к консоли MikoPBX с помощью SSH:

Подключение к АТС с помощью SSH-клиента (Putty)

В данной инструкции будет описано подключение по SSH с помощью Putty

  1. Запустите скаченную программу. У вас откроется главное меню.

  1. Перейдите в раздел «Соединение» - «Данные»

  1. «Имя пользователя для автовхода» укажите root

«Строка типа терминала» укажите xterm-256color

  1. Перейдите в раздел «Кодировка»

  1. «Кодировка» - укажите UTF-8

    Установите флаг «Включить рисование линий VT100 даже в режиме UTF-8»

  1. Перейдите в раздел «Сессия» - «Журнал». Тут можно настроить вывод в файл:

  1. Перейдите в раздел "Сеанс"

9. Необходимые данные:

  • Имя хоста (или IP-адрес)- IP адрес АТС

  • Порт - порт для подключения по SSH по умолчанию 22

  • Введите имя сессии и сохраните ее настройки

  1. В дальнейшем используйте действие «Загрузить» для использования сохраненной ранее сессии

  1. Выполните действие «Соединиться» для подключения к АТС и введите пароль SSH

  1. Перед подключением вам необходимо разрешить авторизацию по паролю в веб-интерфейсе MikoPBX, а так же задать пароль для подключения: для этого перейдите "Общие настройки" -> "SSH"

  1. После ввода пароля SSH, у вас откроется меню АТС

  1. Для открытия консоли перейдите в "[9] Console(Shell)"

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

Для начала нам необходимо установить SSH соединение с новой MikoPBX. Прочитать как сделать это, можно в .

Далее необходимо заполнить файл содержимым (скриптом). Ознакомиться с ним Вы можете.

Установка .

Установка .

Установка .

Установка в .

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

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

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

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

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

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

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

1. Скачайте программу VirtualBox по и установите ее.

Перемещаться по пунктам меню можно .

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

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

Для знакомства с системой MikoPBX, используйте следующую .

MikoPBX установлена на отдельно выделенный сервер по . В качестве дополнительного диска для хранения записей разговоров (диск storage) подключен 4-ый раздел основного диска (/dev/sda4), где установлена MikoPBX. Свободное место на 4-ом разделе диска закончилось. Необходимо подключить к MikoPBX в качестве диска storage отдельный диск (/dev/sdb) и перенести на него все записи разговоров, которые ранее хранились на 4-ом разделе основного диска.

Подключитесь к MikoPBX через с помощью SSH по :

Подключитесь к MikoPBX по протоколу SSH (документация о различных способах подключения — )

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

Скачайте программу для подключения по SSH. Это можно сделать на официальном сайте по

Подключение к АТС с помощью SSH-клиента
этой статье
по ссылке
на отдельный компьютер
в виртуальную машину
с помощью облачных сервисов
Docker контейнере
здесь
инструкции
здесь
инструкция
здесь
здесь
Маршрутизация входящих вызовов
Маршрутизация исходящих вызовов
Очереди вызовов
IVR-меню
Конференции
этой статье
этой статье
ссылке
клавишами управления курсором
буквенно-цифровом блоке клавиатуры
здесь
документацию
Подключение к АТС с помощью SSH-клиента (Putty)
Подключение с помощью SSH (Windows)
Подключение с помощью SSH (Linux/MacOS)
инструкции
инструкции
здесь
mkdir /storage/usbdisk1/mikopbx/custom_modules/shared-folder-script
cat > /storage/usbdisk1/mikopbx/custom_modules/shared-folder-script/mount-shared-folder.sh
#!/bin/sh
HOST='//172.16.32.38/SharedFolder';
USER='';
PASS='';
REC_DIR='autorecords';
mountPoint='/storage/win-shared';

createLink ()
{
  subDir="$(date '+%Y/%m')";
  monitorDir="$(/bin/busybox grep monitordir < /etc/inc/mikopbx-settings.json | /bin/busybox cut -f 4 -d '"')";
  if [ "${monitorDir}x" = 'x' ];then
    echo "Empty monitor dir";
    return;
  fi;
  /bin/busybox mkdir -p "$monitorDir" "$mountPoint/$REC_DIR/$subDir";
  if [ ! -L "$monitorDir/$subDir" ] && [ -d "$monitorDir/$subDir" ];then
    cp -r "$monitorDir/$subDir/"*  "$mountPoint/$REC_DIR/$subDir";
    rm -rf "${monitorDir:?}/$subDir/";
    ln -s "$mountPoint/$REC_DIR/$subDir" "${monitorDir:?}/$subDir";
  fi;

  if [ ! -L "$monitorDir/$subDir" ] && [ ! -f "${monitorDir:?}/$subDir" ]; then
    ln -s "$mountPoint/$REC_DIR/$subDir" "${monitorDir:?}/$subDir";
  fi;
}

/bin/busybox mount | /bin/busybox grep "$HOST";
resGrep="$?";
if [ "$resGrep" = "0" ]; then
  echo "Disk is mounted..."
  createLink;
  exit 2;
fi;

mkdir -p "$mountPoint";
/bin/busybox mount -t cifs "$HOST" "$mountPoint" -o "username=$USER,password=$PASS,vers=2.0"
resMount="$?";

if [ "$resMount" != '0' ];then
  echo "Error mount $HOST"
  exit 1;
fi;

createLink;
chmod +x /storage/usbdisk1/mikopbx/custom_modules/shared-folder-script/mount-shared-folder.sh
*/1 * * * * /storage/usbdisk1/mikopbx/custom_modules/shared-folder-script/mount-shared-folder.sh > /dev/null 2> /dev/null
ssh-keygen -t ed25519 -C "example.poweshell@gmail.com"
ssh-keygen -t ed25519 -f ~/.ssh/my_new_key
cat ~/.ssh/id_ed25519.pub
ssh -i Users\<Username>\.ssh\id_ed25519 root@mikopbxipadress
ssh -V
ssh-keygen -t ed25519 -C "example.poweshell@gmail.com"
ssh-keygen -t ed25519 -f ~/.ssh/my_new_key
Get-Content ~/.ssh/id_ed25519.pub
Тип ключа
Ключ
ssh -i C:\Users\<Username>\.ssh\id_ed25519 root@mikopbxipadress
по ссылке
ссылке

Vscale

Установка MikoPBX с помощью Vscale

Vscale переехал в Selectel

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

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

  2. Выберите тип образа - "File" (п.1)

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

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

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

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

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

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

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

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

  4. Выберите загруженный ранее образ MikoPBX

  5. Настройте два диска, первый на 5Гб, второй на 50Гб

  6. В разделе "Сеть" - "Публичный IP" - выберите "Создать новый публичный IP"

  7. В разделе "Доступ" задайте сложный пароль

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

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

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

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

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

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

AWS подробная инструкция

Установка MikoPBX в AWS с помощью произвольного образа

Для выполнения инструкций установите утилиту командной строки Amazon, для этого откройте Терминал и введите в командной строке

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

Для быстрого и удобного поиска в сервисе Amazon используйте панель поиска

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

  1. Перейдите к своему аккаунту

  2. В выпадающем меню выберите Security credentials

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

  1. В таблице Access keys выберите Create access key

  2. Скопируйте Access key и Secret access key

Если у вас есть ключ доступа, скопируйте Access key и Secret access key

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

  1. Откройте Services / Storage / S3

  2. На вкладке выберите Create bucket

  3. Введите уникальное имя бакета (Bucket name)

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

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

  1. Откройте созданный бакет и выберите Upload

  2. На открывшейся вкладке выберите Add files

  3. Загрузите файл из дистрибутива MikoPBX с расширением .raw

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

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

Добавление прав и прикрепление политик

Если для данного облака не выполнялось, сделайте один раз

  1. Создайте отдельную папку для файлов на компьютере

  2. Создайте в папке файл trust-policy.json

    1. Откройте Терминал и перейдите к созданной папке

    2. Выполните команду vi trust-policy.json

    3. Перейдите в режим редактирования, нажав i, вставьте текст

    4. Нажмите ESC и напишите :wq, чтобы записать файл

  1. Аналогично создайте файл role-policy.json, измените значение имени бакета в тексте на имя созданного вами бакета

  1. Аналогично создайте файл import-image.sh, измените значения параметра DEFAULT_BUCKET на имя созданного вами бакета и параметра DEFAULT_IMAGE на имя образа, загруженного в бакет

  1. Выполните команду aws configure, укажите регион и скопированные ключи Access key и Secret access key

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

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

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

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

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

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

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

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

  1. Укажите тип машины (Instance type) - t3.micro

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

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

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

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

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

  1. В разделе Network settings установите флажки Allow SSH traffic и Allow HTTPS traffic

Для развертывания АТС используйте два диска:

  • диск объемом 1 Гб для основной системы

  • диск объемом 50+ Гб для хранения записей разговоров

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

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

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

Запуск АТС MikoPBX

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

  2. На открытой вкладке выберите Connect / EC2 serial console, дождитесь полной загрузки системы, пока не отобразятся параметры авторизации

  1. Скопируйте внешний адрес созданной виртуальной машины и введите его в строке браузера

  2. Для входа используйте указанные в EC2 serial console логин и пароль

Обязательно выполните настройку Firewall на самой АТС MikoPBX

Инструкция по установке MikoPBX в Selectel доступна по ссылке:

Скачайте актуальный образ системы с расширением .raw на

Выполните авторизацию на портале

Авторизуйтесь в сервисе Amazon Web Services

curl "https://awscli.amazonaws.com/AWSCLIV2.pkg" -o "AWSCLIV2.pkg" 
sudo installer -pkg AWSCLIV2.pkg -target /
vi trust-policy.json
{
"Version": "2012-10-17",
    "Statement":
    [
        {
            "Effect": "Allow",
            "Principal": { "Service": "vmie.amazonaws.com" },
            "Action": "sts:AssumeRole",
            "Condition": {
                "StringEquals":{"sts:Externalid": "vmimport"}
            }
        }
    ]
}
{
    "Version":"2012-10-17",
    "Statement":
    [
        {
        "Effect": "Allow",
        "Action": [
            "s3:GetBucketLocation",
            "s3:GetObject",
            "s3:ListBucket"
            ],
        "Resource": [
            "arn:aws:s3:::",
            "arn:aws:s3:::/*"
            ]
        },
        {
        "Effect": "Allow",
        "Action": [
            "ec2:ModifySnapshotAttribute",
            "ec2:CopySnapshot",
            "ec2:RegisterImage",
            "ec2:Describe*"
        ],
        "Resource": "*"
        }
    ]
}
#!/bin/bash

# Определение переменных по умолчанию
DEFAULT_IMAGE=""
DEFAULT_BUCKET=""
DEFAULT_DESCRIPTION="MikoPBX the best open source PBX on asterisk"
DEFAULT_NAME="MikoPBX 2024.1.40-dev"

# Переопределение переменных значениями переменных окружения, если они установлены
IMAGE="${IMAGE:-$DEFAULT_IMAGE}"
BUCKET="${BUCKET:-$DEFAULT_BUCKET}"
DESCRIPTION="${DESCRIPTION:-$DEFAULT_DESCRIPTION}"
NAME="${NAME:-$DEFAULT_NAME}"

# Файл JSON для команды import-snapshot
JSON_FILE="disk_container.json"

# Создание файла JSON
cat <<EOF> ${JSON_FILE}
{
  "Description": "${DESCRIPTION} image",
  "Format": "raw",
  "UserBucket": {
	"S3Bucket": "${BUCKET}",
	"S3Key": "${IMAGE}"
  }
}
EOF

# Импорт снимка
IMPORT_TASK_ID=$(aws ec2 import-snapshot --description "${DESCRIPTION} image" --disk-container "file://${JSON_FILE}" --query 'ImportTaskId' --output text)

echo "Import task started with ID: $IMPORT_TASK_ID"

# Ожидание завершения импорта снимка
while true; do
	STATUS=$(aws ec2 describe-import-snapshot-tasks --import-task-ids $IMPORT_TASK_ID --query 'ImportSnapshotTasks[0].SnapshotTaskDetail.Status' --output text)
	echo "Current status: $STATUS"
	if [ "$STATUS" == "completed" ]; then
		break
	fi
	sleep 30
done

# Получение SnapshotId
SNAPSHOT_ID=$(aws ec2 describe-import-snapshot-tasks --import-task-ids $IMPORT_TASK_ID --query 'ImportSnapshotTasks[0].SnapshotTaskDetail.SnapshotId' --output text)

# Регистрация AMI
AMI_ID=$(aws ec2 register-image \
	  --name "$NAME" \
	  --description "$DESCRIPTION" \
	  --architecture x86_64 \
	  --sriov-net-support simple \
	  --virtualization-type paravirtual \
	  --ena-support \
	  --boot-mode legacy-bios \
	  --root-device-name "/dev/sda1" \
	  --block-device-mappings "[{\"DeviceName\": \"/dev/sda1\", \"Ebs\":{\"DeleteOnTermination\":true, \"VolumeSize\":1, \"SnapshotId\":\"$SNAPSHOT_ID\"}}, {\"DeviceName\": \"/dev/sdb\", \"Ebs\":{\"VolumeSize\":50}}]" \
	  --query 'ImageId' \
	  --output text)

echo "AMI created with ID: $AMI_ID"
aws configure
aws iam create-role --role-name vmimport --assume-role-policy-document "file://trust-policy.json"
aws iam put-role-policy --role-name vmimport --policy-name vmimport --policy-document "file://role-policy.json"
sh import-image.sh
https://docs.mikopbx.com/mikopbx/setup/cloud/selectel
сайте
https://vscale.io
https://aws.amazon.com

DigitalOcean

Установка MikoPBX с помощью сервиса DigitalOcean

Инструкция актуальна для версии 2024.2.111 и новее!

В данной инструкции мы пошагово произведем установку MikoPBX с помощью облачной платформы DigitalOcean.

Загрузка образа в DigitalOcean

  1. Перейдите в "Manage" -> "Backups & Snapshots"

  1. Перейдите в "Custom Images" -> "Import via URL":

  1. Вставьте ссылку на файл образа диска с расширением .raw, скопированную ранее.

  2. Введите имя для образа, выберите регион для его загрузки (должен совпадать с будущим регионом виртуальной машины). В качестве операционной системы образа выберите "Unknown"

Нажмите "Upload image"

Дождитесь загрузки образа.

Создание виртуальной машины в облаке

  1. Перейдите на главную страницу DigitalOcean.

  1. Для перехода к создаю виртуальной машины, перейдите в "Create" -> "Droplets":

  1. Выберите регион и датацентр для Вашей виртуальной машины.

  1. Далее выберите ранее загруженный образ и конфигурацию для вашей виртуальной машины:

  1. Перейдите во вкладку "Additional Storage". Здесь необходимо добавить второй диск, который будет использоваться для хранения записей разговоров. Для этого нажмите "Add volume" и укажите параметры для нового диска.

Рекомендуемый размер диска для хранения записей разговоров - от 50ГБ.

  1. Перейдите в раздел "Choose authentication method". Здесь необходимо выбрать "SSH Key" и добавить связку ключей для SSH подключения. Подробнее прочитать про их создание Вы можете в следующих статьях:

  1. Нажмите "Create Droplet".

Подключение к консоли и первый вход в WEB-Интерфейс

Подключение из консоли Digital Ocean

  1. Перейдите в меню созданной машины. Дождитесь ее запуска. Далее подключитесь с помощью встроенной консоли в DigitalOcean (элемент на скриншоте).

  1. После загрузки системы, перейдите в web-интерфейс, используя внешний IP-адрес, указаный в консоли (external).

  1. Вставьте IP-адрес машины в строку браузера. После перехода на страницу авторизации в MikoPBX, используйте следующие данные для входа:

  • Логин - admin

  • Пароль - id Виртуальной машины, найти который Вы можете в адресной строке:

Подключение по SSH

Стандартный логин для авторизации по SSH для ВМ в DigitalOcean - do-user.

  1. Перейдите в Powershell и пропишите следующую команду:

ssh -i C:\Users\<Username>\.ssh\id_ed25519 do-user@mikopbxipadress

Замените:

  1. C:\Users\<Username>\.ssh\id_ed25519 на путь к Вашему ключу на локальном устройстве

  2. do-user на Ваш root-логин (если Вы его изменяли при созданиии ВМ)

  3. mikopbxadress на IP-адрес вашей станции (IPv4 в интерфейсе управления Виртуальной машиной)

После нажатия "Enter" произойдет авторизация по SSH и Вы попадете в консольное меню MikoPBX.

Selectel

Установка MikoPBX с помощью Selectel

В данной инструкции мы пошагово произведем установку MikoPBX с помощью облачной платформы Selectel.

Загрузка образа в Selectel

  1. Перейдите в раздел Облачная платформа -> Образы.

  1. Нажмите "Создать образ".

  1. Укажите:

  • Имя образа - любое желаемое название для вашего образа.

  • ОС - Linux

  • Источник - Файл

  • Файл - выберите раннее загруженный файл с расширением .iso

Все остальное - по умолчанию.

Нажмите создать и дождитесь окончания процесса.

Создание сервера в Selectel

  1. Перейдите в раздел Облачная платформа -> Серверы

  1. Нажмите "Создать сервер":

  1. В конфигурации вашей ВМ укажите:

  • Имя - произвольное название.

  • Пул - такой же, как у раннее созданного образа.

  • Источник - выберите раннее загруженный образ.

  • Конфигурация - желаемое "железо" исходя из ваших потребностей.

  • Диски: Здесь вам необходимо указать размер для первого диска (он же - системный диск) - 5Гб (минимально возможный в Selectel). А так же создайте новый диск, используя кнопку "Добавить". Укажите размер. Для диска, который используется для записи разговоров - рекомендуемое значение >50Гб. Типы дисков - "Базовый HDD"

  • Сеть - "Приватная + 1 публичный IP"

  1. Нажмите "Создать сервер".

После создания, сразу остановите запуск сервера.

Включение DHCP

  1. Перейдите в раздел Облачная платформа -> Сеть.

  1. Перейдите в конфигурацию сети "Nat":

  1. Перейдите в раздел Подсети -> Автоматические сетевые настройки.

  1. Включите переключатель "DHCP-сервер".

Первый запуск MikoPBX

  1. Вернитесь к разделу Облачная платформа -> Серверы. Далее - в созданный сервер.

  2. Включите сервер:

  1. Перейдите в раздел "Syslog":

Произведите подключение по:

External IP Address - внешний IP-адрес вашей MikoPBX. Скопируйте и вставьте его в адресную строку.

Web credentials - данные для входа в WEB-интерфейс. Введите логин и пароль.

Телефония

Описание раздела телефонии MikoPBX

Глава "Телефония" в документации MikoPBX содержит подробную информацию и инструкции, связанные с настройкой и использованием телефонии в системе.

Сотрудники

Сотрудники в MikoPBX — это индивидуальные пользователи системы, которым назначены внутренние номера для совершения и приема звонков. Они имеют персональные учетные записи, позволяющие настроить права доступа, переадресацию вызовов и другие персональные настройки в системе.

В данной статье Вы найдете подробную документацию по добавлению новых сотрудников в станцию, настройку их прав и профилей. Помимо этого, информацию про их дополнительные параметры.


Очереди вызовов

Очереди вызовов в MikoPBX — это функция, позволяющая распределять входящие звонки между группой операторов, удерживая вызовы в очереди до момента, когда оператор станет доступен. Это обеспечивает эффективное управление большим потоком звонков и улучшает качество обслуживания клиентов.

В данной статье Вы найдете подробную документацию по созданию и настройке таких очередей.


IVR меню

IVR меню в MikoPBX — это интерактивное голосовое меню, которое позволяет звонящим взаимодействовать с телефонной системой с помощью нажатия клавиш или голосовых команд. Оно автоматически направляет вызовы к нужным отделам или сотрудникам, улучшая эффективность обработки звонков и повышая качество обслуживания клиентов.

В данной статье вы найдете документацию по созданию и настройке IVR меню.


Конференции

Конференции в MikoPBX — это функция, позволяющая организовывать групповые телефонные звонки с участием нескольких абонентов одновременно. Она позволяет проводить коллективные обсуждения, совещания и встречи по телефону, улучшая коммуникацию как внутри компании, так и с внешними партнерами.

В данной статье вы найдете документацию по созданию и настройке комнат конференций.


Звуковые файлы

Звуковые файлы в MikoPBX — это аудиозаписи, которые используются системой для воспроизведения различных сообщений, таких как приветствия, объявления, инструкции в IVR-меню или сигналы ожидания. Они позволяют персонализировать аудиоконтент, который слышат звонящие, улучшая взаимодействие с системой и предоставляя необходимую информацию.

В данной статье вы найдете подробную информацию про них, а так же способы добавления и их редактирования.


История вызовов

История вызовов в MikoPBX — это журнал, который сохраняет информацию о всех входящих и исходящих звонках через систему. Она предоставляет детальные данные о каждом вызове, включая время, длительность, номера участников и статус, что позволяет анализировать коммуникации и оптимизировать работу телефонной сети компании. В данной статье Вы найдете информацию про хранение записей разговоров и их фильтров.

Конференции

Создание и настройка конференций в MikoPBX

Конференции в MikoPBX — это функция, позволяющая организовывать групповые телефонные звонки с участием нескольких абонентов одновременно. Она позволяет проводить коллективные обсуждения, совещания и встречи по телефону, улучшая коммуникацию как внутри компании, так и с внешними партнерами.

Создание конференц-комнат

Список конференц-комнат располагается в разделе "Телефония" -> "Конференции".

Для создания новой конференц-комнаты нажмите кнопку Добавить конференцию.

Необходимо указать название конференции и ее внутренний номер, позвонив на который можно в эту конференцию зайти.

Для того чтобы в конференцию не могли зайти сотрудники, для которых это обсуждение не предназначено, можно защитить конференц-комнату паролем. Для этого заполните поле cr_pinCode. В это поле можно вводить только цифры, минимум одна цифра.

В этом случае для того чтобы попасть в данную конференцию сотруднику после набора номера конференции необходимо будет ввести пин-код.

Характерные особенности конференц-связи

  • Все собеседники общаются только голосом (никаких других способов передачи информации, кроме речевого, не предоставляется);

  • все собеседники могут говорить и слышать друг друга одновременно (то есть обеспечивается дуплексная связь);

  • участники используют для общения телефоны (аппаратные или программные).

Использование

  • Каждый участник конференции звонит на номер конференции. Первый участник слышит музыку на удержании до тех пор, пока к конференции не присоединится хотя бы еще один участник.

  • Сотрудник может перевести своего собеседника в конференцию, реализовав перевод с помощью комбинации стар-кодов на своем телефоне. Перевести в конференцию можно как внутренний номер, так и внешний. Комбинация для переводов задается в разделе "Система" -> "Общие настройки" -> "Переводы вызовов". Пример: Сотрудник набирает комбинацию **1111 (комбинация для безусловного перевода) и его собеседник попадает в конференцию и становится её первым участником. У переводившего сотрудника вызов завершается, и, чтобы попасть в конференцию он звонит на номер конференции 1111.

Максимальное количество участников конференции не ограничено.

Перед началом Вам необходимо скопировать ссылку на актуальный образ MikoPBX с расширением .raw. Сделать это можно на .

Для подключения по SSH следуйте . В данной статье будет пример с использованием powershell (windows).

Перед началом вам необходимо скачать актуальный образ MikoPBX с расширением .raw. Сделать это можно по .

github MikoPBX
Windows
MacOS/Linux
инструкциям
ссылке
Сотрудники
Очереди вызовов
IVR меню
Конференции
Звуковые файлы
История вызовов

Модули

Описание раздела Модули в MikoPBX

Раздел «Модули» в MikoPBX — это интерфейс для управления дополнительными функциональными компонентами системы, который включает два подраздела: «Управление модулями» и «Приложения диалплана».

Управление этими подразделами позволяет настроить MikoPBX максимально гибко и эффективно, расширяя функциональность телефонной системы и адаптируя ее под уникальные требования организации.

Регистрация в маркетплейсе модулей

Регистрация в Маркетплейсе MikoPBX не влияет на базовый функционал системы. Вы можете использовать MikoPBX для работы со звонками без регистрации и установки дополнительных модулей. Однако, Мы рекомендуем пройти процедуру регистрации в маркетплейсе для получения возможности расширения функционала системы.

Регистрация даст вам доступ к дополнительным модулям и расширениям.


Управление модулями

Управление модулями в MikoPBX — это интерфейс для управления дополнительными компонентами системы, расширяющими ее функциональность. Здесь администраторы могут устанавливать, обновлять, включать или отключать модули, добавляя новые возможности или интеграции с внешними сервисами. Этот раздел позволяет адаптировать систему под специфические потребности компании, обеспечивая гибкость и масштабируемость телефонной сети.


Приложения диалпланов

Приложения диалпланов в MikoPBX — это набор инструментов, которые позволяют настраивать индивидуальные сценарии обработки звонков внутри системы. С их помощью вы можете определить последовательность действий, которую система выполнит при поступлении или совершении вызова. Это может включать перенаправление звонка на определенный внутренний номер, воспроизведение специальных аудиосообщений, запрос дополнительной информации у звонящего или выполнение других функций.

Используя приложения диалпланов, вы можете гибко настроить логику работы телефонной системы под потребности вашего бизнеса, не углубляясь в сложное программирование. Это облегчает создание сложных сценариев обработки вызовов, позволяя улучшить эффективность коммуникаций и повысить уровень обслуживания клиентов.

Исходящие маршруты

Описание и настройка исходящей маршрутизации

Исходящие маршруты в MikoPBX — это набор правил и настроек, определяющих, как система обрабатывает исходящие звонки от сотрудников к внешним номерам. С их помощью администраторы могут управлять направлением вызовов через различные провайдеры телефонии или линии связи в зависимости от определенных условий, таких как набранный номер, префиксы, время суток или права доступа пользователя. Это позволяет оптимизировать затраты на связь, распределять нагрузку между каналами и применять политики безопасности, ограничивая или разрешая определенные типы вызовов. Настройка исходящих маршрутов обеспечивает гибкость и контроль над исходящей телефонной связью, способствуя эффективной работе коммуникационной системы компании.

В данной статье Вы найдете подробную документацию по настройке исходящей маршрутизации.

Вы можете создавать неограниченное количество правил исходящей маршрутизации. Для одного провайдера можно создать несколько правил.

Создание правила

Дополнительные примеры настройки исходящей маршрутизации доступны в разделе FAQ.

Шаг 1. Добавление нового правила

Чтобы добавить новое правило исходящей маршрутизации нажмите на кнопку Добавить новое правило.

Шаг 2. Название и заметка

Название правила можно задавать произвольным.

В заметке можно описать маршрут звонка, который хотите реализовать, в дальнейшем это может помочь вам в отладке.

Шаг 3. Задание шаблона номеров

Приведенный на картинке выше пример означает следующее: если набранный номер начинается с "7" или "8", и остальная часть номера состоит 10 цифр.

Если набираемый номер подходит под правила нескольких маршрутов, то вызов будет производится в порядке описания маршрутов, поочередно, пока вызов не будет отвечен, или пока подходящие маршруты не закончатся.

Шаг 4. Преобразование номера

Преобразовать номер - данная настройка предназначена для удаления префикса номера и замены его на нужный префикс.

В приведенном примере в начале номера не отсекаются цифры и не добавляются цифры.

Шаг 5. Выбор провайдера

Выберите из списка провайдера, для которого настроили исходящую маршрутизацию и сохраните изменения.

Примеры

Примеры шаблонов номеров

Номер начинается с
Остальная часть номера состоит из указанного количества цифр
Примеры номеров

[7-8]{1}

10

79257184255, 84952293042

7925

оставьте поле пустым

79257184255, 7925, 7925718…

7ХХ

0

700, 701, 702…

74952293042

0

74952293042

74(95|99)

7

74952293042, 74996382584…

(7|8)0{1}

1

700, 701, 802, 803…

(25|26)

0

25, 26

[0-9]{1}

0

цифра от 0 до 9-ти, вхождение один раз

[1-5]{2}

0

12, 15, 14, 25 цифра от 1 до 5-ти, вхождение два раза

[8-9]+

0

8899, 888, 988888 цифра от 8 до 9-ти, вхождение от одного и более раз

Примеры изменения префиксов номеров

Пример 1. Необходимо заменить префиксы номеров "+7" на "8".

Например, номер +74952293042 должен быть преобразован к номеру 84952293042.

Реализация правила выглядит следующим образом:

Пример 2. Необходимо заменить префиксы номеров "8", "7" на "+7".

Например, номера 84952293042 и 74952293042 должны быть преобразованы к номеру +74952293042.

Реализация правила выглядит следующим образом:

Пример 3. Необходимо добавить префикс "8" к номеру.

Например, номера 4952293042 и 4996382584 должны быть преобразованы к номеру 84952293042 и 84996382584 соответственно.

Реализация правила выглядит следующим образом:

Пример 4. Необходимо удалить код города "8495" или "7495", или "8499", или "7499" и оставлять 7-значный номер.

Например, номера 84952293042 и 74996382584 должны быть преобразованы к номеру 2293042 и 6382584 соответственно.

Реализация правила выглядит следующим образом:

Задайте шаблон для исходящих звонков. Подробнее про шаблоны номеров .

Примеры преобразования номеров приведены , а так же .

Регистрация в маркетплейсе модулей
Управление модулями
Приложения диалпланов
в следующем параграфе
в разделе FAQ
в следующем параграфе

Обновление Docker

Вариант обновления для MikoPBX в Docker контейнере

Для обновления контейнера 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
services:
  mikopbx:
    container_name: "mikopbx"
    image: "ghcr.io/mikopbx/mikopbx-x86-64:latest"
    network_mode: "host"
    cap_add:
      - NET_ADMIN
    entrypoint: "/sbin/docker-entrypoint"
    hostname:  "mikopbx-in-a-docker"
    volumes:
      - data_volume:/cf
      - data_volume:/storage
    tty: true
    environment:
      # Изменение имени станции через переменные окружения
      - PBX_NAME=MikoPBX-in-Docker
      # Изменение стандартного порта SSH на 23
      - SSH_PORT=23
      # Изменение стандартного порта WEB на 8080
      - WEB_PORT=8080
      # Изменение стандартного порта WEB HTTPS на 8443
      - WEB_HTTPS_PORT=8443
      
volumes:
  data_volume:

Сохраните содержимое в файл docker-compose.yml, выполните необходимые корректировки и запускайте командой:

sudo docker compose -f docker-compose.yml up

Примечания

  • Данные: Поскольку данные сохраняются в Docker Volume, они остаются нетронутыми при обновлении, что позволяет сохранить настройки и пользовательские данные.

  • Переменные окружения: Убедитесь, что все необходимые переменные окружения передаются корректно.

  • Безопасность: Перед обновлением всегда рекомендуется создать резервные копии ваших данных.

Эти шаги помогут обеспечить гладкое и безопасное обновление вашего контейнера MikoPBX.

Обслуживание

Описание раздела Обслуживание в MikoPBX

Раздел «Обслуживание» в MikoPBX — это интерфейс для управления техническими аспектами системы и обеспечения ее стабильной работы. Здесь администраторы могут выполнять задачи по резервному копированию и восстановлению данных, обновлению программного обеспечения, мониторингу состояния системы и управлению журналами событий. Этот раздел помогает поддерживать работоспособность телефонной системы, своевременно обнаруживать и устранять возможные проблемы.

Обновление системы

Раздел «Обновление» в MikoPBX — это интерфейс для управления обновлениями программного обеспечения системы. Здесь администраторы могут проверять наличие новых версий, устанавливать обновления и просматривать историю изменений. Регулярное использование этого раздела обеспечивает актуальность, безопасность и стабильность работы MikoPBX.


Диагностика системы

Раздел «Диагностика системы» в MikoPBX — это инструмент для мониторинга и анализа состояния телефонной системы. Здесь администраторы могут просматривать журналы событий, проверять с помощью них статус различных сервисов и компонентов системы, а также выполнять тестирование соединений и вызовов. Использование этого раздела помогает своевременно обнаруживать и устранять технические проблемы, обеспечивая стабильную и эффективную работу MikoPBX.


Перезагрузка и выключение системы

Раздел «Перезагрузка и выключение системы» в MikoPBX — это интерфейс для безопасного управления состоянием телефонной системы через веб-интерфейс. Здесь администраторы могут перезагрузить систему для применения новых настроек или корректно выключить ее для технического обслуживания. Использование этого раздела предотвращает возможные ошибки и обеспечивает стабильную работу MikoPBX. Помимо этого, будет рассмотрена возможность перезагрузки через консоль.

Защита от взлома

В данном разделе производится настройка Fail2ban.

Fail2ban включается вместе с Сетевым экраном переключателем в разделе Сеть и FireWall → Сетевой экран.

Сервис Fail2ban блокирует IP адреса с нестандартной активностью. При неудачной попытке авторизации в лог АТС попадет информация об ошибке, Fail2ban анализирует все неудачные попытки авторизации и считает их. Когда количество неудачных попыток авторизации превышает максимально допустимое количество, IP-адрес отправляется в бан. Fail2ban способен снизить скорость неудачных попыток аутентификации.

Будьте внимательны, Fail2ban не поможет при использовании простых паролей.

Настройки защиты от взлома можно найти в боковом меню:

  • Если происходит определенное число неудачных попыток входа (Количество попыток для блокировки) в течение определенного периода (В течение (секунд)), IP адрес будет заблокирован в течение заданного периода времени (Блокировать на (секунд)).

  • Белый список адресов определяет IP - адреса, которые не будут заблокированы Fail2ban. Указывать можно как ip адрес 93.188.40.10, так и подсеть 93.188.40.10/32. В качестве разделителя используется «пробел».

  • Обратите внимание, что если Вы в разделе «Сетевой экран» для подсети указали настройку «Никогда не блокировать адреса из этой сети», то подсеть автоматом попадает в белый список и добавлять ее вручную не требуется. Не нужно пытаться наполнять вручную список белых IP-адресов, желательно в исключительных случаях прописывать IP-адреса.

Список заблокированных адресов показывает , какие IP-адреса в настоящее время заблокированы.

Так же вы можете разблокировать адрес кликом на соответствующую иконку в таблице

Перезагрузка и выключение системы

Описание возможностей раздела

Перезагрузка станции через интерфейс MikoPBX

Меню выключения/перезагрузки системы вы можете найти в MikoPBX в "Перезагрузка" -> "Обслуживание".

При открытии страницы будет отображен список активных звонков на АТС. Отображается дата начала звонка, «Кто» и «Кому» звонит.

Пока есть активные вызовы перезагрузка и отключение не будут доступны через web интерфейс.

  • «Перезагрузить АТС» - команда начинает перезагрузку станции.

  • «Выключение АТС» - завершает все процессы и отключает станцию.

Перезагрузка станции через консольное меню

Вы можете перезагрузить станцию через консольное меню. Для этого выберете раздел «[3] Перезагрузить систему».

Если вы хотите перезагрузить станцию: нажмите «[1] Перезагрузить MikoPBX».

Если вы хотите выключить станцию: нажмите «[2] Выключить».

Перезагрузка с проверкой диска

В случае аварийной перезагрузки АТС (например, выключение электроэнергии) может потребоваться выполнить проверку диска на ошибки.

В консольном меню АТС введите команду «[9] Консоль(Shell)» и нажмите Enter

Система запустит консоль АТС.

Введите команду Reboot. Нажмите Enter

Система перезагрузится с проверкой диска.

Настройка E-mail уведомлений для почтового сервиса Gmail

Настройка почты для сервиса gmail

  1. Введем IP адрес АТС MikoPBX в браузере и перейдем в Система → Почта и уведомления.

Настройки SMTP клиента для сервиса Gmail:

  • SMTP хост - smtp.gmail.com

  • SMTP Порт - 465 (Порт для обслуживания клиентов)

  • Адрес отправителя и Логин - E-mail с которого будут отправляться сообщения о пропущенных вызовах

  • Пароль - пароль от электронной почты, необходимый для авторизации

  • Метод шифрования - Использовать TLS

  1. Возвращаемся в Система → Почта и уведомления. Осуществим отправку тестового письма на электронную почту любого сервиса. В случае успешного тестирования на указанный Вами адрес электронной почты придет тестовое письмо.

Почта и уведомления

Настройка почты и уведомлений

Раздел «Почта и уведомления» в MikoPBX позволяет настроить отправку системных уведомлений через электронную почту. Здесь администраторы указывают параметры SMTP-сервера, определяют события для уведомлений, такие как голосовые сообщения или системные ошибки, и редактируют шаблоны писем. Этот раздел помогает своевременно информировать пользователей и администраторов о важных событиях, обеспечивая эффективный контроль за работой системы.

Настройка уведомлений для почтовых сервисов:

Подключение к SMTP серверу

Для получения уведомлений о пропущенных вызовах и сообщениях голосовой почты по электронной почте необходимо настроить SMTP-клиент. SMTP (Simple Mail Transfer Protocol) используется для отправки электронной почты через Интернет. SMTP-клиенты взаимодействуют с SMTP сервером, который отправляет электронную почту.

  • SMTP хост - адрес почтового сервера

  • SMTP порт - порт почтового сервера

  • SMTP логин, SMTP пароль - параметры авторизации

  • Адрес отправителя - от имени этого адреса будут отправляться электронные письма

  • Email системного администратора - на этот электронный адрес будут отправляться все системные уведомления, к примеру о нехватке места на диске. При изменении и сохранении настроек на этот адрес будет отправлено тестовое письмо

  • Использовать TLS - активирует использование шифрования при подключении к серверу, для подключения по SSL, необходимо к адресу сервера добавить описание протокола

  • Проверять сертификат сервера - в ряде случаев необходимо отключить, при использовании самоподписанных сертификатов

  • Использовать оповещения - позволяет включить / отключить все оповещения на email, включая голосовую почту

Если сервер поддерживает защищенное соединение только по SSL, то можно явно указать протокол в поле «SMTP хост», к примеру

Оповещения о пропущенных

Существует возможность настроить адрес и шаблон оповещения о пропущенных вызовах:

  • Тема, текст, подвал письма могут содержать параметры в виде ИМЯ_ПАРАМЕТРА

Список доступных «параметров»:

  • NOTIFICATION_MISSEDCAUSE - на текущий момент всегда принимает значение «NOANSWER», т.е. пропущенный вызов

  • NOTIFICATION_CALLERID - от кого был вызов

  • NOTIFICATION_TO - кому был вызов

  • NOTIFICATION_DURATION - длительность в секундах

  • NOTIFICATION_DATE - дата вызова

Голосовая почта

Существует возможность настроить адрес и шаблон оповещения о голосовой почте:

  • Голосовая почта будет отправлена каждому сотруднику, кто пропустил вызов (если email указан в его карточке).

  • Голосовая почта всегда будет отправлена на «Единый Email для отправки сообщений голосовой почты»

В теме, теле и подвале email можно использовать следующие «параметры»:

  • VM_DATE - дата и время

  • VM_CALLERID - callerid звонящего, состоит из name и num, пример «Alexey Portnov» <101>

  • VM_DUR - длительность сообщения

  • VM_CALLER_NAME - имя звонящего (берется из VM_CALLERID)

  • VM_CALLER_NUM - номер телефона звонящего (берется из VM_CALLERID)

Чтобы указать параметр, нужно использовать конструкцию вида ИМЯ_ПАРАМЕТРА.

Нажмите Сохранить для завершения настройки.

Всегда используйте «Пароли приложений» для авторизации. . smtp от Gmail

Для получения уведомлений о пропущенных вызовах по электронной почте необходимо настроить SMTP-клиент. Подробная информация об уведомлениях в MikoPBX рассмотрена . В рамках данной инструкции будет рассмотрен пример настройки уведомлений о пропущенных вызовах для почтового сервиса Gmail.

Сохраним введённые настройки и перейдем к настройке Вашего почтового аккаунта. Особенностью сервиса Gmail является то, что к Вашему аккаунту автоматически запрещен доступ ненадежным приложениям, к которым относится MikoPBX, поэтому необходимо вручную разрешить доступ к данным приложениям (инструкции по настройке размещены ).

О том, как настроить шаблон письма для создания E-mail уведомления вы можете прочитать .

Email для уведомлений о пропущенных - по умолчанию, уведомления о пропущенных отправляются на email, указанный в . Если вызов не удается сопоставить с сотрудником или email не указан, то вызов будет направлен на этот «общий» адрес

Прослушать запись голосовой почты возможно из АТС

Обновление системы
Диагностика системы
Перезагрузка и выключение системы
ssl://smtp.gmail.com
См. инструкции
Инструкции по настройке
здесь
здесь
здесь
Gmail
Yandex
M
ail.ru
карточке сотрудника
истории звонков

Кастомизация системных файлов

Описание возможностей раздела "Кастомизация системных файлов"

Раздел «Кастомизация системных файлов» в MikoPBX предоставляет администраторам возможность напрямую изменять или дополнять стандартные конфигурационные файлы системы. Здесь вы можете внести индивидуальные настройки, которые не доступны через стандартный веб-интерфейс, и адаптировать поведение системы под специфические требования вашей организации.

С его помощью можно:

  • Редактировать конфигурационные файлы: вносить изменения в существующие файлы или добавлять новые параметры.

  • Переопределять стандартные настройки: изменять значения по умолчанию для определенных функций или модулей.

  • Добавлять собственные скрипты или модули: расширять функциональность системы путем интеграции пользовательских решений.

Он находится в Система -> Кастомизация системных файлов:

Важно отметить, что неправильное изменение системных файлов может привести к нестабильной работе или сбоям системы. Поэтому рекомендуется создавать резервные копии перед внесением изменений и тщательно проверять корректность настроек.

Мы рекомендуем использовать возможности данного раздела только опытным администраторам Asterisk. В MikoPBX есть возможность из web-интерфейса изменять следующие конфигурационные файлы:

Наименование файла

Описание

asterisk.conf

Общие (глобальные) настройки Asterisk. В файле конфигурации asterisk.conf Вы определяете следующее: -Местоположение, права доступа и владельца сокета, которые используется для подключения удаленной консоли управления сервером. Местоположение различных директорий, используемых сервером Asterisk для определения местоположения файлов конфигурации, библиотек, скриптов и место, где будут создаваться лог фалы. Параметры командной строки запуска сервера, используемые по умолчанию.

cel.conf

Лог событий канала. В отличии от CDR, сохраняет все события имевшие место в канале.

extensions.conf

План набора (dialplan) Asterisk. В нем определяется обработка и маршрутизация входящих и исходящих вызовов. Этот файл управляет поведением всех соединений, проходящих через Вашу АТС.

features.conf

В файле назначаются пользовательские коды и опции абонентских функций Asterisk, такие как: перевод вызова (transfer); перехват вызова (pickup); запись по требованию (record on demand); таймауты набора и переадресации (digit timeout); паркинг (park) и др.

http.conf

Встроенный http сервер Asterisk

iax.conf

В файле Вы описываете ваши соединения по протоколу IAX.

indications.conf

Национализация тональных сигналов

logger.conf

Настройка логов Asterisk. В данном файле настраивается логирование событий Asterisk в файлы, консоль и syslog linux. Для применения настроек выполните команду «logger reload» в консоли (CLI) Asterisk.

manager.conf

Настройка интерфейса AMI (Asterisk Manager Interface)

modules.conf

Параметры загрузки модулей Asterisk.

musiconhold.conf

Параметры музыки на удержание в IVR

queues.conf

Очередь входящих вызовов Asterisk. Подробное описание стратегии вызовов. Penalty, timeout, member и все доступные параметры.

rtp.conf

Глобальные настройки RTP - медиа-портов и протокола

sip.conf

Файл отвечает за настройку внутренних и внешних каналов SIP в Asterisk.

voicemail.conf

Настройки уведомлений по E-mail

jail.local

Настройки Fail2ban

msmtp.conf

Настройки SMTP-клиента

Перед Вами будет открыта форма редактирования конфигурационного файла:

Выберите один из четырех возможных вариантов редактирования:

  • «Не менять» - не позволяет вносить изменения в файл, только чтение файла.

  • «Добавлять в конец файла» - в конец выбранного конфигурационного файла будут добавлены (рекомендуемый).

  • «Заменять полностью» - все Ваши изменения переопределят конфигурационный файл.

  • Режим "Script" - читайте далее.

Кастомизация системных файлов скриптом

Существуют сценарии, когда нужно выполнить более сложные модификации системных файлов, чем простое добавление текста в конец конфигурационного файла. Например, нужно выполнить переопределение параметров PJSIP учетных записей, но хочется сохранить возможность настройки системы через веб интерфейс.

Реализован новый подход к кастомизации. Можно описать bash скрипт, который будет выполняться каждый раз после того, как система сформирует конфигурационный файл. В итоге интегратор сможет делать очень тонкие изменения конфигурационных файлов без разработки дополнительных модулей.

Например, мы хотим поменять значение max_contacts у всех сотрудников, кроме одного.

sip.conf

Добавить параметры к существующей секции возможно используя конструкцию (+):

[general](+)
allowtransfer=yes

Описать новую секцию можно в произвольной форме, единственное, не следует допускать повторения имен секций: Пример:

[user2_pingtel]
type=friend
username=user2_pingtel
secret=blah
host=dynamic
qualify=1000 ; Рассматриваем клиента как неработающего,
; если ответ от него идет более 1 сек.
callgroup=1,3-4 ; Клиент является членом групп вызовов: 1, 3 и 4
pickupgroup=1,3-4 ; Мы можем совершать "pick-up" вызовов, нажатием *8,
; для вызовов из групп 1, 3 и 4
defaultip=192.168.0.60
disallow=all
allow=ulaw
allow=alaw
allow=g729

extensions.conf

Дорабатывайте dialplan с осторожностью - есть большая вероятность нарушить работу АТС!

Существует возможность перехватить выполнения dialplan. Для этого необходимо описать custom контексты. На текущий момент можно перехватить выполнения в следующих контекстах:

  • internal-originate-custom - контекст используется при звонках из панели телефонии для 1С

  • <ID-ПРОВАЙДЕРА>-incoming-custom - контекст предназначен для обработки входящих вызовов через провайдера

  • <ID-ПРОВАЙДЕРА>-outgoing-custom - контекст предназначен для обработки исходящих вызовов через провайдера

  • all_peers-custom - контекст используется при прямом исходящем звонке с телефона

  • outgoing-custom - контекст используется при наборе внешнего номера, ДО выбора исходящего маршрута

  • add-trim-prefix-clid-custom - этот контекст используется при обработке входящих вызовов, лучшим образом подходит для нормализации входящего номера телефона, добавить / отсечь префикс

  • internal-users-custom - в этом контексте обрабатываются вызовы на внутренние номера

  • public-direct-dial-custom - контекст обработки входящих вызовов БЕЗ авторизации

Пример контекста:

[outgoing-custom]
exten => _X!,1,NoOp(--- hangup - ${CHANNEL} ---)
	same => n,return

Обязательно следует в конце вызывать метод «return».

Некоторые примеры использования custom-контекстов:

  • Настройка исходящего AOH для сотрудника

Для редактирования конфигурационного файла воспользуйтесь кнопкой:

Звонок через определённого провайдера

Общие настройки

Описание настроек основных параметров системы

В данном разделе производится настройка основных параметров системы. Данные параметры рекомендуется настраивать сразу после установки АТС.

Основные

  • Название PBX системы - будет отображаться на главной странице MikoPBX

  • Дополнительное описание - будут видеть только администраторы системы.

  • Язык звуковых сообщений - укажите язык оповещений

  • Длина внутреннего номера - максимальная длина внутреннего номера (для сотрудников)

  • Максимальный таймаут между цифрами при вводе добавочного

  • Перезапускать АТС каждую ночь - рестарт asterisk каждую ночь

  • Отправлять разработчикам информацию о сбоях - при возникновении ошибки, ее описание будет выслано разработчикам (требуется доступ в интернет)

Запись разговоров

  • Запись разговоров - позволяет включить / отключить запись

  • Запись внутренних разговоров - позволяет включить / отключить запись внутренних разговоров

  • Сохранять записи разговоров в стерео режиме изменяет режим записи с mono на stereo. Поток записи будет разделен на входящий и исходящий и объединен в стерео файл.

Имеется слайдер, с помощью которого можно выбрать сколько будут храниться записи разговоров.

Так же можно выбрать звуковой файл для предупреждения о записи разговоров.

Телефонные звонки сохраняются в формате mp3. Пример информации об итоговом файле записи разговора:

Input File     : 'mikopbx-1554098285.0_M1gEr1pgrt.mp3'
Channels       : 1
Sample Rate    : 8000
Precision      : 16-bit
Duration       : 00:00:17.64 = 141120 samples ~ 1323 CDDA sectors
File Size      : 70.6k
Bit Rate       : 32.0k
Sample Encoding: MPEG audio (layer I, II or III)

Ориентировочно, 1 час разговора занимает 14Мб места на диске.

Переводы вызовов

Парковка (Удержание)

Парковка - это вариант «удержания» клиента на линии. Полезно использовать в том случае, когда необходимо временно разъединиться с клиентом для уточнения некоторой информации. Клиенту во время парковки будет проигрываться мелодия.

В MikoPBX возможно два варианта парковки вызова от клиента:

  1. Если вам необходимо запарковать вызов клиента, введите *2. Вызов клиента MikoPBX поставит на удержание, а Вам сообщит номер слота припаркованного вызова. Любой сотрудник может забрать вызов, набрав с телефона номер слота припаркованного вызова.

  2. В разделе Переводы вызовов задайте номер для парковки. При переадресации вызова клиента на номер парковки, MikoPBX поставит такой вызов на удержание, а Вам сообщит номер слота припаркованного вызова. Любой сотрудник может забрать вызов, набрав с телефона номер слота припаркованного вызова.

Диапазон номеров слота припаркованного вызова можно задать в разделе Переводы вызовов: Начальный парковочный слот и Конечный парковочный слот.

Переводы вызовов

MikoPBX предлагает два вида переводов: Условный и Безусловный (слепой).

  • При использовании условного перевода Вы можете поговорить с человеком прежде, чем переадресовать вызов. Вызывающий абонент находится в это время на удержании. После того как человек, который переадресовывает вызов, вешает трубку, переадресация успешно завершается.

  • Если вы переведете вызов, не поговорив предварительно с коллегой, то этот перевод Безусловный. Например, если вам поступает второй входящий звонок, а Вы уже разговариваете по телефону. Чтобы не прерывать текущий вызов, Вы переводите новый вызов на свободного коллегу.

  • По умолчанию комбинация для условного перевода - две решетки

  • По умолчанию комбинация для безусловного перевода - две звездочки

Таймауты

Время возврата вызова если нет ответа после безусловного (слепого) перевода - 45 сек.

Перехват (Pickup)

Если звонит телефон коллеги, то есть возможность перехватить вызов набрав *8<НомерКоллеги>. Если номер коллеги не известен, то можно просто набрать *8.

SIP

Session Initiation Protocol (SIP) является сигнальным протоколом, используемым большинством телефонов VoIP. Вы можете изменить SIP-порт(по умолчанию порт 5060) для повышения безопасности. Кроме того, некоторым SIP провайдерам необходимы дополнительные параметры, такие как Периоды регистрации (Время через которое регистрация будет сброшена). Некоторые брандмауэры закрывают порты после периода неактивности. Такое поведение может потребовать сократить время ожидания регистрации SIP провайдеров. Другой причиной может быть необходимость в различных тайм-аутах при регистрации некоторых SIP-провайдеров. Значения по умолчанию:

  • SIPMiniExpiry - минимальная продолжительность регистрации в секундах, по умолчанию 60 секунд;

  • SIPMaxExpiry - максимальная продолжительность регистрации в секундах, по умолчанию 3600 секунд.

В режиме реального времени Transport Protocol (RTP) определяет стандартный формат для передачи аудио и видео по IP-сетям. По умолчанию, RTP использует диапазон портов между 10000 и 10200. Для некоторых маршрутизаторов и брандмауэров, возможно, потребуется настроить диапазон портов. Еще одна причина для настройки диапазона портов - большое количество параллельных звонков. Каждый вызов использует два RTP порта. Это означает,что если есть 200 портов, то возможно только 100 параллельных звонков. Если ваша телефонная система должна обрабатывать больше звонков в одно и то же время, необходимо расширить диапазон портов.

  • «Адрес STUN сервера» - в ряде случаев, к примеру при использовании WebRTC помогает при работе АТС за NAT.

  • «Использовать WebRTC» - будут произведены дополнительные настройки для работы с WebRTC соедиением. К примеру для внутреннего номера 201 будет создан дополнительный endpoint, подключиться к которому будет возможно по протоколу WebRTC с использованием URL sip:201-WS@IP_PBX

Аудио/видео кодеки

Настройка разрешенных кодеков для АТС в целом.

AMI&AJAM

Asterisk Manger Interface (AMI) — мощный и удобный программный интерфейс (API) Asterisk для управления системой из внешних программ. Благодаря AMI внешние программы могут осуществлять соединения с Asterisk посредством TCP протокола, инициировать выполнение команд, считывать результат их выполнения, а так же получать уведомления о происходящих событиях в реальном времени. AMI часто используют для интеграции с бизнес-процессами и системами, программным обеспечением CRM (Customer Relationship Managment — управление взаимодействия с клиентами). AMI принимает подключения, устанавливаемые на сетевой порт (по умолчанию - TCP порт 5038). Клиентская программа подключается к AMI через этот порт и аутентифицируется, после этого Asterisk будет отвечать на запросы, а также отправлять извещения о изменениях состояния заданных подсистем. Asynchronous Javascript Asterisk Manager (AJAM) - это новая технология, которая позволяет веб-браузерам или другим приложениям с поддержкой HTTP и веб-страницам напрямую обращаться к интерфейсу Asterisk Manager (AMI) через HTTP/HTTPS. По умолчанию используется порт 8088.

SSH

SSH или Secure Shell — это зашифрованный протокол, который часто используется для взаимодействия и удаленного управления серверами. SSH сервер может выполнять аутентификацию пользователей с помощью различных алгоритмов. Самый популярный — это аутентификация по паролю. Он достаточно прост, но не очень безопасный. Пароли передаются по безопасному каналу, но они недостаточно сложны для противостояния попыткам перебора. Вычислительная мощность современных систем в сочетании со специальными скриптами делают перебор очень простым.

Авторизация через SSH-клиент по умолчанию в MikoPBX:

  • Логин - root

  • Пароль - admin, рекомендуем сразу изменить это значение

Существует более безопасный и надежный способ аутентификации — ключи SSHа. Каждая пара ключей состоит из открытого и закрытого ключа. Секретный ключ сохраняется на стороне клиента и не должен быть доступен кому-либо еще. Утечка ключа позволит злоумышленнику войти на сервер, если не была настроена дополнительная аутентификация по паролю.

Мы настоятельно рекомендуем отключить аутентификацию по паролю. Для этого активируйте опцию «Отключить авторизацию по паролю»

Открытый ключ используется для шифрования сообщений, которые можно расшифровать только закрытым ключом. Это свойство и используется для аутентификации с помощью пары ключей. Открытый ключ загружается на удаленный сервер, к которому необходимо получить доступ. Его нужно добавить в специальный файл ~/.ssh/authorized_keys.

Когда клиент попытается выполнить проверку подлинности через этот ключ, сервер отправит сообщение, зашифрованное с помощью открытого ключа, если клиент сможет его расшифровать и вернуть правильный ответ — аутентификация пройдена.

Публичный(открытый) SSH-ключ можно сохранить на АТС в поле SSH Authorized Keys. Если у Вас несколько публичных ключей, то их можно скопировать подряд, разделитель - пустая строка.

Web-интерфейс

В данном подразделе для повышения безопасности Вы можете изменить HTTP-порт (по умолчанию порт 80) или активировать режим HTTPS. HTTPS (HyperText Transfer Protocol Secure) — расширение протокола HTTP для поддержки шифрования в целях повышения безопасности. Данные в протоколе HTTPS передаются поверх криптографических протоколов SSL или TLS. В отличие от HTTP с TCP-портом 80, для HTTPS по умолчанию используется TCP-порт 443.

  • Редирект на HTTPS - при попытке открыть web интерфейс по протоколу http пользователь будет переадресован на HTTPS

При начале работы системы АТС сама генерирует сертификат для работы по https - это «самоподписанный» сертификат, то есть не заверенный публичным «регистратором», но тем не менее этот сертификат позволяет работать по https и шифровать трафик между АТС и браузером.

Пароль web интерфейса

В данном подразделе необходимо изменить Логин WEB-интерфейса и Пароль WEB-интерфейса.

Авторизация в MikoPBX по умолчанию:

  • Логин - admin

  • Пароль - admin

Удаление настроек системы

Тонкая настройка firewall

При публикации АТС на публичном IP адресе возникает задача по защите АТС от сканеров, вредителей, кто пытается подобрать пароли к SIP учетным записям АТС. Если установлен простой числовой пароль, то он будет подобран очень быстро, что повлечет убытки.

Для базовой защиты от сканеров обязательно следует включить fail2ban. Дополнительно, можно более тонко настроить правила iptables.

  1. Перейдите в раздел "Кастомизация системных файлов"

  1. Перейдите к редактированию файла /etc/firewall_additional

  1. Установите режим "Добавлять в конец файла", вставьте следующий код:

Добавленное правило позволит блокировать все входящие запросы по UDP протоколу, которые содержат подстроку «friendly-scanner»

Более полный пример набора правил:

Это обезопасит от большинства сканеров, которые при запросе упоминаю User-Agent.

Накладываем ограничение на 30 запросов в 1 секунду.

Как создать ключ для авторизации по SSH и добавить его на сервер? Подробности читайте .

Вы можете использовать модуль для создания самоподписанного сертификата.

здесь
Let's encrypt
iptables -I INPUT 2 -p udp -m udp --dport 5060 -m string --string 'friendly-scanner' --algo bm --to 65535 -j DROP
iptables -I INPUT 2 -p udp -m udp --dport 5060 -m string --string 'sipcli' --algo bm --to 65535 -j DROP
iptables -I INPUT 2 -p udp -m udp --dport 5060 -m string --string 'sip-scan' --algo bm --to 65535 -j DROP
iptables -I INPUT 2 -p udp -m udp --dport 5060 -m string --string 'iWar' --algo bm --to 65535 -j DROP
iptables -I INPUT 2 -p udp -m udp --dport 5060 -m string --string 'sipvicious' --algo bm --to 65535 -j DROP
iptables -I INPUT 2 -p udp -m udp --dport 5060 -m string --string 'sipsak' --algo bm --to 65535 -j DROP
iptables -I INPUT 2 -p udp -m udp --dport 5060 -m string --string 'sundayddr' --algo bm --to 65535 -j DROP
iptables -I INPUT 2 -p udp -m udp --dport 5060 -m string --string 'VaxSIPUserAgent' --algo bm --to 65535 -j DROP
iptables -I INPUT 2 -p udp -m udp --dport 5060 -m string --string 'friendly-scanner' --algo bm --to 65535 -j DROP

iptables -I INPUT 2 -p tcp -m tcp --dport 5060 -m string --string 'sipcli' --algo bm --to 65535 -j DROP
iptables -I INPUT 2 -p tcp -m tcp --dport 5060 -m string --string 'sip-scan' --algo bm --to 65535 -j DROP
iptables -I INPUT 2 -p tcp -m tcp --dport 5060 -m string --string 'iWar' --algo bm --to 65535 -j DROP
iptables -I INPUT 2 -p tcp -m tcp --dport 5060 -m string --string 'sipvicious' --algo bm --to 65535 -j DROP
iptables -I INPUT 2 -p tcp -m tcp --dport 5060 -m string --string 'sipsak' --algo bm --to 65535 -j DROP
iptables -I INPUT 2 -p tcp -m tcp --dport 5060 -m string --string 'sundayddr' --algo bm --to 65535 -j DROP
iptables -I INPUT 2 -p tcp -m tcp --dport 5060 -m string --string 'VaxSIPUserAgent' --algo bm --to 65535 -j DROP
iptables -I INPUT 2 -p tcp -m tcp --dport 5060 -m string --string 'friendly-scanner' --algo bm --to 65535 -j DROP
iptables -I INPUT 2 -p udp -m state --state NEW -m recent --set --name SipAttacks --mask 255.255.255.255 --rsource -m udp --dport 5060
iptables -I INPUT 2 -p udp -m state --state NEW -m recent --update --seconds 1 --hitcount 30 --name SipAttacks --mask 255.255.255.255 --rsource -m udp --dport 5060 -j DROP
iptables -I INPUT 2 -p tcp -m state --state NEW -m recent --set --name SipAttacks --mask 255.255.255.255 --rsource -m tcp --dport 5060
iptables -I INPUT 2 -p tcp -m state --state NEW -m recent --update --seconds 1 --hitcount 30 --name SipAttacks --mask 255.255.255.255 --rsource -m tcp --dport 5060 -j DROP
iptables -I INPUT 2 -p tcp -m state --state NEW -m recent --set --name SipAttacks --mask 255.255.255.255 --rsource -m tcp --dport 5061
iptables -I INPUT 2 -p tcp -m state --state NEW -m recent --update --seconds 1 --hitcount 30 --name SipAttacks --mask 255.255.255.255 --rsource -m tcp --dport 5061 -j DROP

Обслуживание

Мониторинг провайдеров на MikoPBX

При работе с поставщиками услуг связи периодически могут возникать проблемы. К примеру сервер поставщика не отвечает / не доступен. В рамках данной статьи будет предложен механизм оповещения на email системного администратора.

  1. Укажите название - например, Provider Monitoring, короткий номер для приложения, к примеру 99, а так жу выберите «Тип кода» - «PHP AGI Скрипт»

  1. Перейдите во вкладку "Программный код":

  1. Вставьте код:

<?php
use MikoPBX\Common\Models\PbxSettings;
use MikoPBX\Common\Models\LanInterfaces;
use MikoPBX\Core\System\Notifications;
use MikoPBX\PBXCoreREST\Lib\SIPStackProcessor;

require_once 'Globals.php';

$result = SIPStackProcessor::callBack(['action' => 'getRegistry']);
$adminMail = null;
$localIP = '';
$message = '';
foreach ($result->data as $provider) {
    if ($provider['state'] !== 'OFF' && $provider['state'] !== 'REGISTERED') {
        if ($adminMail === null) {
            $adminMail = PbxSettings::getValueByKey('SystemNotificationsEmail');
            $interfaces = LanInterfaces::find("disabled='0'");
            foreach ($interfaces as $interface) {
                if (!empty($interface->ipaddr)) {
                    $localIP = $interface->ipaddr;
                    break;
                }
            }
        }
        $message .= "Provider state: {$provider['state']}<br>" . "Url (local): ']} <br><br>";
    }
}

if (!empty($message) && !empty($adminMail)) {
    $notify = new Notifications();
    try {
        $notify->sendMail($adminMail, 'Provider invalid state...', $message);
    } catch (\Throwable $e) {
    }
}
  1. Сохраните изменения и скопируйте идентификатор приложения из адресной строки браузера, он имеет вид «DIALPLAN-APP-9С060381»

  1. Перейдите в раздел Система → Кастомизация системных файлов, откройте для редактирования файл /var/spool/cron/crontabs/root

  1. Выберите режим «Добавлять в конец файла», внизу в черное поле для редактирования вставьте следующий код:

Скорректируйте имя файла согласно вашему идентификатору приложения «DIALPLAN-APP-9С060381»

*/5 * * * * /usr/bin/php -f /var/lib/asterisk/agi-bin/DIALPLAN-APP-9С060381.php start > /dev/null 2> /dev/null 

Сохраните изменения.

Готово!

Изменить имя для авторизации

При настройке SIP Клиентов часто можно увидеть два ключевых параметра:

  1. Username - обычно равен ID учетной записи, в случае с MikoPBX равен внутреннему номеру

  2. Auth Username - имя пользователя для авторизации. В случае MikoPBX равен внутреннему номеру

Для изменения имени авторизации:

  1. Откройте учетную запись сотрудника на редактирование

  1. Перейдите к «Расширенным настройкам» → «Дополнительные параметры SIP»

  1. Добавьте следующие строчки:

Вместо MIKO204 укажите имя для авторизации, желательно использовать и буквы и цифры

Для работы оповещений потребуется настроить SMTP клиент. См. инструкции в разделе «»

Создайте новое «».

При добавлении на АТС нового на АТС заводится учетная запись SIP с числовым внутренним номером. В ряде случаев, в целях безопасности есть необходимость изменить имя для авторизации этого сотрудника.

Почта и уведомления
Приложение диалплан
а
[auth] 
username = MIKO204
Сотрудника
Раздел "Кастомизация системных файлов"
Меню кастомизации системного файла /acl.conf (пример)
Кастомизация файлов "скриптом"
Раздел "Общие настройки" в MikoPBX
Раздел "Основные" в настройках
Раздел "Запись разговоров" в настройках
Раздел "Переводы вызовов" в настройках
Раздел "SIP" в настройках
Раздел "Аудио/Видео кодеки" в настройках
Раздел "AMI&AJAM" в настройках
Раздел "SSH" в настройках
Раздел "Web-интерфейс" в настройках
Раздел "Пароль WEB интерфейса" в настройках
Раздел "Удаление настроек системы" в настройках
Раздел "Кастомизация системных файлов"
Файл "/etc/firewall_additional"
Код для файла "/etc/firewall_additional"
Создание нового приложения диалплана
Параметры диалплана
Раздел "Программный код"
Идентификатор приложения диалплана
Необходимый файл для редактирования
Раздел "Сотрудники"
Расширенные настройки сотрудника
Дополнительные параметры
Интерфейс MikoPBX
IP-адрес MikoPBX для подключения к WEB-интерфейсу
Страница авторизации в web-интерфейс
Первая авторизация в WEB-интерфейс MikoPBX
Стартовое окно ImageUSB
Руководство по записи образа на флэш-накопитель
Список всех подключенных дисков
Элемент "Create a New Virtual Machine"
Выбор типа создаваемой виртуальной машины
Выбор источника установки системы для создаваемой виртуальной машины
Выбор операционной системы и версии для создаваемой виртуальной машины
Указание названия и пути для создаваемой виртуальной машины
Указание параметров для системного жесткого диска для создаваемой виртуальной машины
Итоговая конфигурация создаваемой машины.
Раздел настроек виртуальной машины
Кнопка для добавления нового элемента системы
Выбор типа нового элемента системы
Выбор типа диска
Выбор параметра "Create a new virtual disk"
Указание параметров для создаваемого диска
Название для второго жесткого диска
Настройка сетевого интерфейса
Кнопка для запуска виртуальной машины
Загруженная MikoPBX с оптического диска
Выбор диска для системы
Выбор диска для хранения записей разговоров
Успешно установленная MikoPBX
IP-адрес MikoPBX
Страница авторизации в WEB-интерфейс MikoPBX
Имя, Тип и Версия виртуальной машины
Размер оперативной памяти и памяти для системного жесткого диска
Тип контроллера и тип адаптера
Раздел "Boot options"
Загрузка образа системы
IP-адрес MikoPBX
Окно входа в веб-интерфейс
MikoPBX создание загрузочного диска в Yandex Cloud
Cover

AWS подробная инструкция

Подробная инструкция по созданию AMI образа

Cover

AWS Маркетплейс

Инструкция по установке готового образа из AWS Marketplace

Cover

Google Cloud Маркетплейс

Инструкция по установке готового образа из Google Cloud Маркетплейс

Cover

Google Cloud подробная инструкция

Подробная инструкция по загрузке MikoPBX из образа на основе .vhd файла из дистрибутива

Cover

Установка докера и cоздание пользователя и каталогов

Команды для установки Docker и Docker Compose и настройка перед созданием контейнера

Cover

Запуск MikoPBX в контейнере

Инструкции по запуску готового контейнера MikoPBX, созданию контейнера из произвольного образа и его запуску

Cover

Запуск MikoPBX с помощью docker compose

Инструкции по запуску нескольких MikoPBX на одном хосте с помощью docker compose

OSS Консоль
Раздел "Buckets"
Элемент "Create bucket"
Параметры Bucket'а
Созданный bucket
Элемент "Upload object"
Ссылка на файл образа диска
Раздел "Images"
Элемент "Import Image"
Параметры импорта образа
Раздел "Key Pairs"
Элемент "Create SSH Key Pair"
Параметры создаваемой связки ключей
Раздел "Security Groups"
Элемент для создания новой группы правил
Параметры группы правил
Раздел "Instances"
Элемент "Create Instance"
Параметры виртуальной машины №1
Параметры виртуальной машины №2
Параметры сети
Элемент "Create Order"
Переход к созданной виртуальной машине
Элемент "Connect"
VNC консоль
Команда для ssh-подключения
SSH-подключение
Важные параметры для авторизации в web-интерфейс
WEB-интерфейс MikoPBX
Раздел "Object Storage"
Элемент "Add Object Storage"
Название хранилища
Новый Bucket
Данные для S3-подключения
"New Site"
Параметры авторизации
Загрузка файла в хранилище
Директория Bucket'а
Разрешение доступа
Элемент "Copy URL"
Раздел "ISOs"
Элемент "Add ISO"
Элемент "Add SSH Key"
Добавление связки
Раздел "Compute"
Элемент "Deploy Server"
Параметры ВМ №1
Параметры ВМ №2
Раздел "Block Storage"
Элемент "Add Block Storage"
Элемент "Attach to"
Меню управления виртуальной машиной
Элемент для открытия консоли
Встроенная консоль
Выбор системного диска
Элемент "Remove ISO"
IP-адрес станции
ID виртуальной машины
web-Интерфейс MikoPBX
Загрузка звуковых файлов в MikoPBX
Запись файла с помощью микрофона
Раздел "Интерактивные голосовые меню - IVR"
Создаение нового IVR (Интерактивного голосового меню)
Настройка действия при донаборе
Настройки IVR
Статусы сотрудников
Поиск сотрудника по электронной почте
Сортировка сотрудников и функции в главном меню
Элемент "Добавить сотрудника"
Вкладка параметров учетной записи сотрудника
Вкладка расширенных настроек учетной записи
Раздел "Настройки маршрутизации"
Раздел "Очереди вызовов"
Элемент "Создать новую очередь"
Параметры для новой очереди вызовов
Раздел "Операторы очереди"
Расширенные настройки очереди
Раздел "Настройки очереди для операторов"
НАстройки очереди для вызывающего абонента
Раздел "Маршрутизация звонков при сбоях"
Раздел "Входящие маршруты" в MikoPBX
Настройка приоритета правил маршрутизации
Маршрут по умолчанию
Несколько маршрутов для одного провайдера
Элемент "Добавить новое правило"
Параметры обработки входящих
Переадресация вызова
Время в секундах, после которого вызов будет направлен на следующее правило
Раздел "Провайдеры телефонии"
Переключение статуса провайдера
Опции подключения нового провайдера
Общие настройки SIP-провайдера
Вкладка "Расширенные настройки" SIP провайдера
Поле "Дополнительные адреса провайдера"
Поле "Порт соединения SIP"
Поле "Транспортный протокол"
Поле "outbound proxy"
Режим NAT
Подраздел "Поддерживать NAT сессию"
Подраздел "Переопределение SIP заголовка FROM"
Поля "User" и "Domain"
Дополнительные параметры провайдера
Кнопка "Сохранить"
Раздел "Звуковые файлы"
Элемент "Добавить новый звуковой файл"
Кнопка для загрузки новых файлов
Имя файла записи
Запись файла с помощью микрофона, используя протокол https
Вкладка "Музыка на удержании"
Раздел "История вызовов"
Помеченные пропущенные вызовы в журнале
Прослушивание и скачивание вызовов
Рашсиренная история вызова
Отбор по номеру телефона
Отбор по двум номерам телефона (кто звонил, кому звонил)
Отбор по дате вызова
Отбор по linkedid
Раздел "Маршрутизация" в MikoPBX
Раздел "Модули" -> "Маркетплейс модулей"
Раздел Маркетплейса, в случае, если не выполнена регистрация
Кнопка "Регистрация в маркетплейсе" в разделе "Модули" -> "Маркетплейс"
Лицензионный ключ
Регистрационная форма для маркетплейса
Успешная регистрация в маркетплейсе
Элемент "Управление лицензией"
Страница "SaaS сервер лицензирования"
Введённый лицензионный ключ
Система SaaS
Раздел "Монитор сессий"
Информация о хосте
Сброс лицензии на хосте.
Раздел "Маркетплейс модулей"
Все установленные модули
Кнопка "Загрузить новый модуль"
Переход в настройки модуля
Включение/отключение модуля
Быстрый переход к документации по модулю
Модули в быстром доступе
Переход в настройки модуля
Параметры модуля
Параметры отображения модуля в боковом меню
Раздел "Маркетплейс"
Кнопка для установки модуля
Карточка модуля
Раздел "История версий"
Раздел "Модули" -> "Маркетплейс модулей"
Активация купона
Раздел "Нерабочее время" в MikoPBX
Создание нового правила нерабочего времени
Форма создания нового правила
Параметр "Применять только к определённым маршрутам"
Раздел "Ограничения по маршрутам"
Пример правила №1
Пример правила №2
Встроенные приложения диалпланов
Элемент для создания нового приложения диалплана
Раздел конфигурации нового приложения диалплана
Вкладка "Программный код"
Раздел "Диагностика системы" в MikoPBX
3 вкладки в разделе
Вкладка "Просмотр логов"
Фильтры для просмотра логов
Вкладка "Информация о системе"
Вкладка "Захват сетевых пакетов"
Элемент для начала фиксации сетевых пакетов
Кнопка остановки захвата сетевых пакетов
Место сохранения сетевых пакетов
Элемент для скачивания всех системных логов
Cover

Обновление онлайн из web-интерфейса

Через web-интерфейс MikoPBX, используя встроенный механизм обновлений

Cover

Обновление из консоли MikoPBX

Из консоли MikoPBX командой для загрузки и установки новой версии

Cover

Обновление Docker

Путём скачивания последнего образа контейнера MikoPBX и перезапуска с новым образом

iso-образ в репозитории релизов MikoPBX
Выбор файла диска в интерфейсе VirtualBox
Консоль MikoPBX
Установка обновления
Обновленная версия
Раздел "Система" в MikoPBX
Раздел "Сетевые интерфейсы"
Локальное имя хоста
Раздел "Сетевые интерфейсы"
Раздел "Топология сети"
Раздел "Кастомизация системных файлов"
Файл /etc/static-routes
Режим и код для ручной настройки сетевых машрутов
Раздел "Сеть и Firewall" -> "Сетевой экран" в MikoPBX
Элемент для создания нового правила
Параметры правила
Раздел "Доступные сервисы"
Раздел "Дополнительные параметры"
Раздел "Дата и время" в MikoPBX
Элемент для корректировки времени вручную
Раздел "Почта и уведомления"
Параметры настроек отправки сообщений
Раздел "Почта и уведомления"
Параметры настроек отправки сообщений
Раздел "Доступ к AMI"
Параметры нового AMI пользователя
Раздел "Сеть и Firewall" в MikoPBX
Страница модуля резервного копирования
Вкладка "Расписание архивации"
Параметры разервного копирования по расписанию
Резервная копия
Переход в настройки восстановления из копии
Окно восстановления из архива
Создание новой резервной копии
Опции архивирования
Кнопка для загрузки архива
"Загрузите файл для восстановления"
Схема переноса данных
Успешное SSH соединение с новой MikoPBX
Выполнение команд для создания файла
Ввод необходимых данных
Генерация нового ключа
Сгенерированный ключ ssh
Вставленный ключ
Успешный перенос
Cover

Магазин приложений

Инструкция по установке готового образа из Яндекс Маркетплейс

Cover

Произвольный образ

Подробная инструкция по загрузке MikoPBX из произвольного образа

Cover

Утилита коммандной строки yc

Установка MikoPBX в Yandex Cloud с помощью утилиты yc

Пример консоли MikoPBX
Окно входа в MikoPBX
Ошибка авторизации в WEB-интерфейс
Консоль MikoPBX
Подтверждение сброса пароля
Изменение данных для входа
Изменение данных для авторизации
SSH подключение
SSH подключение
Раздел "Кастомизация системных файлов"
Редактирование файла crontabs/root
Планирование задачи
Создание SSH ключа
Полученный ключ
Раздел "Общие настройки"
Поле "SSH Authorized Keys"
Успешное подключение!
Версия OpenSSH
Создание ключа в Powershell
Созданные ключи
Раздел "Общие настройки"
Поле "SSH Authorized Keys"
Успешное подключение!
Раздел "Backups & Snapshots"
"Import via URL"
Параметры образа
Главная страница DigitalOcean
Создание нового "Droplet"
Параметры ВМ #1
Параметры ВМ #2
Раздел "Additional Storage"
Методы авторизации
Консоль в Digital Ocean
external ip-адрес
ID виртуальной машины
Команда для SSH подключения
Раздел "Образы"
Кнопка "Создать образ"
Параметры загружаемого образа диска
Раздел "Серверы"
"Создать сервер"
Первая секция конфигурации
Вторая секция конфигурации
"Создать сервер"
Раздел "Сеть"
Сеть "Nat"
Автоматические сетевые настройк
"DHCP-сервер"
Элемент переключения состояния сервера
Раздел "Syslog"
Раздел "Телефония" в MikoPBX
Раздел "Телефония" -> "Конференции"
Кнопка "Добавить конференцию"
Название и внутренний номер конференции
Установка пин-кода для входа в конференцию
Раздел "Модули" в MikoPBX
Раздел "Исходящие маршруты" в MikoPBX
Элемент для добавления нового правила исходящей маршрутизации
Названия правила и заметка
Указания шаблона номеров, попадающих под правило
Настройки преобразования номера
Выбор провайдера для правила
Шаблон для замены +7 -> 8
Шаблон для замены 7,8 -> +7
Шаблон для преобразования номера
Шаблон для преобразования номера
Раздел "Обслуживание"
Переключатель "Сетевой экран и защита от взлома включены"
Раздел "Защита от взлома"
Параметры защиты
Список заблокированных адресов
Элемент для разблокировки IP-адреса
Раздел "Обслуживание" -> "Перезагрузка"
Список активных звонков
Опции выключения/перезагрузки системы
Консоль MikoPBX
Перезагрука/выключение станции
Консольное меню MikoPBX
Команда Reboot
Раздел "Почта и уведомления"
Параметры настроек отправки сообщений
Раздел "Почта и уведомления" в MikoPBX
Раздел "Шаблон - пропущенные вызовы"
Раздел "Шаблон - голосовая почта"

Обновление из web-интерфейса

Вариант обновления из web-интерфейса

В некоторых разделах интерфейса (например, Сотрудники) в правом нижнем углу указана текущая версия MikoPBX.

В web-интерфейсе АТС перейдите в Обслуживание → Обновление PBX.

Если есть версии АТС новее вашей текущей, они будут отображены в таблице Доступны онлайн обновления, в которой в первом поле номер версии, а во втором - список изменений.

Рекомендуем проводить обновления последовательно, «не перепрыгивая» через релизы.

Далее возможны два варианта обновления: обновление онлайн, обновление скачанным img-файлом.

Обновление онлайн

Появится окно предупреждения. Нажмите в нем Обновить.

АТС загрузит и применит обновления, а затем перезагрузится.

Обновление скачанным img-файлом

Следует сразу заметить, что данным способом можно выполнить не только обновление, но и откат на более прежнюю версию.

Начнется скачивание img-образа. Дождитесь завершения загрузки.

Затем нажмите Применить обновление, а в появившемся окне предупреждения нажмите Обновить.

Начнется применение обновлений. После окончания которого АТС перезагрузится.

Отображение версии в web-интерфейсе
Раздел "Обновление PBX"
Раздел "Доступные онлайн обновления"

Будьте внимательны! Если система установлена на тот же диск, где хранятся записи разговоров, то могут быть сложности с обновлением.

Обновления загружаются на АТС и сразу же применяются. Для обновления таким способом нажмите кнопку в нужной вам версии обновления.

Кнопка для обновления системы
Окно предупреждения

Для обновления данным способом нажмите кнопку в нужной вам версии обновления.

Кнопка для загрузки файла обновления

Затем нажмите кнопку и выберите данный img-файл.

Выбор файла для обновления
Установка обновления
Процесс обновления
см. форум