Bu kılavuzu okuyarak, Nginx sunucunuzu daha verimli yönetmek ve karşılaşabileceğiniz sorunları güvenle çözmek için gerekli bilgiye sahip olacaksınız.

İçindekiler

1. Gereksinimler
2. Sistem Güncellemesi
3. Nginx Kurulumu
4. Yaygın Nginx Hataları ve Çözümleri
   • Address family not supported by protocol
   • Varsayılan Nginx Sayfası
   • 403 Forbidden
   • 404 Not Found
   • 500 Internal Server Error
   • 502 Bad Gateway
   • 504 Gateway Timeout

1. Gereksinimler

Sorun giderme işlemlerine başlamadan önce sisteminizin aşağıdaki gereksinimleri karşıladığından emin olun:

• Linux Dağıtımı: Ubuntu 20.04, CentOS, AlmaLinux, Debian veya uyumlu bir sürüm
• Kullanıcı Yetkileri: Root ya da sudo yetkisine sahip bir kullanıcı
• Nginx Sürümü: Yüklü olan en son kararlı Nginx sürümü

2. Sistem Güncellemesi

Sistem güncel olmadığında güvenlik açıkları ve hatalarla karşılaşmanız olasıdır. Yazılım yüklemeden veya yapılandırmadan önce şu komutla sisteminizi güncelleyebilirsiniz:

sudo apt update -y && sudo apt upgrade -y

3. Nginx Kurulumu

Eğer Nginx yüklü değilse, aşağıdaki komutla yükleyebilirsiniz:

sudo apt install nginx -y<br>

Ardından Nginx hizmetini başlatın ve sistem açılışında otomatik başlatılması için etkinleştirin:

sudo systemctl start nginx
sudo systemctl enable nginx

Nginx’in düzgün çalıştığını kontrol etmek için:

sudo systemctl status nginx

Hizmetin active (running) durumunda olması, Nginx’in sorunsuz çalıştığını gösterir.

Nginx, yüksek performanslı bir web sunucusu ve ters proxy sunucusu olarak popülerdir, ancak bu popülerlikle birlikte, kullanıcıların sıkça karşılaştığı bazı yaygın sorunlar gelir. Bu makalede, bu sorunları ve etkili çözümlerini ayrıntılı bir şekilde ele alıyoruz.

Nginx, yüksek performanslı bir web sunucusu ve ters proxy olarak yaygın şekilde kullanılan güçlü bir araçtır. Ancak, yapılandırma karmaşıklığı ve sunucu entegrasyonları nedeniyle kullanıcılar bazen hatalarla karşılaşabilir. Bu makalede, Nginx’te sıkça görülen hataların İngilizce tanımlarını ve bu hatalara yönelik Türkçe çözümlerini ayrıntılı bir şekilde inceleyeceğiz.

1. “502 Bad Gateway”

Hatanın Tanımı:
“502 Bad Gateway” hatası, genellikle Nginx ile arka uç (backend) sunucu arasındaki iletişimde bir sorun olduğunda ortaya çıkar. Arka uç sunucusu çalışmıyor olabilir veya Nginx proxy ayarları yanlış yapılandırılmış olabilir.

Çözüm:

1. Arka Uç Sunucusunu Kontrol Edin:
   Backend (örneğin, PHP-FPM) sunucusunun çalışıp çalışmadığını kontrol edin:

sudo systemctl status php-fpm

Eğer sunucu çalışmıyorsa, şu komutla başlatabilirsiniz:

sudo systemctl start php-fpm

2. Nginx ve Backend Ayarlarını Doğrulayın:
   Nginx yapılandırma dosyasındaki fastcgi_pass veya proxy_pass direktifinin doğru olduğundan emin olun.
   Örnek yapılandırma:

location ~ \.php$ {
    include fastcgi_params;
    fastcgi_pass 127.0.0.1:9000;
    fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
}

3. Bağlantı Sorunlarını Giderin:
   netstat veya curl ile backend sunucusuna bağlantı kurabiliyor musunuz, bunu kontrol edin. Örneğin:

curl http://127.0.0.1:9000

2. “403 Forbidden”

Hatanın Tanımı:
403 hatası, istemcinin (client) belirli bir dosya veya dizine erişim yetkisi olmadığında görülür. Bu genellikle dosya izinleri veya Nginx yapılandırmasındaki yanlışlıklarla ilişkilidir.

Çözüm:

1. Dosya İzinlerini Kontrol Edin:
   Web dosyalarının doğru izinlere sahip olup olmadığını kontrol edin:

sudo chmod -R 755 /var/www/html
sudo chown -R www-data:www-data /var/www/html

2. SELinux Ayarlarını İnceleyin:
   SELinux etkinse, bu da erişim kısıtlamasına neden olabilir. Şu komutlarla SELinux ayarlarını kontrol edin:

getenforce
setenforce 0  # Geçici olarak devre dışı bırakır.

3. Nginx Yapılandırmasını Doğrulayın:
   root veya index direktiflerinde hata olmadığından emin olun:

location / {
    root /var/www/html;
    index index.html;
}

