Различия

Показаны различия между двумя версиями страницы.

--- vm:n8n_mcp:01-install_http_multi-user [2025/08/13 20:30] – admin
+++ vm:n8n_mcp:01-install_http_multi-user [2025/08/14 11:08] (текущий) – admin
@@ Строка 1: / Строка 1: @@
+====== n8n MCP Multi-Instance - Руководство пользователя ======
 =====Источники=====
 https://github.com/czlonkowski/n8n-mcp\\
@@ Строка 4: / Строка 6: @@
 =====Установка в один клик=====
+** Важно!**\\
+Если хотите что бы все папки и файлы создались от текущего пользователя что бы был доступ для редактирования запускать не от SUDO\\
+Тогда скрипт выяснит текущего пользователя и установит все от системного пользователя.
 <code>
 cd ~
@@ Строка 9: / Строка 14: @@
 tar -xvf n8n_mcp_multi_installer.tar
 chmod +x n8n_mcp_multi_installer.sh
-sudo ./n8n_mcp_multi_installer.sh
+./n8n_mcp_multi_installer.sh
 </code>
-====== n8n MCP Multi-Instance - Руководство пользователя ======
+** Важно!**\\
+После установки первичной нужно выйти из текущей сессии и зайти что бы применились все новые права для работы с меню.
-===== Обзор системы =====
+====== N8N MCP Multi-Instance Docker Installer v3.0 ======
-n8n MCP Multi-Instance - это система управления множественными изолированными инстансами n8n MCP с централизованным управлением клиентскими подключениями.
+===== Описание =====
-==== Ключевые возможности ====
+**N8N MCP Multi-Instance Docker Installer** - это автоматизированный скрипт для развертывания множественных изолированных инстансов n8n-mcp в Docker контейнерах с умным управлением портами и централизованной системой управления.
-  * 🏗️ **Множественные инстансы** - создание изолированных серверов на разных портах
-  * 🔄 **Автоматическое распределение портов** - система сама выбирает свободные порты
-  * 👥 **Управление клиентами** - создание конфигураций для подключения MCP клиентов
-  * 🎛️ **Централизованное управление** - единая консоль для всех операций
-  * 🚀 **Массовые операции** - запуск/остановка всех инстансов одной командой
-===== Структура системы =====
+<WRAP center round info 60%>
+**Версия:** 3.0\\
+**Совместимость:** Ubuntu 18.04+, Debian 10+\\
+**Требования:** sudo права, интернет соединение\\
+**Автор:** Система автоматической установки n8n-mcp
+</WRAP>
-<code>
+===== Основные возможности =====
-/opt/n8nmcp/
-├── instances/              # Инстансы n8n MCP
+  * 🚀 **Автоматическая установка** Docker и Docker Compose
-│   ├── main/              # Базовый инстанс (создается автоматически)
+  * 🎯 **Умное управление портами** с автоматическим поиском свободных портов
-│   ├── instance2/         # Дополнительные инстансы
+  * 📦 **Множественные инстансы** с изоляцией и независимой конфигурацией
-│   └── ...
+  * 🎛️ **Консоль управления** с 16 функциями администрирования
-├── clients/               # Клиентские конфигурации
+  * 👥 **Управление клиентами** с генерацией конфигов подключения
-│   ├── client1/
+  * 🔒 **Безопасность** с автоматической генерацией токенов авторизации
-│   └── ...
+  * 📊 **Мониторинг** статуса всех инстансов и портов
-├── multi-manage.sh        # Главная консоль управления
-├── start-main.sh          # Быстрый запуск базового инстанса
+===== Быстрый старт =====
-└── logs/                  # Общие логи системы
+==== 1. Загрузка и запуск ====
+<code bash>
+# Скачайте скрипт
+wget https://your-domain.com/install-n8n-mcp-v3.sh
+# Или создайте файл вручную
+nano install-n8n-mcp-v3.sh
+# Вставьте код скрипта
+# Сделайте исполняемым
+chmod +x install-n8n-mcp-v3.sh
+# Запустите установку
+./install-n8n-mcp-v3.sh
 </code>
