---
title: Настройка локальной среды разработки
description: Подготовьте локальную среду ОС для NocoBase CLI и приложений NocoBase — Windows WSL, macOS, Linux, Node.js, Yarn и Docker.
---

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

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

Если вы разворачиваете систему для реальных пользователей, сначала ознакомьтесь с [системными требованиями для production](../get-started/system-requirements.md).

## 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-wsl.md).

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

- 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.

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

```bash
node -v
yarn -v
docker version
```

:::tip Примечание

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

:::

## macOS

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

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

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

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

```bash
node -v
yarn -v
docker version
```

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

## Linux

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

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

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

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

```bash
node -v
yarn -v
docker version
```

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

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

- [Способы установки и сравнение версий](../get-started/quickstart.md) — Сначала сравните способы установки и каналы версий
- [Установить приложение NocoBase](./install-nocobase-app.md) — Инициализируйте локальное приложение через NocoBase CLI
- [Руководство по интеграции AI Agent](./quick-start.mdx) — Позвольте AI Agent подключаться к NocoBase и управлять им