3. “504 Gateway Timeout”

Hatanın Tanımı:
Nginx’in bir backend sunucusundan zamanında yanıt alamaması durumunda bu hata görülür. Bu genellikle yoğun trafik veya uzun çalışan işlemlerle ilişkilidir.

Çözüm:

1. Zaman Aşımı Süresini Artırın:
   Backend işlemlerine daha fazla zaman tanımak için şu ayarları yapabilirsiniz:

proxy_read_timeout 300;
proxy_connect_timeout 300;
proxy_send_timeout 300;

2. Backend Performansını Optimize Edin:
   Backend uygulamanızın yüksek yük altında düzgün çalıştığından emin olun. Örneğin, sorgu sürelerini düşürmek veya işlem sırasını optimize etmek gerekebilir.
3. Bağlantıları İzleyin:
   Şu komutlarla bağlantı sorunlarını kontrol edin:

netstat -tuln

4. “Nginx Service Failed to Start”

Hatanın Tanımı:
Nginx servisi, hatalı bir yapılandırma dosyası veya port çakışması nedeniyle başlatılamayabilir.

Çözüm:

1. Yapılandırmayı Test Edin:
   Nginx yapılandırmasını başlatmadan önce doğrulayın:

sudo nginx -t

2. Varsayılan Port Çakışmasını Giderin:
   80 veya 443 portları başka bir uygulama tarafından kullanılıyorsa, Nginx için farklı bir port belirleyin:

server {
    listen 8080;
}

3. Logları Kontrol Edin:
   /var/log/nginx/error.log dosyasını kontrol ederek hata detaylarını öğrenin.

5. “Static Files Not Loading”

Hatanın Tanımı:
Statik dosyaların (CSS, JS, img) yüklenmemesi genellikle root veya alias direktiflerinde yapılan yanlışlıklarla ilişkilidir.

Çözüm:

1. Doğru Root veya Alias Kullanımı:
   Statik dosya dizini için doğru yolu belirlediğinizden emin olun:

location /static/ {
    root /var/www/html;
}

2. MIME Türlerini Tanımlayın:
   Statik dosyalar için uygun MIME türlerini etkinleştirin. Örnek yapılandırma:

include /etc/nginx/mime.types;

3. Dosya İzinlerini Kontrol Edin:
   Statik dosyaların okuma izinlerine sahip olduğundan emin olun.

6. “SSL/TLS Issues”

Hatanın Tanımı:
SSL sertifikasıyla ilgili sorunlar genellikle hatalı veya eksik ara sertifikalardan kaynaklanır. Ayrıca, eski protokoller uyumluluk sorunlarına neden olabilir.

Çözüm:

1. Doğru Sertifika ve Zincir Kullanımı:
   Sertifika ve zincir dosyalarını doğru şekilde yapılandırın:

ssl_certificate /etc/nginx/ssl/cert.pem;
ssl_certificate_key /etc/nginx/ssl/key.pem;
ssl_trusted_certificate /etc/nginx/ssl/chain.pem;

2. Protokolleri Güncelleyin:
   Sadece güvenli SSL/TLS protokollerini etkinleştirin:

ssl_protocols TLSv1.2 TLSv1.3;
ssl_prefer_server_ciphers on;

3. Sertifika Analizi Yapın:
   SSL Labs gibi bir araçla sertifikanızı test edin.

Sonuç

Bu makalede, Nginx’te sıkça karşılaşılan sorunlar ve bu sorunların nasıl çözüleceği detaylı bir şekilde ele alındı. Doğru yapılandırma ve düzenli bakım ile Nginx’i daha verimli bir şekilde kullanabilirsiniz.

1. Docker’da Kaynak Yönetiminin Önemi

Docker konteynerleri, sisteminizde çalışan diğer uygulamalarla aynı donanım kaynaklarını kullanır. Eğer bir konteyner fazla kaynak tüketiyorsa, bu durum diğer konteynerleri veya ana makinedeki uygulamaları olumsuz etkileyebilir. Kaynak sınırları koyarak:

• Sistem kararlılığını artırabilir,
• Kaynak tüketimindeki dengesizlikleri önleyebilir,
• Performansı optimize edebilirsiniz.

2. Docker’da Bellek ve CPU Sınırlandırma Komutları

Docker konteynerlerinin bellek ve CPU kullanımını sınırlandırmak için birkaç temel komut kullanılır. Bu komutları, docker run veya docker-compose.yml dosyaları aracılığıyla belirleyebilirsiniz.

2.1. Bellek Sınırlandırma

Bellek sınırlarını koyarak konteynerlerin belirli bir bellek alanını aşmasını engelleyebilirsiniz.

• --memory: Maksimum bellek sınırını belirler.
• --memory-swap: Bellek kullanımının swap ile birlikte maksimum sınırını ayarlar.

Örnek:

docker run --memory=512m --memory-swap=1g my-container

Bu komut, konteynerin 512 MB RAM kullanabileceğini ve toplamda (swap dahil) 1 GB’a kadar çıkabileceğini belirtir.

Swap Nedir?

