ACLClouds
ACLClouds

Как установить FreePBX 17 на VPS с Debian 12?

Установить FreePBX 17 и Asterisk официальным скриптом, открыть порты SIP и RTP, настроить NAT, создать внутренний номер и SIP-транк, затем защитить АТС от

FreePBX — свободный веб-интерфейс для Asterisk, программной офисной АТС (IP PBX). Установленный на VPS, он управляет внутренними номерами команды, SIP-линиями оператора, голосовой почтой, очередями и графиком работы без оборудования в офисе. Версия 17 ставится официальным скриптом Sangoma, который поддерживает только Debian 12.

Пошаговая инструкция

  1. Подготовить VPS с Debian 12

    Выберите Debian 12 при заказе или переустановите VPS на эту систему: скрипт рассчитан на чистую установку без веб-сервера и базы данных. Затем подключитесь по SSH под root.

  2. Обновить систему и задать имя машины

    Выполните apt update && apt upgrade -y и перезагрузитесь, если установилось новое ядро. Задайте VPS полное имя (FQDN), например pbx.example.com, через hostnamectl set-hostname и строку в /etc/hosts: скрипт останавливается, если hostname -f ничего не возвращает.

  3. Запустить официальный скрипт

    Скачайте sng_freepbx_debian_install.sh из репозитория GitHub FreePBX/sng_freepbx_debian_install и запустите его через bash. Он установит Asterisk 22, FreePBX, Apache, PHP 8.2, MariaDB, Fail2ban и базовые модули; это занимает 15–30 минут. Подробный журнал пишется в /var/log/pbx/.

  4. Создать учётную запись администратора

    Откройте http://VPS_IP/ в браузере. FreePBX попросит имя пользователя, пароль и адрес электронной почты для уведомлений. Активация в Sangoma необязательна: она нужна для коммерческих модулей.

  5. Открыть порты SIP и RTP

    В «Брандмауэре» панели ACLClouds разрешите 5060/UDP для сигнализации SIP и диапазон 10000-20000/UDP для голоса (RTP). Доступ к 80 и 443/TCP, то есть к интерфейсу администрирования, ограничьте своим IP-адресом.

  6. Настроить NAT и создать внутренний номер

    В «Settings» > «Asterisk SIP Settings» нажмите «Detect Network Settings», чтобы заполнить внешний адрес и локальные сети. Затем создайте внутренний номер PJSIP в «Applications» > «Extensions», настройте его на софтфоне и нажмите «Apply Config».

Задать имя машины и установить FreePBX 17

apt update && apt upgrade -y
hostnamectl set-hostname pbx.example.com
echo "127.0.1.1 pbx.example.com pbx" >> /etc/hosts
hostname -f
wget https://github.com/FreePBX/sng_freepbx_debian_install/raw/master/sng_freepbx_debian_install.sh -O /tmp/sng_freepbx_debian_install.sh
bash /tmp/sng_freepbx_debian_install.sh

Полезные команды после установки

fwconsole restart
fwconsole reload
fwconsole ma upgradeall
fwconsole chown
asterisk -rvvv

В консоли Asterisk

pjsip show endpoints
pjsip show registrations
core show channels

Перед началом

Для небольшой команды АТС на FreePBX почти не нагружает сервер: нагрузка зависит в основном от числа одновременных звонков, записи разговоров и перекодирования между кодеками. Также нужен SIP-транк — линия от VoIP-оператора, чтобы звонить на внешние номера и принимать звонки на ваши номера.

  • Скрипт FreePBX 17 принимает только Debian 12 (bookworm); Debian 13 он отклоняет и блокирует обновление до него.
  • VPS должен сохранять один и тот же IP-адрес: на него ссылаются оператор и телефоны.
  • По умолчанию скрипт ставит и коммерческие модули Sangoma, включая System Admin и Firewall; параметр --opensourceonly их убирает, в том числе модуль Firewall.

Добавить SIP-транк

В «Connectivity» > «Trunks» добавьте транк PJSIP с данными оператора: SIP-сервер, логин, пароль и, в зависимости от тарифа, регистрация или аутентификация по IP-адресу. Затем создайте входящий маршрут («Inbound Routes») для каждого номера и исходящий маршрут («Outbound Routes») с разрешёнными форматами номеров.

