پرش به مطلب اصلی

کاربران

کاربر — حساب کاربری‌ای است که اشتراک از آن ساخته می‌شود: دسترسی به inboundها از طریق گروه‌ها، محدودیت‌های ترافیک، تاریخ انقضا و فهرست دستگاه‌ها. بخش Users در پنل تنها جایی است که کاربران ساخته و تغییر داده می‌شوند.

ساخت کاربر​

Users → Create را باز کنید و فیلدها را پر کنید.

فیلدالزامیقواعد
usernameبله3–36 کاراکتر: حروف، ارقام، _، -
expireAtبلهتاریخ انقضا، برای مثال 2026-01-17T15:38:45.065Z
statusخیربه‌صورت پیش‌فرض ACTIVE
trafficLimitBytesخیرمحدودیت بر حسب بایت؛ 0 — بدون محدودیت
trafficLimitStrategyخیردوره بازنشانی ترافیک، پیش‌فرض NO_RESET
hwidDeviceLimitخیرتعداد دستگاه‌ها؛ 0 — بدون محدودیت
tagخیرحداکثر 16 کاراکتر: حروف بزرگ، ارقام، _
telegramId, email, descriptionخیراعلان‌ها و یادداشت‌ها
activeInternalSquadsخیرگروه‌های داخلی کاربر
externalSquadUuidخیرگروه خارجی کاربر

رمزهای عبور و شناسه‌های پروتکل‌ها (trojanPassword، vlessUuid، ssPassword) را خود پنل تولید می‌کند — نیازی به تعیین دستی آن‌ها نیست.

وضعیت‌ها​

وضعیتمعنیچگونه تغییر می‌کند
ACTIVEدسترسی باز استهنگام ساخت، فعال‌سازی، تمدید، بازنشانی ترافیک
DISABLEDتوسط مدیر غیرفعال شدهبا دکمه Disable، بازگشت — Enable
LIMITEDمحدودیت ترافیک تمام شدهبه‌صورت خودکار توسط زمان‌بند
EXPIREDexpireAt گذشته استبه‌صورت خودکار توسط زمان‌بند

LIMITED و EXPIRED خودبه‌خود برداشته نمی‌شوند، بلکه با اقدامی آگاهانه برداشته می‌شوند: بازنشانی ترافیک یا تمدید مدت. کاربران را می‌توان بر اساس وضعیت فیلتر کرد و گروهی حذف کرد — Delete users by status.

محدودیت‌های ترافیک​

trafficLimitBytes بر حسب بایت تعیین می‌شود، 0 محدودیت را برمی‌دارد. دوره صفر شدن را trafficLimitStrategy تعیین می‌کند:

مقداردوره
NO_RESETترافیک بازنشانی نمی‌شود
DAYهر شبانه‌روز
WEEKهر هفته
MONTHماه تقویمی
MONTH_ROLLINGیک ماه از تاریخ ساخت کاربر

بازنشانی دستی ترافیک: کارت کاربر → Reset traffic. شمارنده مصرف صفر می‌شود، lastTrafficResetAt به‌روزرسانی می‌شود و وضعیت LIMITED به ACTIVE تبدیل می‌شود. برای گروه بازنشانی گروهی وجود دارد — Bulk actions → Reset traffic (تا 500 کاربر در یک نوبت).

تاریخ انقضا​

expireAt تاریخی است که پس از آن کاربر به EXPIRED می‌رود. تمدید با دکمه Extend بر اساس این قواعد روز اضافه می‌کند:

  • EXPIRED — شمارش از لحظه کنونی، وضعیت ACTIVE می‌شود؛
  • ACTIVE — روزها به تاریخ انقضای کنونی افزوده می‌شوند؛
  • DISABLED و LIMITED — تاریخ تمدید می‌شود، وضعیت تغییر نمی‌کند.

تمدید گروهی: Bulk actions → Extend expiration date.

محدودیت دستگاه​

hwidDeviceLimit تعداد دستگاه‌ها را بر اساس HWID محدود می‌کند. 0 بررسی را کاملاً غیرفعال می‌کند و مقدار خالی یعنی «fallbackDeviceLimit از تنظیمات اشتراک گرفته شود». جزئیات — در بخش محدودیت دستگاه بر اساس HWID.

اتصال به گروه‌ها​

دسترسی به inboundها را گروه‌های داخلی تعیین می‌کنند: کاربر فقط آن هاست‌هایی را می‌بیند که inbound آن‌ها در گروه‌هایش قرار دارد. گروه خارجی (externalSquadUuid) چیزی را مجاز نمی‌کند، بلکه ظاهر و رفتار اشتراک را تغییر می‌دهد — قالب‌ها، هدرها، تنظیمات HWID. هر دو نوع در بخش گروه‌ها بررسی شده است.

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

لینک به‌صورت خودکار از SUB_PUBLIC_DOMAIN و شناسه کوتاه ساخته می‌شود:

https://sub.example.com/<shortUuid>

این لینک به صفحه اشتراک می‌رود یا پیکربندی را مستقیم برمی‌گرداند. اگر لینک لو رفته باشد، اشتراک را لغو کنید (Revoke subscription): پنل shortUuid جدید و رمزهای عبور جدید پروتکل‌ها را صادر می‌کند و لینک قدیمی از کار می‌افتد. حالت «فقط رمزهای عبور» هم وجود دارد — در این حالت شناسه کوتاه حفظ می‌شود.

هشدار

لغو اشتراک دسترسی همه کسانی را که لینک قدیمی را از پیش import کرده‌اند قطع می‌کند. پیش از آنکه لینک جدید را بدهید، کاربر را آگاه کنید.

نکته

شناسه کوتاه با روشی از SHORT_UUID_METHOD تولید می‌شود. تغییر آن در میانه کار توصیه نمی‌شود: قالب همه لینک‌های جدید را عوض می‌کند. ببینید متغیرهای محیطی.

گام‌های بعدی​