آموزش دپلوی ربات تلگرام روی سرور

sudo apt update && sudo apt upgrade -y

adduser botadmin
usermod -aG sudo botadmin
su - botadmin

گام سوم- نصب پیش‌نیازها و ساخت محیط ایزوله (venv)

حالا نوبت نصب ابزارهای اصلی است. ما به پایتون (یا Node.js)، گیت‌هاب (برای کلون کردن کدها) و ابزار مدیریت محیط مجازی نیاز داریم.

اگر پایه پروژه شما پایتون است، ساخت Virtual Environment (محیط مجازی) از واجبات است تا کتابخانه‌های ربات با سایر بخش‌های لینوکس تداخل پیدا نکنند:

sudo apt install python3 python3-venv python3-pip git -y
mkdir mytelegrambot && cd mytelegrambot
python3 -m venv venv

با اجرای دستور بالا، یک پوشه به نام venv ساخته می‌شود که یک نسخه کاملاً ایزوله و تمیز از پایتون را در دل خود دارد.

دپلوی ربات تلگرام پایتون روی سرور

حالا که زمین بازی آماده شد، نوبت به انتقال و اجرای کدها می‌رسد. پروسه دپلوی ربات تلگرام پایتون روی سرور چند مرحله مشخص دارد که اگر آن‌ها را به درستی طی نکنید، ربات شما با اولین قطعی ارتباط SSH خاموش خواهد شد!

۱. انتقال کدها و نصب وابستگی‌ها

برای آوردن کدها به سرور می‌توانید از git clone استفاده کنید یا فایل‌ها را ازطریق ابزارهایی مثل FileZilla (یا دستور scp) آپلود کنید. (اگر در این بخش با چالش روبرو هستید، پیشنهاد می‌کنم نگاهی به مقاله جامع ما درباره آموزش آپلود پروژه پایتون روی سرور ابری (Nginx، Flask و…) بیندازید).

بعداز انتقال فایل‌ها (به‌خصوص فایل حاوی کدهای ربات مثل bot.py و لیست پکیج‌ها یا همان requirements.txt)، محیط مجازی را فعال‌سازی و کتابخانه‌ها را نصب می‌کنیم:

source venv/bin/activate
pip install -r requirements.txt

۲. اجرای دائمی ربات با Systemd

در این مرحله اگر دستور python bot.py را بزنید، ربات کار می‌کند و پیغام Online می‌دهد. اما به‌محض اینکه ترمینال لینوکس را ببندید، پردازه‌ی ربات (SIGHUP) از بین می‌رود و ربات خاموش می‌شود.

برای اجرای دائمی ربات تلگرام روی سرور، نباید به بازماندن ترمینال وابسته باشیم. در لینوکس، قدرتمندترین ابزار برای فعال نگه‌داشتن و اجرای پس‌زمینه برنامه‌ها systemd است (برای پروژه‌های Node.js معمولاً از ابزار سبک‌تری مثل PM2 استفاده می‌شود، اما systemd به‌عنوان دی‌فالت لینوکس، باثبات‌ترین گزینه است).

کافی است با دستور زیر، یک سرویس برای ربات خود بسازیم تا مدیریت آن (اجرا و راه‌اندازی خودکارِ مجدد درصورت کرش کردن) به هسته لینوکس سپرده شود:

sudo nano /etc/systemd/system/telegrambot.service

و این ساختار را در آن تنظیم کنیم (حتماً مسیرها را با توجه به سرور خود شخصی‌سازی کنید):

[Unit]
Description=My Python Telegram Bot
After=network.target

[Service]
User=botadmin
WorkingDirectory=/home/botadmin/mytelegrambot
ExecStart=/home/botadmin/mytelegrambot/venv/bin/python /home/botadmin/mytelegrambot/bot.py
Restart=always

[Install]
WantedBy=multi-user.target

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

sudo systemctl daemon-reload
sudo systemctl start telegrambot
sudo systemctl enable telegrambot

دپلوی ربات Node.js روی لینوکس

اگر از عاشقان جاوا اسکریپت هستید و می‌خواهید پروسه دپلوی ربات تلگرام روی سرور را با Node.js پیش ببرید، مسیر شما کمی متفاوت اما بسیار سرراست است. اکوسیستم Node به‌دلیل ساختار Non-blocking (غیرمسدودکننده) ذاتی خود، برای هندل کردن ریکوئست‌های همزمانِ تلگرام فوق‌العاده عمل می‌کند.

نصب Node.js و npm

ابتدا باید موتور محرک کدهایمان را روی سرور نصب کنیم. برای نصب ربات تلگرام Node.js روی لینوکس، پیشنهاد می‌کنم همیشه از نسخه‌های پایدار (LTS) استفاده کنید تا درگیر باگ‌های عجیب نشوید:

curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
sudo apt install -y nodejs

راه‌اندازی پروژه و نصب پکیج‌های تلگرام

مانند پایتون، در اینجا هم بهتر است یک پوشه مجزا برای ربات بسازیم و پکیج‌های استانداردی مثل telegraf یا node-telegram-bot-api را نصب کنیم:

mkdir mynodebot && cd mynodebot
npm init -y
npm install telegraf

اجرای سرویس دائمی (PM2 یا Systemd؟)

توسعه‌دهندگان وب معمولاً برای سرِپا نگه‌داشتن پروژه‌های Node.js از ابزار محبوبی به نام PM2 استفاده می‌کنند. نصب و اجرای آن با دستور pm2 start bot.js به‌سادگی انجام می‌شود. اما از نگاه یک مدیر زیرساخت، برای میزبانی Telegram Bot در محیط‌های پروداکشن واقعی، استفاده از ابزار بومیِ لینوکس یعنی systemd (که در بخش قبل بررسی کردیم) بسیار پایدارتر است. systemd مستقیماً با هسته سیستم‌عامل در ارتباط است و در زمان ریبوت شدن سرور، با اطمینان بسیار بالاتری سرویس شما را بالا می‌آورد.

اجرای دائمی ربات تلگرام روی سرور

شاید بپرسید چرا این‌قدر روی عبارت اجرای دائمی ربات تلگرام روی سرور پافشاری می‌کنیم؟ واقعیت این است که در محیط سرور، اتفاقات غیرمنتظره‌ای مثل کمبود موقت رم (OOM Killer)، آپدیت‌های سیستمی یا حتی یک باگ کوچک در کدهای شما می‌تواند باعث کرش ربات شود. رباتِ خاموش، یعنی ریزش کاربر و از دست رفتن اعتماد!

سیستم‌دی (Systemd) و قدرت Auto-Restart

همان‌طورکه پیش‌تر فایل سرویس systemd را ساختیم، قدرت اصلی این ابزار در دو خطِ پیکربندی زیر است:

Restart=always
RestartSec=10

این دستورات به لینوکس می‌گویند: اگر پردازه‌ی ربات به‌هردلیلی کشته شد، فقط ۱۰ ثانیه صبر کن و مجدداً آن را راه‌اندازی کن. این یعنی شما در خواب هستید، اما سرور به‌صورت خودکار ربات شما را احیا می‌کند!