-===== Запуск консоли управления =====
+==== 2. Применение прав Docker ====
+После установки выполните одну из команд для применения прав Docker:
-==== Основная команда ====
 <code bash>
-/opt/n8nmcp/multi-manage.sh
+# Вариант 1: Применить в текущей сессии
+newgrp docker
+# Вариант 2: Перелогиниться
+exit
+ssh user@server
 </code>
-==== Быстрый запуск базового инстанса ====
+==== 3. Запуск базового инстанса ====
 <code bash>
+# Быстрый запуск основного инстанса
 /opt/n8nmcp/start-main.sh
+# Или через консоль управления
+/opt/n8nmcp/multi-manage.sh
 </code>
-===== Главное меню =====
+===== Структура установки =====
-При запуске консоли управления вы увидите следующее меню:
+После установки создается следующая структура:
 <code>
-================================
+/opt/n8nmcp/
-n8n MCP Multi-Instance Management Console
+├── instances/           # Директория инстансов
-================================
+│   └── main/           # Базовый инстанс
+│       ├── docker-compose.yml
+│       ├── .env        # Конфигурация
+│       ├── instance.json # Метаданные
+│       ├── data/       # Данные инстанса
+│       ├── logs/       # Логи
+│       └── config/     # Конфигурации
+├── clients/            # Клиентские конфиги
+├── logs/              # Общие логи
+├── config/            # Общие конфигурации
+├── shared/            # Общие ресурсы
+├── multi-manage.sh    # Консоль управления
+├── start-main.sh      # Быстрый запуск
+├── instances.registry # Реестр инстансов
+└── clients.registry   # Реестр клиентов
+</code>
-📦 ИНСТАНСЫ:
+===== Консоль управления =====
-) 🆕 Создать новый инстанс
-) 📋 Список инстансов
-) ⚙️  Управление инстансом
-) 🔄 Запустить все инстансы
-) ⏹️  Остановить все инстансы
-👥 КЛИЕНТЫ:
+Запустите консоль управления: ''%%/opt/n8nmcp/multi-manage.sh%%''
-) 🆕 Создать клиентский конфиг
-) 📋 Список клиентов
-) 🔌 Тестировать подключение клиента
-) 🗑️  Удалить клиента
-🔧 СИСТЕМА:
+==== Категории функций ====
-) 📊 Общий статус системы
-) 📡 Показать все подключения
-) 🧹 Очистка неиспользуемых ресурсов
-) 🔄 Обновить все образы
-) 🔧 Исправить права доступа
-) ❌ Выход
+=== 📦 ИНСТАНСЫ ===
-</code>
-===== Управление инстансами =====
+^ Опция ^ Функция ^ Описание ^
+| **1** | 🆕 Создать новый инстанс | Создание нового изолированного инстанса |
+| **2** | 📋 Список инстансов | Отображение всех инстансов с статусом |
+| **3** | ⚙️ Управление инстансом | Запуск/остановка/удаление инстанса |
+| **4** | 🔄 Запустить все инстансы | Массовый запуск всех инстансов |
+| **5** | ⏹️ Остановить все инстансы | Массовая остановка всех инстансов |
-==== Создание нового инстанса ====
+=== 👥 КЛИЕНТЫ ===
-=== Шаг 1: Выберите пункт меню ===
+^ Опция ^ Функция ^ Описание ^
-Выберите **1) 🆕 Создать новый инстанс** в главном меню
+| **6** | 🆕 Создать клиентский конфиг | Генерация конфига для подключения |
+| **7** | 📋 Список клиентов | Отображение всех клиентских конфигов |
+| **8** | 🔌 Тестировать подключение | Проверка соединения с инстансом |
+| **9** | 🗑️ Удалить клиента | Удаление клиентского конфига |
-=== Шаг 2: Введите имя инстанса ===
+=== 🌐 ПОРТЫ ===
-<code>
-Введите имя инстанса: production
-</code>
-<WRAP center round info 60%>
+^ Опция ^ Функция ^ Описание ^
-**Рекомендации по именованию:**
+| **10** | 📊 Показать использование портов | Карта занятых/свободных портов |
-  * Используйте понятные имена: ''production'', ''development'', ''test''
+| **11** | 🔍 Найти свободный порт | Поиск доступного порта в диапазоне |
-  * Избегайте пробелов и специальных символов
-  * Используйте только латинские буквы, цифры и дефисы
-</WRAP>
-=== Шаг 3: Выбор порта ===
+=== 🔧 СИСТЕМА ===
-<code>
-Автоматически выбран порт: 3001
-Использовать этот порт или ввести другой? (Enter для 3001):
-</code>
-  * **Enter** - использовать автоматически выбранный порт
+^ Опция ^ Функция ^ Описание ^
-  * **Ввести число** - использовать свой порт (например: ''3005'')
+| **12** | 📊 Общий статус системы | Информация о Docker, инстансах, ресурсах |
+| **13** | 📡 Показать все подключения | URL и токены всех инстансов |
+| **14** | 🧹 Очистка неиспользуемых ресурсов | Docker system prune |
+| **15** | 🔄 Обновить все образы | Обновление n8n-mcp образов |
+| **16** | 🔧 Исправить права доступа | Восстановление прав на файлы |
-=== Результат создания ===
+===== Создание инстанса =====
-<code>
-✅ Инстанс production создан успешно!
+==== Автоматический режим ====
-Порт: 3001
-AUTH_TOKEN: AbCdEf123456...
+<code bash>
+# Через консоль управления
+/opt/n8nmcp/multi-manage.sh
+# Выберите опцию 1
+# Введите имя инстанса (например: production)
+# Система автоматически найдет свободный порт
 </code>
