ДОКУМЕНТАЦИЯ
Установка и запуск
Культура Платежей · Версия 1.0.0 · Правообладатель ООО «КУЛЬТУРА КОДА»
Инструкция описывает установку серверного выпуска «Культура Платежей» версии 1.0.0 из поставляемого комплекта готовых контейнерных образов. Node.js и средства сборки на сервере установки не требуются.
Новую установку выполняют в пустую схему базы данных. Повторная инициализация существующей установки не выполняется. Обычные остановка и запуск сохраняют данные.
1. Подготовка сервера
- Linux amd64 (x86_64), Python 3.9 или новее.
- Docker Engine и плагин Docker Compose с поддержкой
up --wait. Пользователь установки должен иметь права на работу с Docker. - Домен с DNS-записью на сервер, хостовый Nginx и действительный доверенный TLS-сертификат.
- Исходящий HTTPS-доступ к
www.cbr.ruдля получения курсов. - Свободные порты
127.0.0.1:8091,127.0.0.1:8092и127.0.0.1:8093на новой установке.
Проверенная конфигурация экземпляра: Debian GNU/Linux 13.7, 2 vCPU, 4 ГБ RAM, диск 40 ГБ, swap 2 ГБ. Это параметры проверенного экземпляра, а не заявленные минимальные требования.
python3 --version
docker info
docker compose version
docker compose up --help
nginx -v
Справка Docker Compose должна содержать параметр --wait.
2. Получение и проверка комплекта
Комплект 1.0.0.tar.gz и контрольная сумма SHA-256 предоставляются отдельно. Сравните контрольную сумму полученного файла с переданной вместе с комплектом. Замените пути в примере: каталог установки должен существовать и быть пустым.
sha256sum /path/to/1.0.0.tar.gz
tar -xzf /path/to/1.0.0.tar.gz -C /path/to/install
Перейдите в корневой каталог распакованного выпуска и выполните:
sha256sum -c SHA256SUMS
cd distribution
python3 run.py check
Все проверки должны завершиться без ошибок. Команда check проверяет состав и контрольные суммы файлов; доступность Docker и курсов она не проверяет.
3. Создание настроек
В примерах замените payments.example.org на домен нового экземпляра, а admin@example.org — на адрес создаваемого суперадминистратора. Из каталога distribution выполните один раз:
python3 run.py init \
--web-origin https://payments.example.org \
--admin-origin https://payments.example.org \
--admin-email admin@example.org
В origins указывайте HTTPS-адрес без пути /admin/. Установщик сам формирует ADMIN_PUBLIC_URL с этим префиксом и создаёт файлы .local/installation.json и .local/runtime.env со случайными секретами.
Логин и пароль суперадминистратора находятся в SUPERADMIN_EMAIL и SUPERADMIN_PASSWORD файла .local/runtime.env. Файл имеет права 600 и не должен публиковаться. Сохраняйте .local вместе с резервными копиями.
4. Запуск сервисов
python3 run.py up
python3 run.py status
Установщик загружает поставленные образы и запускает API, клиентский интерфейс, административный интерфейс и PostgreSQL. Сборка и скачивание образов из внешнего реестра не выполняются. При первом запуске API применяет миграции новой базы и создаёт суперадминистратора.
API доступен на 127.0.0.1:8091, клиентский интерфейс — на 127.0.0.1:8092, административный — на 127.0.0.1:8093. PostgreSQL наружу не публикуется. Браузеры обращаются к интерфейсам через хостовый HTTPS-прокси.
5. Внешний доступ через HTTPS
Настройте хостовый Nginx. Административный интерфейс собран для /admin/, оба интерфейса обращаются к API через /api/. Пример конфигурации:
server {
listen 80;
server_name payments.example.org;
return 301 https://$host$request_uri;
}
server {
listen 443 ssl;
server_name payments.example.org;
ssl_certificate /etc/letsencrypt/live/payments.example.org/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/live/payments.example.org/privkey.pem;
client_max_body_size 15m;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
location = /admin {
return 301 /admin/;
}
location /admin/ {
proxy_pass http://127.0.0.1:8093/;
}
location /api/ {
proxy_pass http://127.0.0.1:8091/;
proxy_cookie_path /v1/ /api/v1/;
}
location / {
proxy_pass http://127.0.0.1:8092;
}
}
Замените домен и пути сертификата на фактические. Установите конфигурацию в подключаемый каталог Nginx вашей ОС, проверьте и примените её:
sudo nginx -t
sudo systemctl reload nginx
Завершающий / в proxy_pass для /admin/ и /api/ удаляет внешний префикс перед передачей запроса контейнеру. Cookie Path переписывается с /v1/ на /api/v1/; атрибуты Secure и HttpOnly сохраняются.
6. Проверка установки
- Проверьте состояние сервисов командой
python3 run.py status. - Откройте клиентский кабинет по HTTPS и административный интерфейс по пути
/admin/. - Войдите в административный интерфейс под созданным суперадминистратором. Проверьте дату курсов и результат синхронизации.
- Зарегистрируйте тестового клиента и заполните профиль компании. Подтвердите профиль в административном кабинете с учётной записью проверяющего.
- Создайте тестовое пополнение в RUB и подтвердите его оператором. Проверьте зачисление USD и запись в истории.
- Выберите плательщика и зарубежного получателя, сформируйте тестовую заявку на международный платёж способом SWIFT. При необходимости приложите тестовый инвойс как файл; проверьте комиссию и итог списания. Проверьте отмену ожидающей заявки и восстановление суммы в USD.
- Убедитесь, что данные сохраняются после штатных остановки и запуска.
Демонстрационные реквизиты не используются для реальных переводов. В рабочем процессе менеджер вручную выполняет перевод во внешнем платёжном сервисе и фиксирует результат в административном кабинете. При тестировании реальный перевод не выполняется.
7. Остановка и повторный запуск
Из каталога distribution выполните:
python3 run.py stop
python3 run.py up
Постоянные данные сохраняются. Не удаляйте тома PostgreSQL и uploads и не выполняйте повторный init существующей установки. Перед обновлениями сохраняйте базу, вложения и конфигурацию.
Предоставленный демонстрационный экземпляр
Клиентский кабинет: demo.kulturapay.ru. Административный интерфейс: demo.kulturapay.ru/admin/. Учётные данные эксперта передаются отдельно. SSH для работы через браузер не требуется.
Сценарии использования приведены в руководстве по эксплуатации.
← Все документы