> ## Documentation Index
> Fetch the complete documentation index at: https://apidoc.cometapi.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Запуск n8n локально с CometAPI

> Используйте это руководство, чтобы запускать n8n локально с CometAPI, настроив параметры локального развертывания, учетные данные и доступ к моделям.

Разверните n8n на своей машине и подключите его к CometAPI через community node, чтобы локально запускать автоматизированные AI-процессы.

## Предварительные требования

* Linux (Ubuntu/Debian/CentOS и т. д.) или macOS
* 2 ГБ+ RAM, 10 ГБ+ свободного места на диске
* Доступ к shell с выходом в публичный npm registry
* Node.js 18.x или 20.x LTS (см. шаг 1)
* Учетная запись CometAPI с активным API key — [получите его здесь](https://www.cometapi.com/console/token)

<Steps>
  <Step title="Получите свой API key CometAPI">
    Войдите в [консоль CometAPI](https://www.cometapi.com/console/token). Нажмите **Add API Key** и скопируйте свой API key CometAPI.

    <Frame>
      <img src="https://mintcdn.com/cometapi/SZhlxZhCnMLn__BW/images/overview/810968_364191.png?fit=max&auto=format&n=SZhlxZhCnMLn__BW&q=85&s=aef81a83f29f8eb16655ed4060425f50" alt="Панель управления CometAPI с кнопкой Add API Key" width="3824" height="1892" data-path="images/overview/810968_364191.png" />
    </Frame>

    <Frame>
      <img src="https://mintcdn.com/cometapi/HhtmQffktazbxUvS/images/overview/810968_364193.png?fit=max&auto=format&n=HhtmQffktazbxUvS&q=85&s=d893f659267150d0faf45f99eb5dffc1" alt="Детали API key CometAPI с base URL" width="2434" height="1232" data-path="images/overview/810968_364193.png" />
    </Frame>
  </Step>

  <Step title="Установите Node.js через nvm">
    Для n8n 1.x требуется Node.js 18.x или 20.x. Рекомендуемый способ — [nvm](https://github.com/nvm-sh/nvm):

    ```bash theme={null}
    # Install nvm
    curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash

    # Reload your shell profile
    source ~/.bashrc   # or ~/.zshrc on macOS

    # Install and activate the LTS version
    nvm install --lts
    nvm use --lts

    # Verify
    node -v
    npm -v
    ```

    <Note>
      Если позже вы увидите `n8n: command not found`, перезапустите терминал или убедитесь, что каталог глобальных bin-файлов npm, управляемый nvm, находится в вашем `PATH`.
    </Note>
  </Step>

  <Step title="Установите и запустите n8n">
    ```bash theme={null}
    npm install -g n8n
    n8n -v       # verify the installed version
    n8n start    # runs on http://localhost:5678/
    ```

    Если порт 5678 уже используется:

    ```bash theme={null}
    export N8N_PORT=5679
    n8n start
    ```

    Чтобы n8n продолжал работать после закрытия терминала:

    ```bash theme={null}
    npm install -g pm2
    pm2 start "n8n" --name n8n
    pm2 save
    pm2 status
    ```

    <Frame>
      <img src="https://mintcdn.com/cometapi/SZhlxZhCnMLn__BW/images/integrations/810968_360463.png?fit=max&auto=format&n=SZhlxZhCnMLn__BW&q=85&s=80fe6068a8af4ec3b3503ff41d378a17" alt="Терминал с успешным запуском n8n" width="715" height="451" data-path="images/integrations/810968_360463.png" />
    </Frame>

    <Frame>
      <img src="https://mintcdn.com/cometapi/SZhlxZhCnMLn__BW/images/integrations/810968_360464.png?fit=max&auto=format&n=SZhlxZhCnMLn__BW&q=85&s=77cadfd218dbe0fef19fe701550ea363" alt="Логи запуска n8n в терминале" width="759" height="460" data-path="images/integrations/810968_360464.png" />
    </Frame>
  </Step>

  <Step title="Создайте свою учетную запись владельца">
    Откройте [http://localhost:5678/](http://localhost:5678/) в браузере. При первом запуске мастер настройки попросит вас создать учетную запись **Owner** (email + password). Завершите этот шаг и войдите в систему.

    <Frame>
      <img src="https://mintcdn.com/cometapi/SZhlxZhCnMLn__BW/images/integrations/810968_360465.png?fit=max&auto=format&n=SZhlxZhCnMLn__BW&q=85&s=8fdd100138f2bf01bbf834d9db1ea29e" alt="Мастер первой настройки n8n с запросом данных учетной записи Owner" width="1249" height="970" data-path="images/integrations/810968_360465.png" />
    </Frame>
  </Step>

  <Step title="Установите community node CometAPI">
    1. Перейдите в **Settings** (внизу слева) → **Community nodes**
    2. Нажмите **Install a community node**
    3. Введите имя пакета: `@cometapi-dev/n8n-nodes-cometapi`
    4. Установите флажок подтверждения риска и нажмите **Install**

    После установки вы сможете найти **CometAPI** в панели узлов.

    <Frame>
      <img src="https://mintcdn.com/cometapi/SZhlxZhCnMLn__BW/images/integrations/810968_360467.png?fit=max&auto=format&n=SZhlxZhCnMLn__BW&q=85&s=1c107922e16332157d278bf834b3e32a" alt="Панель Settings в n8n с разделом Community nodes" width="1265" height="975" data-path="images/integrations/810968_360467.png" />
    </Frame>

    <Frame>
      <img src="https://mintcdn.com/cometapi/SZhlxZhCnMLn__BW/images/integrations/810968_360468.png?fit=max&auto=format&n=SZhlxZhCnMLn__BW&q=85&s=98c05d77cb6adf333052b4d5014fc506" alt="Диалог установки с введенным именем пакета CometAPI" width="1261" height="965" data-path="images/integrations/810968_360468.png" />
    </Frame>

    <Note>
      Если раздел Community Nodes отсутствует: убедитесь, что вы вошли в систему под учетной записью **Owner**, и проверьте **Settings → Security**, чтобы подтвердить, что установка community node включена.
    </Note>
  </Step>

  <Step title="Создайте workflow и настройте credentials">
    1. Нажмите **+ New** вверху, чтобы создать workflow.
    2. Нажмите **+** на canvas и найдите **CometAPI**, чтобы добавить узел.

    <Frame>
      <img src="https://mintcdn.com/cometapi/SZhlxZhCnMLn__BW/images/integrations/810968_360469.png?fit=max&auto=format&n=SZhlxZhCnMLn__BW&q=85&s=b47e1304ec3165720dd3ef37e1429485" alt="Canvas workflow в n8n с открытым поиском узла CometAPI" width="1235" height="899" data-path="images/integrations/810968_360469.png" />
    </Frame>

    <Frame>
      <img src="https://mintcdn.com/cometapi/SZhlxZhCnMLn__BW/images/integrations/810968_360472.png?fit=max&auto=format&n=SZhlxZhCnMLn__BW&q=85&s=b765a2d8024f4c5d36305916c440d02f" alt="Узел CometAPI, добавленный на canvas n8n" width="1724" height="854" data-path="images/integrations/810968_360472.png" />
    </Frame>

    3. Добавьте узел **Manual Trigger** и соедините его с узлом CometAPI.
    4. В узле CometAPI в разделе **Credential to connect with** выберите **Create new**. Вставьте свой API key CometAPI в поле **CometAPI Key** и нажмите **Save**. Base URL по умолчанию — `https://api.cometapi.com`, и обычно его не нужно менять.

    <Frame>
      <img src="https://mintcdn.com/cometapi/SZhlxZhCnMLn__BW/images/integrations/810968_360474.png?fit=max&auto=format&n=SZhlxZhCnMLn__BW&q=85&s=deee1c999cbfb2c432daaa53904d6b38" alt="Диалог credentials CometAPI с введенным API key" width="1906" height="608" data-path="images/integrations/810968_360474.png" />
    </Frame>

    5. Настройте узел:

    * **Model**: введите текущий model ID, который хотите использовать
    * **Messages**: установите Role как `user`, а Content как ваш тестовый prompt (например, `Hello`)
    * Необязательно: добавьте сообщение `system`, задайте **Max Tokens**, **Temperature** и т. д.

    6. Нажмите **Execute step**, чтобы запустить узел. На панели **Output** отобразится JSON-ответ.

    <Frame>
      <img src="https://mintcdn.com/cometapi/SZhlxZhCnMLn__BW/images/integrations/810968_360471.png?fit=max&auto=format&n=SZhlxZhCnMLn__BW&q=85&s=6953b97533f02e4f50cb1f0490ff057d" alt="Панель вывода n8n с успешным JSON-ответом CometAPI" width="2092" height="1762" data-path="images/integrations/810968_360471.png" />
    </Frame>
  </Step>
</Steps>

<AccordionGroup>
  <Accordion title="Устранение неполадок">
    * **`node-gyp` или ошибки нативной сборки** — установите build tools: `sudo apt install build-essential python3` (Debian/Ubuntu) или Xcode Command Line Tools (macOS).
    * **Ошибки прав доступа npm (EACCES)** — используйте nvm для установки Node.js на уровне пользователя; `sudo` не нужен.
    * **Конфликт порта (`localhost:5678` недоступен)** — задайте `N8N_PORT=5679` (или другой свободный порт) перед запуском `n8n start`.
    * **Раздел Community Nodes отсутствует** — войдите под учетной записью **Owner** и проверьте **Settings → Security**.
    * **npm install завершается с ошибкой в корпоративных сетях** — настройте proxy: `npm config set proxy http://user:pass@host:port`
    * **Узел CometAPI возвращает 401/403** — проверьте ваш API key и убедитесь, что модель доступна в вашем тарифном плане CometAPI.
    * **Пустые ответы или ошибки лимита token** — увеличьте **Max Tokens**; при необходимости скорректируйте **Temperature** и **Top P**.
    * **n8n останавливается при закрытии терминала** — используйте pm2: `pm2 start "n8n" --name n8n && pm2 save`.
  </Accordion>
</AccordionGroup>

<script type="application/ld+json">
  {`
    {
    "@context": "https://schema.org",
    "@graph": [
      {
        "@type": "HowTo",
        "@id": "https://apidoc.cometapi.com/integrations/n8n-local-deployment#howto",
        "name": "Локальный запуск n8n с CometAPI",
        "description": "Используйте это руководство, чтобы запускать n8n локально с CometAPI, настроив параметры локального развертывания, credentials и доступ к модели.",
        "step": [
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/n8n-local-deployment#step-1",
            "position": 1,
            "name": "Получите свой API key CometAPI",
            "text": "Создайте или откройте свою учетную запись CometAPI, затем скопируйте активный API key из панели управления."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/n8n-local-deployment#step-2",
            "position": 2,
            "name": "Установите Node.js через nvm",
            "text": "Выполните шаг Install Node.js via nvm в руководстве Локальный запуск n8n с CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/n8n-local-deployment#step-3",
            "position": 3,
            "name": "Установите и запустите n8n",
            "text": "Выполните шаг Install and start n8n в руководстве Локальный запуск n8n с CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/n8n-local-deployment#step-4",
            "position": 4,
            "name": "Создайте свою учетную запись владельца",
            "text": "Выполните шаг Create your owner account в руководстве Локальный запуск n8n с CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/n8n-local-deployment#step-5",
            "position": 5,
            "name": "Установите community node CometAPI",
            "text": "Выполните шаг Install the CometAPI community node в руководстве Локальный запуск n8n с CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/n8n-local-deployment#step-6",
            "position": 6,
            "name": "Создайте workflow и настройте credentials",
            "text": "Выполните шаг Create a workflow and configure credentials в руководстве Локальный запуск n8n с CometAPI."
          }
        ]
      },
      {
        "@type": "BreadcrumbList",
        "itemListElement": [
          {
            "@type": "ListItem",
            "position": 1,
            "name": "Документация CometAPI",
            "item": "https://apidoc.cometapi.com/"
          },
          {
            "@type": "ListItem",
            "position": 2,
            "name": "Интеграции",
            "item": "https://apidoc.cometapi.com/integrations"
          },
          {
            "@type": "ListItem",
            "position": 3,
            "name": "Локальный запуск n8n с CometAPI",
            "item": "https://apidoc.cometapi.com/integrations/n8n-local-deployment"
          }
        ]
      }
    ]
    }
    `}
</script>