-<WRAP center round important 60%>
+==== Интерактивный выбор порта ====
-**ВАЖНО:** Обязательно сохраните AUTH_TOKEN - он понадобится для подключения клиентов!
+При создании инстанса доступны 3 опции:
+  - **1)** Использовать предлагаемый порт (автоматический)
+  - **2)** Ввести другой порт вручную
+  - **3)** Показать занятые порты и выбрать
+<WRAP center round tip 60%>
+**Совет:** Используйте опцию 3 для просмотра карты портов перед выбором
 </WRAP>
-==== Просмотр списка инстансов ====
+==== Конфигурация .env файла ====
-Выберите **2) 📋 Список инстансов** для просмотра всех созданных инстансов:
+После создания инстанса отредактируйте файл конфигурации:
-<code>
+<code bash>
-Активные инстансы:
+nano /opt/n8nmcp/instances/ИМЯ_ИНСТАНСА/.env
-------------------------------------------------
-ИМЯ             ПОРТ       СТАТУС       СОЗДАН
-------------------------------------------------
-main            3000       ЗАПУЩЕН      2025-01-15
-production      3001       ОСТАНОВЛЕН   2025-01-15
-development     3002       ЗАПУЩЕН      2025-01-15
-------------------------------------------------
 </code>
-==== Управление отдельным инстансом ====
+Раскомментируйте и настройте N8N API:
-=== Выбор инстанса ===
+<code bash>
-Выберите **3) ⚙️ Управление инстансом**, затем введите имя инстанса:
+# n8n MCP Instance Configuration - production
-<code>
+AUTH_TOKEN=сгенерированный_токен
-Введите имя инстанса: production
+USE_FIXED_HTTP=true
-</code>
+MCP_MODE=http
+TZ=Europe/Moscow
+INSTANCE_NAME=production
+INSTANCE_PORT=3001
-=== Меню управления ===
+# Добавьте здесь ваши n8n API настройки:
-<code>
+N8N_API_URL=https://your-n8n-instance.com
-Управление инстансом: production
+N8N_API_KEY=your-n8n-api-key
-) Запустить
-) Остановить
-) Перезапустить
-) Логи
-) Статус
-) Удалить
 </code>
