برنامه‌نویسی پایتون یکی از محبوب‌ترین حوزه‌های توسعه وب و ربات‌نویسی است. اما اغلب کاربران هاست اشتراکی دسترسی ترمینال ندارند و تصور می‌کنند اجرای اسکریپت پایتون فقط در سرور اختصاصی یا مجازی ممکن است. اگر هاست شما از CloudLinux و کنترل پنل cPanel با قابلیت Setup Python App پشتیبانی می‌کند، شما بدون نیاز به SSH هم می‌توانید اسکریپت یا ربات پایتون (مثل ربات تلگرام) را راه‌اندازی کنید. این آموزش برای افراد مبتدی و پیشرفته آماده شده و شامل بخش توضیحات اجرای ربات تلگرام نیز می‌باشد.
پیش‌نیازها و نکات مهم برای اجرای اسکریپت پایتون
- هاست شما باید تحت CloudLinux و کنترل پنل cPanel داشته باشد.
- در پنل باید گزینه Setup Python App فعال باشد.
- به File Manager دسترسی داشته باشید.
- نیازی به دسترسی SSH یا ترمینال ندارید.
- این روش برای اجرای انواع اسکریپت پایتون و حتی ربات تلگرام مناسب است.
راهنمای گزینه‌های Setup Python App در cPanel
| گزینه | توضیح |
|---|---|
| Python version | انتخاب نسخه مناسب پایتون برای پروژه (مثلاً 3.10) |
| Application Root | پوشه محل قرارگیری فایل‌های پروژه (مثلاً public_html/telegrambot) |
| Application URL | دامنه یا ساب‌دامنه‌ای که برنامه پایتون روی آن اجرا می‌شود |
| Application Startup File | اسم فایل اصلی پروژه (مثلاً bot.py یا app.py) |
| Application Entry Point | نام تابع یا متغیر اصلی اجرای برنامه. برای Flask معمولا app و برای Django application. در اسکریپت ساده معمولا نیازی نیست. |
| Passenger Log File | مسیر فایل ذخیره لاگ اجرای برنامه (اختیاری) |
| Environment Variables | متغیرهای محیطی پروژه (اختیاری، مثلا برای API KEY و …) |
| Create | ساخت و فعال‌سازی اپلیکیشن پایتون |
| Restart | ریستارت کردن اپلیکیشن پس از هر تغییر یا نصب کتابخانه |
| Run Pip Install | نصب خودکار کتابخانه‌هایی که در requirements.txt نوشته‌اید (بدون ترمینال) |
آموزش گام‌به‌گام اجرای اسکریپت پایتون در هاست بدون ترمینال
۱. ورود به cPanel و بخش Setup Python App
وارد پنل cPanel شوید و از بخش Software روی گزینه Setup Python App کلیک کنید.
۲. ساخت یک Python Application جدید
روی دکمه Create Application کلیک کنید.
نسخه پایتون مورد نظر (مثلاً Python 3.10) را انتخاب نمایید.
در قسمت Application Root یک پوشه دلخواه مثل public_html/telegrambot وارد کنید.
Application URL (دامنه یا ساب‌دامنه مورد نظر) را انتخاب کنید.
Application Startup File را مثلاً bot.py بنویسید.
Application Entry Point را برای پروژه‌های Flask معمولاً app و برای Django معمولاً application بنویسید (برای اسکریپت معمولی خالی بگذارید).
روی Create کلیک کنید.
۳. آپلود فایل اسکریپت پایتون
به File Manager بروید و به پوشه‌ای که در مرحله قبل انتخاب کردید وارد شوید.
فایل اسکریپت اصلی (مثلاً bot.py) و فایل requirements.txt و سایر فایل‌های پروژه را آپلود کنید.
۴. ساخت فایل requirements.txt و نصب کتابخانه‌ها
- اگر اسکریپت شما نیاز به کتابخانه خارجی دارد (مثلاً Flask یا pyTelegramBotAPI)، یک فایل متنی با اسم
requirements.txtبسازید. - نام کتابخانه‌های مورد نیاز را هرکدام در یک خط وارد کنید:
pyTelegramBotAPI
requests
- به Setup Python App برگردید.
- روی دکمه Run Pip Install کلیک کنید تا کتابخانه‌ها نصب شوند.
۵. اجرای اسکریپت و مشاهده خروجی
- اگر پروژه شما وب‌اپ (Flask, Django) است، آدرس دامنه یا ساب‌دامنه را در مرورگر باز کنید و نتیجه را ببینید.
- اگر اسکریپت معمولی است، خروجی ممکن است در قالب فایل متنی، ارسال پیام یا عملیاتی دیگر باشد.
- بعد از هر تغییر یا نصب کتابخانه جدید، اپلیکیشن را Restart کنید.
اجرای ربات تلگرام در هاست اشتراکی (cPanel)
شما می‌توانید ربات تلگرام خود را نیز در هاست اشتراکی اجرا کنید. کافی است مراحل بالا را طی کنید و فایل bot.py و requirements.txt را آماده داشته باشید.
نمونه کد ساده ربات تلگرام (با کتابخانه pyTelegramBotAPI):
import telebot
TOKEN = "توکن ربات خود را اینجا قرار دهید"
bot = telebot.TeleBot(TOKEN)
@bot.message_handler(commands=['start', 'help'])
def send_welcome(message):
bot.reply_to(message, "سلام! ربات شما آماده است.")
bot.polling()
- کد بالا را به نام
bot.pyدر هاست آپلود کنید. - در فایل
requirements.txtفقط نامpyTelegramBotAPIرا وارد کنید. - اپلیکیشن را از طریق Setup Python App مطابق آموزش بالا بسازید و Run Pip Install را بزنید.
- در آخر، اپلیکیشن را Restart کنید.
نکته: اجرای ربات به صورت polling ممکن است در هاست‌های اشتراکی که اجرای اسکریپت طولانی را محدود می‌کنند متوقف شود. برای اجرای همیشگی یا پروژه‌های بزرگ، VPS یا هاست مخصوص ربات مناسب‌تر است.
اگر قصد راه‌اندازی ربات با webhook دارید (برای مصرف منابع کمتر و قطع نشدن)، می‌توانید آدرس دامنه را به BotFather بدهید و کد webhook را جایگزین polling کنید.
سوالات متداول و عیب‌یابی
- چرا نصب کتابخانه‌ها ارور می‌دهد؟
اسم کتابخانه را دقیق در requirements.txt وارد کنید. نسخه پایتون را بررسی کنید. فضای هاست نباید پر باشد. - چرا ربات تلگرام قطع می‌شود یا آنلاین نمی‌ماند؟
در هاست اشتراکی، پروسه‌های طولانی معمولاً بسته می‌شوند. بهتر است ربات را به صورت webhook اجرا کنید یا از VPS استفاده نمایید. - خطای ModuleNotFoundError دریافت می‌کنم؟
حتماً Run Pip Install را زده‌اید؟ فایل requirements.txt باید در مسیر پروژه باشد. - خروجی اسکریپت کجاست؟
برای اسکریپت معمولی، خروجی در قالب فایل متنی یا پیام در همان مسیر پروژه یا تلگرام خواهد بود.
جمع‌بندی
در این آموزش یاد گرفتید که حتی بدون دسترسی ترمینال یا SSH، می‌توانید به سادگی اسکریپت‌های پایتون، پروژه‌های وب و حتی ربات تلگرام را روی هاست اشتراکی خود راه‌اندازی کنید. امکانات بخش Setup Python App در کنترل‌پنل cPanel این فرصت را برای همه کاربران فراهم می‌کند تا بدون نیاز به دانش تخصصی لینوکس، تنها با چند کلیک پروژه‌های پایتونی خود را اجرا کنند.
فراموش نکنید اگر پروژه شما به کتابخانه خاصی نیاز دارد، کافی است یک فایل requirements.txt بسازید و با دکمه Run Pip Install همه کتابخانه‌ها را به راحتی نصب کنید. همچنین پس از هر تغییری در کد یا کتابخانه‌ها، اپلیکیشن را Restart کنید تا تغییرات شما فعال شود.
نکته مهم:
سرویس‌های میزبانی وب حرفه‌ای و هاست پربازدید های‌دیتا، امکان اجرای پایتون را برای شما فراهم کرده‌اند و این سرویس‌ها را می‌توانید به عنوان یک هاست پایتون انتخاب و استفاده کنید. اگر قصد راه‌اندازی سایت، پروژه وب یا حتی ربات تلگرام با پایتون را دارید، کافی است یکی از این سرویس‌ها را سفارش دهید و بلافاصله از تمامی امکانات اجرای پایتون بهره‌مند شوید.
در نهایت، اجرای پایتون در هاست اشتراکی دیگر یک رویا نیست؛ کافی است مراحل این آموزش را دنبال کنید تا هر اسکریپتی که مدنظر دارید را اجرا نمایید. اگر سوال یا مشکلی داشتید، می‌توانید از طریق بخش نظرات همین مقاله یا ارسال تیکت به پشتیبانی، راهنمایی دریافت کنید.
موفق باشید و لذت برنامه‌نویسی را در هاست‌های پرقدرت با های‌دیتا تجربه کنید!
