مقاله آموزشی استفاده از Black Fox Config Builder

۱. تغییر زبان، به‌روزرسانی و گزارش فعالیت (Settings / تنظیمات)

در تب پنجم (Settings یا «تنظیمات») می‌توانید زبان، وضعیت آپدیت و لاگ خطاهای Config Builder را کنترل کنید:

• انتخاب زبان (Language / زبان): لیست بازشو شامل ۱۰ زبان زنده دنیا (فارسی، انگلیسی، روسی، چینی، آلمانی، ازبکی، ترکی استانبولی، اندونزیایی، اوکراینی و هندی). با انتخاب فارسی تمام دکمه‌ها، منوها و پیام‌ها فوراً فارسی و راست‌چین می‌شوند.
• بررسی به‌روزرسانی (Check for updates): نسخه نصب‌شده برنامه را با سرور مقایسه می‌کند. در صورت وجود نسخه جدید، می‌توانید دکمه به‌روزرسانی را بزنید تا فایل APK با نمایش درصد پیشرفت (%) دانلود و مستقیماً نصب شود. اگر آپدیت اجباری باشد پنجره نصب سریع باز می‌شود.
• به‌روزرسانی و تنظیمات سرور (Updates & Remote Config): یک پنجره جانبی باز می‌کند که نسخه موجود روی سرور و دکمه بروزرسانی از سرور را در اختیارتان می‌گذارد تا نسخه سرور، ولت و اطلاعیه‌ها را به‌صورت دستی از سرورهای دوگانه (blackfoxupdate.ir و foxnext.net) تازه‌سازی کنید.
• لاگ فعالیت (Activity log): تمام رویدادها با برچسب زمان و وضعیت ([INFO]، [OK]، [ERROR]) به‌صورت خودکار اینجا ثبت و به خط آخر اسکرول می‌شوند. با دکمه‌های Copy log (کپی لاگ) و Clear log (پاک کردن لاگ) گزارش را مدیریت کنید.

۲. اتصال ایمن به پنل 3X-UI (Connection / اتصال)

در تب اول، مشخصات ورود پنل 3X-UI خود را وارد کنید. Config Builder از دو روش احراز هویت پشتیبانی می‌کند:

• آدرس پنل (Panel URL): الزامی — آدرس کامل پنل همراه با پروتکل، پورت و مسیر ورود؛ مثال: https://sub.domain.com:2053/mybase
• نام کاربری (Username) و رمز عبور (Password): اطلاعات ورود استاندارد پنل (کاراکترهای رمز به‌صورت نقطه‌چین مخفی می‌شوند).
• کلید API (API Key - optional): اختیاری و هوشمند! اگر در این کادر کلید API وارد کنید، Config Builder به‌صورت خودکار حالت API را فعال کرده و فیلدهای نام کاربری و رمز عبور را غیرفعال (قفل) می‌کند؛ همچنین عملیات اتصال و ساخت با سرعت بالاتری انجام می‌شود. اگر API Key ندارید، این کادر را خالی بگذارید.
• آدرس اشتراک (Sub URI - optional): اختیاری — اگر لینک سابسکریپشن پنل شما روی دامنه یا پورت جداگانه‌ای تنظیم شده، آدرس پایه آن را اینجا بنویسید؛ در غیر این صورت خالی بگذارید تا از تنظیمات خود پنل استفاده شود.

توضیح کامل ۴ دکمه این صفحه

• Connect (اتصال): اطلاعات را چک کرده، در حافظه امن ذخیره می‌کند، به پنل وصل می‌شود و فوراً لیست Inboundها را از سرور می‌گیرد. تا زمانی که دکمه قطع اتصال را نزنید، نشست (Session) فعال می‌ماند.
• Disconnect (قطع اتصال): فقط زمانی فعال است که متصل باشید؛ نشست جاری با پنل را می‌بندد و صفحات ساخت را پاکسازی می‌کند.
• Save (ذخیره): اطلاعات تایپ‌شده را بدون برقراری اتصال، در حافظه امن گوشی ذخیره می‌کند.
• Delete (حذف): هم اتصال فعال را قطع می‌کند و هم تمام اطلاعات ذخیره‌شده پنل را از گوشی پاک می‌کند.

۳. ساخت کانفیگ تکی (Single / تکی)

پس از سبز شدن وضعیت (Connected)، به تب دوم بروید تا یک اشتراک جدید بسازید:

• نام کانفیگ (Config name): نام مشتری را وارد کنید. قانون نام‌گذاری: فقط حروف انگلیسی (A-Z، a-z)، اعداد، فاصله و خط تیره (-) مجاز است (حروف فارسی یا علامت‌های خاص پذیرفته نمی‌شود). همچنین Config Builder به‌صورت هوشمند اجازه ساخت نام تکراری را نمی‌دهد. با زدن آیکون چرخش (↻) در انتهای کادر، نام یکتای تصادفی با فرمت Black fox-XXXXXX ساخته می‌شود.
• حجم ترافیک (Traffic (GB)): پیش‌فرض روی 10 گیگابایت است. اگر عدد 0 وارد کنید، زیر کادر عبارت «0 = نامحدود» ظاهر می‌شود.
• مدت اعتبار (Duration (days)): پیش‌فرض 30 روز است. وارد کردن عدد 0 به معنی بدون محدودیت زمانی (نامحدود) است.
• انتخاب Inbound (پروتکل و پورت): زیر فیلدها منوی بازشو انتخاب Inbound وجود دارد که تمام ورودی‌های پنل را با فرمت «پروتکل · توضیح · پورت · وضعیت فعال/غیرفعال» نمایش می‌دهد. می‌توانید همزمان یک یا چند Inbound را تیک بزنید (یا با آیکون Refresh لیست را دوباره از سرور بگیرید).
• ساخت (Create config): با لمس دکمه آبی، کانفیگ فوراً ساخته شده و در لیست سوابق هم ذخیره می‌شود.