-=== Описание действий ===
+===== Управление инстансами =====
-^ Действие ^ Описание ^
-| **Запустить** | Запуск остановленного инстанса |
-| **Остановить** | Остановка работающего инстанса |
-| **Перезапустить** | Перезапуск инстанса (применение изменений) |
-| **Логи** | Просмотр логов в реальном времени (Ctrl+C для выхода) |
-| **Статус** | Информация о состоянии контейнера |
-| **Удалить** | Полное удаление инстанса (требует подтверждения) |
-==== Массовые операции ====
+==== Основные команды ====
-=== Запуск всех инстансов ===
+<code bash>
-Выберите **4) 🔄 Запустить все инстансы** для одновременного запуска всех созданных инстансов.
+# Запуск инстанса
+cd /opt/n8nmcp/instances/ИМЯ_ИНСТАНСА
+docker-compose up -d
-=== Остановка всех инстансов ===
+# Остановка инстанса
-Выберите **5) ⏹️ Остановить все инстансы** для остановки всех работающих инстансов.
+docker-compose down
-===== Управление клиентами =====
+# Перезапуск инстанса
+docker-compose restart
-==== Создание клиентского конфига ====
+# Просмотр логов
+docker-compose logs -f
-Клиентские конфиги содержат всю информацию, необходимую для подключения MCP клиентов к конкретному инстансу.
+# Статус инстанса
+docker-compose ps
+</code>
-=== Шаг 1: Выберите пункт меню ===
+==== Через консоль управления ====
-Выберите **6) 🆕 Создать клиентский конфиг**
-=== Шаг 2: Введите имя клиента ===
+<code bash>
-<code>
+/opt/n8nmcp/multi-manage.sh
-Имя клиента: claude-desktop
+# Выберите опцию 3 "Управление инстансом"
+# Выберите нужный инстанс и действие
 </code>
-=== Шаг 3: Выберите инстанс ===
+===== Работа с клиентами =====
-Система покажет список доступных инстансов:
-<code>
-Активные инстансы:
-------------------------------------------------
-ИМЯ             ПОРТ       СТАТУС       СОЗДАН
-------------------------------------------------
-main            3000       ЗАПУЩЕН      2025-01-15
-production      3001       ЗАПУЩЕН      2025-01-15
-------------------------------------------------
-Имя инстанса: production
+==== Создание клиентского конфига ====
-</code>
-=== Результат создания ===
+<code bash>
-<code>
+# Через консоль управления
-✅ Клиент создан!
+/opt/n8nmcp/multi-manage.sh
-URL: http://localhost:3001
+# Выберите опцию 6 "Создать клиентский конфиг"
-Token: AbCdEf123456...
+# Введите имя клиента: my-client
+# Выберите инстанс для подключения: production
 </code>
-==== Список клиентов ====
+==== Использование конфига ====
-Выберите **7) 📋 Список клиентов** для просмотра всех созданных клиентских конфигов:
+<code bash>
+# Скрипт подключения
+/opt/n8nmcp/clients/my-client/connect.sh
-<code>
+# Конфигурационный файл
-claude-desktop -> production (http://localhost:3001)
+cat /opt/n8nmcp/clients/my-client/config.json
-vscode-extension -> main (http://localhost:3000)
-test-client -> development (http://localhost:3002)
 </code>
-==== Тестирование подключения ====
+Пример конфига клиента:
-=== Проверка клиента ===
+<code json>
-Выберите **8) 🔌 Тестировать подключение клиента**, затем введите имя клиента:
+{
-<code>
+  "client_name": "my-client",
-Имя клиента: claude-desktop
+  "instance_name": "production",
+  "url": "http://192.168.1.100:3001",
+  "auth_token": "abc123...",
+  "port": 3001
+}
 </code>
-=== Результаты теста ===
+===== Мониторинг и диагностика =====
-<code>
-Тестирование: http://localhost:3001
+==== Проверка статуса системы ====
-✅ Подключение успешно
+<code bash>
+# Через консоль управления
+/opt/n8nmcp/multi-manage.sh
+# Опция 12: Общий статус системы
+# Или командная строка
+docker ps --filter 'name=n8n-mcp'
 </code>
-или
+==== Просмотр использования портов ====
-<code>
+<code bash>
-Тестирование: http://localhost:3001
+# Через консоль управления
-❌ Ошибка подключения
+/opt/n8nmcp/multi-manage.sh
+# Опция 10: Показать использование портов
+# Или вручную
+netstat -tuln | grep :3000
+ss -tuln | grep :3000
 </code>
-<WRAP center round tip 60%>
+==== Диагностика проблем ====
-**Совет:** Если подключение не работает, убедитесь что инстанс запущен через ''3) Управление инстансом''
-</WRAP>
-==== Удаление клиента ====
+<code bash>
+# Проверка логов инстанса
+cd /opt/n8nmcp/instances/ИМЯ_ИНСТАНСА
+docker-compose logs -f
-Выберите **9) 🗑️ Удалить клиента** для удаления клиентского конфига:
+# Проверка статуса контейнера
-<code>
+docker ps -a --filter 'name=n8n-mcp-ИМЯ_ИНСТАНСА'
-Имя клиента: old-client
-Клиент удален
+# Проверка прав Docker
+docker ps
+# Если ошибка, выполните: newgrp docker
+# Проверка здоровья инстанса
+curl -s http://localhost:ПОРТ/health
 </code>
