نصب

نصب سریع

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

این اسکریپت:

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

نصب دستی

با 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.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 deploy کنید: 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/ را هرگز نمی‌خواند و تغییر نمی‌دهد، پس هر دو نسخه می‌توانند روی یک ماشین کنار هم باشند؛ دستورهای fleet که فقط وضعیت 3.x را پیدا کنند، این گزینه‌ها را توضیح می‌دهند.

نیازمندی‌ها

• Python 3.11+ (uv آن را نصب و مدیریت می‌کند)
• دسترسی کلید SSH به سرور شما، به‌عنوان root یا کاربر با sudo بدون گذرواژه

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

تأیید نصب

meridian --version