Скачивание, первый запуск, мастер настройки и дальнейшая конфигурация через админ-панель — без API.
Версия 1.0.6. Для установки и настройки платформы API не нужен — все шаги выполняются через веб-интерфейс. Документация API для внешних интеграций — на странице Документация; полная интерактивная документация — в разделе API Explorer админ-панели.
| Компонент | Требование |
|---|---|
| ОС | Linux x86_64 (Ubuntu 20.04+, CentOS 8+ и др.), Windows 10+, macOS 12+ |
| ОЗУ | от 512 МБ (рекомендуется 2 ГБ) |
| Диск | от 500 МБ свободного места |
| СУБД | MySQL 8.0+ или PostgreSQL 14+ (можно поднять отдельно или в Docker) |
Рекомендуемый способ для Linux — готовый дистрибутив ядра.
wget https://cascad360.ru/downloads/core/1.0.6/cascad360-1.0.6-linux-x86_64.tar.gz
# или
curl -LO https://cascad360.ru/downloads/core/1.0.6/cascad360-1.0.6-linux-x86_64.tar.gzПрямая ссылка: cascad360-1.0.6-linux-x86_64.tar.gz
tar -xzf cascad360-1.0.6-linux-x86_64.tar.gz
cd cascad360-1.0.6-linux-x86_64
# опционально: установка в /opt
# sudo mv cascad360-1.0.6-linux-x86_64 /opt/cascad360
# cd /opt/cascad360./cascad360 start
# если исполняемый файл в bin/:
# ./bin/cascad360 startПосле запуска откройте в браузере:
http://localhost:5000http://localhost:5000/setuphttp://localhost:5000/adminОсновной файл — config.yml в каталоге установки. При первой установке можно скопировать шаблон:
cp config.yml.example config.ymlМинимально полезные параметры перед первым запуском:
app:
name: Контур
version: 1.0.6
setup_completed: false
web:
host: 0.0.0.0
port: 5000
public_port: 5001
public_api_separate: false # true — Public API на отдельном порту
public_api_enabled: true
plugin_ports:
enabled: false # true — HTTP-listener'ы плагинов (см. 3.1)
database:
driver: mysql
host: localhost
port: 3306
database: cascad360
username: cascad_user
password: change-meПараметры подключения к БД можно также указать в мастере настройки (/setup) — тогда правка config.yml не обязательна до первого входа.
Перед продакшеном измените пароль БД и секретные ключи приложения. Полный список параметров — в config.yml.example и документации API; детально про порты — в разделе 3.1.
Порты задаются в config.yml. После изменения перезапустите сервис.
| Порт / диапазон | Параметр | Назначение |
|---|---|---|
5000 | web.port | Основной HTTP: админ-панель, Admin API, шлюз, маршрутизация |
5001 | web.public_port | Public API — только при public_api_separate: true |
8000–8999 | plugin_ports | Диапазон HTTP-listener'ов плагинов (при enabled: true) |
web)port — порт админки и Admin API (по умолчанию 5000).public_api_separate: false — Public API на том же порту (режим по умолчанию, как в 1.0.5).public_api_separate: true — Admin API на port, Public API на public_port; удобно для сетевого разделения контуров.public_api_enabled: false — отключить Public API полностью.# Раздельные порты Admin и Public API
web:
port: 5000
public_port: 5001
public_api_separate: true
public_api_enabled: trueplugin_ports, 1.0.6)Для плагинов с собственным веб-интерфейсом. По умолчанию выключено — ядро остаётся компактным.
plugin_ports:
enabled: true
port_range_min: 8000
port_range_max: 8999
max_listeners: 10
reserved_ports: [5000, 5001, 5050] # порты, которые плагины не могут занять
auto_start_on_boot: false
default_host: 0.0.0.0
hook_timeout_seconds: 30Управление listener'ами — в админ-панели (раздел плагинов) с правами plugin_ports_view, plugin_ports_manage, plugin_ports_operate.
Firewall: откройте только нужные порты — обычно web.port и при необходимости public_port или конкретные порты из диапазона plugin_ports. Порт СУБД не должен быть доступен извне.
При первом запуске (setup_completed: false) система перенаправляет на http://localhost:5000/setup. Мастер выполняется в браузере, шаги:
setup_completed: true.После завершения войдите в админ-панель: http://localhost:5000/admin с учётной записью, созданной на шаге 2.
Все дальнейшие настройки — через боковое меню админ-панели. Доступ к разделам зависит от роли и прав пользователя.
| Раздел | Путь | Что настраивается |
|---|---|---|
| Главная | /admin/ | Дашборд, сводка состояния |
| Сервисы | /admin/services | Список сервисов, статус, запуск и остановка |
| Маршрутизация | /admin/routing | Правила проксирования запросов к сервисам |
| Балансировка | /admin/load-balancing | Алгоритмы распределения нагрузки |
| Контейнеры | /admin/containers | Управление контейнерами (Docker) |
| Пользователи | /admin/users | Учётные записи, роли и права |
| Модули | /admin/modules | Установленные модули ядра |
| Плагины | /admin/plugins | Включение и конфигурация плагинов |
| Обновления | /admin/updates | Обновление ядра, модулей и плагинов |
| Маркет | /admin/market | Каталог и установка артефактов |
| Журналы | /admin/logs | Логи системы |
| Мониторинг | /admin/monitoring | Метрики, алерты, дашборды |
| Файлы | /admin/files | Загрузка и управление файлами |
| БД ядра | /admin/database | Структура таблиц основной БД |
| БД сервисов | /admin/service-databases | Привязка БД к сервисам |
| Студия БД | /admin/db-studio | Работа с таблицами, SQL-консоль, аудит |
| API Explorer | /admin/api-explorer | Документация Admin/Public API, Try it out, экспорт OpenAPI |
| Настройки | /admin/settings | Системные параметры, API-ключи для интеграций |
Работа с данными выполняется в трёх связанных разделах админ-панели.
/admin/database)Просмотр структуры основной базы данных платформы: список таблиц, проверка схемы. Используется для диагностики после установки.
/admin/service-databases)Привязка отдельных баз данных к подключённым сервисам:
/admin/db-studio)Единый интерфейс для любой привязанной базы (ядро или сервис):
В верхней части студии выберите источник данных и базу — контекст сохраняется в URL, ссылку можно передать коллеге.
Доступ к студии и операциям с данными регулируется правами роли: db_view, db_edit, db_schema, db_sql_execute, db_audit. Назначение прав — в разделе «Пользователи».
/admin/api-explorer)Единый раздел для просмотра и проверки API без внешних инструментов:
api_docs_view, api_docs_execute);Публичная страница Swagger для внешнего API: /api/docs/public. Старый адрес /api/v1/admin/docs перенаправляет в API Explorer.
Если плагин предоставляет собственный HTTP-интерфейс, включите plugin_ports.enabled: true в config.yml — параметры и диапазоны портов описаны в разделе 3.1. Регистрация и запуск listener'ов — в админ-панели (раздел плагинов) с учётом RBAC.
/admin/services)На странице сервисов отображаются подключённые бэкенды: статус, health-check, метрики. Доступны действия запуска, остановки, перезапуска и масштабирования — через кнопки в интерфейсе.
/admin/routing)Настройка правил, по которым запросы /api/module/<модуль>/… проксируются к целевым сервисам:
/admin/load-balancing)Выбор алгоритма распределения запросов между репликами сервиса (round-robin, least connections и др.).
/admin/containers)Обзор и управление Docker-контейнерами, если Service Discovery работает через Docker.
/admin/updates)Управление версиями ядра, модулей и плагинов:
stable, beta);Канал и URL реестра задаются в config.yml (секция updates), остальное — в панели.
/admin/market)Витрина модулей и плагинов поверх центра обновлений:
Установка и обновление из маркета требуют активной подписки или лицензии. На dev/staging просмотр каталога может быть доступен без подписки (параметр market.subscription_gate_mode: browse в config.yml).
Если нужно подключить внешнее приложение к данным или файлам платформы, создайте API-ключ в разделе Настройки (/admin/settings) и назначьте нужные разрешения. Подробности — в документации публичного API.
Убедитесь, что платформа работает:
http://localhost:5000/admin и войдите с учётной записью администратора.curl http://localhost:5000/api/health
# Ожидаемый ответ: {"status":"ok","version":"1.0.6"}Если шлюз не отвечает — проверьте, что процесс запущен (./cascad360 status), порт 5000 не занят и параметры БД в config.yml верны.