vm:n8n_mcp:01-install_http_multi-user

Различия

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

Ссылка на это сравнение

Предыдущая версия справа и слева Предыдущая версия
Следующая версия		 Предыдущая версия
vm:n8n_mcp:01-install_http_multi-user [2025/08/13 14:25] – adminvm: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\\ https://github.com/czlonkowski/n8n-mcp\\
Строка 4: Строка 6:
  
 =====Установка в один клик===== =====Установка в один клик=====
 +** Важно!**\\
 +Если хотите что бы все папки и файлы создались от текущего пользователя что бы был доступ для редактирования запускать не от SUDO\\
 +Тогда скрипт выяснит текущего пользователя и установит все от системного пользователя.
 <code> <code>
 cd ~ cd ~
Строка 12: Строка 17:
 </code> </code>
  
-====== n8n MCP - Автоматическая установка n8n-mcp в Docker ======+** Важно!**\\ 
 +После установки первичной нужно выйти из текущей сессии и зайти что бы применились все новые права для работы с меню.
  
-===== Быстрая установка =====+====== N8N MCP Multi-Instance Docker Installer v3.0 ======
  
-Для установки n8n MCP сервера выполните следующие команды в терминале:+===== Описание ===== 
 + 
 +**N8N MCP Multi-Instance Docker Installer** - это автоматизированный скрипт для развертывания множественных изолированных инстансов n8n-mcp в Docker контейнерах с умным управлением портами и централизованной системой управления. 
 + 
 +<WRAP center round info 60%> 
 +**Версия:** 3.0\\ 
 +**Совместимость:** Ubuntu 18.04+, Debian 10+\\ 
 +**Требования:** sudo права, интернет соединение\\ 
 +**Автор:** Система автоматической установки n8n-mcp 
 +</WRAP> 
 + 
 +===== Основные возможности ===== 
 + 
 +  * 🚀 **Автоматическая установка** Docker и Docker Compose 
 +  * 🎯 **Умное управление портами** с автоматическим поиском свободных портов 
 +  * 📦 **Множественные инстансы** с изоляцией и независимой конфигурацией 
 +  * 🎛️ **Консоль управления** с 16 функциями администрирования 
 +  * 👥 **Управление клиентами** с генерацией конфигов подключения 
 +  * 🔒 **Безопасность** с автоматической генерацией токенов авторизации 
 +  * 📊 **Мониторинг** статуса всех инстансов и портов 
 + 
 +===== Быстрый старт ===== 
 + 
 +==== 1. Загрузка и запуск ====
  
 <code bash> <code bash>
-cd ~ +# Скачайте скрипт 
-wget "https://dokuwiki.nanokey.tech/_media/vm:n8n_mcp:install-n8n-mcp.tar" -O install-n8n-mcp.tar +wget https://your-domain.com/install-n8n-mcp-v3.sh
-tar -xvf install-n8n-mcp.tar +
-chmod +x install-n8n-mcp.sh +
-./install-n8n-mcp.sh +
-</code>+
  
-===== Оглавление =====+# Или создайте файл вручную 
 +nano install-n8n-mcp-v3.sh 
 +# Вставьте код скрипта
  
