README.fa.md

🚀 iRolixBot

| ⚡ ربات پیشرفته تلگرام برای فروش VPN با پنل مدیریتی

راه‌حل نهایی برای ارائه‌دهندگان خدمات VPN

کسب‌وکار VPN خود را با یک ربات تلگرام قدرتمند و غنی از ویژگی تبدیل کنید که فروش را خودکار می‌کند، کاربران را مدیریت می‌کند و عملیات شما را ساده می‌کند.

English • فارسی • 中文 • Русский

🌟 ستاره • 🐛 گزارش باگ • 💡 درخواست ویژگی • 📖 مستندات

---

📋 فهرست مطالب

• ✨ ویژگی‌ها
• 🎯 نکات کلیدی
• 📦 نیازمندی‌ها
• 🚀 شروع سریع
• ⚙️ پیکربندی
• 🌐 پشتیبانی از پنل‌های VPN
• 💳 درگاه‌های پرداخت
• 🔒 امنیت
• 📚 مستندات
• 💬 پشتیبانی و جامعه
• 💰 حمایت از توسعه
• 📄 مجوز

---

✨ ویژگی‌ها

🤖 ویژگی‌های ربات

• 📱 مدیریت اشتراک

  • خرید اشتراک (نوع، حجم، مدت)
  • تمدید و گسترش سرویس
  • خرید حجم و روز اضافی
  • سرویس تست (یک‌بار مصرف)
  • اطلاعات و جزئیات سرویس

• 👥 مدیریت کاربران

  • اطلاعات حساب کاربری
  • تاریخچه تراکنش‌ها
  • آمار معرفی
  • مدیریت موجودی

• 💳 سیستم پرداخت

  • درگاه‌های پرداخت متعدد (زرین‌پال، کارت به کارت و بیشتر)
  • پردازش خودکار پرداخت
  • مدیریت فاکتور
  • تأیید پرداخت

• 🎁 برنامه معرفی

  • لینک‌های معرفی منحصر به فرد
  • کمیسیون قابل تنظیم (درصد/ثابت)
  • پرداخت خودکار
  • آمار معرفی

• 🎫 سیستم پشتیبانی

  • پشتیبانی مبتنی بر تیکت
  • اعلان‌های ادمین
  • ارسال پیام

👨‍💼 ویژگی‌های ادمین

• 📊 پنل ادمین در ربات

  • مدیریت کاربران
  • مدیریت سرویس‌ها
  • مدیریت محصولات
  • مدیریت پنل‌ها
  • لاگ‌ها و آمار
  • پیکربندی تنظیمات

• 🌐 پنل ادمین وب

  • داشبورد کامل با آمار
  • رابط مدیریت کاربران
  • مدیریت سرویس‌ها
  • مدیریت محصولات
  • مدیریت پنل‌های VPN
  • مدیریت فاکتورها
  • مدیریت سیستم معرفی
  • نظارت بر امنیت
  • لاگ‌گیری جامع
  • پشتیبانی چندزبانه (انگلیسی، فارسی، چینی، روسی)

🔒 ویژگی‌های امنیتی

• 🛡️ سیستم ضد اسپم

  • محدودیت‌های قابل تنظیم نرخ کلیک
  • عملکرد سکوت خودکار
  • محدودیت‌های مبتنی بر زمان

• 🚨 سیستم ضد کلاهبرداری

  • نظارت بر فعالیت ادمین
  • لغو دسترسی خودکار
  • تشخیص فعالیت مشکوک

• 📊 نظارت بر امنیت

  • ردیابی IP
  • تشخیص مرورگر و سیستم عامل
  • تشخیص کشور
  • ثبت فعالیت

• 🔐 امنیت اضافی

  • تأیید IP تلگرام
  • جلوگیری از تزریق SQL
  • محافظت در برابر XSS
  • محافظت در برابر CSRF
  • محدودیت نرخ
  • مدیریت جلسه امن

---

🎯 نکات کلیدی

• ✅ پشتیبانی چندزبانه - پشتیبانی کامل از انگلیسی، فارسی، چینی و روسی
• ✅ معماری دوگانه ربات - ربات PHP برای هاست اشتراکی، ربات Python برای VPS
• ✅ پنل‌های VPN متعدد - پشتیبانی از 12+ نوع پنل VPN
• ✅ درگاه‌های پرداخت - یکپارچه‌سازی با درگاه‌های پرداخت ایرانی و بین‌المللی
• ✅ نصب خودکار - نصب یک کلیکی برای هر دو نوع هاست
• ✅ پنل ادمین حرفه‌ای - پنل ادمین مبتنی بر وب با رابط کاربری مدرن
• ✅ امنیت پیشرفته - ضد اسپم، ضد کلاهبرداری و نظارت جامع
• ✅ سیستم معرفی - برنامه کامل معرفی و وابسته
• ✅ تولید QR Code - QR Code های سفارشی با تصاویر پس‌زمینه

