Yaygın Nginx Hata Mesajları Nasıl Onarılır: Adım Adım Kılavuz

NGINX Hatası Nedir?

Bir Nginx hatası, Nginx web sunucusunu kullanırken meydana gelen bir aksaklık veya aksaklık anlamına gelir. Nginx, çoğu web sitesinin güvendiği, yaygın olarak kullanılan web sunucusudur. Ancak, herhangi bir yazılım gibi, web sitenizin düzgün çalışmasını bozabilecek hatalarla karşılaşabilir.

Örneğin, bunu web sitenizin veya herhangi bir web uygulamasının normal işleyişini kesintiye uğratabilecek bir yol tümseği olarak düşünün. Çok karmaşık bir yazılım sistemi olan Nginx, bazen çeşitli faktörlerin neden olduğu sorunlarla karşılaşabilir. Yanlış ayarlar, sunucu tarafında meydana gelen sorunlar, ağ sorunları ve hatta istemci tarafından yapılan hatalar gibi.

Nginx hataları, bazılarına zaten aşina olabileceğiniz çeşitli biçimlerde ortaya çıkabilir. Örneğin, bunlar arasında 502 Kötü Ağ Geçidi Hatası nginx, 404 Bulunamadı Hatası, 503 Hizmet Kullanılamıyor Hatası, 504 Ağ Geçidi Zaman Aşımı Hatası ve yönlendirme hataları (301 ve 302) yer alır.

Web sitesi ziyaretçileriniz için sorunsuz bir deneyim sağlamak için nginx hatalarını etkili bir şekilde ele almak çok önemlidir. Web sunucusu olan Nginx, zaman zaman hatalarla karşılaşır ve bunları belirli hata kodlarını kullanarak iletir. Bu kodları anlayarak, sorunun doğasını kolayca belirleyebilir ve buna göre düzeltebilirsiniz.

Bu kapsamlı kılavuzda, yaygın Nginx hatalarını derinlemesine inceleyeceğiz, nedenlerini keşfedeceğiz ve bu sorunları etkili bir şekilde giderip çözmenize yardımcı olacak pratik çözümler sunacağız.

Bazı Yaygın Nginx Hataları

Nginx hataları, yanlış yapılandırmalar, sunucu tarafı sorunları, ağ sorunları veya istemci istekleri gibi çeşitli kaynaklardan kaynaklanabilir. Karşılaşabileceğiniz bazı yaygın Nginx hatası türlerine bir göz atalım:

Yaygın Nginx Hata Mesajları ve Çözümleri:

1. 502 Kötü Ağ Geçidi Hatası:

• Nedenleri: Bu hata, genellikle Nginx bir proxy gibi davrandığında ve yukarı akış sunucusundan geçerli bir yanıt alamayınca ortaya çıkar.
• Çözümler: Bunu çözmek için yukarı akış sunucusunun yapılandırmasını kontrol edin, ağ bağlantısını doğrulayın ve sunucunun çalışır durumda olduğundan emin olun.

Okuyun: 502 Kötü Ağ Geçidi NGINX Hatası Nasıl Düzeltilir? (7 Yöntem)

2. 404 Bulunamadı Hatası:

Nginx ile yapılandırılmış bir web sitesini ziyaret ettiğinizde, web sitesi sunucusuna başarıyla bağlandı ancak herhangi bir dosya adı veya URL gibi istenen kaynakları bulamadı. Ve bu tür bir hata mesajı genellikle yapılandırma dosyası sorunları nedeniyle tetiklenir.

• Nedenleri: Bu hata, istenen kaynağın sunucuda bulunmadığını gösterir.
• Çözümler: Bunu çözmek için nginx.conf dosyasının veya dizininin varlığını doğrulayın, URL yapılandırmasını gözden geçirin ve büyük/küçük harf duyarlılığı sorunlarını kontrol edin.

Okuyun: WordPress Sitesi ve Android için 404 Bulunamadı Hatası Nasıl Düzeltilir?

3. 503 Hizmet Kullanılamıyor Hatası:

• Nedenleri: Bu hata, sunucu geçici olarak istekleri işleyemediğinde ortaya çıkar.
• Çözümler: Bu sorunu çözmek için sunucu yükünü kontrol edin, Nginx'i yeniden başlatın, arka uç sunucularının sağlığını analiz edin veya uygun önbelleğe alma mekanizmalarını uygulayın.

Okuyun: “HTTP Hatası 503 Hizmeti Kullanılamıyor” Nasıl Düzeltilir?

4. 504 Ağ Geçidi Zaman Aşımı Hatası (devamı):