-===== Системные функции =====
+===== Настройка systemd =====
-==== Общий статус системы ====
+Скрипт автоматически создает systemd service для базового инстанса:
-Выберите **10) 📊 Общий статус системы** для просмотра общей информации:
+<code bash>
+# Управление службой
+sudo systemctl start n8n-mcp
+sudo systemctl stop n8n-mcp
+sudo systemctl restart n8n-mcp
+sudo systemctl status n8n-mcp
-<code>
+# Автозапуск при загрузке
-================================
+sudo systemctl enable n8n-mcp
-Статус системы
+sudo systemctl disable n8n-mcp
-================================
-Docker: Docker version 24.0.7
-Инстансов: 3
-Клиентов: 2
-Запущено контейнеров: 2
 </code>
-==== Показ всех подключений ====
+===== Обновление системы =====
-Выберите **11) 📡 Показать все подключения** для просмотра информации о подключениях:
+==== Обновление образов ====
-<code>
+<code bash>
-================================
+# Через консоль управления
-Все подключения
+/opt/n8nmcp/multi-manage.sh
-================================
+# Опция 15: Обновить все образы
-main
-  URL: http://localhost:3000
-  Token: xyz123...
-production
+# Или вручную
-  URL: http://localhost:3001
+docker pull ghcr.io/czlonkowski/n8n-mcp:latest
-  Token: abc456...
+# Перезапуск инстансов для применения обновлений
+/opt/n8nmcp/multi-manage.sh
+# Опция 4: Запустить все инстансы
 </code>
 ==== Очистка ресурсов ====
-Выберите **12) 🧹 Очистка неиспользуемых ресурсов** для удаления неиспользуемых Docker образов и контейнеров.
+<code bash>
+# Через консоль управления
+/opt/n8nmcp/multi-manage.sh
+# Опция 14: Очистка неиспользуемых ресурсов
-==== Обновление образов ====
+# Или вручную
+docker system prune -f
+docker volume prune -f
+docker network prune -f
+</code>
-Выберите **13) 🔄 Обновить все образы** для загрузки последних версий Docker образов.
+===== Резервное копирование =====
-==== Исправление прав доступа ====
+==== Важные данные для бэкапа ====
-Выберите **14) 🔧 Исправить права доступа** если возникли проблемы с правами на файлы.
+<code bash>
+# Конфигурации инстансов
+tar -czf n8nmcp-configs-$(date +%Y%m%d).tar.gz /opt/n8nmcp/instances/*/
-===== Использование с MCP клиентами =====
+# Данные инстансов
+tar -czf n8nmcp-data-$(date +%Y%m%d).tar.gz /opt/n8nmcp/instances/*/data/
-==== Claude Desktop ====
+# Клиентские конфиги
+tar -czf n8nmcp-clients-$(date +%Y%m%d).tar.gz /opt/n8nmcp/clients/
-=== Конфигурация ===
+# Полный бэкап
-После создания клиентского конфига используйте полученные данные в настройках Claude Desktop:
+tar -czf n8nmcp-full-backup-$(date +%Y%m%d).tar.gz /opt/n8nmcp/
-<code json>
-{
-  "mcpServers": {
-    "n8n-mcp": {
-      "command": "npx",
-      "args": ["-y", "@modelcontextprotocol/server-fetch"],
-      "env": {
-        "FETCH_ENDPOINT": "http://localhost:3001",
-        "FETCH_HEADERS": "{\"Authorization\": \"Bearer AbCdEf123456...\"}"
-      }
-    }
-  }
-}
 </code>