-  * [[#Описание|Описание]] +# Сделайте исполняемым 
-  * [[#Системные требования|Системные требования]] +chmod +x install-n8n-mcp-v3.sh
-  * [[#Что делает скрипт|Что делает скрипт]] +
-  * [[#Процесс установки|Процесс установки]] +
-  * [[#Управление сервером|Управление сервером]] +
-  * [[#Структура файлов|Структура файлов]] +
-  * [[#Конфигурация|Конфигурация]] +
-  * [[#Безопасность|Безопасность]] +
-  * [[#Мониторинг и логи|Мониторинг и логи]] +
-  * [[#Устранение неполадок|Устранение неполадок]] +
-  * [[#FAQ|FAQ]]+
  
-===== Описание =====+# Запустите установку 
 +./install-n8n-mcp-v3.sh 
 +</code>
  
-**n8n MCP Docker Installer** - это автоматизированный bash-скрипт для развертывания n8n-mcp сервера в Docker контейнере. Скрипт полностью автоматизирует процесс установки и настройки, создавая готовую к работе среду для многопользовательского доступа через HTTP режим.+==== 2. Применение прав Docker ====
  
-**Ключевые особенности:** +После установки выполните одну из команд для применения прав Docker:
-  * 🚀 **Полная автоматизация** - установка одной командой +
-  * 🐳 **Docker-based** - изолированная среда выполнения +
-  * 🔒 **Безопасность** - генерация уникальных токенов авторизации +
-  * 👥 **Многопользовательский режим** - поддержка HTTP для нескольких клиентов +
-  * 🎛️ **Удобное управление** - интерактивная консоль управления +
-  * 🔧 **Права пользователя** - работа без root привилегий +
-  * 🌍 **Сетевой доступ** - автоматическое определение IP адреса+
  
-===== Системные требования =====+<code bash> 
 +# Вариант 1: Применить в текущей сессии 
 +newgrp docker
  
-==== Поддерживаемые ОС ==== +# Вариант 2: Перелогиниться 
-  * Ubuntu 18.04+ +exit 
-  * Debian 10+ +ssh user@server 
-  * Linux Mint 19+ +</code>
-  * Другие Debian-based дистрибутивы+
  
-==== Минимальные требования ==== +==== 3. Запуск базового инстанса ====
-  * **RAM:** 1 GB (рекомендуется 2 GB) +
-  * **Свободное место:** 2 GB +
-  * **Права:** sudo доступ +
-  * **Порты:** 3000 (должен быть свободен)+
  
-==== Зависимости ==== +<code bash> 
-Скрипт автоматически устанавливает: +# Быстрый запуск основного инстанса 
-  * Docker Engine +/opt/n8nmcp/start-main.sh
-  * Docker Compose +
-  * curl +
-  * необходимые системные пакеты+
  
-===== Что делает скрипт =====+# Или через консоль управления 
 +/opt/n8nmcp/multi-manage.sh 
 +</code>
  
-==== 1. Подготовка системы ==== +===== Структура установки =====
-  * Проверяет права sudo +
-  * Обновляет системные пакеты +
-  * Устанавливает зависимости+
  
-==== 2. Установка Docker ==== +После установки создается следующая структура:
-  * Добавляет официальный репозиторий Docker +
-  * Устанавливает Docker Engine и Docker Compose +
-  * Настраивает автозапуск Docker +
-  * Добавляет пользователя в группу docker+
  
-==== 3. Создание структуры проекта ==== 
 <code> <code>
 /opt/n8nmcp/ /opt/n8nmcp/
-├── docker-compose.yml    # Конфигурация контейнера +├── instances/           # Директория инстансов 
-├── .env                 # Переменные окружения +│   └── main/           # Базовый инстанс 
-├── data/                # Данные приложения +│       ├── docker-compose.yml 
-├── logs/                # Логи +│       ├── .env        # Конфигурация 
-├── config/              # Конфигурация +│       ├── instance.json # Метаданные 
-├── start.sh             # Запуск сервера +│       ├── data/       # Данные инстанса 
-├── stop.sh              # Остановка сервера +│       ├── logs/       # Логи 
-├── status.sh            # Проверка статуса +│       └── config/     # Конфигурации 
-├── update.sh            # Обновление образа +├── clients/            # Клиентские конфиги 
-├── fix-permissions.sh   # Исправление прав +├── logs/              # Общие логи 
-└── manage.sh            # Консоль управления+├── config/            # Общие конфигурации 
 +├── shared/            # Общие ресурсы 
 +├── multi-manage.sh    # Консоль управления 
 +├── start-main.sh      # Быстрый запуск 
 +├── instances.registry # Реестр инстансов 
 +└── clients.registry   # Реестр клиентов
 </code> </code>
  
-==== 4. Генерация конфигурации ==== +===== Консоль управления =====
-  * Создает docker-compose.yml с оптимальными настройками +
-  * Генерирует уникальный AUTH_TOKEN +
-  * Настраивает переменные окружения +
-  * Определяет IP адрес машины+
  
-==== 5. Создание скриптов управления ==== +Запустите консоль управления: ''%%/opt/n8nmcp/multi-manage.sh%%''
-  * **manage.sh** - интерактивная консоль с 11 функциями +
-  * **start.sh/stop.sh** - быстрый запуск/остановка +
-  * **status.sh** - мониторинг состояния +
-  * **update.sh** - обновление образа+
  
-==== 6. Настройка systemd ==== +==== Категории функций ====
-  * Создает systemd service для автозапуска +
-  * Настраивает зависимости от Docker+
  
-==== 7. Запуск и проверка ==== +=== 📦 ИНСТАНСЫ ===
-  * Загружает Docker образ +
-  * Запускает контейнер +
-  * Выполняет health check +
-  * Выводит информацию о подключении+
  
-===== Процесс установки =====+^ Опция ^ Функция ^ Описание ^ 
 +| **1** | 🆕 Создать новый инстанс | Создание нового изолированного инстанса | 
 +| **2** | 📋 Список инстансов | Отображение всех инстансов с статусом | 
 +| **3** | ⚙️ Управление инстансом | Запуск/остановка/удаление инстанса | 
 +| **4** | 🔄 Запустить все инстансы | Массовый запуск всех инстансов | 
 +| **5** | ⏹️ Остановить все инстансы | Массовая остановка всех инстансов | 
 + 
 +=== 👥 КЛИЕНТЫ === 
 + 
 +^ Опция ^ Функция ^ Описание ^ 
 +| **6** | 🆕 Создать клиентский конфиг | Генерация конфига для подключения | 
 +| **7** | 📋 Список клиентов | Отображение всех клиентских конфигов | 
 +| **8** | 🔌 Тестировать подключение | Проверка соединения с инстансом | 
 +| **9** | 🗑️ Удалить клиента | Удаление клиентского конфига | 
 + 
 +=== 🌐 ПОРТЫ === 
 + 
 +^ Опция ^ Функция ^ Описание ^ 
 +| **10** | 📊 Показать использование портов | Карта занятых/свободных портов | 
 +| **11** | 🔍 Найти свободный порт | Поиск доступного порта в диапазоне | 
 + 
 +=== 🔧 СИСТЕМА === 
 + 
 +^ Опция ^ Функция ^ Описание ^ 
 +| **12** | 📊 Общий статус системы | Информация о Docker, инстансах, ресурсах | 
 +| **13** | 📡 Показать все подключения | URL и токены всех инстансов | 
 +| **14** | 🧹 Очистка неиспользуемых ресурсов | Docker system prune | 
 +| **15** | 🔄 Обновить все образы | Обновление n8n-mcp образов | 
 +| **16** | 🔧 Исправить права доступа | Восстановление прав на файлы | 
 + 
 +===== Создание инстанса ===== 
 + 
 +==== Автоматический режим ====
  
-==== Шаг 1: Загрузка и распаковка ==== 
 <code bash> <code bash>
-cd ~ +# Через консоль управления 
-wget "https://dokuwiki.nanokey.tech/_media/vm:n8n_mcp:install-n8n-mcp.tar" -O install-n8n-mcp.tar +/opt/n8nmcp/multi-manage.sh 
-tar -xvf install-n8n-mcp.tar+# Выберите опцию 1 
 + 
 +# Введите имя инстанса (например: production) 
 +# Система автоматически найдет свободный порт
 </code> </code>
  
-==== Шаг 2: Установка прав и запуск ====+==== Интерактивный выбор порта ==== 
 + 
 +При создании инстанса доступны 3 опции: 
 + 
 +  - **1)** Использовать предлагаемый порт (автоматический) 
 +  - **2)** Ввести другой порт вручную 
 +  - **3)** Показать занятые порты и выбрать 
 + 
 +<WRAP center round tip 60%> 
 +**Совет:** Используйте опцию 3 для просмотра карты портов перед выбором 
 +</WRAP> 
 + 
 +==== Конфигурация .env файла ==== 
 + 
 +После создания инстанса отредактируйте файл конфигурации: 
 <code bash> <code bash>
-chmod +x install-n8n-mcp.sh +nano /opt/n8nmcp/instances/ИМЯ_ИНСТАНСА/.env
-./install-n8n-mcp.sh+
 </code> </code>
  
-==== Что происходит при установке ==== +Раскомментируйте и настройте N8N API:
-  - ⏳ Проверка системы и прав +
-  - 📦 Установка Docker и зависимостей +
-  - 📁 Создание структуры директорий +
-  - ⚙️ Генерация конфигурации +
-  - 🔑 Создание AUTH_TOKEN +
-  - 🚀 Запуск сервера +
-  - ✅ Проверка работоспособности+
  
-**Время установки:** 5-15 минут (зависит от скорости интернета)+<code bash> 
 +# n8n MCP Instance Configuration - production 
 +AUTH_TOKEN=сгенерированный_токен 
 +USE_FIXED_HTTP=true 
 +MCP_MODE=http 
 +TZ=Europe/Moscow 
 +INSTANCE_NAME=production 
 +INSTANCE_PORT=3001
  
-===== Управление сервером =====+# Добавьте здесь ваши n8n API настройки: 
 +N8N_API_URL=https://your-n8n-instance.com 
 +N8N_API_KEY=your-n8n-api-key 
 +</code> 
 + 
 +===== Управление инстансами ===== 
 + 
 +==== Основные команды ====
  
-==== Интерактивная консоль управления ==== 
 <code bash> <code bash>
-/opt/n8nmcp/manage.sh+# Запуск инстанса 
 +cd /opt/n8nmcp/instances/ИМЯ_ИНСТАНСА 
 +docker-compose up -d 
 + 
 +# Остановка инстанса 
 +docker-compose down 
 + 
 +# Перезапуск инстанса 
 +docker-compose restart 
 + 
 +# Просмотр логов 
 +docker-compose logs -f 
 + 
 +# Статус инстанса 
 +docker-compose ps
 </code> </code>
  
-**Доступные функции:** +==== Через консоль управления ====
-  * 🟢 **Запустить сервер** - запуск n8n-mcp +
-  * 🔴 **Остановить сервер** - корректная остановка +
-  * 🔄 **Перезапустить сервер** - перезапуск без даунтайма +
-  * 📊 **Показать статус** - состояние контейнера и ресурсы +
-  * 📋 **Показать логи** - просмотр логов в реальном времени +
-  * 🔄 **Обновить образ** - обновление до последней версии +
-  * 🏥 **Health Check** - проверка доступности сервиса +
-  * 📡 **Информация о подключении** - URL и токены +
-  * 🔧 **Исправить права доступа** - восстановление прав +
-  * ⚙️ **Редактировать конфигурацию** - изменение настроек +
-  * 🔑 **Показать AUTH_TOKEN** - просмотр токена авторизации+
  
-==== Быстрые команды ==== 
 <code bash> <code bash>
-# Запуск +/opt/n8nmcp/multi-manage.sh 
-/opt/n8nmcp/start.sh+# Выберите опцию 3 "Управление инстансом" 
 +# Выберите нужный инстанс и действие 
 +</code>
  
-# Остановка   +===== Работа с клиентами =====
-/opt/n8nmcp/stop.sh+
  
-# Статус +==== Создание клиентского конфига ====
-/opt/n8nmcp/status.sh+
  
-# Обновление +<code bash> 
-/opt/n8nmcp/update.sh+# Через консоль управления 
 +/opt/n8nmcp/multi-manage.sh 
 +# Выберите опцию 6 "Создать клиентский конфиг"
  
-# Логи +# Введите имя клиента: my-client 
-cd /opt/n8nmcp && docker-compose logs -f+# Выберите инстанс для подключения: production
 </code> </code>
  
-==== Systemd управление ====+==== Использование конфига ==== 
 <code bash> <code bash>
-# Включить автозапуск +# Скрипт подключения 
-sudo systemctl enable n8n-mcp+/opt/n8nmcp/clients/my-client/connect.sh
  
-# Запуск через systemd +# Конфигурационный файл 
-sudo systemctl start n8n-mcp+cat /opt/n8nmcp/clients/my-client/config.json 
 +</code>
  
-# Остановка через systemd +Пример конфига клиента:
-sudo systemctl stop n8n-mcp+
  
-# Статус +<code json> 
-sudo systemctl status n8n-mcp+{ 
 +  "client_name": "my-client", 
 +  "instance_name": "production", 
 +  "url": "http://192.168.1.100:3001", 
 +  "auth_token": "abc123...", 
 +  "port": 3001 
 +}
 </code> </code>
  
-===== Структура файлов =====+===== Мониторинг и диагностика =====
  
-==== Основные файлы ==== +==== Проверка статуса системы ====
-^ Файл ^ Назначение ^ Права ^ +
-| docker-compose.yml | Конфигурация Docker контейнера | 644 | +
-| .env | Переменные окружения и токены | 600 | +
-| manage.sh | Интерактивная консоль управления | 755 | +
-| start.sh | Скрипт запуска сервера | 755 | +
-| stop.sh | Скрипт остановки сервера | 755 | +
-| status.sh | Проверка статуса сервера | 755 | +
-| update.sh | Обновление Docker образа | 755 | +
-| fix-permissions.sh | Исправление прав доступа | 755 |+
  
-==== Директории данных ==== +<code bash> 
-^ Директория ^ Назначение ^ Описание ^ +# Через консоль управления 
-| /opt/n8nmcp/data/ | Данные приложения | База данных, конфигурация n8n | +/opt/n8nmcp/multi-manage.sh 
-| /opt/n8nmcp/logs/ | Файлы логов | Логи контейнера и приложения | +# Опция 12: Общий статус системы
-| /opt/n8nmcp/config/ | Конфигурационные файлы | Дополнительные настройки |+
  
-===== Конфигурация =====+# Или командная строка 
 +docker ps --filter 'name=n8n-mcp' 
 +</code>
  
-==== Docker Compose настройки ==== +==== Просмотр использования портов ====
-<code yaml> +
-# Основные параметры в docker-compose.yml +
-ports: +
-  - "3000:3000"           # Порт сервиса +
-   +
-environment: +
-  - MCP_MODE=http         # HTTP режим +
-  - USE_FIXED_HTTP=true   # Фиксированный HTTP +
-  - LOG_LEVEL=info        # Уровень логирования +
-  - TZ=Europe/Moscow      # Временная зона+
  
-resources: +<code bash> 
-  limits: +# Через консоль управления 
-    memory: 1G            # Лимит памяти +/opt/n8nmcp/multi-manage.sh 
-    cpus: '0.5'          # Лимит CPU+# Опция 10: Показать использование портов 
 + 
 +# Или вручную 
 +netstat -tuln | grep :3000 
 +ss -tuln | grep :3000
 </code> </code>
  
-==== Переменные окружения (.env) ====+==== Диагностика проблем ==== 
 <code bash> <code bash>
-# Основные настройки +# Проверка логов инстанса 
-AUTH_TOKEN=<generated-token>     # Токен авторизации +cd /opt/n8nmcp/instances/ИМЯ_ИНСТАНСА 
-USE_FIXED_HTTP=true             # HTTP режим +docker-compose logs -f 
-MCP_MODE=http                   # Режим работы + 
-TZ=Europe/Moscow                # Временная зона+# Проверка статуса контейнера 
 +docker ps -a --filter 'name=n8n-mcp-ИМЯ_ИНСТАНСА'
  
-# Настройки пользователя +# Проверка прав Docker 
-CURRENT_UID=1000                # UID пользователя +docker ps 
-CURRENT_GID=1000                # GID группы+# Если ошибка, выполните: newgrp docker
  
-# n8n API (настраивается вручную) +# Проверка здоровья инстанса 
-# N8N_API_URL=https://your-n8n-instance.com +curl -s http://localhost:ПОРТ/health
-# N8N_API_KEY=your-n8n-api-key+
 </code> </code>
  
-==== Настройка n8n API ==== +===== Настройка systemd =====  
-Для подключения к вашему n8n инстансу отредактируйте .env файл:+ 
 +Скрипт автоматически создает systemd service для базового инстанса: 
 <code bash> <code bash>
-nano /opt/n8nmcp/.env+# Управление службой 
 +sudo systemctl start n8n-mcp 
 +sudo systemctl stop n8n-mcp 
 +sudo systemctl restart n8n-mcp 
 +sudo systemctl status n8n-mcp
  
-# Добавьте или раскомментируйте: +# Автозапуск при загрузке 
-N8N_API_URL=https://your-n8n-instance.com +sudo systemctl enable n8n-mcp 
-N8N_API_KEY=your-n8n-api-key+sudo systemctl disable n8n-mcp
 </code> </code>
  
-===== Безопасность =====+===== Обновление системы =====
  
-==== Авторизация ==== +==== Обновление образов ====
-  * **AUTH_TOKEN** - уникальный токен для каждой установки +
-  * Токен генерируется случайным образом (32 символа base64) +
-  * Хранится только в .env файле с правами 600 +
-  * Требуется для всех MCP подключений+
  
-==== Права доступа ==== +<code bash> 
-  * Контейнер запускается от имени текущего пользователя +# Через консоль управления 
-  * Все файлы принадлежат пользователю, запустившему установку +/opt/n8nmcp/multi-manage.sh 
-  * Системные права используются только для установки Docker +# Опция 15: Обновить все образы
-  * .env файл защищен правами 600 (только владелец)+
  
-==== Сетевая безопасность ==== +# Или вручную 
-  * Сервис слушает только порт 3000 +docker pull ghcr.io/czlonkowski/n8n-mcp:latest
-  * Используется изолированная Docker сеть +
-  * Доступ возможен только с авторизационным токеном +
-  * Health check endpoint открыт для мониторинга+
  
-==== Рекомендации ==== +# Перезапуск инстансов для применения обновлений 
-<WRAP center round tip 60%> +/opt/n8nmcp/multi-manage.sh 
-📋 **Безопасность:** +# Опция 4: Запустить все инстансы 
-  * Сохраните AUTH_TOKEN в безопасном месте +</code>
-  * Не передавайте токен по незащищенным каналам   +
-  * Регулярно обновляйте Docker образ +
-  * Используйте файрвол для ограничения доступа к порту 3000 +
-</WRAP>+
  
-===== Мониторинг и логи =====+==== Очистка ресурсов ====
  
-==== Health Check ==== 
 <code bash> <code bash>
-# Локальная проверка +# Через консоль управления 
-curl http://localhost:3000/health+/opt/n8nmcp/multi-manage.sh 
 +# Опция 14: Очистка неиспользуемых ресурсов 
 + 
 +# Или вручную 
 +docker system prune -f 
 +docker volume prune -f 
 +docker network prune -f 
 +</code> 
 + 
 +===== Резервное копирование ===== 
 + 
 +==== Важные данные для бэкапа ==== 
 + 
 +<code bash> 
 +# Конфигурации инстансов 
 +tar -czf n8nmcp-configs-$(date +%Y%m%d).tar.gz /opt/n8nmcp/instances/*/ 
 + 
 +# Данные инстансов 
 +tar -czf n8nmcp-data-$(date +%Y%m%d).tar.gz /opt/n8nmcp/instances/*/data/
  
-# Сетевая проверка   +# Клиентские конфиги 
-curl http://YOUR_IP:3000/health+tar -czf n8nmcp-clients-$(date +%Y%m%d).tar.gz /opt/n8nmcp/clients/
  
-# Через manage.sh +# Полный бэкап 
-/opt/n8nmcp/manage.sh  # выбрать пункт 7+tar -czf n8nmcp-full-backup-$(date +%Y%m%d).tar.gz /opt/n8nmcp/
 </code> </code>
  
-==== Просмотр логов ====+==== Восстановление ==== 
 <code bash> <code bash>
-# В реальном времени +# Остановка всех инстансов 
-cd /opt/n8nmcp && docker-compose logs -f+/opt/n8nmcp/multi-manage.sh # Опция 5
  
-# Последние 50 строк +# Восстановление из бэкапа 
-cd /opt/n8nmcp && docker-compose logs --tail=50+sudo tar -xzf n8nmcp-full-backup-YYYYMMDD.tar.gz -C /
  
-# Логи через manage.sh +# Восстановление прав 
-/opt/n8nmcp/manage.sh  # выбрать пункт 5+sudo chown -R $(whoami):$(id -gn) /opt/n8nmcp/ 
 +chmod -R 755 /opt/n8nmcp/ 
 +find /opt/n8nmcp/ -name "*.env" -exec chmod 600 {} \; 
 + 
 +# Запуск инстансов 
 +/opt/n8nmcp/multi-manage.sh # Опция 4
 </code> </code>
  
-==== Мониторинг ресурсов ====+===== Устранение неполадок ===== 
 + 
 +==== Частые проблемы ==== 
 + 
 +=== Ошибка: "AUTH_TOKEN is required" === 
 + 
 +<WRAP center round important 80%> 
 +**Проблема:** Контейнер не может найти токен авторизации\\ 
 +**Решение:** Проверьте файл .env в директории инстанса 
 +</WRAP> 
 <code bash> <code bash>
-# Использование ресурсов контейнера +# Проверьте наличие токена 
-docker stats n8n-mcp-server+grep AUTH_TOKEN /opt/n8nmcp/instances/main/.env
  
-# Статус через manage.sh +# Если токена нет, добавьте: 
-/opt/n8nmcp/manage.sh  # выбрать пункт 4+echo "AUTH_TOKEN=$(openssl rand -base64 32)" >> /opt/n8nmcp/instances/main/.env 
 + 
 +# Перезапустите инстанс 
 +cd /opt/n8nmcp/instances/main 
 +docker-compose restart
 </code> </code>
  
-==== Информация о подключении ==== +=== Ошибка: "permission denied" при запуске Docker ===
-После установки сервер доступен по адресам: +
-  * **Локально:** http://localhost:3000 +
-  * **Сеть:** http://YOUR_IP:3000 +
-  * **Health:** http://localhost:3000/health+
  
-===== Устранение неполадок =====+<WRAP center round important 80%> 
 +**Проблема:** Пользователь не в группе docker\\ 
 +**Решение:** Применить права Docker группы 
 +</WRAP>
  
-==== Проблемы с правами Docker ==== 
 <code bash> <code bash>
-# Если появляется ошибка доступа к Docker+# Проверьте группы пользователя 
 +groups $(whoami) 
 + 
 +# Если нет группы docker: 
 +sudo usermod -aG docker $(whoami)
 newgrp docker newgrp docker
  
-# Или перелогиньтесь в систему +# Или перелогиньтесь 
-exit +exit && ssh user@server
-# войдите снова+
 </code> </code>
  
-==== Исправление прав файлов ====+=== Порт уже занят === 
 + 
 +<WRAP center round important 80%> 
 +**Проблема:** Выбранный порт уже используется\\ 
 +**Решение:** Используйте автоматический поиск портов 
 +</WRAP> 
 <code bash> <code bash>
-# Автоматическое исправление прав +# Через консоль управления 
-/opt/n8nmcp/fix-permissions.sh+/opt/n8nmcp/multi-manage.sh 
 +# Опция 10: Показать использование портов 
 +# Опция 11: Найти свободный порт
  
 # Или вручную # Или вручную
-sudo chown -R $(whoami):$(id -gn) /opt/n8nmcp/ +netstat -tuln | grep :3000 
-chmod -R 755 /opt/n8nmcp/ +ss -tuln | grep :3000
-chmod 600 /opt/n8nmcp/.env +
-chmod +x /opt/n8nmcp/*.sh+
 </code> </code>
  
-==== Контейнер не запускается ====+=== Инстанс не запускается === 
 <code bash> <code bash>
-# Проверить логи запуска +# Проверьте логи 
-cd /opt/n8nmcp && docker-compose logs+cd /opt/n8nmcp/instances/ИМЯ_ИНСТАНСА 
 +docker-compose logs
  
-# Пересоздать контейнер +# Проверьте статус контейнера 
-cd /opt/n8nmcp && docker-compose down +docker ps -a
-cd /opt/n8nmcp && docker-compose up -d --force-recreate+
  
-# Проверить порт 3000 +# Проверьте права на файлы 
-sudo netstat -tulpn | grep 3000+ls -la /opt/n8nmcp/instances/ИМЯ_ИНСТАНСА/ 
 + 
 +# Исправьте права 
 +sudo chown -R $(whoami):$(id -gn) /opt/n8nmcp/
 </code> </code>
  
-==== Проблемы с подключением ==== +===== Безопасность =====
-<code bash> +
-# Проверить файрвол +
-sudo ufw status+
  
-# Открыть порт если нужно +==== Рекомендации по безопасности ====
-sudo ufw allow 3000+
  
-# Проверить IP адрес +  * 🔒 **Токены авторизации** генерируются автоматически и уникальны для каждого инстанса 
-ip route get 8.8.8.8 | head -1 | awk '{print $7}' +  * 🛡️ **Файлы .env** имеют права доступа 600 (только владелец) 
-</code>+  * 🌐 **Сетевая изоляция** - каждый инстанс в собственной Docker сети 
 +  * 👤 **Пользовательские права** - контейнеры запускаются от имени текущего пользователя 
 + 
 +==== Настройка файрвола ====
  
-==== Обновление образа ==== 
 <code bash> <code bash>
-# Автоматическое обновление +# Открытие портов для инстансов (пример для ufw) 
-/opt/n8nmcp/update.sh+sudo ufw allow 3000/tcp comment "n8n-mcp main instance" 
 +sudo ufw allow 3001/tcp comment "n8n-mcp production instance"
  
-# Или вручную +# Ограничение доступа по IP 
-cd /opt/n8nmcp +sudo ufw allow from 192.168.1.0/24 to any port 3000
-docker-compose down +
-docker-compose pull +
-docker-compose up -d+
 </code> </code>
  
-===== FAQ =====+==== Смена токенов ====
  
-==== Общие вопросы ====+<code bash> 
 +# Генерация нового токена 
 +NEW_TOKEN=$(openssl rand -base64 32)
  
-**Q: Можно ли изменить порт сервера?**\\ +# Обновление в .env файле 
-A: Да, отредактируйте docker-compose.yml и измените "3000:3000" на "НОВЫЙ_ПОРТ:3000"+sed -i "s/AUTH_TOKEN=.*/AUTH_TOKEN=$NEW_TOKEN/" /opt/n8nmcp/instances/ИМЯ_ИНСТАНСА/.env
  
-**Q: Как получить AUTH_TOKEN?**\\ +# Обновление в метаданных 
-A: Выполните `grep "AUTH_TOKEN=" /opt/n8nmcp/.env | cut -d'=' -f2` или используйте manage.sh (пункт 11)+sed -i "s/\"auth_token\": \".*\"/\"auth_token\": \"$NEW_TOKEN\"/" /opt/n8nmcp/instances/ИМЯ_ИНСТАНСА/instance.json
  
-**Q: Можно ли запустить несколько экземпляров?**\\ +# Перезапуск инстанса 
-A: Да, но нужно изменить порты и директории для каждого экземпляра+cd /opt/n8nmcp/instances/ИМЯ_ИНСТАНСА 
 +docker-compose restart 
 +</code>
  
-**Q: Как подключиться к серверу извне?**\\ +===== API и интеграция =====
-A: Используйте http://IP_СЕРВЕРА:3000 с вашим AUTH_TOKEN+
  
-**Q: Где хранятся данные?**\\ +==== Подключение к инстансу ====
-A: В /opt/n8nmcp/data/ - эта директория сохраняется при обновлениях+
  
-==== Технические вопросы ====+<code bash> 
 +# Базовое подключение 
 +curl -H "Authorization: Bearer YOUR_TOKEN" http://localhost:3000/health
  
-**Q: Какая версия Docker требуется?**\\ +# Проверка здоровья инстанса 
-A: Скрипт устанавливает последнюю стабильную версию автоматически+curl -s http://localhost:3000/health | jq .
  
-**Q: Можно ли изменить директорию установки?**\\ +# MCP подключение 
-A: Нет, скрипт использует фиксированную директорию /opt/n8nmcp+curl -H "Authorization: Bearer YOUR_TOKEN" \ 
 +     -H "Content-Type: application/json" \ 
 +     -d '{"method": "ping"}' \ 
 +     http://localhost:3000/mcp 
 +</code>
  
-**Q: Как сделать резервную копию?**\\ +==== Конфигурация N8N ====
-A: Скопируйте директорию /opt/n8nmcp/, особенно папку data/+
  
-**Q: Поддерживается ли SSL/HTTPS?**\\ +В настройках N8N добавьте MCP сервер:
-A: Базово - нет. Используйте reverse proxy (nginx) для SSL+
  
-**Q: Можно ли запустить на ARM процессоре?**\\ +<code json> 
-A: Зависит от доступности образа для ARM архитектуры+{ 
 +  "name": "n8n-mcp-instance", 
 +  "url": "http://localhost:3000", 
 +  "auth": { 
 +    "type": "bearer", 
 +    "token": "YOUR_AUTH_TOKEN" 
 +  } 
 +} 
 +</code>
  
-==== Производительность ====+===== Полезные команды =====
  
-**Q: Сколько памяти потребляет сервер?**\\ +<code bash> 
-A: Обычно 200-500 MB в зависимости от нагрузки+# Просмотр всех инстансов 
 +docker ps --filter 'name=n8n-mcp' --format 'table {{.Names}}\t{{.Status}}\t{{.Ports}}'
  
-**Q: Как увеличить лимиты ресурсов?**\\ +# Просмотр использования ресурсов 
-A: Отредактируйте deploy.resources.limits в docker-compose.yml+docker stats --filter 'name=n8n-mcp'
  
-**Q: Можно ли масштабировать horizontally?**\\ +# Просмотр логов всех инстансов 
-A: Да, запустите несколько экземпляров на разных портах с load balancer+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> 
 + 
 +===== Контакты и поддержка =====
  
 <WRAP center round info 60%> <WRAP center round info 60%>
-📞 **Поддержка:**   +**Документация:** [[https://docs.n8n-mcp.com|docs.n8n-mcp.com]]\\ 
-Если у вас возникли проблемы, не описанные в FAQ, обратитесь к документации n8n-mcp или сообщите об ошибке в репозитории проекта.+**GitHub:** [[https://github.com/czlonkowski/n8n-mcp|n8n-mcp repository]]\\ 
 +**Issues:** [[https://github.com/czlonkowski/n8n-mcp/issues|GitHub Issues]]
 </WRAP> </WRAP>
  
----+==== Полезные ссылки ====
  
-**Версия документации:** 1.1   +  * [[https://docs.docker.com/|Docker Documentation]] 
-**Дата обновления:** {{ :date: }}   +  * [[https://docs.docker.com/compose/|Docker Compose Documentation]] 
-**Автор:** n8n MCP Community+  * [[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>
  • vm/n8n_mcp/01-install_http_multi-user.1755095153.txt.gz
  • Последнее изменение: 2025/08/13 14:25
  • — admin