• Nedenleri: Bu hata genellikle yukarı akış sunucusu belirli bir süre içinde yanıt veremediğinde ortaya çıkar.
• Çözümler: Bunu çözmek için yukarı akış sunucusunun yapılandırmasını kontrol edin, uygun ağ bağlantısını sağlayın ve gerekirse daha uzun yanıt sürelerine izin vermek için Nginx'teki zaman aşımı ayarlarını yapın.

Oku: HTTP 504 Ağ Geçidi Zaman Aşımı Hatası Nasıl Düzeltilir?

5. 301 ve 302 Yönlendirme Sorunları:

• Nedenleri: Bu hatalar, yanlış yapılandırmalar veya yeniden yönlendirme sürecindeki döngüler gibi URL yeniden yönlendirmesiyle ilgili sorunlar olduğunda ortaya çıkar.
• Çözümler:

• Nginx yapılandırmasını doğrulayın: Yönlendirme kurallarının doğru tanımlandığından emin olmak için Nginx yapılandırma dosyalarını kontrol edin. Yapılandırma dosyası genellikle /etc/nginx/nginx.conf konumunda veya /etc/nginx/conf.d/ dizininde ayrı bir dosyada bulunur.
• Sunucu bloğu yapılandırmasını kontrol edin: Yapılandırma dosyasında, etkilenen etki alanına veya sanal ana bilgisayara karşılık gelen sunucu bloğunu bulun. Uygun server_name yönergesinin doğru etki alanı adına ayarlandığından emin olun.
• Yeniden yönlendirme kurallarını gözden geçirin: Yeniden yönlendirme kurallarını tanımlayan location bloklarını veya server bloklarını inceleyin. İstekleri istenen konuma yeniden yönlendirmek için rewrite veya return yönergelerinin doğru şekilde yapılandırıldığından emin olun. Normal ifadelere ve hedef URL'lere dikkat edin.
• Nginx'i Yeniden Başlatın : Yapılandırma dosyalarında herhangi bir değişiklik yaptıktan sonra, değişikliklerin uygulanması için Nginx hizmetini yeniden başlatmanız gerekir. Nginx'i yeniden başlatmak için aşağıdaki komutu kullanın:

sudo service nginx restart

• Tarayıcı önbelleğini temizle : Bazen, tarayıcılar yeniden yönlendirme yanıtlarını önbelleğe alır. Önbelleğin yönlendirmeyi engellemediğinden emin olmak için tarayıcı önbelleğinizi temizleyin veya web sitesine özel veya gizli bir pencerede erişmeyi deneyin.
• Yönlendirmeyi test edin : Bir web tarayıcısı açın ve yönlendirmeyi tetiklemesi gereken URL'ye erişmeyi deneyin. Yeniden yönlendirmenin beklendiği gibi çalıştığını ve istenen hedefe ulaşıldığını doğrulayın.
• Hatalar için günlükleri kontrol edin: Yönlendirme hala çalışmıyorsa, ilgili hata mesajları için Nginx hata günlüklerini ( /var/log/nginx/error.log ) inceleyin. Günlükler, sorunun nedenini belirlemek için değerli bilgiler sağlayabilir.

Bu adımları izleyerek, Nginx'teki yaygın yeniden yönlendirme sorunlarını teşhis edip düzeltebilmelisiniz.

Bir NGINX hatasını nasıl düzeltirim?

Artık bazı yaygın NGINX hatalarını gördüğünüze göre, aklınızda şu soru olabilir: 'Bir NGINX hatasını nasıl düzeltirim?'

Cevap göründüğü kadar zor değil. NGINX hataları için çeşitli sorun giderme yöntemleri mevcuttur. Ancak, bu sorun giderme yöntemlerinin yalnızca başlangıç ​​aşaması için olduğunu not etmek önemlidir. Sorunun kesin nedenini belirlemek için daha fazla araştırma yapılması gerekir.

NGINX hataları için sorun giderme yolculuğunuza başlamanıza yardımcı olabilecek temel olarak üç komut vardır.

• Bu komutu kullanarak Hata günlüğünü ve sorunun ayrıntılarını alın: sudo cat /var/log/nginx/error.log
• Nginx aktif durumunu kontrol etmek için: sudo systemctl status nginx
• Yapılandırma dosyasındaki sözdizimi hatalarını kontrol etmek için: sudo nginx -t

1. Nginx hatalarını hata günlükleriyle giderme

NGINX ile ilgili bir sorunla karşılaştığınızda, bu NGINX hatalarının çoğu belirsizdir ve asıl sorunu basitçe anlamak kolay değildir. Hata, daha büyük bir sorun nedeniyle tetiklenebilir veya tamamen ilgisiz olabilir.

