# Начало работы

> Установите Meridian и разверните ваш первый прокси-сервер за две минуты.

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

Вам понадобятся:
- **VPS** на Debian или Ubuntu (с доступом по SSH ключу под root)
- **Терминал** на вашем локальном компьютере (macOS, Linux или WSL)

## Установить CLI

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

Это установит команду `meridian` через [uv](https://docs.astral.sh/uv/) (предпочтительно) или pipx.

Можно запустить на своём компьютере или прямо на VPS. Рекомендуется локальная машина — с неё можно выполнить `meridian test` извне, и учётные данные останутся на вашем устройстве.

## Развернуть

```
meridian deploy
```

Интерактивный мастер спросит ваш IP-адрес сервера, SSH пользователя и цель маскировки (SNI). Для всего предусмотрены умные значения по умолчанию.

Или укажите всё заранее:

```
meridian deploy 1.2.3.4 --sni www.microsoft.com
```

Если вы запускаете команду прямо на VPS под root, SSH пропускается:

```
meridian deploy local
```

## Что происходит

1. **Устанавливает Docker** и развертывает Xray через панель управления 3x-ui
2. **Генерирует x25519 пару ключей** — уникальные ключи для аутентификации Reality
3. **Затвердевает сервер** — брандмауэр UFW, только SSH-ключи, управление перегрузкой BBR
4. **Конфигурирует VLESS+Reality** на порту 443 — выдаёт себя за настоящий TLS сервер
5. **Включает транспорт XHTTP** — дополнительный слой скрытности, маршрутизируется через nginx
6. **Выводит QR-коды** и сохраняет HTML страницу подключения

## Где что лежит

Meridian подключается к VPS по SSH (или работает прямо на нём через `deploy local`). После развёртывания состояние кэшируется локально:

| Что | Где |
|------|-------|
| Credentials и ключи | `~/.meridian/credentials/<IP>/` на вашей машине |
| Реестр серверов | `~/.meridian/servers` на вашей машине |
| Прокси-сервисы | Docker, Xray, nginx на VPS |

Когда вы запускаете `meridian client add alice`, Meridian находит сервер в локальном реестре, подключается по SSH, создаёт клиента и обновляет локальный кэш. При нескольких серверах укажите нужный через `--server NAME`.

## Подключиться

Команда deploy выводит:
- **QR-код**, который можно отсканировать телефоном
- **HTML файл** со ссылками подключения для обмена с семьей
- **Ссылку для обмена** (если включены страницы, размещённые на сервере)

Установите одно из этих приложений, затем отсканируйте QR-код или нажмите «Открыть в приложении»:

| Платформа | Приложение |
|----------|-----|
| iOS | [v2RayTun](https://apps.apple.com/app/v2raytun/id6476628951) |
| Android | [v2rayNG](https://github.com/2dust/v2rayNG/releases/latest) |
| Windows | [v2rayN](https://github.com/2dust/v2rayN/releases/latest) |
| Все платформы | [Hiddify](https://github.com/hiddify/hiddify-app/releases/latest) |

## Добавить ещё пользователей

```
meridian client add alice
```

Каждый клиент получает свой собственный ключ и страницу подключения. Отобразить клиентов можно командой `meridian client list`, отозвать доступ — `meridian client remove alice`.

## Управление серверами

Когда вы управляете несколькими VPS:

```
meridian server list                # просмотр всех серверов
meridian server add 5.6.7.8        # добавить существующий сервер
meridian server remove finland     # удалить из реестра
```

Флаг `--server` позволяет указать конкретный сервер для любой команды: `meridian client add alice --server finland`.

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

- [Руководство развёртывания](/md/ru/deploy/) — полное руководство по развёртыванию со всеми опциями
- [Релейные узлы](/md/ru/relay/) — маршрутизация через домашний IP для восстановления при блокировке IP
- [Режим домена](/md/ru/domain-mode/) — добавьте резервный CDN через Cloudflare
- [IP заблокирован?](/md/ru/recovery/) — пошаговое восстановление при блокировке сервера
- [Решение проблем](/md/ru/troubleshooting/) — частые проблемы и их решения