Hangi yayın modelini kullanıyorsunuz?
| Model | Uygulama sürecini kim başlatır? | Dikkat |
|---|---|---|
| HttpPlatformHandler | IIS içindeki handler | Uygulama atanan portu kullanmalıdır. |
| ARR reverse proxy | Ayrı servis veya görev yöneticisi | IIS yalnız hedefe HTTP trafiği aktarır. |
| Arka plan worker | Ayrıca seçilmiş süreç yöneticisi | Web isteği karşılaması gerekmeyebilir. |
AdaPanel’in mevcut barındırma akışı
Yönetici veya yetkili bayi; çalışma zamanı bileşenini, başlangıç dosyasını, site içindeki çalışma klasörünü, argümanları ve ortam değişkenlerini tanımlar. Panel HttpPlatformHandler bileşenini hazırlar ve site web.config dosyasındaki uygulama ayarlarını yazar.
Uygulamaya PORT değeri olarak HttpPlatformHandler’ın atadığı port aktarılır. Sabit 8000 portuna bağlanan bir uygulama bu değerle uyumlu hâle getirilmeden aynı modelde çalışmayabilir. Python için tamponlanmamış günlük çıktısı da yapılandırılır; günlük konumu site içindeki App_Data/AdaPanel/logs alanıdır.
Taşınabilir Python paketi ve worker sınırı
Pakete python.exe, bağımlılıklar veya modeller eklemek tek başına panel entegrasyonu anlamına gelmez. Mevcut akış çalışma zamanı bileşeni ve başlangıç dosyası üzerinden ilerler. Her taşınabilir paket ve iki süreçli server/worker düzeni için otomatik taşıma, sahiplenme veya .env koruması varsayılmamalıdır.
Uygulamayı zaten Windows görevleri çalıştırıyorsa aynı komutu panel veya ikinci bir servisle başlatmayın. Web sunucusu ve worker için görev adı, komut, kullanıcı, çalışma klasörü ve yeniden başlatma davranışını kaydedin. Her süreç için tek yönetici belirleyip geçişi kontrollü yapın.
Yayın öncesi doğrulama sırası
- Seçilen executable ile uygulamanın bağımlılıklarını doğrulayın; geliştirme bilgisayarındaki PATH’e güvenmeyin.
- Çalışma klasörünü ve ortam değişkenlerini açıkça tanımlayın; sırları günlük çıktısına yazmayın.
- Mevcut süreçleri ve dinleyen portu kontrol ederek ikinci bir kopya başlatılmadığını doğrulayın.
- Yerel HTTP yanıtını test edin; /healthz yalnız uygulamanız gerçekten bu yolu sağlıyorsa kullanılabilir.
- IIS üzerinden HTTPS, büyük yükleme ve uzun işlem davranışını kontrol edin.
- Web süreci ve worker için yeniden başlatma sonrası davranışı ayrı test edin.
Özel uygulama dosyalarını koruyun
.env, AI modelleri, geçici çalışma dosyaları ve özel yüklemeler herkese açık statik dosya alanına dönüşmemelidir. Uygulama izinlerini ve IIS erişim kurallarını birlikte inceleyin. Bir dosyaya menüden bağlantı verilmemesi doğrudan URL erişimini engellemez; engellemeyi gerçek HTTP isteğiyle sınayın.
Sık sorulan sorular
Reverse proxy worker sürecini de çalıştırır mı?
Hayır. Reverse proxy HTTP trafiğini iletir. Worker için ayrı ve tek bir süreç yönetimi düzeni gerekir.
Panel her taşınabilir Python paketini otomatik devralır mı?
Bunu varsaymayın. Mevcut bileşen/başlangıç dosyası akışı, özel paket ve server/worker görevleri için ayrıca uyumluluk kontrolü gerektirir.