---

📦 نیازمندی‌ها

نیازمندی‌های سرور

برای ربات PHP (هاست اشتراکی):

• PHP >= 8.1
• MySQL/MariaDB >= 5.7
• Apache/Nginx با mod_rewrite
• افزونه cURL
• افزونه PDO MySQL
• افزونه mbstring
• افزونه GD (برای QR Code)
• افزونه BCMath
• مجوز نوشتن برای لاگ‌ها و آپلودها

برای ربات Python (VPS):

• Python 3.9+
• MySQL/MariaDB >= 5.7
• Nginx (توصیه می‌شود)
• Systemd (برای مدیریت سرویس)

افزونه‌های PHP

• pdo_mysql - اتصال به پایگاه داده
• curl - درخواست‌های HTTP
• json - پردازش JSON
• mbstring - مدیریت رشته‌های چندبایتی
• gd - پردازش تصویر (QR Code)
• bcmath - عملیات ریاضی

کتابخانه‌های PHP (Composer)

• endroid/qr-code ^4.0 - تولید QR Code
• guzzlehttp/guzzle ^7.0 - کلاینت HTTP

---

🚀 شروع سریع

📦 نصب خودکار (توصیه می‌شود)

برای هاست اشتراکی

1. تمام فایل‌های پروژه را به هاست خود آپلود کنید
2. به آدرس بروید: https://yourdomain.com/installer/host/install.php
3. دستورالعمل نصب را دنبال کنید:
   • مرحله 1: بررسی نیازمندی‌ها
   • مرحله 2: پیکربندی پایگاه داده
   • مرحله 3: پیکربندی ربات
   • مرحله 4: نصب خودکار
   • مرحله 5: تکمیل!

برای VPS (Ubuntu/Debian)

