Обновление и восстановление

Инструкция относится к v1.4.0 и явно отмеченным в истории релизов изменениям текущих исходников. Сохраните прежний бинарник и соответствующую копию данных.

До обновления

1. Остановите MCPBox и убедитесь, что процесс завершён; не запускайте две версии с одной базой.
2. Скопируйте всю папку установки/данных, включая скрытые файлы, SQLite и оставшиеся WAL/SHM, package_store/, knowledge_base/, skill_store/, .mcpboxpro/. Базу и файлы Skills сохраняйте вместе.
3. Отдельно сохраните внешние папки источников, данные PostgreSQL/RagBox, окружение/секреты и настройки прокси соответствующими инструментами.
4. Проверьте скачанный бинарник по SHA256SUMS того же релиза.

Замена и проверка

Замените только исполняемый файл, сохраните данные и настройки, затем запустите приложение. При старте выполняются добавочные миграции базы. Проверьте вход, количество проектов, серверы, CLI, поиск знаний, связи Skills и файлы заданий. Выполните реальный безопасный MCP-вызов: одного /healthz недостаточно.

Оба порта теперь локальные: панель 127.0.0.1:38181, MCP 127.0.0.1:38182. В v1.3.0 MCP слушал 0.0.0.0. Для прямого удалённого доступа задайте адрес явно и настройте HTTPS/авторизацию; прокси на той же машине не требует публичного bind. Если старая установка должна сохранить admin-порт 38180, явно задайте MCPBOX_PORT=38180.

Миграция PolicyBox

В v1.4.0 интеграция удалена. Старые проекты с проверкой идентификации блокируются до явного перехода на bearer с паузой для проверки доступа. Перед включением проверьте сохранённые OAuth-клиенты. Новый bearer не воспроизводит правила личности/ролей PolicyBox. Выполните инструкцию миграции.

Прежние редакции и Skills

Возможности бывшего MCPBoxPro включены без лицензии. Аккаунты и совместимые имена /api/pro/*, pro:*, MCPBOX_PRO_* сохраняются. Отдельные базы MCPBox/MCPBoxPro не объединяются автоматически. Данные SkillBox не мигрируют и не удаляются: импортируйте переносимые пакеты явно.

Откат

Остановите новую версию. Восстановите прежний бинарник вместе с соответствующей копией базы, файлов, внешнего состояния и конфигурации до обновления. Сначала проверьте восстановление в отдельной установке. Замена одного бинарника не отменяет миграции данных.