---
title: "Передача сервера"
id: "1946"
type: "page"
slug: "handover"
published_at: "2026-09-20T12:55:20+00:00"
modified_at: "2026-09-22T15:01:36+00:00"
url: "https://pastukhov.com/agents/multiagent/docs/handover"
markdown_url: "https://pastukhov.com/agents/multiagent/docs/handover.md"
excerpt: "Обычно MultiAgent — центр управления: он держит записи серверов, разворачивает на них агентов и продукты…"
---

# Передача сервера

[https://pastukhov.com/agents/multiagent/docs/handover.md](https://pastukhov.com/agents/multiagent/docs/handover.md)

Обычно MultiAgent — центр управления: он держит записи серверов, разворачивает на них агентов и продукты и настраивает маршрутизацию. Но сервер может быть не вашим, а клиентским, и тогда логично отдать управление самому клиенту: он получает свой MultiAgent на своём сервере и сам распоряжается своими агентами. **Передача** — это разовая операция, которая переносит управление записями с вашего центрального экземпляра на экземпляр клиента. Сами запущенные приложения при этом не трогаются: они продолжают работать, ничего не останавливается и не переустанавливается.

Что это даёт на практике: клиент становится полным хозяином своих агентов, приложений и маршрутов, а вы продолжаете отвечать только за сам сервер — доступ по SSH, проверки, папки, очистку Docker. Секреты при передаче идут напрямую между двумя экземплярами по защищённому машинному каналу и не показываются ни в интерфейсе, ни в журналах, ни в ответах программного API.

## Как это устроено

На сервере разворачивают сам MultiAgent — как обычный продукт из каталога, вкладка «Новый агент». Ничего отдельного настраивать не нужно: появившись, этот экземпляр сам получает от центрального свою запись сервера и сразу подключается к нему. Записи передаются между двумя MultiAgent напрямую, поэтому клиенту не нужно ничего вводить руками и не нужно открывать наружу какие-то дополнительные адреса.

Пока на сервере есть свой MultiAgent, на странице сервера в центральном экземпляре появляется вкладка **«Передача»**, а в шапке страницы — кнопка **«Управление»**.

## Вкладка «Передача»

Вкладка показывает предпросмотр: что именно переедет к клиенту и что останется у вас. Передумать на этом шаге можно без последствий — предпросмотр ничего не меняет.

- **Переезжает:** агенты, приложения продуктов, инструменты, свои маршруты, данные сертификатов, ключи доступа к репозиториям, а по желанию — и лицензии, на которые ссылаются агенты;
- **Остаётся у вас:** сама строка сервера — доступ по SSH, проверки, папки и очистка Docker — и строка приложения Мультиагент, чтобы вы могли обновлять его образ.

Кнопка **«Передать»** запускает саму операцию: она ещё раз связывается с экземпляром клиента, отправляет ему все записи и показывает ход переноса в панели прогресса. Передача считается успешной, только когда на стороне клиента появились все записи агентов и инструментов. После этого центральный экземпляр забывает перенесённые записи — на самом сервере при этом ничего не удаляется, контейнеры работают как работали.

Если что-то пошло не так, на вашей стороне **ничего не меняется**: ни пометок, ни удалений. В отчёте будет названо то, из-за чего операция не прошла, — чаще всего это имя, которое уже занято на экземпляре клиента. Устраните это на его стороне и запустите передачу снова: повторная попытка безопасна. Сбои при переносе маршрутов, сертификатов или ключей репозиториев передачу не блокируют — эти записи при необходимости создаются на стороне клиента вручную.

## Что происходит после передачи

- **Маршрутизацией управляет клиент.** Виртуальный веб-сервер собирается из записей самого экземпляра клиента, поэтому он и решает, куда ведут подпапки. Изменение адресов, развёртывание новых агентов и продуктов на сервере идут через его экземпляр;
- **Ваша сторона больше не пересобирает конфигурацию.** Все операции, которые раньше обновляли маршруты, теперь просто отмечают в журнале, что сервер передан. Это не мешает ни работать с файлами по SSH, ни запускать и останавливать приложения, за которые вы по-прежнему отвечаете;
- **Сервер отдан один раз.** Повторная передача того же сервера отклоняется с понятным сообщением. Так исключены две системы, одновременно правящие одну конфигурацию.

## Кнопка «Управление» — зайти к клиенту без пароля

После передачи сервером удобно заглянуть в экземпляр клиента: проверить, как встали агенты, разобраться с занятым именем, посмотреть его маршруты. Кнопка **«Управление»** в шапке страницы открывает интерфейс клиента в новой вкладке уже выполненным входом — пароль вводить не нужно, и он нигде не хранится.

Для этого центральный экземпляр выдаёт разовую ссылку входа: код действует пять минут и срабатывает только один раз. Чужой или устаревший код просто приводит на страницу входа клиента. Сам ключ доступа при этом остаётся на сервере и в браузер не попадает. Если экземпляр клиента закрыт центральным входом, сначала придётся один раз пройти его обычный вход — кода это не касается.

## Если что-то не получается

- **Ответ «включите машинный API».** Значит, приложение Мультиагент было развёрнуто раньше, чем появился ключ доступа, по которому экземпляры разговаривают между собой. Пересоздайте это приложение на центральном экземпляре и повторите передачу;
- **Ответ «ключ отвергнут».** Так бывает, если экземпляр клиента развернули заново и он получил новый ключ. Лечится так же — пересозданием приложения на центральном экземпляре;
- **Перенос не принял какое-то имя.** Запись с таким именем уже есть на экземпляре клиента. Переименуйте или удалите её там и запустите передачу снова;
- **Маршруты выглядят устаревшими.** Значит, клиент не успел применить свою конфигурацию — это не блокирует передачу. Откройте его вкладку «Nginx» и нажмите «Применить конфигурацию».

Подробнее о том, как устроены маршруты сервера, — на странице [Nginx-роутинг](/agents/multiagent/docs/routes)
; о самом приложении Мультиагент — на странице [Продукты](/agents/multiagent/docs/products)
.

[← Оглавление документации](/agents/multiagent/docs)