Инструкция по установке и настройке ПО «1С-ФИНДИР»

Серверная версия (on-premise) — установка на оборудовании Заказчика

1. Минимальные технические требования

Операционная система:
Debian 12 (Bookworm) 64-bit и старше
CPU:
2 ядра, 2.3 GHz
RAM:
4 GB, рекомендовано 8 GB
ROM:
20 GB свободного места
Почта:
SMTP-сервер или релей для отправки почтовых уведомлений

2. Схема архитектуры

Заказчик 1С-ФИНДИР NGINX PostgreSQL Dashboard Backend API Dashboard Frontend Браузер клиента HTTPS 443

3. Описание ПО

Основные компоненты ПО:
  • Backend — предоставляет API, парсинг данных, расчет всех показателей, формирование Excel-файлов, проверки данных
  • Frontend — UI Личного кабинета
Вспомогательные компоненты:
  • PostgreSQL — база для хранения данных
  • Nginx — прокси-сервер

4. Ход установки

Для установки программного обеспечения «1С-ФИНДИР» потребуется около 2–4 часов.

4.1. Загрузка Docker-образов

Авторизация в нашем registry и загрузка Docker-образов предоставляются после подписания договора.

4.2. Настройка перед деплоем

Сертификаты

Необходимо подготовить сертификаты для локальной (внутренней) сети. Если используется DMZ, необходим сертификат для доступа из внешней сети, подписанный GlobalSign.

Сертификаты добавьте в директорию /etc/ssl/certs/findir с именами:

Локальные сертификаты:
internal.domain.crt, internal.domain.key
Глобальные сертификаты (опционально):
external.domain.crt, external.domain.key

В директорию /opt/findir/nginx добавьте шаблоны nginx. Скачать их можно по ссылке.

ШаблонНазначениеКогда нужен
internal.conf.templateМаршрутизация трафика внутри локальной сети Заказчика. Используется самоподписанный сертификат локальной сетиОбязательно
external.conf.templateМаршрутизация трафика для глобальной сети. Используется сертификат, подписанный GlobalSignЕсли используется доступ из внешней сети (опционально)

В шаблоне nginx можно переопределить имя сертификата.

Локальная сеть — internal.conf.template:

…
ssl_certificate     /etc/nginx/ssl/internal.domain.crt;
ssl_certificate_key /etc/nginx/ssl/internal.domain.key;
…

Глобальная сеть — external.conf.template:

…
ssl_certificate     /etc/nginx/ssl/external.domain.crt;
ssl_certificate_key /etc/nginx/ssl/external.domain.key;
…

Проверка портов на сервере ПО

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

— PostgreSQL: 5432

— nginx http: 80

— nginx https: 443

Для проверки занятых портов используйте команду:

sudo netstat -tlpn | grep -E "(:443|:80|:5432)"

Если порты заняты другим ПО, найдите процесс по номеру порта, затем по PID завершите его:

sudo lsof -i :80
sudo kill -9 <PID>

4.3. Деплой ПО с помощью docker-compose

Заказчику предоставляется ссылка на директорию с файлами:

— docker-compose.yml — файл с описанием развертывания Docker-контейнеров;

— .env — файл с конфигурационными настройками.

Их необходимо добавить в созданную ранее директорию /opt/findir/docker. В файле .env замените значение NGINX_HOST на DNS-имя Вашей внутренней сети.

Запуск сервиса 1С-ФИНДИР

Для запуска перейдите в директорию с файлами и выполните команду:

sudo docker compose up -d

Если docker-compose.yml лежит в другой директории или имеет другое имя:

sudo docker compose -f path/to/docker-compose.yml up -d

Если .env лежит в другой директории или имеет другое имя:

sudo docker compose --env-file path/to/env/file up -d

Или оба варианта:

sudo docker compose -f path/to/docker-compose.yml --env-file path/to/env/file up -d

5. Результат установки и доступ

После выполнения вышеуказанных действий приложение будет доступно по адресу https://<NGINX_HOST>. Переменная NGINX_HOST берется из переменных окружения в файле .env.

Для первичной настройки воспользуйтесь учетной записью Администратора — в дальнейшем ее можно удалить.

Логин:
Запросить у администратора
Пароль:
Запросить у администратора

После успешной авторизации откроется главный экран:

Главный экран 1С-ФИНДИР после авторизации Скриншот: главный экран после авторизации

6. API 1С-ФИНДИР

Swagger backend:
https://<your-dns>/backend/swagger/index.html
Swagger aggregation service:
https://<your-dns>/aggregation/swagger/index.html