View as Markdown

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

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

Вам понадобятся:

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

Установить CLI

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

Это установит команду meridian через 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-код или нажмите «Открыть в приложении»:

ПлатформаПриложение
iOSv2RayTun
Androidv2rayNG
Windowsv2rayN
Все платформыHiddify

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

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.

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

On this page