# مدیریت کلاینت‌ها

> افزودن کاربران، اشتراک‌گذاری اطلاعات اتصال و مدیریت کلیدهای دسترسی.

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

```
meridian client add alice
```

این یک کلید اتصال منحصر به فرد برای "alice" ایجاد می‌کند و نمایش می‌دهد:
- یک **کد QR** در ترمینال — آن را با یک برنامه VPN اسکن کنید تا فوری متصل شوید
- **URL‌های اتصال** — پیوندهای VLESS برای هر پروتکل (Reality، XHTTP و WSS اگر حالت دامنه فعال باشد)
- **URL صفحه قابل اشتراک** — میزبانی‌شده در سرور شما، آماده برای ارسال از طریق هر مسنجری
- یک **فایل HTML** ذخیره‌شده به‌صورت محلی — نسخه پشتیبان برای اشتراک‌گذاری آفلاین

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

URL قابل اشتراک صفحه اتصالی را باز می‌کند با:
- دستورالعمل‌های گام‌به‌گام برای نصب برنامه VPN (v2RayTun، v2rayNG، Hiddify یا v2rayN)
- کدهای QR برای هر پروتکل اتصال
- پیوندهای عمیق "باز در برنامه" تک‌ضربتی
- وضعیت اتصال و آمار استفاده

URL را از طریق ایمیل، iMessage، تلگرام یا هر مسنجر دیگری ارسال کنید. گیرنده آن را باز می‌کند، برنامه را نصب می‌کند، کد QR را اسکن می‌کند و متصل می‌شود. هیچ دانش فنی مورد نیاز نیست.

## نمایش اطلاعات اتصال

برای نمایش مجدد اطلاعات اتصال برای یک کلاینت موجود در هر زمان:

```
meridian client show alice
```

این همان کد QR، URL‌های اتصال و پیوند صفحه قابل اشتراک را خروجی می‌دهد — بدون ایجاد کلید جدید. از این زمانی استفاده کنید که:
- نیاز دارید صفحه اتصال را با کسی دوباره اشتراک‌گذاری کنید
- کد QR یا فایل HTML اصلی را گم کرده‌اید
- می‌خواهید بررسی کنید اتصال کلاینت چگونه به نظر می‌رسد

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

```
meridian client list
```

تمام کلاینت‌ها را با اتصالات پروتکل آن‌ها نشان می‌دهد (Reality، XHTTP، WSS).

## حذف کلاینت

```
meridian client remove alice
```

دسترسی را بلافاصله لغو می‌کند. UUID کلاینت از تمام inbound‌های سرور حذف می‌شود.

## چند سرور

برای هدف‌گذاری سرور نام‌گذاری شده خاص از `--server` استفاده کنید:

```
meridian client add alice --server finland
meridian client show alice --server finland
meridian client list --server finland
```

اگر فقط یک سرور دارید، به‌طور خودکار انتخاب می‌شود.

## محل ذخیره اطلاعات اعتبار

وقتی `meridian deploy` را از لپ‌تاپ خود اجرا می‌کنید، Meridian اطلاعات اعتبار سرور را به‌صورت محلی ذخیره می‌کند:

```
~/.meridian/credentials/<IP>/proxy.yml   # کلیدها، UUID‌ها، دسترسی پنل
~/.meridian/servers                      # رجیستری سرور
```

در خود سرور، همان داده‌ها در `/etc/meridian/proxy.yml` قرار دارد. Meridian پس از `client add` و `client remove` به‌طور خودکار آن‌ها را همگام‌سازی می‌کند.

به همین دلیل `meridian client add alice` بدون تعیین سرور کار می‌کند — Meridian آن را در رجیستری محلی جستجو می‌کند. اگر چندین سرور دارید، از `--server NAME` استفاده کنید.

اگر اطلاعات اعتبار ناهمگام شدند (مثلاً کلاینت از ماشین دیگری اضافه شده)، `client show` به‌طور خودکار داده‌ها را از پنل سرور بازیابی می‌کند.

## پنل وب

Meridian پنل مدیریت 3x-ui را برای نظارت بر ترافیک مستقر می‌کند. از طریق مسیر مخفی HTTPS نشان‌داده‌شده در اطلاعات اعتبار دسترسی پیدا کنید:

```
cat ~/.meridian/credentials/<IP>/proxy.yml | grep -A5 panel
```

URL پنل، نام کاربری و رمز عبور در آنجا فهرست شده‌اند. تونل SSH نیاز نیست — nginx پنل را از طریق مسیر تصادفی HTTPS پراکسی معکوس می‌کند.

## نحوه کار

نام‌های کلاینت به فیلدهای 3x-ui `email` با پیشوندهای پروتکل نقشه‌برداری می‌شود:
- `reality-alice` — Reality inbound
- `xhttp-alice` — XHTTP inbound
- `wss-alice` — WSS inbound (حالت دامنه)

هر کلاینت UUID منحصر به فردی در تمام inbound‌های سرور دریافت می‌کند.