-==== VS Code или другие клиенты ====
+==== Восстановление ====
-Используйте следующие параметры подключения:
+<code bash>
-  * **URL**: ''http://localhost:ПОРТ''
+# Остановка всех инстансов
-  * **Authorization Header**: ''Bearer ТОКЕН''
+/opt/n8nmcp/multi-manage.sh # Опция 5
-  * **Content-Type**: ''application/json''
-===== Практические примеры =====
+# Восстановление из бэкапа
+sudo tar -xzf n8nmcp-full-backup-YYYYMMDD.tar.gz -C /
-==== Сценарий 1: Создание среды разработки ====
+# Восстановление прав
+sudo chown -R $(whoami):$(id -gn) /opt/n8nmcp/
+chmod -R 755 /opt/n8nmcp/
+find /opt/n8nmcp/ -name "*.env" -exec chmod 600 {} \;
-<code>
+# Запуск инстансов
-. Запустите консоль: /opt/n8nmcp/multi-manage.sh
+/opt/n8nmcp/multi-manage.sh # Опция 4
-. Выберите: 1) Создать новый инстанс
-. Введите имя: development
-. Нажмите Enter для автопорта (например, 3001)
-. Выберите: 6) Создать клиентский конфиг
-. Введите имя клиента: dev-claude
-. Выберите инстанс: development
-. Используйте полученные URL и Token в вашем MCP клиенте
 </code>
-==== Сценарий 2: Тестирование нового функционала ====
+===== Устранение неполадок =====
-<code>
+==== Частые проблемы ====
-. Создайте тестовый инстанс: test-v2
-. Создайте клиентский конфиг: test-client
-. Протестируйте функционал через клиента
-. При необходимости удалите инстанс через: 3) Управление инстансом → 6) Удалить
-</code>
-==== Сценарий 3: Продакшн развертывание ====
+=== Ошибка: "AUTH_TOKEN is required" ===
-<code>
+<WRAP center round important 80%>
-. Создайте продакшн инстанс: production
+**Проблема:** Контейнер не может найти токен авторизации\\
-. Настройте клиентские конфиги для всех пользователей
+**Решение:** Проверьте файл .env в директории инстанса
-. Используйте 4) Запустить все инстансы для массового запуска
+</WRAP>
-. Мониторьте через 10) Общий статус системы
-</code>
-===== Устранение неисправностей =====
+<code bash>
+# Проверьте наличие токена
+grep AUTH_TOKEN /opt/n8nmcp/instances/main/.env
+# Если токена нет, добавьте:
+echo "AUTH_TOKEN=$(openssl rand -base64 32)" >> /opt/n8nmcp/instances/main/.env
+# Перезапустите инстанс
+cd /opt/n8nmcp/instances/main
+docker-compose restart
+</code>
-==== Проблемы с правами Docker ====
+=== Ошибка: "permission denied" при запуске Docker ===
-<WRAP center round important 60%>
+<WRAP center round important 80%>
-**Решение:** Выполните команду ''newgrp docker'' или перелогиньтесь в систему
+**Проблема:** Пользователь не в группе docker\\
+**Решение:** Применить права Docker группы
 </WRAP>
 <code bash>
-# Применить права Docker в текущей сессии
+# Проверьте группы пользователя
+groups $(whoami)
+# Если нет группы docker:
+sudo usermod -aG docker $(whoami)
 newgrp docker