Если оператор аутентифицирует по IP-адресу, сообщите ему IPv4 вашего VPS и откройте в брандмауэре 5060/UDP только для его адресов.

Защитить АТС

Публичный SIP-порт получает автоматические попытки входа уже через несколько часов после запуска. Главный риск — мошеннические звонки на платные и международные номера через взломанный внутренний номер за счёт вашего счёта у оператора.

  • Не отключайте Fail2ban, который ставит скрипт: он банит адреса после нескольких неудачных попыток SIP-аутентификации.
  • Задайте каждому внутреннему номеру длинный случайный пароль, а не сам номер.
  • Запретите анонимные звонки: установите «Allow Anonymous Inbound SIP Calls» и «Allow SIP Guests» в «No» в «Asterisk SIP Settings».
  • Ограничьте исходящие маршруты нужными направлениями и попросите оператора установить лимит расходов или заблокировать платные и международные номера.

Частые ошибки и их решение

Большинство проблем со звуком связано с NAT или портами RTP. pjsip show endpoints и журнал /var/log/asterisk/full чаще всего показывают причину.

  • Звонок соединяется, но звука нет или он идёт только в одну сторону: диапазон 10000-20000/UDP закрыт или в «Asterisk SIP Settings» не указан внешний адрес. Исправьте и нажмите «Apply Config».
  • Внутренний номер не регистрируется и получает 401 Unauthorized: неверный логин или пароль. Если после нескольких попыток ответа нет совсем, его адрес забанил Fail2ban.
  • Скрипт останавливается с Unsupported OS version: система — не Debian 12. Переустановите VPS на Debian 12 и запустите скрипт снова.
  • Скрипт останавливается на Fully qualified domain name (FQDN) is not set correctly: задайте машине полное имя через hostnamectl и /etc/hosts.
  • После обновления интерфейс показывает пустую страницу или ошибку: выполните fwconsole chown, затем fwconsole restart.

Какой VPS выбрать для FreePBX?

В ACLClouds на 17 ноября 2026 года VPS Mini (2 vCPU, 8 ГБ RAM, 40 ГБ хранилища) стоит 4,99 € в месяц без обязательств или 3,99 € в месяц при сроке 1 год: этого хватает для АТС небольшой компании с голосовой почтой. VPS Essentiel (4 vCPU, 16 ГБ RAM, 80 ГБ) за 9,99 € в месяц оставляет запас для записи разговоров и множества одновременных звонков. Сеть — до 1 Гбит/с; звонок в G.711 занимает около 90 кбит/с в каждую сторону.

Быстрая проверка

  • http://VPS_IP/ открывает вход в FreePBX.
  • pjsip show endpoints показывает внутренний номер как доступный.
  • Звонок между двумя внутренними номерами проходит со звуком в обе стороны.
  • Транк отображается как зарегистрированный в pjsip show registrations.
  • Интерфейс администрирования доступен только с ваших адресов.

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

FreePBX бесплатен?

Да. FreePBX и Asterisk — свободное ПО без лицензии за каждый внутренний номер. Платны только некоторые коммерческие модули Sangoma, например EndPoint Manager; полноценная АТС работает и без них. Внешние звонки оплачиваются вашему SIP-оператору.

Можно ли поставить FreePBX 17 на Debian 13 или Ubuntu?

Не официальным скриптом: на любой системе, кроме Debian 12, он останавливается. Ручная установка возможна, но Sangoma её не поддерживает: для рабочей АТС выбирайте Debian 12.

Нужен ли HTTPS-сертификат для интерфейса?

Он рекомендуется, как только интерфейс или пользовательский портал (UCP) становится доступен из интернета. Направьте доменное имя на VPS и запросите сертификат Let’s Encrypt; модуль FreePBX «Certificate Management» тоже умеет его получать и продлевать.

Сколько одновременных звонков выдержит небольшой VPS?

Без перекодирования и записи на 2 vCPU помещается несколько десятков звонков: Asterisk в основном пересылает пакеты. Перекодирование (например, из G.722 в G.729) и запись каждого звонка заметно повышают нагрузку на CPU и диск. Перед добавлением номеров замерьте нагрузку через core show channels в часы пик.