Агенты > Pastukhov MultiAgent > Документация MultiAgent > Установка и настройка

Установка и настройка

Эта страница — для тех, кто ставит MultiAgent сам, на своём сервере или компьютере с Windows: от установки до первой рабочей фабрики. Дальше MultiAgent управляет остальными серверами сам — на них ничего настраивать вручную не нужно.

Если вы на тарифе «Эксперт», сервер и обслуживание — на вас, а помощь с установкой и настройкой входит в подписку: пишите в Telegram @max_pas, если что-то не получается.

Что понадобится

  • Машина под сам MultiAgent — Linux с Docker или Windows 10 и новее (64-разрядная). Хватит 1 ГБ памяти; база по умолчанию встроенная, PostgreSQL подключается по желанию. Мощность нужна не MultiAgent, а агентам — они работают на управляемых серверах.
  • Управляемые серверы — Linux (Ubuntu/Debian) с SSH-доступом и правами root или sudo. Подключение — по паролю или приватному ключу. Docker и всё остальное на них MultiAgent поставит сам.
  • Лицензия — встроенного пробного ключа нет: без ключа приложение работает, но не даёт создавать и менять фабрики и агентов. Ключ выдаётся вручную: пробный — в составе тарифа «Пробный», ключ тарифа «Эксперт» — после оплаты на странице «Купить фабрику агентов».

Установка в Docker

Для этого способа подойдёт любой сервер или компьютер с Docker. Создайте файл compose.yml:

services:
  multiagent:
    image: maxpastukhov/multiagent:min-latest
    container_name: multiagent
    ports:
      - "3990:80"
    volumes:
      - multiagent-data:/data
    environment:
      - ASPNETCORE_ENVIRONMENT=Production
      - ASPNETCORE_URLS=http://+:80
      - MULTIAGENT_DATA=/data
      # русская сборка и так открывается на русском — строку можно не указывать
      - MULTIAGENT_BRAND=pastukhov
      # ключ лицензии: без него приложение работает, но не даёт менять фабрики и агентов
      # - AGENT_LICENSE=ваш-ключ
    restart: unless-stopped

volumes:
  multiagent-data:

Запустите docker compose up -d и откройте http://адрес-машины:3990. Том /data обязателен: в нём живут база, ключи, сертификаты и лицензия, и без него всё это пропадёт при первом же docker compose down.

Полный разбор — минимальные требования, все переменные окружения, файл .env, хранение данных и запуск без compose — на странице «Установка в Docker».

Установка на Windows

Установщик PastukhovMultiAgent-Setup-<версия>.exe ставит MultiAgent службой Windows: она запускается вместе с системой и продолжает управлять серверами, даже когда в систему никто не вошёл. Мастер спросит порт (по умолчанию 3991), папку данных, логин и пароль, лицензию и режим запуска службы. Среда .NET не нужна — в установщике уже всё есть. Подробнее — на странице «Установка на Windows».

Первый вход

Откройте веб-интерфейс и нажмите «Регистрация»: первый пользователь создаётся прямо на странице входа и становится администратором. Логин и пароль можно задать и заранее — переменными MULTIAGENT_LOGIN и MULTIAGENT_PASSWORD, где пароль хранится отпечатком SHA-256. Получить такой отпечаток можно на странице входа или в командной строке Linux и macOS:

printf '%s' 'ваш-пароль' | sha256sum | cut -d' ' -f1

Команда вернёт отпечаток из 64 символов — его и подставьте в MULTIAGENT_PASSWORD. В браузере данные пользователя (куки) запоминаются на 90 дней.

Лицензия

Встроенного пробного ключа в сборке нет: ключ выдаётся вручную, а пробный идёт в составе тарифа «Пробный». Свой ключ добавляется двумя способами: переменной AGENT_LICENSE при запуске или в диалоге лицензии — его открывает строка состояния лицензии в окне настроек. Лицензия — подписанная строка: сервер никуда не обращается за проверкой, а срок и продление видны там же. Подробнее — Безопасность и лицензирование.

Настройка после установки

  1. Добавьте сервер — машину, на которой будут жить фабрики: адрес, SSH-порт, пользователь, пароль или приватный ключ. На Windows вместо SSH можно выбрать «Локальный WSL» — дистрибутив на этом же компьютере. Подробнее — Серверы.
  2. Создайте фабрику — выберите сервер, задайте имя и короткое имя развёртывания (слаг, по умолчанию agents): оно задаёт сеть, приставку имён контейнеров и папки. Подробнее — Фабрики.
  3. Пройдите чек-лист фабрики — кнопка проверки на её странице покажет, чего не хватает: подключение, Docker, папки, Nginx, сертификат, Postgres, резервные копии, домашняя страница, центральный вход. Недостающее исправляется в один клик.
  4. Поставьте агентов и продукты — мастер «Новый агент»: выберите тип (автономный агент или продукт), имя, фабрику, образ и порт подставятся сами. Дальше MultiAgent соберёт compose.yml и поднимет контейнеры на сервере. Подробнее — Агенты.

Остальные шаги — маршруты по подпапкам, домашняя страница фабрики, единый вход по QR-коду — разобраны в «Начале работы».

Обновление

  • Docker — docker compose pull, затем docker compose up -d: том с данными остаётся на месте;
  • Windows — повторный запуск установщика новой версии: мастер предложит «Перенастроить или обновить», файлы заменятся, папка данных сохранится;
  • Агенты и продукты — обновляются из интерфейса: «Обновить плавно» дождётся паузы в чате, «Пересоздать» заменит контейнер сразу. Подробнее — Агенты.

Резервные копии

На каждой фабрике MultiAgent поднимает службу резервного копирования: она отдаёт папки docker, данных, проектов, инструментов, домашней страницы и другие разделы — только на чтение, чтобы копию можно было забрать по расписанию. Сам MultiAgent копируется вместе с томом /data, поэтому держите его на постоянном томе. Подробнее — раздел «Резервное копирование» на странице Безопасность и лицензирование.

Безопасность

MultiAgent хранит SSH-ключи серверов, пароли агентов и лицензионные ключи, поэтому в открытый интернет его порт лучше не выставлять напрямую: поставьте перед ним прокси с HTTPS (например, Nginx) или включите MULTIAGENT_SSL=auto — тогда MultiAgent поднимет HTTPS на соседнем порту с самоподписанным сертификатом (в Docker этот порт нужно открыть в compose.yml). Все секреты на диске шифруются. Подробнее — Безопасность и лицензирование.

Если что-то не работает

  • Docker — журнал контейнера: docker logs multiagent;
  • Windows — журнал <папка данных>\service.log и служба «MultiAgent (Pastukhov)» в services.msc;
  • Страница не открывается — чаще всего порт уже занят другой программой: поменяйте его в compose.yml или в мастере установки;
  • Вопрос по настройке — Telegram @max_pas: помощь с установкой и настройкой входит в подписку «Эксперт».

← Оглавление документации