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

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 را پوشش می‌دهد. با رعایت این مراحل می‌توانید برنامه‌های پایتون را به‌صورت پایدار و استاندارد روی سرور خود اجرا کنید.