ربات Telegram

کنترل از راه دور اختیاری برای مدیران و نمای خودسرویس برای کاربران، بدون خروج از Telegram.

آخرین به‌روزرسانی ۲۳ مرداد ۱۴۰۵نمایش به‌صورت مارک‌داون

معرفی

ربات Telegram اختیاری است و به صورت پیش‌فرض خاموش. با روشن کردن آن، مدیران یک کنترل از راه دور برای پنل به دست می‌آورند و کاربران بدون مرورگر به جزئیات اشتراک خود می‌رسند. ربات درون همان پروسه nasnet-panel اجرا می‌شود و شکست آن بی‌خطر است: اگر ربات به دلیل توکن نادرست یا نبود شبکه بالا نیاید، پنل خطا را ثبت می‌کند و به سرو کردن پنل وب و رابط برنامه‌نویسی ادامه می‌دهد.

پیش‌نیازها

  • یک توکن ربات از @BotFather.
  • شناسهٔ عددی کاربری تلگرام خودتان، که @userinfobot به شما می‌گوید.
  • میان polling و webhook تصمیم بگیرید. polling به نشانی عمومی نیاز ندارد و پیش‌فرض است؛ webhook به یک نقطهٔ HTTPS عمومی نیاز دارد.

مراحل

  1. ربات را با @BotFather بسازید و توکنش را کپی کنید.

  2. کلیدها را در .env بگذارید:

    TELEGRAM_ENABLED=true
TELEGRAM_BOT_TOKEN=123456:ABC-your-token
ADMIN_IDS=11111111,22222222

  3. پنل را دوباره راه‌اندازی کنید. شناسه‌های داخل ADMIN_IDS هنگام بالا آمدن به‌عنوان مدیر در پایگاه‌داده هماهنگ می‌شوند.

  4. اگر شبکهٔ پنل مستقیم به API ربات تلگرام نمی‌رسد، ترافیک ربات را از یک پراکسی SOCKS5 عبور دهید:

    TELEGRAM_PROXY_ENABLED=true
TELEGRAM_PROXY_TYPE=socks5
TELEGRAM_PROXY_HOST=127.0.0.1
TELEGRAM_PROXY_PORT=1080
TELEGRAM_PROXY_USERNAME=
TELEGRAM_PROXY_PASSWORD=

    این‌ها از تنظیمات ← Telegram هم قابل ویرایش‌اند، و مقدار پایگاه‌داده بر .env می‌چربد.

  5. به ربات پیام بدهید تا مطمئن شوید پاسخ می‌دهد.

مرجع

حالت تنظیم توضیح
polling (پیش‌فرض) BOT_MODE=polling پنل با long-poll از تلگرام می‌پرسد. نه نشانی عمومی لازم است نه درگاه ورودی.
webhook BOT_MODE=webhook و WEBHOOK_URL=https://your-domain/... تلگرام به‌روزرسانی‌ها را به نشانی شما می‌فرستد. به یک نقطهٔ HTTPS عمومی نیاز دارد.
متغیر چه می‌کند پیش‌فرض
TELEGRAM_ENABLED ربات را روشن می‌کند. false
TELEGRAM_BOT_TOKEN توکن گرفته‌شده از @BotFather. تنظیم‌نشده
ADMIN_IDS شناسه‌های کاربری تلگرام، جداشده با ویرگول، که مدیر شمرده می‌شوند. تنظیم‌نشده
BOT_MODE یکی از polling یا webhook. polling
WEBHOOK_URL نقطه‌ای که تلگرام در حالت webhook به آن می‌فرستد. خالی
TELEGRAM_PROXY_ENABLED ترافیک API ربات را از یک پراکسی SOCKS5 عبور می‌دهد. false

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

کاربران چه می‌توانند بکنند: دیدن اشتراکشان، شامل پیوند، کد QR، حجم و زمان باقی‌مانده، و دستگاه‌ها.

پنل از توکن‌های پیوند هم پشتیبانی می‌کند که یک حساب پنل را به یک هویت تلگرامی گره می‌زنند، تا همان شخص در پنل وب، پنل مشترک و ربات یکی شناخته شود.

رفع اشکال

ربات هیچ‌وقت پاسخ نمی‌دهد ولی پنل سالم است. این همان شکست طراحی‌شده است. خطای بالا آمدن ربات را در گزارش‌های پنل ببینید؛ دو علت معمول، توکن نامعتبر و در دسترس نبودن API ربات است، و تنظیمات پراکسی SOCKS5 دقیقاً برای دومی وجود دارد.

مطالب مرتبط