آموزش نصب و اجرای برنامه Python WSGI در cPanel

این مقاله نحوه نصب، پیکربندی، تست و ثبت یک برنامه Python WSGI در cPanel را توضیح می‌دهد. شامل ساخت محیط مجازی، ایجاد فایل passenger_wsgi.py، نصب وابستگی‌ها، اجرای برنامه، ثبت در Application Manager و ری‌استارت با restart.txt است.

Python WSGIcPanel PythonPassenger Python

~2 دقیقه مطالعه • بروزرسانی ۲ اسفند ۱۴۰۴

1. مقدمه


این راهنما نحوه نصب یک برنامه Python™ WSGI را از طریق خط فرمان توضیح می‌دهد. WSGI یک رابط استاندارد برای اجرای برنامه‌های پایتون روی وب‌سرورها است.


برای اطلاعات بیشتر، مستندات Python WSGI و راهنمای cPanel برای استفاده از Python در AlmaLinux، Rocky Linux، Ubuntu و CloudLinux 9 را مطالعه کنید.


هشدار: cPanel توسعه‌دهنده Python WSGI نیست و پشتیبانی فنی ارائه نمی‌دهد. مسئولیت هرگونه از دست رفتن داده با شماست.


2. پیش‌نیازهای نصب


نکته: تمام مراحل باید به‌عنوان کاربر cPanel انجام شوند، نه root. همچنین می‌توانید از Terminal در cPanel استفاده کنید.


در این مقاله، pythonapp نام برنامه است.


ارائه‌دهنده هاست باید pip و بسته‌های EasyApache 4 موردنیاز را نصب کرده باشد.


2.1 بسته‌های موردنیاز برای CentOS 7، AlmaLinux 8، Rocky Linux 8


  • ea-ruby27-mod_passenger
  • ea-apache24-mod_env

توصیه‌شده: ea-ruby27-ruby-devel


2.2 بسته‌های موردنیاز برای AlmaLinux 9 / Rocky Linux 9


  • ea-apache24-mod-passenger
  • ea-apache24-mod_env

Passenger به‌صورت خودکار جدیدترین نسخه‌های Ruby، NodeJS و Python را استفاده می‌کند.




3. نصب برنامه Python WSGI


3.1 ساخت مسیر برنامه


mkdir directoryname

3.2 ساخت محیط مجازی


virtualenv --python=python3 directoryname

اگر virtualenv نصب نیست:


pip install virtualenv

3.3 فعال‌سازی محیط مجازی


cd directoryname
source bin/activate

3.4 ساخت فایل WSGI


فایل passenger_wsgi.py را ایجاد کنید:


import sys, os

INTERP = "/home/username/pythonapp/bin/python"
if sys.executable != INTERP: os.execl(INTERP, INTERP, *sys.argv)

from pythonapp import app as application

3.5 نصب وابستگی‌ها


فایل requirements.txt بسازید و اجرا کنید:


pip install -r requirements.txt

هشدار: نسخه وابستگی‌ها باید با نسخه Python شما سازگار باشد.




4. تست برنامه


برنامه را اجرا کنید:


python pythonapp.py

خروجی نمونه:


Hello, World!

در یک ترمینال دیگر:


curl http://localhost:5000



5. ثبت برنامه


از مسیر زیر استفاده کنید:


cPanel » Home » Software » Application Manager


سپس برنامه از طریق URL زیر قابل دسترسی است:


http://example.com/pythonapp




6. ری‌استارت برنامه


برای اعمال تغییرات، فایل restart.txt را در مسیر /tmp برنامه ایجاد کنید:


pythonapp/tmp/restart.txt

Passenger فقط زمانی برنامه را ری‌استارت می‌کند که این فایل touch شود.




نتیجه‌گیری


این راهنما تمام مراحل نصب، پیکربندی، تست، ثبت و ری‌استارت برنامه‌های Python WSGI در cPanel را پوشش می‌دهد. با رعایت این مراحل می‌توانید برنامه‌های پایتون را به‌صورت پایدار و استاندارد روی سرور خود اجرا کنید.


نوشته و پژوهش شده توسط دکتر شاهین صیامی