Web Servisi Hata Ayıklama Kılavuzu

ServBay, varsayılan web sunucusu olarak Caddy, NGINX ve Apache’yi destekler. Günlük kullanımda, kullanıcılar sitelerin açılmaması gibi sorunlarla karşılaşabilir. Aşağıda bazı yaygın sorunlar için çözümler bulunmaktadır.

ServBay'in Kendi Araçlarını Kullanarak Sorun Giderme

ServBay, son derece etkili bir sorun giderme aracı ile donatılmıştır. Sorunları kendi başınıza teşhis etmek ve çözmek için ServBay'in hata ayıklama aracını kullanmanızı öneririz.

ServBay uygulamasını açın, sol taraftaki navigasyonda hata ayıklama bölümünü bulup ServBay’in dahili sorun giderme aracına erişebilirsiniz.

Yapılandırma Dosyalarını Kontrol Etme

Caddyfile Kontrolü

Caddy'nin yerleşik doğrulama işlevini kullanarak Caddyfile’in doğru olup olmadığını kontrol edin. Aşağıdaki komutu çalıştırın:

$ /Applications/ServBay/bin/caddy validate -c /Applications/ServBay/etc/caddy/Caddyfile

Eğer Geçerli yapılandırma (Valid configuration) dönerse, her şey yolunda demektir. Eğer başka hata kodları alırsanız, hata kodlarının önerilerine göre bir sonraki adımı atın. (Not: Yukarıdaki komut, çok sayıda INFO ve WARN çıktısı üretebilir, bu normaldir ve servisin normal çalışmasını etkilemez.)

Sertifika Hatası

loading certificates: open xxxxx: no such file or directory gibi bir hata alırsanız, bu durum sertifika dosyasının bulunmadığını gösterir. Sertifika dosyasının adresinin doğru olup olmadığını kontrol edin.

2024/12/09 17:24:16.970 INFO using config from file {"file": "/Applications/ServBay/etc/caddy/Caddyfile"}
2024/12/09 17:24:16.991 INFO adapted config to JSON {"adapter": "caddyfile"}
2024/12/09 17:24:16.991 WARN Caddyfile input is not formatted; run 'caddy fmt --overwrite' to fix inconsistencies {"adapter": "caddyfile", "file": "/Applications/ServBay/etc/caddy/Caddyfile", "line": 8}
2024/12/09 17:24:16.999 INFO tls.cache.maintenance started background certificate maintenance {"cache": "0x1400121f300"}
2024/12/09 17:24:17.006 INFO tls.cache.maintenance stopped background certificate maintenance {"cache": "0x1400121f300"}

Error: loading http app module: provision http: getting tls app: loading tls app module: provision tls: loading certificates: open /Applications/ServBay/ssl/private/tls-certs/mail.servbay.host/mail.servbay.host.1crt: no such file or directory

Web Dizini Hatası

parsing caddyfile tokens for 'root': too many arguments gibi bir hata alırsanız, lütfen web dizini yolunda boşluk olup olmadığını kontrol edin. Bu, çok yaygın bir hatadır.

Örneğin, root * /Applications/ServBay/www/public web ifadesinde, public ve web arasında bir boşluk var. Bu, iki ayrı parametre olarak algılanarak hataya yol açar. Doğru ayar, yolu çift tırnak içinde ("") alarak yapmaktır. Örneğin, root * "/Applications/ServBay/www/public web" biçimindedir.

Herhangi bir dosya adında, yolda boşluk veya özel sembol bulunmamasını tavsiye ediyoruz. Kelimeleri ayırmak için - veya _ sembollerini kullanabilirsiniz; örnekler: public-folder, public_dir.

2024/12/09 17:26:37.371 INFO using config from file {"file": "/Applications/ServBay/etc/caddy/Caddyfile"}

Error: adapting config using caddyfile: parsing caddyfile tokens for 'root': too many arguments; should only be a matcher and a path, at /Applications/ServBay/etc/caddy/Caddyfile:1388

