معرفی faoxima
faoxima یک ربات تلگرامی حرفهای برای فروش و مدیریت خودکار اشتراک VPN/پروکسی است که بهطور اختصاصی برای فروشندگان (ادمینهای NonSudo) روی پنلهای مختلف VPN طراحی شده است.
faoxima از سه بخش تشکیل شده که روی یک پایگاهدادهٔ مشترک کار میکنند: ربات تلگرام برای تعامل با مشتری و فروش سرویس، مینیاپ تلگرام (SPA) برای تجربهٔ خرید، تمدید و مدیریت شبیه یک اپلیکیشن مستقل، و پنل وب ادمین برای مدیریت کامل فروش، پنلهای متصل و کاربران. این سه بخش با هم به شما امکان میدهند فرآیند فروش سرویس، رصد لحظهای مصرف و کنترل کامل دسترسیها را کاملاً خودکار انجام دهید.
روند معمول استفاده از دید مشتری اینگونه است: ابتدا کیفپول خود را شارژ میکند، سپس از موجودی برای خرید سرویس استفاده میکند؛ faoxima بهصورت خودکار روی پنل بالادستی متصلشده یک اکانت میسازد (یا در صورت وجود، از انبار ازپیشساخته برمیدارد) و بلافاصله لینک اشتراک و QR سرویس را تحویل میدهد. پیش از شروع نصب و راهاندازی، پیشنیازهای سرور و PHP را در بخش پیشنیازها بررسی کنید.
این پروژه بازطراحی کامل و بهینهسازیشدهای از ربات متنباز میرزا است و با هدف ارتقای تجربهٔ کاربری و افزایش کارایی توسعه داده میشود.
faoxima کاملاً رایگان و متنباز (تحت لایسنس GPL-3.0) است. هرگونه فروش یا دریافت وجه بابت خودِ این ربات تخلف محسوب میشود.
بخش نمایندگی (reseller) در حال حاضر غیرفعال است و هنوز در دست توسعه قرار دارد.
پیشنیازها
پیش از نصب، موارد زیر را آماده کنید:
- سرور یا هاست: سرور لینوکس
Ubuntu 22+(روش VPS) یا هاستcPanel/aaPanel. - PHP 8.2 یا 8.3 بههمراه اکستنشنهای
gd،intl،zipوsodium. - پایگاهداده:
MySQLیاMariaDB. - دامنه + گواهی SSL (اتصال باید روی
httpsباشد). - کرونجاب (اجباری) برای اجرای وظایف زمانبندیشده.
- توکن ربات از @BotFather.
بدون تنظیم کرونجاب، تمدید خودکار، یادآوریها و گزارشهای زمانبندیشده کار نخواهند کرد.
امکانات و مزایا
مهمترین قابلیتهای faoxima:
مینیاپ تلگرام
تجربهٔ خرید، تمدید و مدیریت سرویس بهصورت اپلیکیشن (SPA) داخل تلگرام.
درگاههای پرداخت متعدد
زرینپال، ترونادو، تونپی، کیوبپی، بلوپال،اطلس پی،تتراپی، NowPayments و Plisio (کریپتو).
کد تخفیف و هدیه
تعریف کد تخفیف و کد هدیه برای کاربران و نمایندگان.
تیکت و پشتیبانی
سیستم تیکتینگ با دپارتمانهای قابل تعریف.
انبارداری پیشرفته
فروش دستی عمده، پنل اضطراری و انبار شبکهٔ ملی.
رنگبندی دکمهها
رنگیکردن دکمههای ربات در سمت کاربر.
ایموجی پرمیوم
اعمال ایموجیهای اختصاصی (نیازمند اکانت پرمیوم مالک ربات).
پنل وب ادمین
پنل وب بازطراحیشده با امکانات کامل مدیریت.
پنلهای پشتیبانیشده
faoxima از پنلهای زیر پشتیبانی میکند
| پنل | شناسهٔ داخلی | روش احراز هویت | نسخه | نکات |
|---|---|---|---|---|
| مرزبان (Marzban) | marzban | یوزرنیم/پسورد ادمین | Latest | آدرس پنل باید بدون /dashboard ارسال شود |
| پاسارگارد (PasarGuard) | PasarGuard | توکن ثابت API | Latest | آدرس پنل باید بدون /dashboard ارسال شود |
| ثنایی (3x-ui) | 3x-ui | یوزر/پسورد + API | Latest | نام کاربری کلاینت مشخص شود؛ دامنهٔ لینک ساب باید تنظیم شود |
| Remnawaveجدید | remnawave | توکن ثابت API + شناسهٔ Squad | Latest | بدون یوزر/پسورد؛ نیازمند آدرس و توکن API. آدرس پنل باید بدون /dashboard ارسال شود |
| Guard (GuardCore) | guard | کلید (key) | Latest | نیازمند ستونهای موردنیاز در دیتابیس |
| Rebeccaجدید | rebecca | توکن ثابت API | Latest | آدرس پنل باید بدون /dashboard ارسال شود |
| فروش دستی (Manual) | Manualsale | — | — | پنل واقعی نیست؛ مدیریت دستی انبار و فروش |
«شناسهٔ داخلی» همان مقداری است که ربات در پایگاهداده ذخیره میکند و معمولاً نیازی به دانستن آن ندارید؛ صرفاً برای رفع اشکال و توسعه مفید است.
سوالات متداول
faoxima رایگان است؟
بله. faoxima کاملاً رایگان و متنباز (تحت لایسنس GPL-3.0) است و فروش آن تخلف محسوب میشود.
روی چه سیستمی نصب میشود؟
روی سرور Ubuntu با اسکریپت install.sh، یا روی هاست cPanel/aaPanel. مراحل کامل هر دو روش در بخش نصب و راهاندازی توضیح داده شده است.
چه نسخهای از PHP لازم است؟
PHP 8.2 یا 8.3 بههمراه اکستنشنهای gd، intl، zip و sodium. تنظیم کرونجاب نیز اجباری است.
از چه پنلهایی پشتیبانی میکند؟
پاسارگارد، 3x-ui، Remnawave، Guard و Rebecca — بهعلاوهٔ حالت فروش دستی. فهرست کامل در بخش پنلهای پشتیبانیشده.
آیا میتوانم نمایندگان فعلی پنلم را به faoxima وصل کنم؟
بله. با افزودن پنل و تعریف ادمین NonSudo، میتوانید فروش را از طریق پنلهای موجودتان به ربات بسپارید. توجه کنید این موضوع با «سیستم نمایندگی داخلی» خودِ faoxima متفاوت است؛ آن بخش در حال حاضر غیرفعال و در دست توسعه است.
تفاوت faoxima با میرزا چیست؟
faoxima ریفکتور کامل میرزاست: بهینهسازی سرعت، مینیاپ بازطراحیشده، پنل وب جدید، پشتیبانی از Remnawave و درگاههای بیشتر، انبارداری پیشرفته، رنگبندی دکمهها و ایموجی پرمیوم.
بعد از نصب، اولین اجرا با چه نکاتی همراه است؟
مهمترین نکته، تنظیم کرونجاب است؛ بدون آن، تمدید خودکار، یادآوریها و گزارشهای زمانبندیشده کار نمیکنند (به بخش پیشنیازها مراجعه کنید). همچنین اطمینان حاصل کنید توکن ربات و اطلاعات اتصال پایگاهداده بهدرستی در تنظیمات ثبت شده باشند.
چرا با اینکه موجودی از کیفپول کسر شد، سرویس ساخته نشد؟
در موارد نادر ممکن است اتصال به پنل بالادستی در لحظهٔ ساخت اکانت با خطا مواجه شود؛ در این حالت مبلغ از کیفپول کسر شده اما سرویسی تحویل داده نمیشود. faoxima در حال حاضر فرآیند بازگشت وجه خودکار ندارد؛ این موارد باید توسط ادمین بهصورت دستی بررسی و جبران شوند. برای رفع سریعتر، وضعیت پنل و اطلاعات ورود آن را بررسی کنید و به بخش مرجع خطاها مراجعه کنید.
هنگام ثبت یا اتصال پنل با خطا مواجه میشوم، چه باید کرد؟
رایجترین علتها عبارتند از: آدرس یا پورت اشتباه، عدم تطابق پروتکل (http/https)، نامکاربری/رمز عبور نادرست ادمین، یا مسدود بودن دسترسی شبکه بین سرور ربات و پنل. ابتدا آدرس کامل پنل بههمراه پورت را بررسی کنید و سپس اطلاعات ورود را دوباره ثبت کنید. فهرست کامل پیامهای خطای مرتبط با پنل در بخش مرجع خطاها موجود است.
آیا فهرست پنلهای پشتیبانیشده کامل است؟
جدول بخش پنلهای پشتیبانیشده پرکاربردترین پنلهای پشتیبانیشده را نشان میدهد. برای مشاهدهٔ فهرست بهروز و کامل، هنگام افزودن پنل جدید از داخل پنل وب ادمین به گزینههای موجود در آن مرحله مراجعه کنید.
چه محدودیتهای شناختهشدهای در faoxima وجود دارد؟
در حال حاضر faoxima فرآیند بازگشت وجه خودکار ندارد و موارد ناموفق باید بهصورت دستی توسط ادمین بررسی شوند. برخی امکانات نیز به شرایط خاص نیاز دارند؛ برای نمونه ایموجی پرمیوم تنها در صورتی کار میکند که حساب تلگرام مالک ربات دارای اشتراک Premium باشد.
با خطای غیرمنتظره مواجه شدم، چه کار کنم؟
در خطاهای غیرمنتظرهٔ سرور، پیام نمایشدادهشده به کاربر عمداً کلی است و جزئیات فقط در لاگ سرور (runtime.log) ثبت میشود. پیش از تماس با پشتیبانی، موارد زیر را بررسی کنید: تنظیمبودن کرونجاب، صحت اطلاعات ورود پنلها، و برقراری اتصال به پایگاهداده. فهرست کامل پیامهای خطا در بخش مرجع خطاها موجود است.