Bu tamamen NGINX kurulumunuzu nasıl yapılandırdığınıza ve karşı karşıya olduğunuz özel duruma bağlıdır.

Meydana gelen NGINX hatalarını daha iyi anlamak için, bu hataların listesini görüntülemek üzere bir komut çalıştırabilirsiniz. İşte komut:

sudo cat /var/log/nginx/error.log

Bu komutu çalıştırmak için ayrıcalıklı bir kullanıcı olmanız gerekir. Kök kullanıcıyı kullanmak yerine sudo erişimine sahip olmanız önerilir.

Bu komut, NGINX hata günlüklerini içeren /var/log/nginx/error.log dosyasının tüm içeriğini okumanızı sağlar. Bu günlükleri terminal pencerenizde gösterecektir.

Bu komutu çalıştırarak, kaydedilen NGINX hatalarının bir listesini görebileceksiniz. Günlükte kayıtlı herhangi bir hata yoksa bir şeyi unutmayın, komutu çalıştırdığınızda herhangi bir çıktı görmezsiniz.

İşte referansınız için bir hata günlüğü örneği,

2023/05/31 10:15:23 [error] 1234#0: *1 open() "/var/www/html/missing-page.html"
failed (2: No such file or directory), client: 192.168.0.1, server: example.com,
request: "GET /nonexistent-page HTTP/1.1", host: "example.com"

2023/05/31 12:45:57 [error] 1234#0: *2 upstream timed out (110: Connection timed out)
while reading response header from upstream, client: 192.168.0.2, server:
example.com, request: "GET /api/data HTTP/1.1", upstream:
"http://127.0.0.1:8000/api/data", host: "example.com"

2023/05/31 15:22:10 [error] 1234#0: *3 rewrite or internal redirection cycle while internally redirecting to "/index.php", client: 192.168.0.3, server: example.com, request: "GET /category/products/ HTTP/1.1", host: "example.com"

Bu örnekte, her satır NGINX tarafından günlüğe kaydedilen ayrı bir hatayı temsil eder. Verilen bilgileri parçalayalım:

• Zaman Damgası: Her satırın ilk kısmı, hatanın oluştuğu tarih ve saati YYYY/MM/DD HH:MM:SS olarak biçimlendirilmiş olarak gösterir.
• Hata Düzeyi: [error] etiketi, bu satırın bir hatayı temsil ettiğini belirtir.
• İşlem Kimliği: # simgesinden sonraki sayı (örneğin, 1234#0 ), isteği işleyen NGINX işlem kimliğini temsil eder.
• Hata Mesajı: Hata mesajı, belirli bir hata hakkında ayrıntılar sağlar. Dosya veya kaynak erişim hataları, yukarı akış bağlantı zaman aşımları veya dahili yeniden yönlendirme sorunları gibi bilgileri içerir.
• İstemci IP'si: client alanı, sunucuya istekte bulunan istemcinin IP adresini gösterir.
• Sunucu Adı: server alanı, hatanın oluştuğu sunucu adını veya sanal ana bilgisayarı gösterir.
• İstek Ayrıntıları: request alanı, istemci tarafından kullanılan HTTP yöntemini, istenen URL'yi ve protokol sürümünü gösterir.
• Ana Bilgisayar: host alanı, istekte kullanılan ana bilgisayar adını veya IP adresini belirtir.

Her hata günlüğü girişi, hata türü, etkilenen kaynak, istemci IP'si ve diğer ilgili ayrıntılar hakkında bilgi sağlayarak sorunların tanılanmasına ve giderilmesine yardımcı olur.

2. Durumunu Kontrol Ederek NGINX Sorunlarını Giderme

NGINX'te sorun gidermek için deneyebileceğiniz başka bir yöntem de durumunu, yani aktif olup olmadığını kontrol etmektir. Belirli sebeplerden dolayı kurulum işleminin tamamlanamaması veya hizmetin henüz aktif olmaması ihtimali vardır.

NGINX hizmet durumunu kontrol etmek için aşağıdaki komutu kullanın:

sudo systemctl status nginx

NGINX servisi aktif ise çıktısı şu şekilde olacaktır;

nginx.service - The NGINX HTTP and reverse proxy server
Loaded: loaded (/lib/systemd/system/nginx.service; enabled; vendor preset:
enabled)
Active: active (running) since Mon 2023-05-31 14:30:00 UTC; 5min ago
Docs: http://nginx.org/en/docs/
Process: 1234 ExecStart=/usr/sbin/nginx -g daemon on;
master_process on;
(code=exited, status=0/SUCCESS)
Main PID: 1234 (nginx)
Tasks: 2 (limit: 2319)
Memory: 3.9M
CGroup: /system.slice/nginx.service
├─1234 nginx: master process /usr/sbin/nginx -g daemon on; master_process on;
└─5678 nginx: worker process

