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

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

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

```
meridian client add alice
```

Это даёт "alice" её собственный ключ и выводит две вещи для обмена:

- **Ссылка на страницу подключения** с QR кодом — самый простой способ отправить
- **URL подписки** для прямого импорта в приложение Xray/V2Ray

Добавьте нескольких человек сразу:

```
meridian client add alice bob charlie
```

Клиенты принадлежат вашему целому флоту, не одному серверу. Каждый выход и ретранслятор, который у вас есть, показывается в их подписке.

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

Страница подключения построена из подлинной подписки человека, поэтому она перечисляет ровно то, что получают его приложения: прямые выходы, ретрансляторы и все включённые способы. На ней есть:

- Два шага: установить приложение, рекомендованное для платформы человека (сначала Happ, затем FlClashX и Clash Mi, а на компьютере ещё Throne), и добавить подключение одним касанием
- QR-код подписки; на компьютере он показан рядом с шагами, чтобы человек мог настроить телефон
- Каждое отдельное подключение с кнопками «Открыть», «Копировать» и QR, свёрнутое, пока не понадобится
- Раздел «Не подключается?» с советами и проверкой «Проверить подключение», которая копирует отчёт без ссылок, чтобы его можно было отправить вам

В приложении записи названы по стране выхода и способу: «🇩🇪 DE · Reality · Chrome», «🇩🇪 DE · XHTTP · Chrome», «🇩🇪 DE · WebSocket · CDN», «🇩🇪 DE · Hysteria2 · UDP»; у записей через ретранслятор добавляется «via relay». Если два выхода находятся в одной стране, после флага показываются их имена («🇩🇪 main»); у выхода с неизвестной страной показывается его имя, когда выходов несколько. Reality и XHTTP приходят также копиями «· Firefox» с другим отпечатком TLS — на случай, если один отпечаток заблокируют. Приложения с автопереключением (приложения на Xray JSON, такие как Happ, а также Mihomo и sing-box) сами выбирают рабочую запись, но не переключаются между отпечатками; для этого Happ показывает отдельную запись «Automatic · Firefox».

Отправьте ссылку через любой мессенджер. Получатель открывает её, устанавливает приложение, нажимает «Добавить в …» (или сканирует QR-код с другого устройства) и подключается.

## Показать детали подключения

Чтобы снова поделиться ссылками клиента:

```
meridian client show alice
```

Это выводит страницу подключения и URL подписки, плюс статус, трафик и когда клиент был последний раз виден. Если страница отсутствует (например, загрузка не удалась), переопубликуйте её:

```
meridian client show alice --repair-page
```

## Перечислить клиентов

```
meridian client list
```

Показывает каждого клиента со статусом, трафиком, временем создания и последним видением.

## Приостановить и возобновить клиента

```
meridian client disable alice
meridian client enable alice
```

`disable` отключает клиента немедленно; `enable` позволяет им вернуться с теми же ссылками.

Отключение временное: следующее применение включает каждого объявленного клиента. Apply запускается для `meridian apply`, переразворачивания и когда вы добавляете клиентов, узлы или ретрансляторы. При необходимости отключите снова после них.

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

`meridian client remove NAME` удаляет клиента окончательно: его ссылки перестанут работать и его страница подключения будет удалена. Флот сохраняет минимум одного клиента. Не удаляйте пользователей в панели Remnawave напрямую — Meridian воссоздаёт любого клиента, который осталась в топологии, при следующем применении.

## Ссылки подписки

URL подписки выглядят как `https://198.51.100.10/<page-path>/sub/<id>`. Они находятся под путём страницы подключения; админ-панель Remnawave остаётся на отдельном секретном пути, который общие ссылки никогда не раскрывают.

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

## Где находятся данные клиента

Учётные записи клиентов (ключи, статус, трафик) живут в базе данных панели Remnawave на сервере контроль-плана. Список клиентов, которыми управляет Meridian, является частью вашей топологии в `~/.config/meridian/cluster.yml`. Команды client используют API панели и не требуют SSH; публикация страницы подключения использует SSH к серверу контроль-плана.

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

[Remnawave](https://remna.st/) админ-панель показывает трафик, пользователей и узлы в браузере, и вы добро пожаловать использовать её. `meridian panel` выводит её URL и имя администратора; `meridian panel --show-password` также выводит пароль.

Meridian и панель разделяют работу поэтому ваши правки не переписываются:

| Meridian управляет (следующее применение восстанавливает его версию) | Ваши для изменения (apply никогда не касается этих) |
|---|---|
| Узлы, профили конфигурации, inbounds, опубликованные Hosts, отряды | Статус каждого клиента: включить/отключить, лимиты трафика, истечение, HWID лимиты, описание |
| Шаблоны подписки и параметры которые Meridian устанавливает | Пользователи которых вы создали сами в панели |
| Какие клиенты существуют, их имена и их отряды | Оповещения, плагины, IP контроль и другие параметры панели |

`meridian plan` показывает любую разницу в том что Meridian управляет перед что-либо изменится. Пользователи которых вы добавили в панель никогда не перечисляются, не изменяются или не удаляются Meridian; чтобы дать кому-то управляемую Meridian ссылку и страницу подключения, используйте `meridian client add` вместо этого.
