Appearance

Быстрый старт ​

Разверните Bitrix Converter за несколько минут с готовыми Docker-образами из GitHub Container Registry.

На коробочном Битрикс24 локальный конвертер обычно быстрее штатного: см. Почему быстрее штатного конвертера.

Требования ​

  • Linux-сервер (Debian/Ubuntu, RHEL/Rocky/Alma, Fedora, Amazon Linux, Arch)
  • 4 GB RAM минимум (consumer с LibreOffice/ffmpeg)
  • Доступ к серверу, где работает Битрикс24 (или общая Docker-сеть)
  • Docker ставится автоматически скриптом install.sh (если его ещё нет)

Установка (рекомендуется) ​

bash
git clone https://github.com/Astrum-Studio/bitrix24-converter-go.git
cd bitrix24-converter-go
./install.sh

Что делает установщик:

  1. Проверяет Docker; при необходимости ставит Engine + Compose под вашу ОС
  2. Копирует .env.example → .env и генерирует безопасные RABBITMQ_USER / RABBITMQ_PASSWORD
  3. Выполняет docker compose pull && docker compose up -d
  4. Печатает URL API для модуля transformer

Полезные флаги:

bash
./install.sh --yes              # без вопросов
./install.sh --port 8200        # другой порт API
./install.sh --skip-docker      # Docker уже установлен
./install.sh --no-start         # только .env, без запуска
./install.sh --force-env        # перезаписать существующий .env

Отдельные скрипты:

bash
./scripts/init-env.sh           # только .env + пароль
./scripts/install-docker.sh     # только Docker

Ручная установка ​

bash
cp .env.example .env
# задайте надёжный RABBITMQ_PASSWORD
docker compose pull
docker compose up -d

Проверка ​

СервисURL по умолчанию
API конвертераhttp://127.0.0.1:8100/convert (только localhost)
Healthhttp://127.0.0.1:8100/health
bash
docker compose ps
docker compose logs -f consumer
curl -s http://127.0.0.1:8100/health

Порт не слушает 0.0.0.0 — снаружи недоступен. Битрикс24 подключайте через Docker-сеть (http://converter-producer:8100/convert).

Интеграция с Битрикс24 ​

Перейдите к разделу Настройка Битрикс24.

Сборка из исходников ​

bash
docker compose -f docker-compose.yml -f docker-compose.build.yml up --build -d

Обновление ​

bash
git pull
docker compose pull
docker compose up -d