• Русский

      • Настройка локальной среды разработки

      Эта страница помогает подготовить локальную среду для NocoBase CLI и приложений NocoBase. Она подходит для локальной разработки, проверки функций и для сценариев, где AI Agent устанавливает или управляет NocoBase на вашем компьютере.

      Если вы разворачиваете систему для реальных пользователей, сначала ознакомьтесь с системными требованиями для production.

      Windows: используйте WSL

      Для локальной настройки в Windows рекомендуется держать основную среду разработки внутри WSL 2: установить Node.js, Yarn и NocoBase CLI в Linux-дистрибутиве WSL и выполнять связанные команды из терминала WSL.

      WSL ближе к Linux-средам, в которых NocoBase обычно разворачивается. Это дает несколько преимуществ:

      • Установка зависимостей, сборка, запуск и анализ логов ближе к реальному серверному процессу
      • После включения Docker Desktop WSL integration можно выполнять команды docker прямо внутри WSL
      • Можно уменьшить дополнительные проблемы с нативными путями Windows, правами файлов, символическими ссылками и сборкой нативных зависимостей
      • Это удобнее для AI Agent. Когда agent выполняет nb, yarn или docker, он использует единые Linux-пути, синтаксис shell и runtime-среду, поэтому диагностика становится прямее

      Если локальная среда на базе WSL еще не готова, см. Настройка локальной среды разработки в Windows с WSL.

      Рекомендуемая конфигурация:

      • Windows 10 / 11
      • WSL 2
      • Ubuntu LTS
      • Node.js >= 22
      • Yarn 1.x
      • Docker Desktop, если вы планируете устанавливать NocoBase через Docker

      Обычно Node.js, Yarn и NocoBase CLI устанавливаются внутри WSL. Если вы используете Docker Desktop, включите WSL integration в Docker Desktop, чтобы WSL мог обращаться к Docker.

      Проверьте среду:

      node -v
yarn -v
docker version
      Примечание

      NocoBase также можно установить на Windows Server. Здесь WSL рекомендуется для локальной разработки и настройки AI Agent на персональном компьютере. Это не означает, что Windows Server нельзя использовать для deployment.

      macOS

      В macOS можно использовать локальный терминал напрямую.

      Подготовьте:

      • Node.js >= 22
      • Yarn 1.x
      • Docker Desktop, OrbStack или Colima, если вы планируете устанавливать NocoBase через Docker

      Проверьте среду:

      node -v
yarn -v
docker version

      Если Docker не используется, docker version можно пропустить.

      Linux

      Linux можно напрямую использовать как локальную среду разработки. Рекомендуются Ubuntu, Debian или другие распространенные дистрибутивы.

      Подготовьте:

      • Node.js >= 22
      • Yarn 1.x
      • Docker Engine, если вы планируете устанавливать NocoBase через Docker

      Проверьте среду:

      node -v
yarn -v
docker version

      Если Docker не используется, docker version можно пропустить.

      Следующие шаги