ve eğer NGINX durumu inaktif ise , sudo systemctl status nginx komutunun çıktısı aşağıdaki gibi servisin aktif olmadığını veya durdurulduğunu gösterecektir.

nginx.service - The NGINX HTTP and reverse proxy server
Loaded: loaded (/lib/systemd/system/nginx.service; enabled; vendor preset: enabled)
Active: inactive (dead)
Docs: http://nginx.org/en/docs/

Bu durumda yapmanız gereken tek şey şu komutu kullanarak NGINX hizmetinizi yeniden başlatmaktır:

sudo systemctl restart nginx

Bundan sonra, NGINX servisinin artık aktif olup olmadığını kontrol etmek için status komutunu tekrar kullanabilirsiniz.

3. Sözdizimi hatasını kontrol ederek NGINX'te sorun giderme

Sözdizimi hataları, komut dosyaları, kodlar yazarken veya Nginx dosyalarını yapılandırırken ortaya çıkabilecek yaygın bir sorundur.

İster yanlış bir sözdizimi yapısı kullanmış olun, ister belirli karakterleri atlamış olun, yanlış bir sözdizimi, kodun veya yapılandırmanın düzgün çalışmasını engelleyecektir.

Nginx yapılandırma dosyaları söz konusu olduğunda, düzgün çalışması için her birinin doğru bir şekilde bildirilmesi gereken çeşitli yönergeler içerirler. Aksi takdirde, amaçlandığı gibi çalışmayacaktır.

Nginx yapılandırma dosyanızda herhangi bir sözdizimi hatası olup olmadığını kontrol etmek için aşağıdaki komutu kullanın.

sudo nginx -t

Sözdizimi doğru çıktıysa, çıktı şöyle olacaktır:

nginx: configuration file /etc/nginx/nginx.conf test is successful

Ancak, sözdiziminde bir sorun varsa, çıktı şu şekilde görüntülenecektir:

nginx: [emerg] unexpected end of file, expecting ";" or "}" in
/etc/nginx/nginx.conf:42
nginx: configuration file /etc/nginx/nginx.conf test failed

Bu kontrolü gerçekleştirerek, Nginx yapılandırmanızın doğru ve eksiksiz olduğunu garanti ederek sözdizimi hatalarını tanımlayabilir ve düzeltebilirsiniz. Sözdizimi hatalarından kaynaklanan sorunlardan kaçınmak için yapılandırma dosyasında her değişiklik yaptığınızda veya Nginx'i yeniden başlatmadan önce bu komutu çalıştırmak iyi bir uygulamadır.

Not: Nginx yapılandırma dosyanızdaki herhangi bir hatayı kontrol etmek ve hiçbir şeyin eksik olmadığından emin olmak için bu sözdizimi komutunu çalıştırmanızı önemle tavsiye ederiz.

Özet

Özetle, Nginx web sunucusunu kullanırken Nginx hataları oluşarak web sitenizde veya web uygulamanızda kesintilere neden olabilir. Bu hatalar, 502 Kötü Ağ Geçidi Hatası, 404 Bulunamadı Hatası, 503 Hizmet Kullanılamıyor Hatası, 504 Ağ Geçidi Zaman Aşımı Hatası ve yönlendirme hataları (301 ve 302) dahil olmak üzere çeşitli biçimlerde gelir.

Nginx hatalarını etkili bir şekilde gidermek için nedenlerini anlamak ve uygun önlemi almak önemlidir. Nginx hataları için yaygın tetikleyiciler arasında yapılandırma dosyası hataları, sunucu tarafı sorunları, ağ sorunları veya istemci istekleri yer alır. Pratik çözümler, hata günlüklerini kontrol ederek, sözdizimi hatalarını arayarak veya Nginx'in aktif durumunu izleyerek temel nedeni teşhis etmeyi içerir.

Bu sorun giderme yöntemleri başlangıçta yardımcı olsa da, sorunun tam nedenini belirlemek için daha fazla araştırma yapılması gerekebileceğini unutmayın.

Bu sorun giderme yöntemlerini izleyerek ve uygun çözümleri uygulayarak, yaygın Nginx hatalarını etkili bir şekilde teşhis edip düzeltebilir ve web sitenizin ziyaretçileri için sorunsuz bir deneyim sağlayabilirsiniz.

Sıkça Sorulan Sorular