-# Или перелогиниться
+# Или перелогиньтесь
-exit
+exit && ssh user@server
-ssh user@your-server
 </code>
-==== Инстанс не запускается ====
+=== Порт уже занят ===
-=== Проверка логов ===
+<WRAP center round important 80%>
-<code>
+**Проблема:** Выбранный порт уже используется\\
-. Выберите: 3) Управление инстансом
+**Решение:** Используйте автоматический поиск портов
-. Введите имя проблемного инстанса
+</WRAP>
-. Выберите: 4) Логи
-. Проанализируйте ошибки
-</code>
-=== Проверка портов ===
 <code bash>
-# Проверить занятые порты
+# Через консоль управления
+/opt/n8nmcp/multi-manage.sh
+# Опция 10: Показать использование портов
+# Опция 11: Найти свободный порт
+# Или вручную
 netstat -tuln | grep :3000
+ss -tuln | grep :3000
 </code>
-==== Ошибки подключения клиентов ====
+=== Инстанс не запускается ===
-=== Чек-лист проверки ===
-  - ✅ Инстанс запущен (проверить через список инстансов)
-  - ✅ Правильный порт в URL
-  - ✅ Корректный AUTH_TOKEN
-  - ✅ Нет файрволла, блокирующего порт
-=== Тестирование вручную ===
 <code bash>
-# Проверить health check
+# Проверьте логи
-curl -H "Authorization: Bearer YOUR_TOKEN" http://localhost:3001/health
+cd /opt/n8nmcp/instances/ИМЯ_ИНСТАНСА
+docker-compose logs
+# Проверьте статус контейнера
+docker ps -a
+# Проверьте права на файлы
+ls -la /opt/n8nmcp/instances/ИМЯ_ИНСТАНСА/
+# Исправьте права
+sudo chown -R $(whoami):$(id -gn) /opt/n8nmcp/
 </code>
-===== Резервное копирование =====
+===== Безопасность =====
+==== Рекомендации по безопасности ====
+  * 🔒 **Токены авторизации** генерируются автоматически и уникальны для каждого инстанса
+  * 🛡️ **Файлы .env** имеют права доступа 600 (только владелец)
+  * 🌐 **Сетевая изоляция** - каждый инстанс в собственной Docker сети
+  * 👤 **Пользовательские права** - контейнеры запускаются от имени текущего пользователя
+==== Настройка файрвола ====
-==== Полная система ====
 <code bash>
-# Создать резервную копию всей системы
+# Открытие портов для инстансов (пример для ufw)
-sudo tar -czf n8nmcp-backup-$(date +%Y%m%d).tar.gz /opt/n8nmcp/
+sudo ufw allow 3000/tcp comment "n8n-mcp main instance"
+sudo ufw allow 3001/tcp comment "n8n-mcp production instance"
+# Ограничение доступа по IP
+sudo ufw allow from 192.168.1.0/24 to any port 3000
 </code>
-==== Отдельный инстанс ====
+==== Смена токенов ====
 <code bash>
-# Резервная копия конкретного инстанса
+# Генерация нового токена
-sudo tar -czf instance-production-$(date +%Y%m%d).tar.gz /opt/n8nmcp/instances/production/
+NEW_TOKEN=$(openssl rand -base64 32)
+# Обновление в .env файле
+sed -i "s/AUTH_TOKEN=.*/AUTH_TOKEN=$NEW_TOKEN/" /opt/n8nmcp/instances/ИМЯ_ИНСТАНСА/.env
+# Обновление в метаданных
+sed -i "s/\"auth_token\": \".*\"/\"auth_token\": \"$NEW_TOKEN\"/" /opt/n8nmcp/instances/ИМЯ_ИНСТАНСА/instance.json
+# Перезапуск инстанса
+cd /opt/n8nmcp/instances/ИМЯ_ИНСТАНСА
+docker-compose restart
 </code>
-===== Полезные команды =====
+===== API и интеграция =====
+==== Подключение к инстансу ====
-==== Быстрый доступ ====
 <code bash>
