Установить LANBilling на Debian 12

  1. Системные требования
  2. Установить дополнительные пакеты
  3. Подготовить сетевые порты
  4. Установить и настроить MySQL-сервер
  5. Установить и настроить веб-сервер
  6. Скачать компоненты LANBilling
  7. Установить LBcore — ядро LANBilling
  8. Настроить ротацию лог-файлов
  9. Установить административный интерфейс 3.x
  10. Активировать лицензионный ключ
  11. Создать агенты и установить их модули
  12. Установить личный кабинет абонента 3.x

Системные требования

Определите, какие версии модулей LANBilling хотите установить, и по таблице совместимости подберите компоненты ОС.

Как правило, требуются следующие компоненты:

Установить дополнительные пакеты

Для дальнейшей установки и настройки вам потребуются:

  • python3-simplejson — для некоторых скриптов платёжных систем.

  • python3-requests — для скриптов автоплатежей.

  • logrotate — утилита ротации логов. Она должна быть на каждом сервере, где будут установлены компоненты LANBilling.

  • dirmngr — служба для управления сетевыми сертификатами.

  • atop — аналитическая система, требуется для анализа производительности LANBilling и сервера в целом.

  • zstd — архиватор.

  • nano — текстовый редактор.

Чтобы установить дополнительные пакеты, введите команду:

apt install -y python3-simplejson python3-requests logrotate dirmngr atop zstd nano

Также установите библиотеки для cgi-скриптов платёжных систем.

apt install -y libsoap-lite-perl libxml-simple-perl libcgi-session-perl libtext-iconv-perl python3-suds libjson-perl

Подготовить сетевые порты

  1. Список портов, которые LANBilling использует по умолчанию.
  2. Настроить порты для исходящих соединений.

Список портов, которые LANBilling использует по умолчанию

Направление Сервер Протокол Номер порта Описание
На вход Сервер, на котором установлены lbweb-admin и lbweb-client HTTP\HTTPS 80 (443) Доступ к административному интерфейсу и личному кабинету
На вход Сервер LBcore JSON\JSON-SSL 1502 (1503) Связь LBcore с модулями агентов и административным интерфейсом
На вход Сервер LBcore SOAP 34012 Связь LBcore с личным кабинетом и доступ по API
На вход Сервер БД MySQL 3306 Используется, если MySQL находится на отдельном сервере. LBcore и модули агентов должны иметь доступ к этому порту. Обратите внимание: MySQL по умолчанию прослушивает только 127.0.0.1 (параметр bind)
На вход Сервер, на котором установлен модуль LBarcd RADIUS 1812\UDP и 1813\UDP 1812\UDP — для авторизации; 1813\UDP — для аккаунтинга
На вход Сервер, на котором установлен модуль LBucd NetFlow 7223\UDP Сбор статистики о трафике
На выход До сервера lic.lanbilling.ru Лицензирование 34100 во внешнюю сеть Активация лицензионного ключа
На выход До серверов сервиса DaData HTTP\HTTPS 80 (443) Заполнение данных пользователя по ИНН, подсказки для полей «БИК» и «Название банка»

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

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

  1. Откройте файл конфигурации:

    nano /etc/sysctl.conf
    

    ``

  2. Добавьте в него строку:

    net.ipv4.ip_local_port_range = 35000 60999
    

    ``

  3. Также рекомендуем оптимизировать работу памяти сервера. Задайте параметры:

    vm.zone_reclaim_mode = 1
    vm.swappiness = 5
    

    ``

    Подробнее об этих параметрах — в официальной документации Linux Kernel.

  4. Сохраните конфигурационный файл. Примените изменения из него:

    sysctl -p
    

    ``

Установить и настроить MySQL-сервер

  1. Установить MySQL-сервер.
  2. Настроить MySQL-сервер.
  3. Запустить MySQL-сервер.
  4. Настроить пароль для MySQL.

