# Установка

> Установите Meridian CLI на вашу локальную машину.

## Быстрая установка

```
curl -sSf https://getmeridian.org/install.sh | bash
```

Этот скрипт:
1. Устанавливает [uv](https://docs.astral.sh/uv/) если его нет, с pipx или pip как возврат
2. Устанавливает `meridian-vpn` из PyPI
3. Добавляет директорий инструмента в ваш shell PATH при необходимости
4. Создаёт `/usr/local/bin/meridian` только когда доступен passwordless sudo

## Ручная установка

С uv (рекомендуется):
```
uv tool install meridian-vpn
```

С pipx:
```
pipx install meridian-vpn
```

## Обновление

```
meridian update
```

Meridian проверяет PyPI сейчас и потом перед интерактивными командами и выводит уведомление когда существует более новая версия. Она никогда не устанавливает обновления самостоятельно. `meridian update` обновляет через какой-либо менеджер пакетов, который установил его, и подтверждает, что активная команда `meridian` сообщает новую версию. Установите `MERIDIAN_DISABLE_UPDATE_CHECK=1` для отключения фоновой проверки в автоматизации.

Обновление CLI ничего не меняет на ваших серверах. Если сервер работает, нет спешки; прочитайте [release notes](https://github.com/getmeridian/meridian/releases), затем запустите ту же команду `meridian deploy` (или `meridian apply`) когда вы готовы применить новую версию.

## Обновление с 3.x

Meridian 4.0 **не является обновлением на месте**. Он заменяет панель 3x-ui на Remnawave, и ссылки с сервера 3.x не могут передаваться: каждый пользователь нуждается в новой ссылке.

Ваши серверы 3.x продолжают работать. У вас есть два выбора:

- **Продолжайте управлять ими с 3.x.** Переустановите CLI 3.x:
  ```
  uv tool install 'meridian-vpn<4'
  ```
  (или `pipx install 'meridian-vpn<4'`). Meridian 3.17.3 и позже остаются на 3.x когда вы запускаете `meridian update`, если вы не передаёте `--major`.
- **Переходите на 4.0.**
  1. Разверните новый сервер с 4.0: `meridian deploy NEW_IP`
  2. Дайте вашим пользователям их новые страницы подключения (`meridian client add NAME` для каждого человека)
  3. Как только все переключились, разберите старый сервер с `meridian teardown OLD_IP` — teardown 4.0 также удаляет 3x-ui

Meridian 4.0 хранит своё состояние в `~/.config/meridian/` и никогда не читает и не меняет состояние 3.x в `~/.meridian/`, поэтому обе версии могут жить на одной машине; команды флота, которые находят только состояние 3.x, объясняют эти варианты.

## Требования

- **Python 3.11+** (uv устанавливает и управляет им для вас)
- **SSH ключевой доступ** к вашему серверу, как root или пользователь с passwordless sudo

Терминальные QR коды отрисовываются встроенным пакетом `segno`; нет системной зависимости.

## Проверить установку

```
meridian --version
```
