نصب

نصب سریع

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

این اسکریپت:

1. اگر uv موجود نباشد آن را نصب می‌کند، pipx یا pip را به‌عنوان جایگزین استفاده می‌کند. نصب‌کنندهٔ uv با نسخه pin شده و پیش از اجرا با SHA-256 بررسی می‌شود.
2. meridian-vpn را از PyPI نصب می‌کند (برای نصب یک نسخهٔ دقیق، MERIDIAN_VERSION=4.0.0 را تنظیم کنید)
3. در صورت نیاز پوشه ابزار را به PATH شل اضافه می‌کند
4. فقط وقتی sudo بدون گذرواژه در دسترس باشد /usr/local/bin/meridian را ایجاد می‌کند

نصب تأییدشده

هر release در GitHub فایل install.sh و SHA256SUMS آن را پیوست می‌کند. برای بررسی اسکریپت پیش از اجرا، هر دو را از release دانلود کنید و تأیید کنید:

VERSION=4.0.0
curl -fLO https://github.com/getmeridian/meridian/releases/download/v$VERSION/install.sh
curl -fLO https://github.com/getmeridian/meridian/releases/download/v$VERSION/SHA256SUMS
sha256sum -c SHA256SUMS          # macOS: shasum -a 256 -c SHA256SUMS
less install.sh                  # optional: read it
MERIDIAN_VERSION=$VERSION bash install.sh

برای بررسی نسخهٔ موجود در getmeridian.org، خروجی curl -sSf https://getmeridian.org/install.sh | sha256sum را با SHA256SUMS همان release مقایسه کنید؛ تا وقتی اسکریپت پس از آن release تغییر نکرده باشد یکسان‌اند. وقتی جدیدترین release یک نسخهٔ بتا باشد، نسخهٔ موجود در وب‌سایت به‌طور پیش‌فرض همان بتا را نصب می‌کند و همان یک خط باعث می‌شود checksum آن با فایل پیوست release فرق کند.

نصب دستی

با uv (توصیه شده):

uv tool install meridian-vpn

با pipx:

pipx install meridian-vpn

به‌روزرسانی

meridian update

Meridian پیش از دستورهای تعاملی PyPI را بررسی می‌کند و نوتیس می‌دهد وقتی نسخه جدیدتری موجود است. هیچ به‌روزرسانی خودکار نصب نمی‌کند. meridian update با هر کدام از package manager‌هایی که ابزار را نصب کردند ارتقا می‌دهد و تأیید می‌کند که دستور فعال meridian نسخه جدید را نشان می‌دهد. برای automation از MERIDIAN_DISABLE_UPDATE_CHECK=1 استفاده کنید.

به‌روزرسانی CLI هیچ تغییری بر روی سرورهای شما ایجاد نمی‌کند. اگر سرور کار می‌کند، عجله‌ای نیست؛ یادداشت انتشار را بخوانید و سپس وقتی آماده باشید دستور meridian deploy (یا meridian apply) را دوباره اجرا کنید.

ارتقا از 3.x

Meridian 4 نیست نصب درجا. جای پنل 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 را بگذارید.
• رفتن به Meridian 4.
  1. سرور جدید را با Meridian 4 deploy کنید: meridian deploy NEW_IP
  2. برای هر شخص صفحات اتصال جدید انتشار دهید (meridian client add NAME)
  3. بعدما که همه تغییر کردند، سرور قدیمی را پاک کنید با meridian teardown OLD_IP — teardown Meridian 4 همچنین 3x-ui را حذف می‌کند

Meridian 4 وضعیت خودش را در ~/.config/meridian/ نگه می‌دارد و وضعیت 3.x در ~/.meridian/ را هرگز نمی‌خواند و تغییر نمی‌دهد، پس هر دو نسخه می‌توانند روی یک ماشین کنار هم باشند؛ دستورهای fleet که فقط وضعیت 3.x را پیدا کنند، این گزینه‌ها را توضیح می‌دهند.

این مستندات Meridian 4 را شرح می‌دهند. مستندات Meridian 3.17.3 برای سرورهایی که روی 3.x نگه می‌دارید در GitHub باقی می‌مانند.

نیازمندی‌ها

• Python 3.11+ (uv آن را نصب و مدیریت می‌کند)
• دسترسی SSH به سرور شما، به‌عنوان root یا کاربر با sudo بدون گذرواژه. ورود با کلید بهترین است؛ اگر سرور فقط گذرواژه می‌پذیرد، meridian deploy و meridian setup پیشنهاد می‌کنند برای Meridian کلیدی بسازند و یک بار با همان گذرواژه نصبش کنند (ببینید سرورهای فقط با گذرواژه)

کدهای QR ترمینال با بستهٔ موجود segno رسم می‌شوند؛ به وابستگی سیستمی نیاز ندارد.

تأیید نصب

meridian --version