(اگر پروژه شما پایتونی است و می‌خواهید تمام ریزه‌کاری‌های زنده نگه‌داشتن اسکریپت‌ها را به‌صورت کاملاً تخصصی و عملی یاد بگیرید، پیشنهاد می‌کنم حتماً مقاله اجرای دائمی ربات پایتون را در وبلاگ ابر فردوسی مطالعه کنید.

لاگ‌گیری و بررسی خطاها

وقتی ربات را به‌صورت سرویسِ پس‌زمینه اجرا می‌کنید، دیگر خروجی‌ها و ارورها (مثل خطاهای سینتکس یا قطعی ارتباط با API تلگرام) روی صفحه ترمینال شما چاپ نمی‌شوند. در اینجا ابزار journalctl حکم جعبه سیاه را برای شما بازی می‌کند. برای اینکه بفهمید در مغزِ ربات چه می‌گذرد و خطاهای احتمالی را دیباگ کنید، کافی‌ست دستور زیر را وارد کنید:

sudo journalctl -u telegrambot.service -f

تنظیم Webhook و HTTPS برای ترافیک بالا

اگر تا اینجای دپلوی ربات تلگرام روی سرور پیش آمده‌اید و قصد دارید ربات خود را برای هزاران کاربر یا یک سرویس سازمانی ارائه دهید، باید با متد Long Polling خداحافظی کنید. در روش Webhook، سرور شما درحالت آماده‌باش (Listen) قرار می‌گیرد و تلگرام پیام‌ها را مستقیماً به‌سمت سرور شما شلیک می‌کند.

اما تلگرام یک شرط سفت‌وسخت دارد: اطلاعات کاربران فقط به آدرس‌های رمزنگاری‌شده (HTTPS) ارسال می‌شود. برای راه‌اندازی این ساختار، گام‌های زیر را در سرور لینوکسی خود طی کنید:

گام اول- اتصال دامنه و دریافت SSL رایگان

ابتدا باید یک دامنه (یا ساب‌دامین مثل bot.yourdomain.com) را در پنل DNS خود به IP سرورتان متصل کنید. سپس با استفاده از ابزار Certbot، یک گواهینامه امنیتی رایگان (Let’s Encrypt) برای آن بگیرید:

sudo apt install certbot python3-certbot-nginx -y
sudo certbot --nginx -d bot.domain.com

اگر با مشکل فیلترینگ یا تحریم روبرو شدید، چاره‌ای ندارید که از DNS استفاده کنید. در این روش، سرور Let’s Encrypt برای تأیید مالکیت، نیازی به لمس مستقیم آی‌پی سرور ایرانی شما ندارد؛ بلکه صحت یک رکورد متنی (TXT Record) را روی لایه مدیریت DNS دامنه شما بررسی می‌کند:

sudo certbot certonly --manual --preferred-challenges dns -d domain.com

گام دوم- انجین‌ایکس (Nginx) در نقش Reverse Proxy

به‌جای اینکه کدهای پایتون یا Node.js شما مستقیماً با اینترنت درگیر شوند، Nginx را جلوی آن‌ها قرار می‌دهیم. انجین‌ایکس ترافیک امن را از تلگرام دریافت می‌کند و آن را به پورت داخلی ربات (مثلاً پورت 3000) پاس می‌دهد.

یک فایل کانفیگ در مسیر /etc/nginx/sites-available/telegrambot بسازید و کدهای زیر را در آن قرار دهید:

server {
    listen 443 ssl;
    server_name bot.yourdomain.com;

    # مسیر گواهینامه‌های SSL که توسط Certbot ساخته شده‌اند
    ssl_certificate /etc/letsencrypt/live/bot.yourdomain.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/bot.yourdomain.com/privkey.pem;

    location / {
        proxy_pass http://127.0.0.1:3000; # پورتی که کدهای ربات شما روی آن در حال اجراست
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
    }
}

پس‌از ذخیره، با دستور sudo systemctl reload nginx تنظیمات را اعمال کنید.

گام سوم- معرفی Webhook به تلگرام

حالا که سرور شما با یک آدرس امن آماده دریافت پیام است، باید این آدرس را به تلگرام معرفی کنید. کافی‌ست در مرورگر خود (یا ازطریق ترمینال با دستور curl) لینک زیر را فراخوانی کنید:

https://api.telegram.org/bot<BOT_TOKEN>/setWebhook?url=https://bot.domain.com

ملاحظات ایران و چالش فیلترینگ

تا این مرحله، پروسه فنیِ دپلوی ربات تلگرام به پایان رسید؛ اما اگر سرور شما داخل ایران باشد، تازه اول دردسر است! همان‌طورکه می‌دانید دسترسی به سرورهای تلگرام در ایران با محدودیت‌های شدیدی روبه‌رو است. این یعنی سرور لینوکسِ شما که در دیتاسنترهای داخلی میزبانی می‌شود، به‌طور پیش‌فرض نمی‌تواند با api.telegram.org ارتباط برقرار کند. نتیجه؟ ربات شما پیام‌های کاربران را دریافت می‌کند (ازطریق Webhook)، اما نمی‌تواند پاسخی برای آن‌ها بفرستد!

راهکارهای پایداری ارتباط و دسترسی بدون وقفه

برای اینکه زحمات شما برای راه اندازی ربات تلگرام روی سرور هدر نرود و ربات درگیر خطای Connection Timeout نشود، باید زیرساخت شبکه را برای ارتباط مداوم آماده کنید:

1. تنظیم پراکسی در سطح کد (Application Level): در فریم‌ورک‌های پایتونی یا جاوا اسکریپتی، می‌توانید متغیرهای محیطیِ پراکسی (مثل HTTPS_PROXY) را مستقیماً داخل کدهای ربات ست کنید تا ریکوئست‌ها ازطریق یک تونل امن به تلگرام برسند.
2. تونلینگ در سطح سرور (OS Level): نصب ابزارهایی مانند V2ray، Xray یا حتی Tor روی سرور داخلی و هدایت ترافیک خروجیِ سرور ازطریق آن‌ها، پایداری فوق‌العاده‌ای به ارتباط شما با تلگرام می‌بخشد.
3. استفاده از سرورهای واسط (Relay Server): می‌توانید یک سرور بسیار ارزان‌قیمت و سبک در خارج از کشور تهیه کنید و ترافیک رباتِ سرور داخلی خود را به آن پاس دهید.

انتخاب بهترین سرور برای ربات تلگرام

اگر سرور شما ناپایدار باشد، حتی تمیزترین کدهای پایتون و Node.js هم زیر بار ترافیکِ کاربران کم می‌آورند. اما بهترین سرور برای ربات تلگرام چه ویژگی‌هایی دارد؟

حداقل منابع سخت‌افزاری لازم

ربات‌های تلگرامی (به‌جز ربات‌هایی که پردازش هوش مصنوعی یا رندر ویدیو انجام می‌دهند) معمولاً پردازه‌های بسیار سبکی هستند. برای اجرای ربات تلگرام روی VPS در سطح ساده تا متوسط، یک سرور با ۱ هسته CPU و ۱ تا ۲ گیگابایت RAM کاملاً پاسخ‌گوی نیاز شما است. آنچه در اینجا اهمیت دارد، قدرت خالص پردازنده (CPU Cache) و سرعت خواندن/نوشتن دیسک است و ربطی به اعداد نجومیِ رَم ندارد!

پایداری شبکه

در میزبانی ربات تلگرام، این سه فاکتور شبکه‌ای بسیار ضروری هستند:

1. آپتایم (Uptime) بالا: رباتی که قطعی داشته باشد، کاربر خود را از دست می‌دهد.
2. تأخیر (Latency) پایین: سرور شما باید بتواند با کمترین پینگ ممکن با api.telegram.org صحبت کند.
3. آی‌پی (IP) ثابت و معتبر: سرورهای تلگرام روی تغییرات مداوم IP حساس هستند و ممکن است درخواست‌های وب‌هوک شما را مسدود کنند.
4. دسترسی کامل (Root/SSH): برای کانفیگ Nginx، نصب کتابخانه‌ها و تنظیم پراکسی‌ها، شما به کنترل صددرصدی روی سیستم‌عامل نیاز دارید (چیزی که در هاست‌های اشتراکی وجود ندارد).

VPS، سرور اختصاصی یا سرور ابری؟

سرورهای اختصاصی برای یک ربات ساده هزینه‌ای غیرمنطقی دارند. سرورهای مجازی سنتی (VPS) گزینه‌های خوبی هستند، اما اگر ربات شما ناگهان وایرال (Viral) شود و ترافیک بالایی بگیرد، ارتقای منابع در VPS سنتی زمان‌بر است. اما اینجا سرور ابری (Cloud Server) به‌دلیل ایزوله بودن منابع و قابلیت مقیاس‌پذیری آنی، منطقی‌ترین انتخاب است.

میزبانی ربات‌ها در ابر فردوسی از تست تا پروداکشن

اگر به‌دنبال زیرساختی هستید که چالش‌های تحریم، فیلترینگ و کندی سرعت را برای اجرای ربات‌ها به‌حداقل برساند، سرور ابری ابر فردوسی زیرساخت خود را برای همین نیازها بهینه کرده است:

چالش توسعه‌دهنده ربات	راهکار تخصصی ابر فردوسی
نیاز به پردازش سریع ریکوئست‌ها	استفاده از سرورهای پرچمدار HPE نسل جدید، پردازنده‌های قدرتمند Intel/AMD و هاردهای فوق‌سریع NVMe
هزینه‌های بالای تست کدهای اولیه	پرداخت ساعتی: فقط به‌اندازه ساعاتی که سرور روشن است هزینه می‌دهید!
نصب پیش‌نیازها و محیط اجرا	بازارچه ابری: نصب ابزارهایی مثل داکر (Docker)، انجین‌ایکس و فریم‌ورک‌ها تنها با یک کلیک
پایداری ارتباط و پینگ پایین	میزبانی در قدرتمندترین دیتاسنترهای ایران (برج میلاد، دانشگاه فردوسی)

برای اینکه کیفیت شبکه، سرعت دیسک و پایداری ارتباط با تلگرام را خودتان شخصاً تست کنید، ابر فردوسی ۱۰۰ هزار تومان اعتبار رایگان برای کاربران جدید درنظر گرفته است. با این اعتبار می‌توانید همین حالا یک سرور ابری بسازید، ربات خود را دپلوی کنید و اگر همه‌چیز عالی بود، میزبانی خود را دائمی کنید.

جمع‌بندی

در این مقاله مسیر تاریک و گاهی پر از باگِ دپلوی ربات تلگرام روی سرور را قدم‌به‌قدم روشن کردیم. یاد گرفتیم که چطور کدهای پایتون یا Node.js خود را در محیط لینوکس ایزوله کنیم، تفاوت Long Polling و Webhook را بررسی کردیم و مهم‌تر از همه، دیدیم که با استفاده از ابزارهایی مثل systemd و Nginx، چطور می‌توان یک ربات را برای همیشه در پس‌زمینه بیدار نگه داشت. حل چالش شبکه در سرورهای ایران هم آخرین قطعه از این پازل بود.

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

منابع:
core.telegram | docs.python | docs.nginx | nginx | docs.redhat | rsf | reuters

سؤالات متداول