Swap, fiziksel belleğin yetmediği durumlarda disk üzerinde kullanılan bir alandır. Ancak swap kullanımı performansı düşürebileceği için dikkatli ayarlanmalıdır.

2.2. CPU Sınırlandırma

CPU sınırlandırması, konteynerlerin işlemci çekirdeklerini ne kadar kullanabileceğini belirler.

• --cpus: CPU kullanımını belirli bir yüzde ile sınırlandırır.
• --cpu-shares: Konteynerin diğer konteynerlere göre önceliğini belirler.
• --cpuset-cpus: Konteynerin kullanabileceği belirli çekirdekleri ayarlar.

Örnek:

docker run --cpus=0.5 my-container

Bu komut, konteynerin yalnızca işlemcinin %50’sini kullanabileceğini belirtir.

Çekirdek Ayarı

Eğer belirli çekirdekleri atamak isterseniz:

docker run --cpuset-cpus="0,1" my-container

Bu komut, konteynerin yalnızca birinci ve ikinci çekirdekleri kullanmasını sağlar.

3. Docker Compose ile Kaynak Sınırlandırma

Eğer birden fazla konteynerle çalışıyorsanız, docker-compose.yml dosyasını kullanarak kaynak sınırlarını kolayca belirleyebilirsiniz.

Örnek bir docker-compose.yml:

version: '3.7'
services:
  my-service:
    image: my-image
    deploy:
      resources:
        limits:
          memory: 512M
          cpus: '0.5'
        reservations:
          memory: 256M
          cpus: '0.25'

Yukarıdaki örnekte:

• Bellek sınırı 512 MB olarak ayarlanmış,
• CPU kullanım sınırı %50 olarak belirlenmiştir.

4. En İyi Uygulamalar

Kaynak sınırlandırması yaparken aşağıdaki uygulamalara dikkat etmelisiniz:

4.1. İhtiyaca Göre Ayarlama

Her konteynerin farklı ihtiyaçları olabilir. Uygulamanızın bellek ve CPU tüketim profilini analiz ederek uygun sınırları belirleyin.

4.2. İzleme ve Optimizasyon

Konteynerlerin kaynak kullanımını izlemek için Docker’ın sunduğu izleme araçlarını kullanabilirsiniz:

docker stats

Bu komut, çalışan tüm konteynerlerin CPU, bellek ve ağ kullanımını gerçek zamanlı olarak gösterir.

4.3. Overcommitten Kaçının

Eğer birden fazla konteyner çalıştırıyorsanız, toplam bellek ve CPU sınırlarının ana makinenizin kapasitesini aşmadığından emin olun. Overcommit (aşırı yükleme), sistem kararsızlığına yol açabilir.

5. İleri Düzey Konfigürasyonlar

5.1. cgroup Kullanımı

Docker, Linux cgroups (control groups) kullanarak kaynak yönetimi yapar. Eğer daha gelişmiş bir yapılandırma yapmak istiyorsanız, cgroup parametrelerini manuel olarak düzenleyebilirsiniz.

5.2. Docker Swarm ile Kaynak Yönetimi

Eğer bir Docker Swarm kümesi kullanıyorsanız, kaynak sınırlarını deploy kısmında belirtebilirsiniz.

Örnek:

deploy:
  resources:
    limits:
      memory: 1G
      cpus: "1.0"

5.3. Kubernetes ile Entegrasyon

Eğer Docker konteynerlerinizi Kubernetes ile yönetiyorsanız, kaynak sınırlarını resources kısmında tanımlayabilirsiniz:

resources:
  limits:
    memory: "512Mi"
    cpu: "0.5"

6. Bellek ve CPU Sınırlamanın Avantajları

• Performans Artışı: Diğer uygulamalara daha fazla kaynak kalmasını sağlar.
• Kararlılık: Sistem çökmesini önler.
• Güvenlik: Yanlış çalışan bir konteynerin sistemi bloke etmesini engeller.
• Maliyet Kontrolü: Özellikle bulut ortamlarında, gereksiz kaynak kullanımını azaltarak maliyetleri düşürür.

7. Örnek Senaryolar

Senaryo 1: Web Sunucusu

Bir NGINX web sunucusu konteynerinin, 1 GB RAM ve %25 CPU kullanmasını sağlamak için:

docker run --memory=1g --cpus=0.25 nginx

Senaryo 2: Yoğun İşlem Gerektiren Uygulama

Bir makine öğrenimi uygulaması için:

docker run --memory=4g --cpus=2 my-ml-app

8. Sonuç

Docker’da bellek ve CPU kullanımını sınırlandırmak, konteynerlerin performansını optimize etmenin ve sistem kaynaklarını verimli kullanmanın önemli bir yoludur. Bu yazıda, temel komutlardan ileri düzey yapılandırmalara kadar her detayı ele aldık. Kaynak sınırlarını belirlerken uygulamanızın ihtiyaçlarını analiz etmeyi, düzenli olarak izlemeyi ve sınırları optimize etmeyi unutmayın.

Docker ile verimli kaynak yönetimi yaparak daha hızlı, kararlı ve güvenilir uygulamalar geliştirebilirsiniz.