# نصب با یک دستور
sudo bash <(curl -sSL https://raw.githubusercontent.com/iitzSeriZdev/iRolixBot/main/installer/vps/install.sh) install

# حذف با پشتیبان‌گیری
sudo bash <(curl -sSL https://raw.githubusercontent.com/iitzSeriZdev/iRolixBot/main/installer/vps/install.sh) uninstall-with-backup

# بروزرسانی مستقیم
sudo bash <(curl -sSL https://raw.githubusercontent.com/iitzSeriZdev/iRolixBot/main/installer/vps/install.sh) update

پس از نصب:

1. اطلاعات پایگاه داده در /tmp/irolix_db_config ذخیره می‌شود
2. فایل /opt/iRolixBot/bot-php/config.php را ویرایش کنید تا توکن ربات را اضافه کنید
3. به پنل در http://YOUR_SERVER_IP/web-panel دسترسی پیدا کنید
4. تنظیمات را از طریق رابط وب تکمیل کنید

📦 نصب دستی

اگر ترجیح می‌دهید نصب دستی انجام دهید:

مرحله 1: کلون کردن مخزن

git clone https://github.com/iitzSeriZdev/iRolixBot.git
cd iRolixBot

مرحله 2: نصب وابستگی‌ها

cd bot-php
composer install

مرحله 3: راه‌اندازی پایگاه داده

یک پایگاه داده MySQL/MariaDB ایجاد کنید و اطلاعات را یادداشت کنید.

مرحله 4: ایجاد ربات تلگرام

1. به @BotFather در تلگرام پیام دهید
2. از /newbot برای ایجاد ربات خود استفاده کنید
3. توکن ربات را به صورت امن ذخیره کنید

مرحله 5: اجرای نصب

1. فایل‌ها را به سرور وب خود آپلود کنید
2. installer/host/install.php را در مرورگر خود بازدید کنید
3. دستورالعمل نصب را دنبال کنید:
   • زبان خود را انتخاب کنید
   • جزئیات پایگاه داده را وارد کنید
   • توکن ربات را پیکربندی کنید
   • حساب ادمین را تنظیم کنید
   • نصب را تکمیل کنید

مرحله 6: تنظیم Cron Jobs

فقط یک cron job پیکربندی کنید:

* * * * * /usr/bin/php /path/to/iRolixBot/bot-php/cron/cron.php >> /path/to/iRolixBot/Logs/cron_output.log 2>&1

یا از HTTP استفاده کنید:

* * * * * curl -s https://yourdomain.com/bot-php/cron/cron.php > /dev/null 2>&1

همین! مدیر متمرکز همه چیز را به صورت خودکار مدیریت می‌کند. 🎉

---

⚙️ پیکربندی

پس از نصب، ربات خود را سفارشی کنید:

1. 🔌 پنل‌های VPN - پنل‌های خود را متصل کنید
2. 💳 درگاه‌های پرداخت - روش‌های پرداخت را تنظیم کنید
3. ⚙️ تنظیمات ربات - رفتار را سفارشی کنید
4. 👥 کاربران - مشتریان را مدیریت کنید
5. 🛍️ محصولات - پیشنهادات را ایجاد کنید
6. 📁 دسته‌بندی‌ها - محصولات را سازماندهی کنید

---

⏰ Cron Jobs

چه چیزی به صورت خودکار اجرا می‌شود؟

• هر دقیقه ⚡ - پرداخت‌ها، اعلان‌ها، پیام‌ها
• هر 2 دقیقه 🎁 - سیستم هدیه، تست کانفیگ
• هر 3 دقیقه 💰 - بررسی درگاه‌های پرداخت
• هر 5 دقیقه 📊 - انقضای پرداخت، گزارش‌ها
• هر 15 دقیقه 🔍 - بررسی وضعیت، نظارت
• هر 30 دقیقه ⏳ - انقضای نماینده
• هر ساعت 🎲 - سیستم قرعه‌کشی
• هر 5 ساعت 💾 - پشتیبان‌گیری خودکار

---

🌐 پشتیبانی از پنل‌های VPN

پنل‌های کتابخانه OpexCore:

• ✅ Marzban - پنل مدرن V2Ray/Xray
• ✅ Marzneshin - پنل VPN پیشرفته
• ✅ ovPanel - پنل OpenVPN
• ✅ Pasarguard - پنل VPN امن
• ✅ Remnawave - پنل VPN Wave
• ✅ Guard Panel - پنل متمرکز بر امنیت

پنل‌های مبتنی بر PHP:

• ✅ Ali Reza - پنل محبوب ایرانی
• ✅ Ali Reza Single Port - نسخه تک پورت
• ✅ 3x-ui - پنل Xray UI
• ✅ x-ui Single Port - Xray UI تک پورت
• ✅ S-ui - پنل UI ساده
• ✅ Mikrotik - یکپارچه‌سازی RouterOS
• ✅ WGDashboard - داشبورد WireGuard
• ✅ Hiddify - پنل Hiddify
• ✅ Sanaei - پنل Sanaei

---

💳 درگاه‌های پرداخت

درگاه‌های ایرانی:

• ✅ زرین‌پال - محبوب‌ترین درگاه ایرانی
• ✅ Nowpayment - درگاه پرداخت مدرن
• ✅ IranPay1 - درگاه پرداخت ایرانی
• ✅ آقای پرداخت - درگاه پرداخت
• ✅ کارت به کارت - انتقال مستقیم کارت

درگاه‌های بین‌المللی:

• ✅ Yoomoney - سیستم پرداخت روسی
• ✅ Yookassa - درگاه پرداخت Yandex
• ✅ Freekassa - درگاه بین‌المللی
• ✅ Heleket - درگاه پرداخت
• ✅ Robokassa - درگاه پرداخت روسی
• ✅ Telegram Stars - سیستم پرداخت تلگرام
• ✅ Cryptomus - درگاه ارز دیجیتال
• ✅ CryptoPay - درگاه پرداخت کریپتو

---

🔒 امنیت

ویژگی‌های امنیتی

• ✅ تأیید IP تلگرام
• ✅ جلوگیری از تزریق SQL (دستورات آماده)
• ✅ محافظت در برابر XSS
• ✅ محافظت در برابر CSRF
• ✅ محدودیت نرخ
• ✅ مدیریت جلسه امن
• ✅ سیستم ضد اسپم
• ✅ سیستم ضد کلاهبرداری
• ✅ نظارت بر امنیت

بهترین روش‌های امنیتی

1. پس از نصب:

   • پوشه installer را حذف کنید
   • رمزهای عبور پیش‌فرض را تغییر دهید
   • گواهی SSL/TLS را تنظیم کنید

2. نگهداری منظم:

   • وابستگی‌ها را به طور منظم بروزرسانی کنید
   • لاگ‌ها را به طور منظم بررسی کنید
   • پایگاه داده را به طور منظم پشتیبان‌گیری کنید

3. امنیت سرور:

   • از رمزهای عبور قوی استفاده کنید
   • فایروال را فعال کنید
   • سیستم را به‌روز نگه دارید

برای اطلاعات امنیتی تفصیلی، SECURITY.md را ببینید

---

📚 مستندات

• 📖 راهنمای نصب
• 🔒 راهنمای امنیت
• ⏰ تنظیمات Cron
• 📊 خلاصه پروژه

---

💬 پشتیبانی و جامعه

دریافت کمک

• 💬 گروه تلگرام: @iRolix_Bot - به جامعه ما بپیوندید!
• 🐛 گزارش باگ: گزارش مشکل - به ما در بهبود کمک کنید!
• 💡 پیشنهادات: اشتراک‌گذاری ایده‌ها - ایده‌های شما مهم است!

دنبال کردن توسعه‌دهنده

• 🐙 GitHub: @iitzSeriZdev
• 🎥 YouTube: @iitzSeriZ
• 🐦 X (Twitter): @iitzSeriZ

---

💰 حمایت از توسعه

🌟 به ما در ساخت آینده کمک کنید! 🌟

حمایت شما همه تفاوت را در جهان ایجاد می‌کند!

ما متعهد به ساخت iRolixBot به عنوان بهترین راه‌حل ربات تلگرام موجود هستیم. کمک‌های مالی شما مستقیماً توسعه سریع‌تر، ویژگی‌های انحصاری و بهبودهای مداوم را تأمین می‌کند.

🚀 چرا کمک مالی شما مهم است

کمک‌های سخاوتمندانه شما به ما امکان می‌دهد:

• ⚡ تسریع توسعه - کمک‌های بیشتر = انتشار ویژگی‌ها و بروزرسانی‌های سریع‌تر
• 🎯 ساخت ویژگی‌های انحصاری - دسترسی به قابلیت‌های پیشرفته
• 🛠️ پشتیبانی بهتر - پشتیبانی اولویت‌دار برای کمک‌کنندگان سخاوتمند
• 🌟 نوآوری مداوم - پروژه را زنده، پررونق و در حال تکامل نگه دارید
• 🔒 امنیت بهتر - سرمایه‌گذاری در ممیزی و بهبود امنیت
• 📚 مستندات جامع - ایجاد راهنماها و آموزش‌های بهتر

💎 هر چه بیشتر بدهید، بیشتر می‌گیرید!

هر کمک مالی ما را به اهدافمان نزدیک‌تر می‌کند!

• کمک‌های بیشتر = دسترسی اولویت‌دار به ویژگی‌های جدید
• بروزرسانی‌های سریع‌تر = انتشارهای مکرر با رفع باگ و بهبودها
• ویژگی‌های انحصاری = قابلیت‌های منحصر به فرد که iRolixBot را متمایز می‌کند
• پشتیبانی بهتر = زمان پاسخ سریع‌تر و کمک اختصاصی

💳 نحوه کمک مالی

روش پرداخت مورد نظر خود را انتخاب کنید:

💰 ارز دیجیتال (انتقال مستقیم)

ارز	شبکه	آدرس
💵 USDT	BEP20 (Binance Smart Chain)	0xCaF05b21A518E6750AA43aD87cEB4a725e78a850
💎 TON	The Open Network	UQAg7NaXzzFMvGxqirO9UYwwzseq8pAi3N8fompkKjOFtIzl
💰 TRX	Tron Network	TPatJCKdLJs1ZpetLtpC97nsHg8X9G1KRs

⚠️ مهم: هنگام ارسال ارز دیجیتال مطمئن شوید که از شبکه صحیح استفاده می‌کنید!

💸 پرداخت آنلاین (توصیه می‌شود)

🌐 کمک مالی از طریق NowPayments

NowPayments می‌پذیرد:

• 💳 کارت‌های اعتباری/نقدی
• 💰 100+ ارز دیجیتال
• 🌍 روش‌های پرداخت متعدد
• 🔒 پردازش امن و سریع

هر کمک مالی، بدون توجه به اندازه، به ما در بهبود iRolixBot و ارائه ویژگی‌های بهتر کمک می‌کند! 🙏

---

📄 مجوز

این پروژه تحت مجوز MIT مجوز دارد - جزئیات را در فایل LICENSE ببینید.

شما آزاد هستید که از این پروژه استفاده کنید، آن را تغییر دهید و توزیع کنید! 🎉

---

ساخته شده با 💜 توسط iitzSeriZ

اگر این مخزن را مفید می‌دانید، لطفاً به آن ستاره بدهید! ⭐

⭐ ستاره • 🐛 گزارش باگ • 💡 درخواست ویژگی • 💸 کمک مالی

#زن_زندگی_آزادی