Caddy ve Web Servisi Hata Ayıklama Kılavuzu

ServBay, varsayılan Web sunucusu olarak Caddy kullanır. Günlük kullanımlarda, kullanıcılar site açılmaması gibi bazı sorunlarla karşılaşabilir. Aşağıda bazı yaygın sorunların çözüm yolları bulunmaktadır.

ServBay'e Ait Araçlarla Hata Ayıklama

ServBay, oldukça güçlü bir hata teşhis aracına sahiptir. Kendi kendine tanı koymak ve sorun çözmek için ServBay'e ait hata ayıklama aracını kullanmanızı öneririz.

ServBay uygulamasını açın ve sol taraftaki navigasyonda hata teşhisi seçeneğini bulun. Böylece ServBay'e ait hata teşhis aracına girebilirsiniz.

Caddyfile'ı Kontrol Etme

Sorunu manuel olarak gidermek isterseniz, aşağıdaki adımları dikkate alabilirsiniz.

Caddyfile'ın doğru olup olmadığını kontrol etmek için Caddy'nin dahili doğrulama işlevini kullanın. Aşağıdaki komutu çalıştırın:

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

Valid configuration dönerse, her şey yolundadır. Diğer hata kodları fark ederseniz, hata koduna göre bir sonraki adımı takip edin. (Not: Yukarıdaki komut birçok INFO ve WARN çıktısı verebilir, bu normal bir durumdur ve hizmetin normal çalışmasını etkilemez.)

Sertifika Hatası

loading certificates: open xxxxx: no such file or directory gibi bir hata alırsanız, bu sertifika dosyasının mevcut olmadığı anlamına gelir. Sertifika dosyası 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 Sitesi Dizini Hatası

parsing caddyfile tokens for 'root': too many arguments gibi bir hata ile karşılaşırsanız, web sitesi dizininin 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 mevcut. Bu iki parametre olarak algılanır ve hata oluşturur. Doğru ayarlama yöntemi, yolu çift tırnak (") ile sarmaktır. Örneğin, root * "/Applications/ServBay/www/public web".

Herhangi bir dosya adında, yol içerisinde boşluk veya özel semboller kullanmamayı pek çok zaman öneriyoruz. Kelime ayırma için - veya _ sembolü kullanılabilir, örneğin: 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 Yazma Kuralı Hatası

Caddy içerisinde yanlış yeniden yazma kuralları kullanılmışsa, örneğin NGINX kurallarını doğrudan kullanmak da hata oluşturur.