مدیریت کلاینت

افزودن کلاینت

meridian client add alice

این به “alice” کلید خود و دو چیز را برای اشتراک می‌دهد:

• لینک صفحه اتصال با کد QR — ساده‌ترین راه برای ارسال
• URL اشتراک برای درج مستقیم در برنامه Xray/V2Ray

چندین نفر را یک‌زمان اضافه کنید:

meridian client add alice bob charlie

کلاینت‌ها به کل فلیت شما تعلق دارند، نه یک سرور. هر exit و relay شما در اشتراک آن‌ها نمایش داده می‌شود.

آنچه گیرنده می‌بیند

صفحه اتصال از اشتراک واقعی فرد ساخته می‌شود، بنابراین دقیقاً همان چیزی را نشان می‌دهد که برنامه‌های او دریافت می‌کنند: exit‌های مستقیم، relay‌ها و هر روش فعال. شامل:

• دو مرحله: نصب برنامه‌ای که برای پلتفرم او پیشنهاد شده (اول Happ، بعد FlClashX و Clash Mi، و روی دسکتاپ Throne) و سپس اضافه کردن اتصال با یک ضربه
• کد QR برای اشتراک؛ روی کامپیوتر کنار مرحله‌ها نشان داده می‌شود تا بتوان گوشی را تنظیم کرد
• هر اتصال جداگانه با دکمه‌های «باز کردن»، «کپی» و QR، که تا وقتی لازم نشود جمع شده است
• بخش «متصل نمی‌شوید؟» با چند توصیه و آزمایش «بررسی اتصال من» که گزارشی بدون لینک کپی می‌کند تا برای شما بفرستد

در برنامه، ورودی‌ها بر اساس کشور exit و روش نام‌گذاری می‌شوند: «🇩🇪 DE · Reality · Chrome»، «🇩🇪 DE · XHTTP · Chrome»، «🇩🇪 DE · WebSocket · CDN»، «🇩🇪 DE · Hysteria2 · UDP»؛ برای ورودی‌های relay عبارت «via relay» هم اضافه می‌شود. اگر دو exit در یک کشور باشند، نام آن‌ها بعد از پرچم نمایش داده می‌شود («🇩🇪 main»)؛ exit بدون کشور مشخص، وقتی چند exit دارید با نام خودش نشان داده می‌شود. Reality و XHTTP نسخه‌های «· Firefox» هم دارند با اثر انگشت TLS دیگر، برای وقتی که یک اثر انگشت مسدود شود. برنامه‌هایی که خودکار تعویض می‌کنند (برنامه‌های Xray JSON مثل Happ، و Mihomo و sing-box) خودشان یک ورودی کارآمد انتخاب می‌کنند اما هرگز بین اثر انگشت‌ها جابه‌جا نمی‌شوند؛ Happ برای این کار یک ورودی جدا به نام «Automatic · Firefox» نشان می‌دهد.

لینک را از طریق هر پیام‌رسانی ارسال کنید. گیرنده آن را باز می‌کند، برنامه را نصب می‌کند، «افزودن به …» را می‌زند (یا کد QR را با دستگاه دیگری اسکن می‌کند) و متصل می‌شود. اتصال او را قدم‌به‌قدم همراهی می‌کند و می‌گوید وقتی کار نمی‌کند چه کند؛ آن صفحه را هم برایش بفرستید.

نمایش جزئیات اتصال

برای اشتراک دوباره لینک‌های کلاینت:

meridian client show alice

این صفحه اتصال و URL اشتراک را چاپ می‌کند، به‌علاوه وضعیت، ترافیک و زمان آخرین اتصال. اگر صفحه گم باشد (مثلاً بارگذاری ناموفق بود)، آن را دوباره منتشر کنید:

meridian client show alice --repair-page

فهرست کلاینت‌ها

meridian client list

هر کلاینت را با وضعیت، ترافیق، زمان ایجاد و آخرین اتصال نمایش می‌دهد.

معلق کردن و از سرکشی درآوردن کلاینت

meridian client disable alice
meridian client enable alice

disable کلاینت را فوراً قطع می‌کند؛ enable آن‌ها را با همان لینک‌ها دوباره فعال می‌کند.

معلق کردن تا زمان client enable پابرجاست: apply، بازاستقرار و تغییرات fleet به آن دست نمی‌زنند.

