Docker ile Nginx Web Sunucusu Nasıl Çalıştırılır?

Docker, Nginx web sunucusunun container ortamında çalıştırılmasını sağlayarak web sunucusu kurulumunu ve yönetimini kolaylaştırır. Docker kullanılarak Nginx, ana işletim sistemine doğrudan kurulmadan izole bir ortamda çalıştırılabilir.

Nginx; web sitelerinin yayınlanması, statik dosyaların sunulması, ters proxy (reverse proxy) işlemleri ve yük dengeleme gibi görevlerde kullanılan açık kaynaklı bir web sunucusudur.

Deploying a Static Website with Docker and Nginx - DEV Community

Docker ile Nginx Nedir?

Docker ile Nginx çalıştırmak, Nginx web sunucusunun Docker Image kullanılarak bir container içerisinde başlatılmasıdır.

Geleneksel kurulumlarda Nginx doğrudan Linux sunucusuna kurulabilir. Docker kullanımında ise Nginx'in çalışması için gerekli dosyalar ve bağımlılıklar hazır bir Docker imajı üzerinden sağlanır.

Docker ile Nginx kullanımının temel özellikleri şunlardır:

  • Nginx izole bir container ortamında çalıştırılabilir.

  • Aynı sunucuda farklı Nginx yapılandırmaları kullanılabilir.

  • Web sitesi dosyaları container'a bağlanabilir.

  • Port yönlendirmeleri Docker üzerinden yönetilebilir.

  • Nginx yapılandırmaları proje dosyalarıyla birlikte saklanabilir.

  • Docker Compose ile diğer uygulama servisleriyle birlikte çalıştırılabilir.

Docker Nginx Image Nedir?

Deploying An Nginx Web Server With Docker | by Austin Storms | Medium

Docker Nginx Image, Nginx web sunucusunun çalıştırılması için hazırlanmış bir Docker imajıdır.

Docker Hub üzerinde Nginx'in farklı sürüm ve işletim sistemi tabanlarına sahip imajları bulunur.

Örnek imajlar:

Docker Image

Açıklama

nginx:latest

latest etiketiyle yayınlanan Nginx imajıdır.

nginx:stable

Stable sürüm kanalındaki Nginx imajıdır.

nginx:alpine

Alpine Linux tabanlı Nginx imajıdır.

nginx:stable-alpine

Stable kanalının Alpine tabanlı imajıdır.

İmaj etiketleri zaman içerisinde farklı sürümlere işaret edebilir. Üretim ortamlarında belirli sürümlerin veya imaj özetlerinin kullanılması tercih edilebilir.

Docker ile Nginx Nasıl Kurulur?

Docker ile Nginx çalıştırmak için bilgisayarda veya sunucuda Docker Engine ya da Docker Desktop kurulu ve çalışır durumda olmalıdır.

1. Nginx Image İndirme

Terminal üzerinden aşağıdaki komut çalıştırılır:

docker pull nginx:alpine

Bu komut, Alpine Linux tabanlı Nginx imajını indirir.

İndirilen imajları görüntülemek için:

docker images

2. Nginx Container Oluşturma

Nginx web sunucusunu çalıştırmak için:

docker run -d --name nginx-web -p 8080:80 nginx:alpine

Bu komutta:

  • docker run: Yeni bir container oluşturur ve başlatır.

  • -d: Container'ı arka planda çalıştırır.

  • --name nginx-web: Container ismini belirler.

  • -p 8080:80: Ana sistemin 8080 portunu container'ın 80 portuna yönlendirir.

  • nginx:alpine: Kullanılacak Nginx imajını belirtir.

3. Nginx Container Durumunu Kontrol Etme

Çalışan container'ları listelemek için:

docker ps

Nginx container kayıtlarını görüntülemek için:

docker logs nginx-web

4. Nginx Web Sunucusuna Erişme

