cPanel Passenger

cPanel ve Passenger kurulumu

English · Türkçe · Languages / Diller

Kapsam: JSON API Forge 0.5.1 · İnceleme: 17 Eylül 2026 · Dil: Türkçe

Passenger yolu ASGI uygulamasını a2wsgi ile WSGI hosting'e bağlar. Bu, standart HTTP API'leri için uyumluluk yoludur. Kalıcı WebSocket ve Editör ses/video signaling için native ASGI gereklidir.

Kurulum sırası

1. Resmi sunucu kaynağını hesabınızdaki özel uygulama dizinine yerleştirin; mümkünse public_html dışında olsun.
2. cPanel'in Python application aracıyla desteklenen Python ortamını oluşturun.
3. Aynı ortamın terminalinden python -m pip install . veya depoda tanımlı bağımlılık kurulumunu çalıştırın.
4. Uygulamayı app/ altına ekleyin. Yeni kurulumda forge init --production çalıştırın.
5. Veritabanı URL'lerini ve gerçek host/proxy/IP ayarlarını yapın.
6. forge validate, forge doctor --production, forge migrate çalıştırın.
7. Startup file'ı passenger_wsgi.py, uygulama callable'ını dosyada tanımlanan application olarak ayarlayın.
8. Panelden application restart yapın; /health, /ready ve gerçek proje endpointini deneyin.

Hosting sağlayıcınızın app root ve working-directory ayarı önemlidir. Relative SQLite/data/env yolları yanlış dizine çözülürse "dosya yok" veya boş uygulama sorunları görülebilir. Sağlayıcının izin verdiği direktifleri doğrulayın; tek bir .htaccess her cPanel kurulumuna uymayabilir.

Güvenli dosya yerleşimi

.env, SQL dosyaları, veritabanları, media kökü ve Editor attachments webden doğrudan indirilememelidir. MIME/static server kurallarıyla rastgele private dosya servis etmeyin. Uygulama erişim kontrolü üzerinden indirme yapılmalıdır.

deploy/cpanel/.htaccess.example başlangıç şablonudur. İçindeki placeholder hesap yollarını gerçek konuma uyarlayın. Python sürümü, Passenger restart yöntemi, egress, RAM ve worker limitleri hosting politikasına bağlıdır.

Editör bağlantısı

Control plane'in HTTPS JSON endpointleri bu köprü üzerinden çalışabilir. Yönetim yüzeyini sadece uygun private/VPN/IP politikasında açın. Founder kurulduktan sonra setup'ı kapatıp EDITOR_TOKEN değerini kaldırın.

Ses/video için ayrı ASGI management deployment veya provider'ın desteklediği ASGI process ve WebSocket proxy gerekir. WSGI altında sadece login çalıştı diye calls özelliğinin de çalışacağını varsaymayın. SSE için timeout/buffering/uzun response limitlerini de sağlayıcıyla doğrulayın.

Sık arızalar

Belirti	İnceleme
Import error	cPanel'in seçtiği Python ortamında paketler kurulu mu?
İlk istekte 500	Lifespan, DB erişimi, writable data dizini
Health var ama proje yok	App root, config geçerliliği, /ready
403	Gerçek proxy peer'i, Host, IP ve HTTPS güveni
Upload erken kesiliyor	LiteSpeed/Apache/Passenger ve Forge body limitleri
WS/call açılmıyor	WSGI taşıma sınırı; native ASGI gerekiyor

Log paylaşırken connection string ve token'ları çıkarın. Üretim sorunu çözmek için kimlik/HTTPS kontrolünü genel olarak devre dışı bırakmayın.

Kaynak ve doğrulama

Bu sayfa aşağıdaki sabit commitlerdeki davranışı açıklar. Yeni bir sürümde aynı davranışın sürdüğünü varsaymayın.

• main/docs/cPanelGuide.md
• main/passenger_wsgi.py
• main/framework/wsgi.py
• main/deploy/cpanel/.htaccess.example

---

Wiki ana sayfa · Tüm sayfalar · Sürüm ve bakım