faoxima
آموزش

نصب و راه‌اندازی

نصب روی سرور (VPS) و هاست (cPanel / aaPanel)

faoxima را می‌توانید روی سرور اختصاصی (VPS) با اسکریپت نصب رسمی، یا روی هاست اشتراکی (cPanel/aaPanel) نصب کنید. مراحل هر دو روش را طبق راهنمای زیر دنبال کنید:

آموزش نصب هاست سی‌پنل / aaPanel

۱. ابتدا آخرین نسخه را از مسیر زیر به‌صورت فایل ZIP دانلود کنید، سپس آن را در هاست خود آپلود کرده و از حالت فشرده خارج کنید:

آدرس دانلود آخرین نسخه
https://github.com/Mmd-Amir/Faoxima/releases

۲. مسیر زیر را در مرورگر باز کنید (به‌جای domin.ir و Faoxima دامنه و مسیر استخراج‌شدهٔ خودتان را وارد کنید):

اجرای نصب‌کننده
https://domin.ir/Faoxima/installer
آموزش آپدیت سورس هاست سی‌پنل / aaPanel

۱. ابتدا سورس نسخهٔ قبلی را به‌طور کامل حذف کنید. پیش از پاک‌سازی، محتوای فایل config.php را کامل کپی و ذخیره کنید.

۲. سورس نسخهٔ جدید را دانلود کرده و در هاست (cPanel یا aaPanel) آپلود کنید.

۳. پس از آپلود، حتماً پوشهٔ installer را حذف کنید.

۴. سپس فایل config.php را باز کرده، تمامی محتوای آن را پاک کنید و محتوای نسخهٔ قبلی را در آن جایگزین کنید.

۵. اگر ربات پس از آپلود به‌درستی کار نکرد، یک‌بار آدرس زیر را در مرورگر اجرا کنید (به‌جای domin.ir و Faoxima دامنه و مسیر استخراج‌شدهٔ خودتان را وارد کنید):

اجرای مجدد پس از آپدیت
https://domin.ir/Faoxima/table.php
هشدار

حذف پوشهٔ installer پس از نصب یا آپدیت الزامی است.

آموزش انتقال دیتابیس به سی‌پنل / aaPanel

برای انتقال دیتابیس ربات به سی‌پنل یا aaPanel، مراحل زیر را به ترتیب انجام دهید:

۱. ابتدا سورس را آپلود کرده و فایل نصب‌کننده را اجرا کنید تا جدول‌های دیتابیس ساخته شوند.

۲. از طریق بخش phpMyAdmin وارد دیتابیس شوید.

۳. دیتابیس را حذف (DROP) کرده و بکاپ موردنظر خود را وارد کنید.

۴. اگر ربات پس از وارد کردن بکاپ کار نکرد، یک‌بار آدرس زیر را در مرورگر اجرا کنید (به‌جای domin.ir و Faoxima دامنه و مسیر استخراج‌شدهٔ خودتان را وارد کنید):

اجرای مجدد پس از بازیابی بکاپ
https://domin.ir/Faoxima/table.php
آموزش نصب اسکریپت سرور

۱. ابتدا اسکریپت زیر را روی سرور اجرا کنید:

اجرای اسکریپت نصب
curl -L -o /root/install.sh https://raw.githubusercontent.com/Mmd-Amir/Faoxima/main/install.sh && bash /root/install.sh

۲. سپس گزینهٔ «۱» را انتخاب کرده و اطلاعات موردنیاز را مطابق درخواست وارد کنید.

آموزش انتقال دیتابیس به سرور دیگر

برای انتقال دیتابیس ربات به سرور جدید، مراحل زیر را به ترتیب انجام دهید:

۱. ابتدا اسکریپت موردنظر را نصب کنید.

۲. از طریق اطلاعات دیتابیسی که توسط اسکریپت ارائه شده، وارد phpMyAdmin شوید.

۳. دیتابیس را حذف (DROP) کرده و بکاپ موردنظر خود را وارد کنید.

۴. اگر پس از وارد کردن بکاپ ربات کار نکرد، از گزینهٔ آپدیت در اسکریپت استفاده کنید.

تنظیم کرون‌جاب

یک کرون با اجرای هر یک دقیقه اضافه کنید:

crontab — اجرای هر دقیقه
curl -s https://your-domain.com/Faoxima/cron/cron.php >/dev/null 2>&1

your-domain.com و Faoxima را با دامنهٔ خودتان و مسیر استخراج‌شدهٔ نصب جایگزین کنید. در cPanel و aaPanel، زمان‌بندی را روی */1 قرار دهید؛ یعنی کرون‌جاب هر یک دقیقه اجرا می‌شود.

نکته

روی نصب VPS، کرون‌جاب به‌صورت خودکار توسط اسکریپت نصب تنظیم می‌شود. روی هاست اشتراکی (cPanel/aaPanel) نیز در صورتی که افزونهٔ php exe روی هاست فعال باشد، کرون‌جاب به‌صورت خودکار تنظیم می‌شود؛ در غیر این صورت باید آن را به‌صورت دستی از بخش Cron Jobs پنل هاست اضافه کنید.

دسترسی به مینی‌اپ

پس از نصب، مینی‌اپ از این آدرس در دسترس خواهد بود:

آدرس مینی‌اپ
https://your-domain.com/Faoxima/app/

your-domain.com و Faoxima را با دامنهٔ خودتان و مسیر استخراج‌شدهٔ نصب جایگزین کنید.

هشدار

حتماً این آدرس را در تنظیمات Menu Button ربات نزد @BotFather ثبت کنید؛ در غیر این صورت مینی‌اپ برای کاربران در دسترس نخواهد بود.