Установить MySQL-сервер

  1. Установите дополнительные утилиты:

    apt install -y --no-install-recommends curl ca-certificates lsb-release wget gnupg2
    

    ``

  2. Подключите репозиторий MySQL-сервера с помощью пакета mysql-apt-config. Сначала проверьте версию пакета на странице разработчика. Затем скачайте пакет:

    wget https://dev.mysql.com/get/mysql-apt-config_0.8.26-1_all.deb
    

    ``

  3. Установите пакет:

    dpkg -i mysql-apt-config_0.8.26-1_all.deb
    

    ``

  4. Во время установки автоматически запустится утилита-конфигуратор.

    Выберите в ней ubuntu lunar.

    image

    Далее выберите пункт «MySQL Server & Cluster». Нажмите клавишу Tab, чтобы выбрать Ok, затем нажмите Enter.

    image

    Установите значение «mysql-8.0». Далее нажмите клавишу 4 либо перейдите к пункту Ok и нажмите Enter.

    image
  5. Обновите подключённые репозитории:

    apt update
    

    ``

  6. Установите MySQL-сервер:

    apt install mysql-server
    

    ``

  7. Если вы устанавливаете MySQL 8.x, потребуется выбрать тип аутентификации. Выберите «Use Legacy Authentication Method (Retain MySQL 5.x Compatibility)».

  8. Остановите MySQL, чтобы продолжить настройку:

    systemctl stop mysql
    

    ``

Настроить MySQL-сервер

  1. Откройте файл mysqld.cnf:

    nano /etc/mysql/mysql.conf.d/mysqld.cnf
    

    ``

  2. Укажите параметры. Если какие-то параметры в файле уже заданы — сверьте их с описанием, приведённым ниже. Установите те значения, которые вам подходят.

    Обратите внимание: в одной секции не должно быть одного и того же параметра с разными значениями.

    Параметры в секции [mysqld]:

    [mysqld]
    default-authentication-plugin = mysql_native_password
    character-set-server = utf8
    character-sets-dir = /usr/share/mysql/charsets
    skip-character-set-client-handshake
    skip-name-resolve
    innodb_file_per_table = ON
    ssl = 0
    bind-address = 127.0.0.1 #Если Вы планируете подключаться к MySQL с другого хоста, следует изменить на 0.0.0.0
    sql_mode = STRICT_TRANS_TABLES,NO_ZERO_IN_DATE,ERROR_FOR_DIVISION_BY_ZERO,NO_ENGINE_SUBSTITUTION
    innodb_stats_on_metadata = 0
    group_concat_max_len = 1000000000
    enforce_gtid_consistency = OFF
    gtid_mode = OFF
    performance_schema = OFF
    explicit_defaults_for_timestamp
    key_buffer_size = 64M
    max_heap_table_size = 128M
    tmp_table_size = 128M
    innodb_buffer_pool_size = 512M
    innodb_buffer_pool_instances = 1
    innodb_log_file_size = 64M #Не нужно изменять без существенной необходимости
    slow_query_log = 1
    innodb_flush_method=O_DIRECT
    innodb-flush-log-at-trx-commit = 2
    disable-log-bin
    

    ``

  3. В стандартной конфигурации бинарное логирование выключено — параметр disable-log-bin.

    Чтобы включить бинарное логирование, удалите эту строку и добавьте два параметра: log-bin и log_bin_trust_function_creators.

    #disable-log-bin
    log-bin = mysql-bin
    log_bin_trust_function_creators = 1
    

    Опции для настройки бинарного логирования

Запустить MySQL-сервер

Запустите сервер:

systemctl start mysql

Настроить пароль для MySQL

По умолчанию пароль root-пользователя пустой. Вы можете задать свой пароль.

mysqladmin --user root --password password 'ваш_пароль_для_root_пользователя_mysql'

Далее в инструкции предполагается, что установлен пустой пароль.

Как сменить пароль, если действует плагин validate_password

Установить и настроить веб-сервер

  1. Установить веб-сервер.
  2. Настроить PHP.
  3. Запустить Apache2.

