Заказать демо
Документация · версия 8.0

Инструкция по установке и настройке

KIN DIGITAL CRM+. Правообладатель: ИП Коробкин Иван Николаевич.

Версия 8.0.

Программа поставляется в двух вариантах: переносная версия для Windows (раздел 2) и серверная версия для Linux (раздел 3). Возможности обоих вариантов одинаковы.

1. Требования

  • Переносная версия: Windows 10 или 11, 64 разряда (Windows Server 2016 и новее).
  • Серверная версия: Ubuntu Server 24.04 LTS (рекомендуется) или Debian 12 и новее, 64 разряда.
  • Процессор x64 от 4 ядер, оперативная память от 8 ГБ, свободное место от 10 ГБ (без учёта документов).
  • Браузер: Яндекс Браузер, Chromium-Гост, Google Chrome, Microsoft Edge или Firefox актуальной версии.
  • Для подписи КЭП на рабочих местах: КриптоПро CSP и КриптоПро ЭЦП Browser plug-in.
  • Подключение к интернету не обязательно. Оно нужно только для внешних сервисов, которые лицензиат подключает сам.

2. Установка переносной версии (Windows)

  1. Распакуйте архив поставки в папку, например C:\KINDIGITAL-CRM. Путь не должен вести в папку, которая синхронизируется с облаком.
  2. Запустите START.cmd двойным щелчком. Откроется окно сервера, при первом запуске создаётся база данных (1-2 минуты).
  3. Браузер откроет http://localhost:3000.
  4. Вход: admin@kindigital.local. Пароль первого входа создаётся случайным и записывается в файл data\ПЕРВЫЙ ВХОД.txt. После входа задайте свой пароль и удалите этот файл.
  5. Загрузите файл лицензии: «Администрирование → Лицензия» (см. документ «Активация и лицензионные ключи»).

Остановка программы - закрыть окно сервера. Порт веб-интерфейса 3000, порт встроенной базы данных 54329 (только для этого компьютера).

3. Установка серверной версии (Linux)

Серверная версия работает как служба: запускается при включении сервера, перезапускается при сбое, сама выпускает и продлевает сертификат HTTPS и ежедневно делает резервную копию.

  1. Подготовьте сервер с Ubuntu Server 24.04 и доступом в интернет. Для доступа из интернета нужен белый IP-адрес, проброс портов 80 и 443 на сервер и запись DNS вида crm.example.ru, указывающая на этот адрес.
  2. Скопируйте на сервер архив KINDIGITAL-CRM-server.tar.gz и выполните: tar -xzf KINDIGITAL-CRM-server.tar.gz cd KINDIGITAL-CRM-server sudo ./install.sh crm.example.ru
  3. Установщик ставит системные пакеты (ffmpeg, Caddy для HTTPS, межсетевой экран), копирует программу в /opt/kindigital-crm, создаёт службу kindigital-crm и ночное резервное копирование, а в конце показывает адрес и пароль первого входа.
  4. Откройте https://crm.example.ru, войдите как admin@kindigital.local, задайте свой пароль и загрузите файл лицензии.

Автоматическая установка с флешки: в поставку входят файлы для загрузочной флешки (каталог tools/server/usb исходного кода). С ней на сервер в один проход устанавливаются Ubuntu Server, программа, лицензия и, по желанию, демонстрационные данные; у пользователя запрашиваются только имя и пароль для входа на сервер.

Порты: веб-интерфейс 3000 (только внутри сервера, наружу открыт через HTTPS на 443), встроенная база данных 54329 (только внутри сервера). Межсетевой экран пропускает только SSH, 80 и 443.

4. Доступ с других компьютеров и телефонов

  • В локальной сети: откройте http://имя-или-адрес-компьютера:3000, разрешите входящие подключения на порт 3000 в брандмауэре Windows.
  • Из интернета и для приложений на телефонах нужен адрес с HTTPS. Серверная версия настраивает HTTPS сама. Для переносной версии укажите в data\settings.env пути к сертификату и ключу: HTTPS_CERT_FILE и HTTPS_KEY_FILE (формат PEM), и внешний адрес PUBLIC_URL.

5. Настройки

Настройки задаются в файле data\settings.env (на сервере Linux - /opt/kindigital-crm/data/settings.env) строками ПАРАМЕТР=значение. После правки на сервере выполните sudo systemctl restart kindigital-crm. Ключи внешних сервисов получает и оплачивает лицензиат по своим договорам с поставщиками.