نتیجه ساخت در نیمه پایینی صفحه

• دو لینک مجزا: هم لینک کانفیگ مستقیم (Config link) و هم لینک سابسکریپشن (Sub link) نمایش داده می‌شوند و هر دو قابل انتخاب و کپی هستند.
• دو بارکد QR مجزا: بارکد Config QR و Sub QR در کنار هم نمایش داده می‌شوند. کافیست یک ضربه روی هر بارکد بزنید تا لینک آن فوراً کپی شود!
• پاک کردن صفحه (Clear page): با نمایش یک پنجره تأیید («آیا اطمینان دارید؟»)، فرم و نتیجه را پاک می‌کند.

۴. ساخت دسته‌ای و گروهی (Bulk / گروهی)

برای ساخت همزمان چندین کانفیگ در یک نوبت (مناسب فروشندگان و توزیع انبوه)، وارد تب سوم شوید:

• نام پایه (Base name): پیشوند نام اکانت‌ها (مثلاً Team) که Config Builder بر اساس آن ردیف‌های متوالی یکتا می‌سازد. با آیکون ↻ یک نام پایه تصادفی غیرتکراری پیشنهاد می‌شود.
• تعداد (Count): تعداد کلاینت‌های مورد نیاز (پیش‌فرض 10). فرمول تولید کل: اگر 10 عدد را روی 2 عدد Inbound انتخاب کنید، در مجموع 20 کانفیگ تولید می‌شود.
• حجم و مدت (Traffic & Duration): برای تمامی کانفیگ‌های این دسته اعمال می‌شوند (نامحدود = 0).
• نوار پیشرفت و دکمه توقف (Stop): پس از زدن Create bulk configs، نوار پیشرفت همراه با شمارنده (مثلاً 0 / 10 تا تکمیل) و دکمه Stop (توقف) نمایش داده می‌شود تا در صورت نیاز درخواست توقف ثبت شود و ادامه نتیجه ذخیره نشود.

مدیریت آسان لینک‌های ساخته‌شده

• جدول دوستونه مرتب: تمام خروجی‌ها در دو ستون کنار هم («لینک کانفیگ» و «لینک Sub» در ستون مقابل) با شماره ردیف آبی‌رنگ نمایش داده می‌شوند. با لمس هر خانه، همان لینک فوراً کپی می‌شود.
• کپی جفتی با شماره ردیف (Link number + Copy): پس از ساخت، کادر «شماره لینک» ظاهر می‌شود؛ کافیست شماره ردیف (مثلاً 3) را وارد کرده و دکمه کپی را بزنید تا هر دو لینک (کانفیگ + ساب) شماره 3 همزمان در کلیپ‌بورد کپی شوند!

۵. مدیریت سوابق و حذف از سرور (List / لیست)

تمام کانفیگ‌های ساخته‌شده در بخش تکی و گروهی به‌صورت خودکار در تب چهارم (List) نگهداری می‌شوند. در زمان خالی بودن لیست عبارت No configs created yet. دیده می‌شود.

• اطلاعات هر سطر: نام کاربر، حجم (GB)، مدت اعتبار (روز) و پیش‌نمایش لینک اشتراک آن نمایش داده می‌شود.
• انتخاب تکی یا دسته‌جمعی: در کنار هر ردیف یک تیک (چک‌باکس) قرار دارد و در بالای صفحه گزینه «انتخاب همه» (Select all) همراه با شمارنده تعداد انتخاب‌شده‌ها (Selected: N) دیده می‌شود.
• منوی سه‌نقطه عملیات (⋮) در انتهای هر سطر: اگر چند سطر را تیک زده باشید، دستور روی تمام موارد انتخاب‌شده اجرا می‌شود:
  ۱. Copy link (کپی لینک): لینک تمام موارد انتخاب‌شده را پشت سر هم (هر لینک در یک خط) کپی می‌کند.
  ۲. Delete from panel (حذف از پنل): حذف واقعی از سرور! پس از تأیید، کلاینت‌ها را مستقیم از پنل 3X-UI پاک کرده و سپس از لیست گوشی حذف می‌کند (مستلزم اتصال به پنل است). در حذف چندتایی، پنجره‌ای شامل تعداد «موفق»، «ناموفق» و لیست خطاهای احتمالی نمایش داده می‌شود.
  ۳. Delete from list (حذف از لیست): رکورد را فقط از حافظه گوشی پاک می‌کند و کاربر روی سرور دست‌نخورده و فعال باقی می‌ماند.

۶. راه‌های ارتباطی و پشتیبانی زنده (Contact / تماس)

در آخرین تب (Contact)، تمامی پل‌های ارتباطی رسمی تیم قرار گرفته‌اند. با لمس هر کارت مستقیماً وارد مرورگر، برنامه ایمیل یا تلگرام می‌شوید:

• وب‌سایت رسمی: www.foxnext.net
• ایمیل پشتیبانی: [email protected]
• مخزن متن‌باز گیت‌هاب: BlackFoxGroup
• کانال رسمی تلگرام: @BlackFoxVpnn (اخبار و انتشار نسخه‌ها)
• پشتیبانی تلگرام: @HiBlackFox (پاسخگویی مستقیم)
• ربات خرید و سرویس: @BlackFox_Agent_Bot
• گروه کاربری تلگرام: @Black_Fox_Group