Установить веб-сервер

  1. Проверьте список поддерживаемых версий. Установите веб-сервер.

    Пакеты:

    apt install apache2 php8.2 libapache2-mod-php8.2 php8.2-soap libtiff5-dev libpng16-16 php8.2-gd php8.2-mbstring php8.2-xml php8.2-bcmath  php8.2-curl php8.2-mysql php8.2-gmp ghostscript
    

    ``

  2. Добавьте веб-сервер в автозагрузку ОС:

    systemctl enable apache2
    

    ``

  3. Включите модуль cgi. Он нужен для работы cgi-скриптов при взаимодействии с платёжными системами.

    a2enmod cgi
    

    ``

Настроить PHP

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

  1. Откройте файл php.ini.

    Путь:

    nano /etc/php/8.2/apache2/php.ini
    

    ``

  2. В файле уже заданы параметры. Раскомментируйте их и приведите к этим значениям:

    date.timezone = Europe/Moscow
    max_execution_time = 3600
    default_socket_timeout = 3600
    memory_limit = 1024M
    max_input_vars = 2500
    

    ``

    В параметре date.timezone укажите свою временную зону. Полный список зон можно посмотреть здесь.

  3. Проверьте, включён ли firewall:

    ufw status
    

    ``

    Если включён, добавьте правила:

    ufw allow 80/tcp
    ufw allow 443/tcp
    ufw reload
    

    ``

  4. Если необходим https, подключите его:

    a2enmod ssl
    a2ensite default-ssl
    

    ``

Запустить Apache2

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

systemctl start apache2

Скачать компоненты LANBilling

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

Вам потребуются:

  • пакет LBcore сборки 2.0.48 — чтобы установить ядро LANBilling;

  • пакеты lbweb-common и lbweb-admin — чтобы установить административный интерфейс;

  • пакеты lbweb-common и lbweb-client — чтобы установить личный кабинет для абонентов;

  • установочные пакеты для модулей агентов — например, LBucd для Netflow и LBarcd для RADIUS. Конкретный список модулей зависит от того, какие платформы вы будете использовать.

    Платформа Агент Модуль
    Платформа «интернет», DialUp, авторизация абонентов RADIUS LBarcd
    Платформа «интернет», широкополосный доступ, без авторизации Netflow LBucd
    Телефония LBphone LBphone
    IP-телефония VoIP LBircd

В названии пакета содержатся основные сведения о нём. Рассмотрим на примере lbcore_2.0.48.0-5.git6a112fb.debian12_amd64.deb:

  • lbcore — название модуля
  • 2.0.48 — версия и номер релиза
  • 0 — порядковый номер прохождения полного тестирования (начиная с 0)
  • 5 — количество изменений с момента релиза (начиная с 1)
  • git6a112fb — номер ревизии модуля
  • debian12_amd64 — ОС, для которой собран пакет

Скачайте пакеты из личного кабинета в Satisfy CRM.

  1. В личном кабинете перейдите на вкладку «Загрузки».

  2. Нажмите image в строке с названием пакета.

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

Установить LBcore

LBcore — модуль ядра LANBilling. В этой инструкции предполагается, что вы устанавливаете MySQL и LBcore на один сервер.

