# Управление клиентами

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

## Добавить клиента

```
meridian client add alice
```

Это создает уникальный ключ подключения для "alice" и отображает:
- **QR-код** в терминале — отсканируйте его с помощью VPN приложения для мгновенного подключения
- **URL подключения** — VLESS ссылки для каждого протокола (Reality, XHTTP и WSS если включен режим домена)
- **URL страницы для обмена** — размещенный на вашем сервере, готовый к отправке через любой мессенджер
- **HTML файл** сохраненный локально — резервная копия для оффлайн обмена

### Что видит получатель

Страница для обмена открывает страницу подключения с:
- Пошаговыми инструкциями по установке VPN приложения (v2RayTun, v2rayNG, Hiddify или v2rayN)
- QR-кодами для каждого протокола подключения
- Ссылками "Открыть в приложении" одним нажатием
- Статусом подключения и статистикой использования

Отправьте URL через электронную почту, iMessage, Telegram или любой другой мессенджер. Получатель открывает его, устанавливает приложение, сканирует QR-код и подключается. Не требуется никаких технических знаний.

## Отобразить данные подключения

Чтобы в любой момент повторно отобразить информацию о подключении существующего клиента:

```
meridian client show alice
```

Это выводит тот же QR-код, URL подключения и ссылку на страницу для обмена — без создания нового ключа. Используйте это когда:
- Вам нужно повторно отправить страницу подключения кому-то
- Вы потеряли исходный QR-код или HTML файл
- Вы хотите проверить, как выглядит подключение клиента

## Список клиентов

```
meridian client list
```

Показывает всех клиентов с их подключениями по протоколам (Reality, XHTTP, WSS).

## Удалить клиента

```
meridian client remove alice
```

Отзывает доступ сразу. UUID клиента удаляется из всех входящих каналов на сервере.

## Несколько серверов

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

```
meridian client add alice --server finland
meridian client show alice --server finland
meridian client list --server finland
```

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

## Где хранятся данные

Когда вы запускаете `meridian deploy` со своего ноутбука, Meridian сохраняет данные сервера локально:

```
~/.meridian/credentials/<IP>/proxy.yml   # ключи, UUID, доступ к панели
~/.meridian/servers                      # реестр серверов
```

На самом сервере те же данные лежат в `/etc/meridian/proxy.yml`. Meridian синхронизирует их автоматически после `client add` и `client remove`.

Поэтому `meridian client add alice` работает без указания сервера — Meridian находит его в локальном реестре. Если серверов несколько, укажите `--server NAME`.

Если данные рассинхронизировались (например, клиент был добавлен с другой машины), `client show` автоматически восстановит данные из панели сервера.

## Веб-панель

Meridian разворачивает панель управления 3x-ui для мониторинга трафика. Доступ по секретному HTTPS-пути из ваших credentials:

```
cat ~/.meridian/credentials/<IP>/proxy.yml | grep -A5 panel
```

URL панели, логин и пароль указаны там. SSH-туннель не нужен — nginx проксирует панель по случайному HTTPS-пути.

## Как это работает

Имена клиентов отображаются на поля `email` 3x-ui с префиксами протокола:
- `reality-alice` — Reality входящий канал
- `xhttp-alice` — XHTTP входящий канал
- `wss-alice` — WSS входящий канал (режим домена)

Каждый клиент получает уникальный UUID по всем входящим каналам на сервере.