View as Markdown

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

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

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 по всем входящим каналам на сервере.

On this page