Yeniden Yazım Kuralı Hatası

Caddy'de yanlış bir Yeniden Yazım kuralı kullanıldığında da hata alabilirsiniz; örneğin NGINX kurallarının doğrudan kullanılması.

NGINX Yapılandırma Kontrolü

Aşağıdaki komutu kullanarak NGINX yapılandırmasının doğru olup olmadığını kontrol edin:

$ /Applications/ServBay/bin/nginx -t

Yapılandırma doğruysa, şu mesajı göreceksiniz:

nginx: the configuration file /Applications/ServBay/etc/nginx/nginx.conf syntax is ok
nginx: configuration file /Applications/ServBay/etc/nginx/nginx.conf test is successful

Yaygın hatalar arasında:

1. Söz dizimi hataları (örneğin, noktalı virgülün eksik olması)
2. Dosya yolu hataları
3. Port çakışmaları

Apache Yapılandırma Kontrolü

Apache yapılandırmasını kontrol etmek için aşağıdaki komutu kullanın:

$ /Applications/ServBay/bin/apachectl configtest

Yaygın hatalar arasında:

1. Modül yükleme hataları
2. .htaccess dosyası söz dizimi hataları
3. Dizin izinlerinin yanlış ayarlanması

500 Hatasını Giderme

500 Internal Server Error, yaygın bir Web sunucusu hatasıdır ve birçok sebebi olabilir:

Genel Sorun Giderme Adımları

1. Sunucu hata günlüğünü kontrol edin:

   • Caddy: /Applications/ServBay/var/logs/caddy/error.log
   • NGINX: /Applications/ServBay/var/logs/nginx/error.log
   • Apache: /Applications/ServBay/var/logs/apache/error.log

2. PHP hizmetinin çalışıp çalışmadığını kontrol edin:

   ps aux | grep php-fpm

3. PHP hatalarını kontrol edin (PHP kullanıyorsanız):

   • /Applications/ServBay/var/logs/php/php_error.log

4. Dosya izinlerini kontrol edin:

   $ ls -la /Applications/ServBay/www/your-site

   Web sunucusu kullanıcısının okuma izinlerine sahip olduğundan emin olun.

Caddy'ye Özgü 500 Hatası

1. FastCGI yapılandırmasının doğru olup olmadığını kontrol edin.
2. PHP-FPM hizmetinin çalıştığından emin olun.
3. Ters proxy ayarlarını doğrulayın.

NGINX'e Özgü 500 Hatası

1. fastcgi_pass ayarının düzgün olup olmadığını kontrol edin.
2. client_max_body_size değerinin yeterince büyük olup olmadığını doğrulayın.
3. try_files yönergesinin yapılandırmasını kontrol edin.

Apache'e Özgü 500 Hatası

1. mod_rewrite'in etkin olup olmadığını kontrol edin.
2. .htaccess dosyasının içeriğini doğrulayın.
3. AllowOverride ayarını kontrol edin.

Servis Yönetimi

Servisi Yeniden Başlatma

Eğer yapılandırmayı değiştirdiyseniz, ilgili servisi yeniden başlatmanız gereklidir:

# Caddy
$ servbayctl restart caddy -all

# NGINX
$ servbayctl restart nginx -all

# Apache
$ servbayctl restart apache -all

Servis Durumunu Görüntüleme

# Caddy
$ servbayctl status caddy -all

# NGINX
$ servbayctl status nginx -all

# Apache
$ servbayctl status apache -all

Gelişmiş Sorun Giderme

Yukarıdaki yöntemler sorunu çözmezse, şunları deneyebilirsiniz:

1. Geçici olarak güvenlik duvarını kapatarak test edin.
2. curl -v ile ayrıntılı istek bilgilerini görüntüleyin.
3. Farklı tarayıcılarda/cihazlarda test edin.
4. DNS çözümlemesinin doğru olup olmadığını kontrol edin.

Daha fazla yardım için lütfen ServBay teknik destek ekibiyle iletişime geçin.