---
title: Обновить приложение NocoBase
description: Обновите приложение NocoBase, сохраненное как CLI env, с помощью nb app upgrade — проверка env, команды обновления, целевые версии и проверка результата.
---

# Обновить приложение NocoBase

:::tip Область применения

Это руководство подходит для приложений, установленных через `nb init`. Если ваше приложение было установлено старым способом, сначала прочитайте [Как обновить NocoBase с 2.0 до 2.1](./upgrade-from-2-0-to-2-1.md).

:::

## Шаг 1: проверьте текущий env

Сначала проверьте активный CLI env:

```bash
nb env current
```

Если вы не уверены, какие env доступны, сначала выведите список:

```bash
nb env list
```

Если текущий env не является приложением, которое нужно обновить, переключитесь на целевой env:

```bash
nb env use <env-name>
```

## Шаг 2: выполните обновление

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

По умолчанию при обновлении исходный код приложения или Docker-образ загружается заново.

Для npm / Git env каталог `source/` удаляется и загружается заново. Не кладите в `source/` файлы, которые нужно сохранить.

Если вы уже вручную подготовили исходный код или Docker-образ и не хотите, чтобы CLI загружал их повторно, добавьте к команде `--skip-download`.

:::

Команда обновления по умолчанию:

```bash
nb app upgrade
```

Обычно эта команда выполняет следующие действия:

1. Останавливает текущее приложение
2. Загружает и заменяет сохраненный исходный код или образ
3. Синхронизирует коммерческие плагины
4. Обновляет и запускает приложение
5. Обновляет runtime-информацию env

В скриптах, CI или сессиях AI Agent явно передавайте `--force`:

```bash
nb app upgrade --force
```

Если обновляемое приложение не является текущим env, укажите env:

```bash
nb app upgrade --env app1 --yes --force
```

### Обновление до конкретной версии

Используйте `--version`, чтобы обновиться до конкретного канала версии:

```bash
nb app upgrade --version beta
```

Можно также указать точную версию:

```bash
nb app upgrade --version 2.1.0-beta.24
```

После успешного обновления CLI записывает целевую версию обратно в конфигурацию env, поэтому последующие обновления или восстановление смогут использовать эту информацию.

### Пропустить загрузку

Если вы уже обновили исходный код или Docker-образ и хотите только выполнить upgrade и start на основе текущего содержимого, добавьте `--skip-download`:

```bash
nb app upgrade --skip-download
```

Этот параметр пропускает загрузку исходного кода или образа, а также синхронизацию коммерческих плагинов. Обычно его используют только тогда, когда целевая версия уже подготовлена вручную.

## Шаг 3: проверьте результат

После обновления сначала проверьте runtime env и логи приложения:

```bash
nb env info
nb app logs
```

Затем откройте приложение и убедитесь, что учетная запись администратора может войти. Если AI Agent должен продолжить работу с этим приложением, запустите новую сессию AI Agent или перезапустите текущую, чтобы он прочитал свежую информацию env.

## Связанные ссылки

- [Управление приложениями](../nocobase-cli/operations/manage-app.md) — Запуск, остановка, перезапуск, просмотр логов и обновление приложений
- [Справочник команды `nb app upgrade`](../api/cli/app/upgrade.md) — Все параметры команды обновления
- [Управление несколькими средами](../nocobase-cli/operations/multi-environment.md) — Проверка, переключение и обслуживание нескольких CLI env