Container başarıyla başlatıldıktan sonra aynı bilgisayardaki tarayıcıdan aşağıdaki adres açılır:

 http://localhost:8080 

Nginx'in varsayılan karşılama sayfası görüntülenir.

Uzak bir sunucuda çalıştırılan Nginx'e erişmek için sunucunun IP adresi, port yönlendirmesi ve güvenlik duvarı ayarları dikkate alınmalıdır.

Docker ile HTML Web Sitesi Yayınlama

Running Your Own Website Inside a Docker Container Using Nginx

Docker ile Nginx kullanılarak HTML, CSS ve JavaScript dosyalarından oluşan statik web siteleri yayınlanabilir.

1. Proje Klasörü Oluşturma

mkdir nginx-site
cd nginx-site

2. HTML Dosyası Hazırlama

Proje klasöründe index.html dosyası oluşturulur.

<!DOCTYPE html>
<html lang="tr">
<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>Docker Nginx Web Sitesi</title>
</head>
<body>
    <h1>Docker ile Nginx Çalışıyor!</h1>
    <p>Bu web sitesi Nginx container üzerinden yayınlanmaktadır.</p>
</body>
</html>

3. Dockerfile Oluşturma

Aynı klasörde Dockerfile isimli dosya hazırlanır.

FROM nginx:alpine

COPY index.html /usr/share/nginx/html/index.html

EXPOSE 80

Bu Dockerfile, Nginx temel imajını kullanır ve hazırlanan HTML dosyasını web sunucusunun varsayılan içerik dizinine kopyalar.

4. Docker Image Oluşturma

docker build -t nginx-sitem:v1 .

5. Web Sitesini Çalıştırma

docker run -d --name nginx-sitem -p 8081:80 nginx-sitem:v1

Tarayıcıdan aşağıdaki adrese erişilebilir:

 http://localhost:8081 

Böylece HTML dosyası Docker içerisinde çalışan Nginx web sunucusu tarafından yayınlanır.

Docker Nginx Dosyaları Nasıl Yönetilir?

Nginx container içerisinde web sitesi dosyalarının bulunduğu varsayılan dizin:

/usr/share/nginx/html

Nginx yapılandırma dosyalarının bulunduğu dizin ise genellikle:

/etc/nginx

Nginx sunucu yapılandırmaları çoğunlukla şu dizinde yer alır:

/etc/nginx/conf.d

Container içerisindeki dosyaları görüntülemek için:

docker exec -it nginx-web sh

Ardından:

ls /usr/share/nginx/html

komutu çalıştırılabilir.

Alpine tabanlı imajlarda bash yerine sh kullanılabilir.

Docker Nginx Volume Nasıl Kullanılır?

Docker ile Nginx çalıştırırken web sitesi dosyaları bind mount yöntemiyle container'a bağlanabilir.

Örnek:

docker run -d \
  --name nginx-gelistirme \
  -p 8082:80 \
  -v "$(pwd):/usr/share/nginx/html:ro" \
  nginx:alpine

Bu komutta:

  • Yerel proje klasörü Nginx içerik dizinine bağlanır.

  • :ro parametresi dosyaların container içerisinde salt okunur olmasını sağlar.

  • Yerel dosyalarda yapılan değişiklikler container tarafından görülebilir.

Bu örnek Linux, macOS ve uygun Unix benzeri terminal ortamlarında kullanılabilir. Windows PowerShell üzerinde klasör yolu belirtme biçimi farklı olabilir.

Bind mount yöntemi özellikle geliştirme ortamlarında kullanışlıdır.

Docker Compose ile Nginx Nasıl Çalıştırılır?

Docker for local web development, part 5: HTTPS all the things — osteel's blog

Docker Compose kullanılarak Nginx web sunucusunun yapılandırması tek bir YAML dosyası üzerinden yönetilebilir.

1. Proje Klasörü Oluşturma

mkdir nginx-compose
cd nginx-compose
mkdir html