جایگزینی لینک لورفته

اگر لینک یا صفحه اتصال یک کلاینت به دست کسی رسیده که نباید، آن را جایگزین کنید:

meridian client reissue alice

Remnawave یک شناسه اشتراک جدید و کلیدهای جدید به کلاینت می‌دهد. نشانی اشتراک و صفحه اتصال قبلی پاسخ 404 می‌دهند و سرورها کلیدهای قبلی را رد می‌کنند. Meridian صفحه قبلی را حذف می‌کند، صفحه تازه‌ای منتشر می‌کند و صفحه و نشانی اشتراک جدید را برای فرستادن به کلاینت چاپ می‌کند. کلاینت لینک جدید را یک بار وارد می‌کند، چون برنامه‌ها نمی‌توانند اشتراکی را به‌روز کنند که نشانی‌اش دیگر وجود ندارد. بقیه چیزهایی که پنل برای کلاینت نگه می‌دارد سر جایش می‌ماند: وضعیت، سقف و مصرف ترافیک، تاریخ انقضا، توضیحات و محدودیت دستگاه HWID.

محدودیت دستگاه HWID در پنل نگه داشته می‌شود، نه در لینک. دستگاه‌هایی که از قبل ثبت شده‌اند پس از صدور دوباره در فهرست HWID کلاینت می‌مانند و همچنان جا می‌گیرند، هرچند لینک قبلی‌شان دیگر وصل نمی‌شود. کلاینت را در پنل باز کنید و دستگاه‌های ناآشنا را حذف کنید تا محدودیت فقط دستگاه‌های خود کلاینت را بشمارد. Meridian هیچ بلیت ادعا یا اتصال به دستگاهی از خودش اضافه نمی‌کند.

با --json، --yes را هم بدهید. لینک‌های جدید فقط در خروجی همین دستور نمایش داده می‌شوند.

حذف کلاینت

meridian client remove NAME کلاینت را برای‌ابد حذف می‌کند: پیوندهای آن‌ها کار نمی‌کنند و صفحه اتصال آن‌ها حذف می‌شود. فلیت حداقل یک کلاینت نگه می‌دارد. کاربران را در پنل Remnawave مستقیماً حذف نکنید — Meridian هر کلاینتی را که در topology باقی است در بعدی اعمال دوباره ایجاد می‌کند.

لینک‌های اشتراک

URL‌های اشتراک مثل https://198.51.100.10/<page-path>/sub/<id> هستند. آن‌ها زیر مسیر صفحه اتصال زندگی می‌کنند؛ پنل مدیریت Remnawave روی مسیر مخفی جداگانه است که لینک‌های اشتراکی هرگز آن را فاش نمی‌کنند.

هر اشتراک از برنامه‌ها می‌خواهد آن را هر ۶ ساعت تازه کنند (هدر profile-update-interval که برنامه‌هایی مثل Happ و Clash Verge از آن پیروی می‌کنند)، بنابراین هنگام افزودن exit یا relay، کلاینت‌ها ظرف چند ساعت و بدون لینک جدید آن را به‌دست می‌آورند. برنامه‌هایی که این هدر را نادیده می‌گیرند طبق برنامهٔ خودشان تازه می‌کنند؛ تازه‌سازی دستی در برنامه تغییرات را فوراً می‌گیرد.

دکمهٔ پشتیبانی در برنامه، صفحهٔ اتصال همان شخص را با راهنمای «متصل نمی‌شوید؟» باز می‌کند. برای فرستادن افراد به جای دیگر، هدر support-url خودتان را در تنظیمات اشتراک پنل بگذارید؛ Meridian آن را نگه می‌دارد.

برنامه‌ها و engineهای آزمایش‌شده

یک URL اشتراک به هر برنامه همان قالبی را می‌دهد که آن برنامه می‌خواند. با هر تغییر در Meridian یک آزمایشگاه چندنودی اجرا می‌شود که هر قالب را از یک پنل واقعی Remnawave می‌گیرد و با engineی که این برنامه‌ها بر پایهٔ آن ساخته شده‌اند بررسی می‌کند:

قالب	برنامه‌ها	engine آزمایش‌شده	آزمایشگاه چه چیزی را بررسی می‌کند
Xray JSON	Happ، v2rayNG، v2rayN، Streisand، V2Box	Xray 26.7.28	ترافیک از هر نقطهٔ ورود و از failover خودکار عبور می‌کند؛ کلید اشتباه رد می‌شود
Mihomo	FlClashX, Clash Mi	Mihomo 1.19.32	mihomo -t پروفایل، قوانین آن و گروه fallback آن را بارگذاری می‌کند
sing-box	sing-box (SFA, SFI), Karing	sing-box 1.14.3	sing-box check پروفایل را بارگذاری می‌کند و گروه خودکار آن مسیر پیش‌فرض است
لینک‌های Base64	دیگر برنامه‌های Xray/V2Ray (v2RayTun، Shadowrocket)	—	هر لینک تجزیه می‌شود و همان سرورها و کلیدی را نام می‌برد که قالب‌های دیگر نام می‌برند

برنامه‌ها به‌روزرسانی engine خودشان را عرضه می‌کنند، بنابراین ممکن است یک برنامه engineی کمی قدیمی‌تر یا جدیدتر از engine آزمایش‌شده اجرا کند.

محل زندگی اطلاعات کلاینت

حساب‌های کلاینت (کلیدها، وضعیت، ترافیق) در پایگاه داده پنل Remnawave روی سرور control-plane زندگی می‌کنند. فهرست کلاینت‌های که Meridian مدیریت می‌کند بخش توپولوژی شما در ~/.config/meridian/cluster.yml است. فرمان‌های کلاینت از API پنل استفاده می‌کنند و SSH نیاز نیست؛ منتشر کردن صفحه اتصال از SSH به سرور control-plane استفاده می‌کند.

پنل وب

پنل مدیریت Remnawave ترافیق، کاربران و نودها را در مرورگر نشان می‌دهد، و می‌توانید از آن استفاده کنید. meridian panel URL و نام کاربری مدیریت را چاپ می‌کند؛ meridian panel --show-password همچنین رمز عبور را چاپ می‌کند.

Meridian و پنل کار را split می‌کنند تا ویرایش‌های شما بیشتر نشود:

Meridian مدیریت می‌کند (بعدی اعمال نسخه آن را بازگردانده)	مال شما برای تغییر (اعمال هرگز به آن‌ها نمی‌رسد)
Nodes، پروفایل‌های config، inbounds، منتشر شدهٔ Hosts، squads	وضعیت هر کلاینت: فعال/غیرفعال، محدودیت‌های ترافیک، انقضا، محدودیت‌های HWID، توضیح
Subscription templates و تنظیمات که Meridian تنظیم می‌کند (عنوان، بازهٔ تازه‌سازی، Xray JSON برای برنامه‌هایی که آن را می‌خوانند، لینک پشتیبانی مگر اینکه لینک خودتان را گذاشته باشید)	کاربرانی که خود در پنل ایجاد می‌کنید
کدام کلاینت‌ها وجود دارند، نام‌های آن‌ها و squads آن‌ها	اطلاعات، plugins، کنترل IP و سایر تنظیمات پنل

meridian plan هر تفاوت در آنچه Meridian مدیریت می‌کند را پیش از هر تغییر نشان می‌دهد. کاربرانی که در پنل اضافه می‌کنید هرگز توسط Meridian فهرست نمی‌شوند، تغییر نمی‌خورند یا حذف نمی‌شوند؛ برای اعطای کسی لینک مریدیان‌مدیریت‌شده و صفحهٔ اتصال، meridian client add را بجای استفاده کنید.

Node pluginها

Node pluginهای Remnawave (‏Ingress Filter، Egress Filter، Torrent Blocker، Connection Drop) اختیاری‌اند و در پنل قرار دارند. برای استفاده از آن‌ها، Node Plugins را در UI مدیریت باز کنید، یک پیکربندی plugin بسازید، pluginهای دلخواه را فعال کنید و آن را به nodeهای خود متصل کنید. Meridian از قبل هر node را با capability ‏NET_ADMIN که pluginها لازم دارند اجرا می‌کند و پیکربندی‌های plugin شما را هرگز تغییر نمی‌دهد و حذف نمی‌کند.

