# ربات Telegram

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

Source: https://joinnasnet.com/fa/guides/nasnet-linux/telegram-bot/
Last updated: 2026-08-14

---

## معرفی

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

## پیش‌نیازها

- یک توکن ربات از [@BotFather](https://t.me/BotFather).
- شناسهٔ عددی کاربری تلگرام خودتان، که
  [@userinfobot](https://t.me/userinfobot) به شما می‌گوید.
- میان polling و webhook تصمیم بگیرید. polling به نشانی عمومی نیاز ندارد و
  پیش‌فرض است؛ webhook به یک نقطهٔ HTTPS عمومی نیاز دارد.

## مراحل

1. ربات را با @BotFather بسازید و توکنش را کپی کنید.
2. کلیدها را در `.env` بگذارید:

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

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

   ```dotenv
   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 دقیقاً برای دومی وجود دارد.

## مطالب مرتبط

- [تنظیمات](/fa/guides/nasnet-linux/settings/)
- [پنل مشترک](/fa/guides/nasnet-linux/subscriber-panel/)
- [هشدارها](/fa/guides/nasnet-linux/alerts/)