-# Консоль управления
+# Базовое подключение
-/opt/n8nmcp/multi-manage.sh
+curl -H "Authorization: Bearer YOUR_TOKEN" http://localhost:3000/health
-# Быстрый запуск базового инстанса
+# Проверка здоровья инстанса
-/opt/n8nmcp/start-main.sh
+curl -s http://localhost:3000/health | jq .
-# Проверка статуса всех контейнеров
+# MCP подключение
-docker ps --filter "name=n8n-mcp"
+curl -H "Authorization: Bearer YOUR_TOKEN" \
+     -H "Content-Type: application/json" \
+     -d '{"method": "ping"}' \
+     http://localhost:3000/mcp
+</code>
-# Просмотр логов конкретного инстанса
+==== Конфигурация N8N ====
-docker logs n8n-mcp-production -f
+В настройках N8N добавьте MCP сервер:
+<code json>
+{
+  "name": "n8n-mcp-instance",
+  "url": "http://localhost:3000",
+  "auth": {
+    "type": "bearer",
+    "token": "YOUR_AUTH_TOKEN"
+  }
+}
 </code>
-==== Прямое управление ====
+===== Полезные команды =====
 <code bash>
-# Перейти к инстансу и управлять напрямую
+# Просмотр всех инстансов
-cd /opt/n8nmcp/instances/production
+docker ps --filter 'name=n8n-mcp' --format 'table {{.Names}}\t{{.Status}}\t{{.Ports}}'
-docker-compose up -d      # Запуск
-docker-compose down       # Остановка
+# Просмотр использования ресурсов
-docker-compose logs -f    # Логи
+docker stats --filter 'name=n8n-mcp'
-docker-compose ps         # Статус
+# Просмотр логов всех инстансов
+for instance in /opt/n8nmcp/instances/*/; do
+  echo "=== $(basename $instance) ==="
+  cd "$instance" && docker-compose logs --tail=10
+done
+# Массовое обновление конфигураций
+find /opt/n8nmcp/instances -name ".env" -exec sed -i 's/TZ=.*/TZ=Europe\/Moscow/' {} \;
+# Поиск инстанса по порту
+grep -r "INSTANCE_PORT=3001" /opt/n8nmcp/instances/*/
 </code>
-===== Заключение =====
+===== Контакты и поддержка =====
-n8n MCP Multi-Instance предоставляет мощный и удобный способ управления множественными инстансами n8n MCP. Система автоматизирует большинство операций и предоставляет интуитивно понятный интерфейс для управления как инстансами, так и клиентскими подключениями.
+<WRAP center round info 60%>
+**Документация:** [[https://docs.n8n-mcp.com|docs.n8n-mcp.com]]\\
+**GitHub:** [[https://github.com/czlonkowski/n8n-mcp|n8n-mcp repository]]\\
+**Issues:** [[https://github.com/czlonkowski/n8n-mcp/issues|GitHub Issues]]
+</WRAP>
-**Ключевые преимущества:**
+==== Полезные ссылки ====
-  * 🚀 **Быстрое развертывание** - новый инстанс за минуту
-  * 🔒 **Изолированность** - каждый инстанс работает независимо
-  * 👥 **Удобство управления клиентами** - автоматическая генерация конфигов
-  * 📊 **Мониторинг** - централизованный контроль всех инстансов
-  * 🛡️ **Безопасность** - уникальные токены для каждого инстанса
-Для получения дополнительной помощи или сообщения об ошибках обращайтесь к документации проекта или создавайте issue в репозитории.
+  * [[https://docs.docker.com/|Docker Documentation]]
+  * [[https://docs.docker.com/compose/|Docker Compose Documentation]]
+  * [[https://n8n.io/docs/|N8N Documentation]]
+  * [[https://ubuntu.com/server/docs|Ubuntu Server Guide]]
+----
+<WRAP center round tip 60%>
+**Последнее обновление:** {{page>:wiki:footer_date&nofooter&noeditbtn}}\\
+**Версия документации:** 3.0\\
+**Совместимость:** N8N MCP Multi-Instance Installer v3.0+
+</WRAP>