Подключение 3CX к локальной инсталляции PostgreSQL и Grafana

Введение

Это руководство описывает подключение АТС 3CX к локально установленной базе данных PostgreSQL и использование Grafana для визуализации данных и создания отчетов.

Шаг 1: Создайте базу данных PostgreSQL

  1. Установите PostgreSQL
  • Windows: Загрузите инсталлятор https://www.postgresql.org/download/windows/ и следуйте инструкциям мастера установки.
  • Linux (Debian): sudo apt update && sudo apt install -y postgresql Проверьте наличие кластера: pg_lsclusters. При необходимости создайте: sudo pg_createcluster <major-version> main --start.
    Запомните пароль суперпользователя postgres и параметры инсталляции (порт по умолчанию 5432).
  1. Создайте пользователя и базу данных PostgreSQL
  • Windows: Откройте командную строку и запустите psql.
  • Выполните SQL-команды:
                CREATE ROLE your_user WITH LOGIN PASSWORD 'your_password';
            CREATE     DATABASE your_db OWNER your_user;
  • Linux (Debian):

sudo -u postgres createuser <username> -P
        sudo -u postgres createdb <dbname> -O <username>

Замените your_user/username, your_password и your_db/dbname на ваши значения.

  1. Разрешите удаленные подключения
  • Отредактируйте postgresql.conf:
  • Windows: Обычно находится в папке C:Program FilesPostgreSQL<version>datapostgresql.conf. Установите listen_addresses = '*'.
  • Linux (Debian): Обычно находится в папке /etc/postgresql/<version>/main/postgresql.conf. Установите listen_addresses = '*'.
  • Отредактируйте pg_hba.conf:
  • Windows: Обычно находится в папке C:Program FilesPostgreSQL<version>datapg_hba.conf.
    Добавьте:     host    your_db         your_user        <allowed_ip>/<cidr>         md5
  • Linux (Debian): /etc/postgresql/<version>/main/pg_hba.conf.
    Добавьте:     host    <dbname>        <username>       <allowed_ip>/<cidr>         md5

Замените <allowed_ip>/<cidr> для ограничения доступа при необходимости (например, 0.0.0.0/0 для любого IP-адреса).

  1.  Перезапустите сервис PostgreSQL:
  • Windows: net stop postgresql-x64-<version> then net start postgresql-x64-<version> (как Administrator).
  • Linux (Debian): sudo systemctl restart postgresql
  1. Предоставьте привилегии в базе данных
  • Windows & Linux: Откройте psql (Windows) или sudo -u postgres psql (Linux) и выполните:
    SQL
    GRANT ALL PRIVILEGES ON DATABASE your_db TO your_user;

Используйте настроенные вами имена пользователя и базы данных.

Альтернативно: Быстрая настройка с помощью скрипта

Обратите внимание: Эти скрипты со временем могут не поддерживаться. Используйте их на свой страх и риск. Будьте осторожны при запуске скриптов с правами администратора.

Шаг 2: Настройте коннектор данных в 3CX

  1. В 3CX перейдите в Консоль администрирования > Integrations > Data Connector
  2. Выберите "PostgreSQL Database" и укажите:
  • Host: IP-адрес или FQDN (если доступно) хоста, на котором установлена PostgreSQL.
  • SSL Validation: Определяет, должна ли АТС пытаться проверить удалённый SSL‑сертификат.
  • CA Certificate: Отображается только если включена проверка SSL (SSL Validation). Загрузите сертификат центра сертификации (CA).
  • Port: Порт базы данных (по умолчанию: 5432).
  • Database Name: Имя базы данных, которое вы настроили в RDS.
  • Username: Имя пользователя, которое вы настроили в RDS.
  • Password: Пароль, настроенный для нового пользователя.
  • Frequency: Частота передачи данных из АТС в PostgreSQL.
  1. Сохраните конфигурацию и нажмите кнопку "Test" на АТС, чтобы проверить соединение с базой данных PostgreSQL. Убедитесь, что соединение успешно. Если тест не пройден, проверьте хост, порт, имя базы данных, имя пользователя и пароль. Также проверьте, разрешают ли сетевые экраны на хосте PostgreSQL и в сети подключения с IP-адреса вашей АТС.

Обратите внимание: Для использования Коннектора данных 3CX требуется лицензия 16SC+.

Шаг 3: Подключите Grafana к экземпляру PostgreSQL

  1. Войдите в ваш экземпляр Grafana (например, grafana.com или локальный Grafana).
  2. Перейдите в меню конфигурации Grafana (значок шестеренки), нажмите "Data Sources" и "Add data source".
  3. Найдите и выберите "PostgreSQL".

Подключите Grafana к экземпляру PostgreSQL

Найдите и выберите "PostgreSQL".

  1. Настройте источник данных в разделе "Connection". Укажите следующие данные:
  • Host: IP-адрес или FQDN и порт вашего PostgreSQL в формате: IP/FQDN:5432
  • Database: Имя базы данных, созданной на Шаге 1.
  • User: Имя пользователя, созданного на Шаге 1.
  • Password: Пароль, настроенный для нового пользователя.

Настройте источник данных в разделе "Connection".

  1. Нажмите "Save & test" и убедитесь, что появилось сообщение "Data source is working". Если возникают ошибки, перепроверьте данные подключения и конфигурацию SSL. Также проверьте, разрешают ли сетевые экраны на хосте PostgreSQL и в сети подключения с IP-адресов Grafana.

Нажмите "Save & test" и убедитесь, что появилось сообщение "Data source is working".

Дополнительная информация

Версия документа

Последнее обновление документа 2 июня 2026

https://www.3cx.ru/docs/postgresql-configuration/