Процесс установки описан исходя из того, что установочный пакет сохранён на сервере в директории /root/.

  1. Убедитесь, что уже установили:

  2. Установите пакет ядра. Пример:

    dpkg -i /root/lbcore_2.0.48.0-5.git6a112fb.debian12_amd64.deb
    

    ``

  3. Добавьте LBcore в автозагрузку ОС:

    systemctl enable lbcore
    

    ``

  4. Зайдите в MySQL под пользователем root — команда mysql. Если вы задавали пароль — mysql -p%пароль%.

  5. Создайте базу данных LBcore. Укажите сведения о пользователях и настройте доступ LANBilling к БД.

    CREATE DATABASE `billing` DEFAULT CHARSET UTF8;
    CREATE USER IF NOT EXISTS 'billing'@'localhost' IDENTIFIED WITH mysql_native_password BY 'billing';
    GRANT ALL ON `billing`.* TO 'billing'@'localhost';
    CREATE USER IF NOT EXISTS 'billing'@'127.0.0.1' IDENTIFIED WITH mysql_native_password BY 'billing';
    GRANT ALL ON `billing`.* TO 'billing'@'127.0.0.1';
    exit
    

    ``

    Разрешённые символы для логинов, паролей и названия БД:

    • латинские буквы
    • цифры
    • пробел
    • ! " $ % & ' ( ) * + , - . / : ; < = > ? @ [ \ ] ^ _` { | } ~
    • # (на любой позиции, кроме первой)

  6. Создайте структуру БД LBcore и подключите справочник адресов — КЛАДР:

    mysql billing < /usr/local/billing/mysql/create.sql
    mysql billing < /usr/local/billing/mysql/claddr.sql
    

    ``

  7. Откройте файл billing.conf:

    nano /etc/billing.conf
    

    ``

    Убедитесь, что указаны параметры доступа, которые вы задавали при создании БД. Если нет, исправьте их. Данные должны быть в формате mysql://dbuser:dbpass@dbhost:dbport/dbname.

    • dbuser и dbpass — логин и пароль администратора.
    • dbhost — IP-адрес сервера.
    • dbport — номер порта.
    • dbname — имя БД.

    Если не указать dbport, будет использоваться порт 3306. Пример для случая, когда LBcore и MySQL установлены на одном сервере и используется порт по умолчанию:

    # DB access parameters
    database = mysql://billing:billing@127.0.0.1/billing
    

    ``

  8. Запустите ядро LANBilling:

    systemctl start lbcore
    

    ``

  9. Чтобы убедиться, что ядро запущено и работает, выполните одну из команд:

    ps ax | grep -i lbcore
    

    ``

    или

    systemctl status lbcore
    

    ``

Настроить ротацию лог-файлов

  1. Убедитесь, что на сервере установлены logrotate и zstd:

    dpkg -l|grep 'logrotate\|zstd'
    

    ``

    Если этих утилит нет, установите их:

    apt install -y logrotate zstd
    

    ``

  1. Лог-файлы по умолчанию находятся в директории /var/log/billing/. Настройте их ротацию одним из двух способов.

    • Способ 1: воспользуйтсь утилитой logrotate. Этот способ подойдёт, если объём логов небольшой. По умолчанию logrotate прописывается в cron.daily и запускается каждый день в 03:01.

      Пример настройки ротации логов находится в файле lbrotate.conf. Скопируйте его в директорию /logrotate/:

      cp /etc/lanbilling/lbrotate.conf /etc/logrotate.d/
      
      
      
    • Способ 2: вручную добавьте задание в планировщик cron. Этот способ удобен, если за сутки накапливается большой объём логов. Вы сможете выбрать произвольный интервал для ротации — например, каждый час.

      Добавьте в файл /etc/crontab строку-задание:

      0 * * * * root /usr/sbin/logrotate /etc/lanbilling/lbrotate.conf
      

Установить административный интерфейс 3.x

Административный интерфейс — веб-приложение, в котором работает оператор связи. Например, системные администраторы задают в нём настройки сети, а менеджеры оператора создают профили абонентов и следят за списаниями.

Обратите внимание: для первого старта интерфейс нужно установить на том же сервере, что и ядро. По умолчанию LBcore принимает запросы только с localhost или 127.0.0.1. В дальнейшем вы можете развернуть административный интерфейс на другом хосте.

  1. Убедитесь, что уже установили и настроили:

  2. Убедитесь, что скачали пакеты lbweb-common и lbweb-admin. Процесс установки описан исходя из того, что установочные пакеты сохранены на сервере в директории /root/.

  3. Установите пакеты. Пример:

    dpkg -i /root/lbweb-common_2.21.1+202204140013git532675b86729-1_all.deb
    dpkg -i /root/lbweb-admin_3.45.0+202302060901git90726f1f16e6-1_all.deb
    

    ``

  4. При установке пакета создаётся пример файла конфигурации. Создайте из него файл конфигурации:

    cp /etc/lanbilling/phpclient/admin/admin.ini.sample /etc/lanbilling/phpclient/admin/admin.ini
    

    ``

  5. Добавьте конфигурацию административного интерфейса LANBilling в настройки веб-сервера:

    cp /etc/lanbilling/phpclient/apache2/lbweb-admin.apache2.sample /etc/apache2/sites-available/lbweb-admin.conf
    a2ensite lbweb-admin.conf
    

    ``

  6. Перезапустите веб-сервер:

    systemctl restart apache2
    

    ``