pluginها قوانین nftables را روی host می‌نویسند، بنابراین upstream به کرنل Linux نسخهٔ 5.7 یا جدیدتر هم نیاز دارد؛ روی کرنل قدیمی‌تر بی‌صدا هیچ کاری نمی‌کنند. meridian check این را روی هر exit و gateway با عنوان Node plugin readiness گزارش می‌کند و دربارهٔ کرنل قدیمی هشدار می‌دهد (به Ubuntu 22.04+ یا Debian 11+ بروید). اگر از pluginها استفاده نمی‌کنید، می‌توانید آن هشدار را نادیده بگیرید.

Torrent Blocker از طریق sniffing ترافیک، BitTorrent را تشخیص می‌دهد و Meridian آن را (به‌صورت route-only، بنابراین مقصدها هرگز بازنویسی نمی‌شوند) روی هر inboundی که تولید می‌کند روشن می‌کند. plugin را در پنل فعال کنید تا روی هر exit کار کند.

اتصال یک ربات به پنل

ربات‌های جامعه، مثل ربات تلگرامی که می‌گوید چقدر ترافیک باقی مانده، مستقیم با API ‏Remnawave صحبت می‌کنند. به هر ربات توکن جداگانه‌ای بدهید که فقط دسترسی لازم را داشته باشد:

1. پنل را باز کنید (meridian panel نشانی را چاپ می‌کند)، به Remnawave Settings → API tokens (تنظیمات Remnawave، توکن‌های API) بروید و Create API token را بزنید.
2. توکن را به نام ربات نام‌گذاری کنید و Expires in (days) را روی مدتی بگذارید که واقعاً آن را می‌چرخانید، مثلاً ۳۰ یا ۹۰ روز.
3. از پیش‌تنظیم Read only شروع کنید، یا endpointهای مشخصی را انتخاب کنید و فقط آنچه ربات استفاده می‌کند بدهید. پنل توکن را فقط یک بار نشان می‌دهد؛ آن را کنار secretهای ربات نگه دارید.
4. ربات را به URL پنل از meridian panel راهنمایی کنید و توکن را به‌صورت Authorization: Bearer <token> بفرستید. مسیرهای API زیر آن URL قرار می‌گیرند، مثلاً https://198.51.100.10/<secret-path>/api/users/by-username/alice. این URL شامل مسیر مخفی پنل است، پس آن را مثل توکن محرمانه نگه دارید.

scopeها به شکل resource:endpoint نام‌گذاری می‌شوند؛ resource:read همهٔ endpointهای خواندن یک resource را می‌دهد و resource:write همهٔ endpointهای نوشتن را. یک ربات فقط‌خواندنی معمولاً به این‌ها نیاز دارد:

Scope	Endpoint	برمی‌گرداند
users:by-username	GET /api/users/by-username/{username}	وضعیت، ترافیک مصرف‌شده و محدودیت، و انقضای یک کاربر
users:by-short-uuid	GET /api/users/by-short-uuid/{shortUuid}	همان‌ها، با یافتن کاربر از شناسهٔ موجود در لینک اشتراکش
users:list	GET /api/users	همهٔ کاربران، صفحه‌بندی‌شده
system:stats	GET /api/system/stats	مجموع کاربران و ترافیک کل پنل
nodes:list	GET /api/nodes	وضعیت و ترافیک هر node

scope نوشتن را فقط وقتی اضافه کنید که ربات حساب‌ها را تغییر می‌دهد، مثلاً users:extend (‏POST /api/users/{id}/actions/extend) برای ربات پرداخت که انقضا را تمدید می‌کند. وضعیت، محدودیت‌ها و انقضا مال شما برای تغییر است (جدول بالا را ببینید)، پس apply بعدی ویرایش‌های ربات را نگه می‌دارد. ربات نباید کلاینت‌های Meridian را تغییر نام دهد یا حذف کند: apply بعدی آن‌ها را دوباره می‌سازد.

توکن خود Meridian را (meridian-provisioner در فهرست توکن‌ها) به ربات ندهید. دسترسی کامل به پنل دارد و عملاً هرگز منقضی نمی‌شود، پس نشت از میزبان ربات همهٔ nodeها، کلیدها و کاربران را فاش می‌کند. توکن جداگانه آسیب را به کارهایی که ربات می‌تواند انجام دهد محدود می‌کند، خودش منقضی می‌شود و بدون تأثیر بر Meridian قابل حذف است. به meridian-provisioner دست نزنید؛ همهٔ دستورهای کلاینت و apply از آن استفاده می‌کنند.