FastAPI Stack

حول FastAPI Stack

ما يُثبَّت

جاهز عند تشغيل الخادم

أنظمة التشغيل المتوافقة

Ubuntu 24.04

التطبيق

FastAPI Stack

المنظومة التقنية

Python 3.12UvicornGunicornNginxPostgreSQL 16pipvirtualenv

الحد الأدنى من RAM

1 غيغابايت

الحد الأدنى من CPU

1 vCPU

الوصول

root عبر SSH

الميزات الرئيسية

• Python 3.12 من PPA deadsnakes — أحدث إصدار مستقر، متوافق تمامًا مع FastAPI وPydantic v2 وSQLAlchemy 2.
• Uvicorn خادم ASGI بـworkers Gunicorn — غير متزامن أصلًا، يتعامل مع WebSockets وSSE؛ Gunicorn يدير دورة حياة الـworkers.
• Nginx proxy عكسي — إنهاء TLS، تقديم الملفات الثابتة، ضغط gzip، ترويسات ترقية WebSocket جاهزة.
• PostgreSQL 16 — دعم async من الدرجة الأولى عبر asyncpg؛ حقول JSONB، بحث نصي كامل، مخطط استعلام متقدم.
• pip وvirtualenv — عزل الاعتماديات لكل مشروع وإعادة إنتاج البيئة بين البيئات.
• Swagger UI وReDoc تولَّدان تلقائيًا — /docs و/redoc متاحتان فورًا لكل endpoint تعرّفه.
• جاهز لـSupervisor — أضف إعداد Supervisor لإبقاء Gunicorn والـworkers حيّين بعد إعادة التشغيل.

متى تستخدم هذا الحل؟

الدليل

نشر FastAPI Stack على خادم VPS الخاص بك

1. 1

   طلب VPS ServOrbit

   يكفي VPS بـ1 غيغابايت RAM على Ubuntu 24.04 لـAPI FastAPI خفيفة. اختر 2 غيغابايت لتشغيل PostgreSQL على نفس VPS، و4 غيغابايت لـworkers Celery أو استدلال النماذج المتزامن.

2. 2

   النشر من marketplace

   اذهب إلى Marketplace → التطوير → FastAPI Stack وانقر نشر. يثبّت السكريبت Python 3.12 وUvicorn وGunicorn وNginx وPostgreSQL 16 تلقائيًا دون جلسة SSH للإعداد الأساسي.

3. 3

   استنساخ مشروعك وإعداده

   اتصل بـSSH، استنسخ مستودعك، أنشئ بيئة افتراضية (python3.12 -m venv venv)، ثبّت الاعتماديات (pip install -r requirements.txt)، وعيّن متغيرات البيئة في ملف .env.

4. 4

   تشغيل Uvicorn مع Gunicorn

   شغّل التطبيق باستخدام gunicorn main:app -k uvicorn.workers.UvicornWorker --bind 127.0.0.1:8000 --workers 4. الـworkers المُوصى بها هي (2 × vCPU) + 1. Nginx يُمرّر المنفذ 80/443 إلى المنفذ 8000.

5. 5

   تفعيل HTTPS والوصول إلى /docs

   نفّذ certbot --nginx -d your-domain.com للحصول على شهادة Let's Encrypt مجانية. واجهتك API تصبح متاحة على https://your-domain.com والوثائق التفاعلية على https://your-domain.com/docs.