Административный интерфейс установлен. Он доступен по адресу http://%IP-адрес-сервера%/lbweb-admin. По умолчанию для входа используется логин admin, без пароля.

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

Если вы будете использовать другой сервер, сначала установите на нём веб-сервер и административный интерфейс. Затем активируйте лицензионный ключ.

Активировать лицензионный ключ

После покупки LANBilling оператор получает ключ активации — он доступен в личном кабинете Satisfy CRM.

Порядок действий:

  1. Убедитесь, что на сервере LBcore открыт доступ к серверу lic.lanbilling.ru и порт 34100.

  2. Авторизуйтесь в административном интерфейсе. Для самой первой авторизации пароль не нужен — введите логин admin и нажмите «Войти».

  3. В административном интерфейсе укажите название оператора.

    Указать название оператора
  4. Активируйте лицензионный ключ. Обратите внимание: если вы сначала активируете ключ, а потом переименуете оператора — понадобится новый ключ.

    Активировать лицензионный ключ

Создать агенты и установить их модули

С помощью агентов LANBilling обменивается данными с операторским оборудованием — это позволяет собирать информацию о трафике и тарифицировать услуги.

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

  1. Заранее скачали пакеты модулей и перенесли на те серверы, где будете их устанавливать.
  2. Установили MySQL-сервер.
  3. Установили веб-сервер.
  4. Установили модуль ядра — LBcore.
  5. Установили административный интерфейс.
  6. Активировали лицензионный ключ.

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

Агент Описание Модуль
RADIUS Для платформы «интернет». Он служит для авторизации абонента и оборудования на сервере, а также для обработки абонентского соединения LBarcd
Netflow Для платформы «интернет». Отвечает за подсчёт трафика, не проводит авторизацию абонентов LBucd
LBphone Для телефонии. С его помощью LANBilling получает от АТС статистическую информацию о звонках в виде CDR-файлов LBphone
VoIP Для IP-телефонии. Обработка звонков происходит по протоколу RADIUS LBircd

Если вы устанавливаете модуль агента на отдельный сервер (не туда же, где установлен LBcore), настройте на этом сервере ротацию лог-файлов.

Установить личный кабинет абонента 3.x

Личный кабинет — веб-интерфейс для абонентов. Например, в личном кабинете абоненты могут подключать новые услуги или переходить с одного тарифа на другой.

  1. Убедитесь, что уже установили и настроили:

  2. Убедитесь, что скачали пакеты lbweb-common и lbweb-client.

  3. Установите пакеты. Пример:

    dpkg -i /root/lbweb-common_2.21.1+202204140013git532675b86729-1_all.deb
    dpkg -i /root/lbweb-client_3.45.0+202302060908git5a8825efcf88-1_all.deb
    

    ``

  4. Добавьте конфигурацию личного кабинета в настройки веб-сервера.

    cp /etc/lanbilling/phpclient/apache2/lbweb-client.apache2.sample /etc/apache2/sites-available/lbweb-client.conf
    a2ensite lbweb-client.conf
    a2enmod rewrite
    

    ``

  5. Перезапустите Apache2, чтобы применить изменения:

    systemctl restart apache2
    

    ``

Личный кабинет установлен. Он доступен по адресу http://%IP-адрес-сервера%/lbweb-client/. Настройка личного кабинета описана здесь.