Назначение Параметры
Адрес и HTTPS PUBLIC_URL, HTTPS_CERT_FILE, HTTPS_KEY_FILE
Заполнение реквизитов по ИНН DADATA_TOKEN
ИИ AI_PROVIDER, AI_BASE_URL, AI_MODEL, AI_API_KEY, GIGACHAT_AUTH_KEY, GIGACHAT_MODEL, YANDEX_API_KEY, YANDEX_CLOUD_FOLDER_ID, AI_LOCAL, AI_EMBED_MODEL
SMS SMS_PROVIDER, SMS_SENDER, SMSC_LOGIN, SMSC_PASSWORD, SMSRU_API_ID, EXOLVE_API_KEY, EXOLVE_NUMBER
Проверочный режим для показа (SMS не отправляются, код входа в приложение показывается на экране) SMS_PROVIDER=test, APP_DEMO_CODES=true
Телефония TELEPHONY_PROVIDER, MANGO_API_KEY, MANGO_API_SALT, ZADARMA_KEY, ZADARMA_SECRET, TELEPHONY_ORIGINATE_URL
Почта и мессенджеры INBOX_EMAIL_IMAP_HOST, INBOX_EMAIL_SMTP_HOST, INBOX_EMAIL_USER, INBOX_EMAIL_PASSWORD, INBOX_MAX_TOKEN, INBOX_VK_TOKEN, INBOX_VK_GROUP_ID
Иностранные мессенджеры (по умолчанию выключены) INBOX_TELEGRAM_ENABLED, INBOX_TELEGRAM_TOKEN
Оплата в «Мобильном Юристе» (подробно - docs/yookassa.md) YOOKASSA_SHOP_ID, YOOKASSA_SECRET, YOOKASSA_RECEIPT, YOOKASSA_VAT_CODE, YOOKASSA_TAX_SYSTEM
Судебная практика PRACTICE_FEEDS, PRACTICE_TOPICS
Сведения о регистрации REG_FIPS_NUMBER, REG_REESTR_NUMBER

Варианты ИИ: - GigaChat по ключу developers.sber.ru: AI_PROVIDER=gigachat, GIGACHAT_AUTH_KEY, GIGACHAT_MODEL (например GigaChat-2-Max). - GigaChat и другие модели через Cloud.ru Foundation Models: AI_PROVIDER=openai, AI_BASE_URL=https://foundation-models.api.cloud.ru/v1, AI_API_KEY, AI_MODEL=GigaChat/GigaChat-2-Max. - Модель на сервере лицензиата (LM Studio, Ollama): AI_PROVIDER=openai, AI_BASE_URL адрес сервера модели, AI_LOCAL=true.

Передачу данных во внешний сервис ИИ дополнительно разрешает администратор в разделе «Администрирование → ИИ и данные». Без этого используется только локальная модель.

6. Распознавание текста и речи

Распознавание сканов и речи выполняется на компьютере лицензиата. Модель распознавания речи входит в поставку (папка models); программа ffmpeg входит в переносную версию (папка tools), на сервере Linux ставится установщиком из пакетов системы.

7. Резервное копирование

Все данные (база данных, документы, настройки, секреты) находятся в папке data. Для резервной копии остановите программу и скопируйте папку data целиком на другой носитель. Для восстановления верните папку data на место и запустите START.cmd. Рекомендуется копировать ежедневно и хранить несколько последних копий.

Серверная версия делает копию сама каждую ночь в 03:30: база данных и файлы сохраняются в /opt/kindigital-crm/backups и хранятся 14 дней. Копируйте эту папку и на другой носитель.

8. Обновление

Обновления устанавливает администратор лицензиата вручную, автоматической загрузки обновлений нет.

  1. Сделайте резервную копию папки data.
  2. Остановите программу, замените папки app и web файлами новой версии. Папку data не трогайте.
  3. Запустите START.cmd. Изменения структуры базы данных применяются автоматически при запуске.

Серверная версия: распакуйте архив новой версии и снова выполните sudo ./install.sh. Программа обновится, данные в /opt/kindigital-crm/data сохранятся.

9. Удаление

Остановите программу и удалите папку. Данные удаляются вместе с папкой data. На сервере Linux: sudo systemctl disable --now kindigital-crm kindigital-crm-backup.timer, затем удалите папку /opt/kindigital-crm.