Node.js Selector, CloudLinux üzerinde kullanıcı bazlı Node.js uygulamaları yayınlamayı kolaylaştırır. Ancak altyapı Passenger kullandığı için bazı modern Node.js davranışları doğrudan desteklenmeyebilir.
Özellikle ECMAScript modules kullanan uygulamalarda ERR_REQUIRE_ESM hatası görülebilir. Bu durumda CommonJS wrapper yaklaşımıyla uygulama başlangıcı düzenlenebilir.
- Node.js Selector cPanel, DirectAdmin ve panel olmayan kurulumlarda değerlendirilebilir; Plesk kendi Node desteğine sahiptir.
- OpenLiteSpeed .htaccess eksikliği nedeniyle uyumlu değildir.
- Passenger CommonJS beklentisi modern ESM projelerde planlanmalıdır.
- alt-nodejs: Alternatif Node.js runtime paketleridir.
- mod_passenger: Node uygulamasını web server ile bağlar.
- app_wrapper.cjs: ESM entrypoint için pratik wrapper dosyasıdır.
Yeni Node projesi kabul ederken package.json type alanını ve entrypoint yapısını kontrol edin. Uygulama lokal ortamda çalışıyor diye Passenger altında aynı şekilde başlayacağını varsaymayın.
- ESM projeler wrapper olmadan başlayamayabilir.
- Plesk sunucuda CloudLinux Node Selector yerine Plesk Node desteği değerlendirilmelidir.
- Port, environment ve restart akışı müşteriye net anlatılmalıdır.
Özellikle ECMAScript modules kullanan uygulamalarda ERR_REQUIRE_ESM hatası görülebilir. Bu durumda CommonJS wrapper yaklaşımıyla uygulama başlangıcı düzenlenebilir.
Operasyon Notu
- Node.js Selector cPanel, DirectAdmin ve panel olmayan kurulumlarda değerlendirilebilir; Plesk kendi Node desteğine sahiptir.
- OpenLiteSpeed .htaccess eksikliği nedeniyle uyumlu değildir.
- Passenger CommonJS beklentisi modern ESM projelerde planlanmalıdır.
Vurgulanacak Ayarlar
- alt-nodejs: Alternatif Node.js runtime paketleridir.
- mod_passenger: Node uygulamasını web server ile bağlar.
- app_wrapper.cjs: ESM entrypoint için pratik wrapper dosyasıdır.
Komut ve Kontrol
cat app_wrapper.cjs
(() => import('./app.js'))();Saha Uygulaması
Yeni Node projesi kabul ederken package.json type alanını ve entrypoint yapısını kontrol edin. Uygulama lokal ortamda çalışıyor diye Passenger altında aynı şekilde başlayacağını varsaymayın.
Riskli Noktalar
- ESM projeler wrapper olmadan başlayamayabilir.
- Plesk sunucuda CloudLinux Node Selector yerine Plesk Node desteği değerlendirilmelidir.
- Port, environment ve restart akışı müşteriye net anlatılmalıdır.