View as Markdown

Установка

Быстрая установка

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

Этот скрипт:

  1. Устанавливает uv если его нет, с pipx или pip как возврат
  2. Устанавливает meridian-vpn из PyPI
  3. Добавляет директорий инструмента в ваш shell PATH при необходимости
  4. Создаёт /usr/local/bin/meridian только когда доступен passwordless sudo

Ручная установка

С uv (рекомендуется):

uv tool install meridian-vpn

С pipx:

pipx install meridian-vpn

Обновление

meridian update

Meridian проверяет PyPI сейчас и потом перед интерактивными командами и выводит уведомление когда существует более новая версия. Она никогда не устанавливает обновления самостоятельно. meridian update обновляет через какой-либо менеджер пакетов, который установил его, и подтверждает, что активная команда meridian сообщает новую версию. Установите MERIDIAN_DISABLE_UPDATE_CHECK=1 для отключения фоновой проверки в автоматизации.

Обновление CLI ничего не меняет на ваших серверах. Если сервер работает, нет спешки; прочитайте release notes, затем запустите ту же команду meridian deploy (или meridian apply) когда вы готовы применить новую версию.

Обновление с 3.x

Meridian 4.0 не является обновлением на месте. Он заменяет панель 3x-ui на Remnawave, и ссылки с сервера 3.x не могут передаваться: каждый пользователь нуждается в новой ссылке.

Ваши серверы 3.x продолжают работать. У вас есть два выбора:

  • Продолжайте управлять ими с 3.x. Переустановите CLI 3.x: 
    uv tool install 'meridian-vpn<4'
    (или pipx install 'meridian-vpn<4'). Meridian 3.17.3 и позже остаются на 3.x когда вы запускаете meridian update, если вы не передаёте --major.
  • Переходите на 4.0.
    1. Разверните новый сервер с 4.0: meridian deploy NEW_IP
    2. Дайте вашим пользователям их новые страницы подключения (meridian client add NAME для каждого человека)
    3. Как только все переключились, разберите старый сервер с meridian teardown OLD_IP — teardown 4.0 также удаляет 3x-ui

Meridian 4.0 хранит своё состояние в ~/.config/meridian/ и никогда не читает и не меняет состояние 3.x в ~/.meridian/, поэтому обе версии могут жить на одной машине; команды флота, которые находят только состояние 3.x, объясняют эти варианты.

Требования

  • Python 3.11+ (uv устанавливает и управляет им для вас)
  • SSH ключевой доступ к вашему серверу, как root или пользователь с passwordless sudo

Терминальные QR коды отрисовываются встроенным пакетом segno; нет системной зависимости.

Проверить установку

meridian --version
On this page