2. HTML Dosyası Hazırlama

html klasöründe index.html isimli bir dosya oluşturulur.

<!DOCTYPE html>
<html lang="tr">
<head>
    <meta charset="UTF-8">
    <title>Nginx Docker Compose</title>
</head>
<body>
    <h1>Nginx Web Sunucusu</h1>
    <p>Docker Compose ile çalışıyor.</p>
</body>
</html>

3. Docker Compose Dosyası Oluşturma

Proje klasöründe compose.yaml dosyası hazırlanır.

services:
  nginx:
    image: nginx:alpine
    container_name: nginx-compose-web
    ports:
      - "8080:80"
    volumes:
      - ./html:/usr/share/nginx/html:ro
    restart: unless-stopped

Bu yapılandırmada Nginx container'ı 8080 portu üzerinden erişilebilir hale gelir.

4. Nginx Servisini Başlatma

docker compose up -d

Servisin durumunu görüntülemek için:

docker compose ps

Tarayıcı üzerinden aşağıdaki adrese erişilebilir:

 http://localhost:8080 

5. Nginx Servisini Durdurma

docker compose down

Bu komut Compose tarafından oluşturulan container'ı ve varsayılan proje ağını kaldırır. Yerel html klasöründeki dosyalar korunur.

Docker Nginx Yapılandırma Dosyası Nasıl Düzenlenir?

Nginx yapılandırması değiştirilerek web sunucusunun davranışı özelleştirilebilir.

Örnek default.conf dosyası:

server {
    listen 80;
    server_name localhost;

    root /usr/share/nginx/html;
    index index.html;

    location / {
        try_files $uri $uri/ =404;
    }

    error_page 404 /404.html;
}

Bu yapılandırmada:

  • Nginx 80 numaralı port üzerinden istekleri dinler.

  • Web sitesi dosyaları belirtilen dizinden sunulur.

  • Varsayılan giriş dosyası index.html olarak belirlenir.

  • Bulunamayan dosyalar için HTTP 404 yanıtı döndürülür.

  • 404.html dosyası mevcutsa özel hata sayfası olarak kullanılabilir.

Yapılandırma dosyasını container'a bağlamak için:

services:
  nginx:
    image: nginx:alpine
    ports:
      - "8080:80"
    volumes:
      - ./html:/usr/share/nginx/html:ro
      - ./default.conf:/etc/nginx/conf.d/default.conf:ro

Yapılandırmayı kontrol etmek için:

docker compose exec nginx nginx -t

Yapılandırma doğruysa Nginx ayarlarını yeniden yüklemek için:

docker compose exec nginx nginx -s reload

Docker Nginx Reverse Proxy Nedir?

Dockerized Node.js & Python Application Deployment with Nginx Proxy | by Neha pawar | Medium

Reverse Proxy, istemcilerden gelen HTTP isteklerinin başka bir sunucuya veya uygulama servisine yönlendirilmesini sağlayan yöntemdir.

Nginx, Docker ortamında farklı uygulamaların önünde ters proxy olarak çalıştırılabilir.

Örneğin bir Node.js uygulamasının 3000 portunda çalıştığı varsayıldığında Nginx yapılandırması şu şekilde hazırlanabilir:

server {
    listen 80;

    location / {
        proxy_pass  http://uygulama:3000; 

        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}

Bu örnekte uygulama, aynı Docker ağı içerisinde bulunan uygulama servisinin adıdır.

Nginx gelen istekleri ilgili servisin 3000 portuna yönlendirir.

Bu yapılandırmanın çalışabilmesi için hedef uygulamanın belirtilen portta çalışması ve Nginx container'ının hedef servise ağ üzerinden erişebilmesi gerekir.

Docker Nginx Yönetim Komutları

Çalışan container'ları listeleme:

docker ps

Nginx container durdurma:

docker stop nginx-web

Nginx container başlatma:

docker start nginx-web

Nginx container yeniden başlatma:

docker restart nginx-web

Nginx kayıtlarını görüntüleme:

docker logs nginx-web

Nginx yapılandırmasını kontrol etme:

docker exec nginx-web nginx -t

Nginx yapılandırmasını yeniden yükleme:

docker exec nginx-web nginx -s reload

Nginx container silme:

docker rm nginx-web

Son komut normal koşullarda durmuş bir container üzerinde kullanılır.

Docker Nginx Kullanırken Karşılaşılan Sorunlar

Nginx Sayfası Açılmıyor

Container durumunu kontrol etmek için:

docker ps -a

Hata kayıtlarını görüntülemek için:

docker logs nginx-web

Container çalışmıyorsa veya port yönlendirmesi yanlışsa web sayfasına erişilemeyebilir.

Port Kullanımda Hatası

Ana sistemde 8080 portu başka bir uygulama tarafından kullanılıyorsa Nginx container başlatılamayabilir.

Farklı bir port kullanılabilir:

docker run -d --name nginx-yeni -p 8085:80 nginx:alpine

403 Forbidden Hatası

403 hatası, dosya izinleri veya Nginx yapılandırması nedeniyle oluşabilir.

Web sitesi dizinindeki dosya izinleri ve varsayılan giriş dosyası kontrol edilmelidir.

404 Not Found Hatası

İstenen dosya mevcut değilse veya Nginx yanlış dizinden dosya sunuyorsa 404 hatası alınabilir.

Dosyaların bulunduğu dizin kontrol edilebilir:

docker exec nginx-web ls /usr/share/nginx/html

Nginx Yapılandırma Hatası

Yapılandırma dosyasında sözdizimi hatası bulunuyorsa:

docker exec nginx-web nginx -t

komutuyla hata kontrolü yapılabilir.

Docker ile Nginx Kullanmanın Avantajları

  • Nginx kurulumu Docker imajı üzerinden gerçekleştirilebilir.

  • Web sunucusu izole bir container ortamında çalıştırılabilir.

  • Aynı sunucuda farklı Nginx yapılandırmaları kullanılabilir.

  • Statik web siteleri kolayca yayınlanabilir.

  • Reverse proxy yapılandırmaları oluşturulabilir.

  • Docker Compose ile diğer servislerle birlikte yönetilebilir.

  • Dockerfile kullanılarak özelleştirilmiş Nginx imajları hazırlanabilir.

Docker Nginx Güvenliği Nasıl Sağlanır?

Docker içerisinde Nginx çalıştırılırken güvenlik açısından şu önlemler değerlendirilmelidir:

  • Güncel ve güvenilir Nginx imajları kullanılmalıdır.

  • Gereksiz ağ portları dış erişime açılmamalıdır.

  • Üretim ortamlarında HTTPS ve uygun TLS yapılandırması kullanılmalıdır.

  • Web sitesi dosyaları mümkün olduğunda salt okunur bağlanmalıdır.

  • Container yetkileri ihtiyaç duyulan seviyede sınırlandırılmalıdır.

  • Nginx yapılandırmaları düzenli olarak kontrol edilmelidir.

  • Erişim ve hata kayıtları izlenmelidir.

  • Güvenlik güncellemeleri takip edilmelidir.

Sonuç

Docker ile Nginx çalıştırmak, web sunucusunun container ortamında kurulmasını ve yönetilmesini sağlayan bir yöntemdir.

Docker Hub üzerinden indirilen Nginx imajı kullanılarak web sunucusu başlatılabilir. Dockerfile ile özel web sitesi imajları oluşturulabilir ve Docker Compose sayesinde Nginx diğer uygulama servisleriyle birlikte yönetilebilir.

Nginx; statik web sitesi yayınlama, reverse proxy, içerik önbellekleme ve yük dengeleme gibi işlemler için Docker ortamlarında kullanılabilir.

 


Alıntı