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.
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?
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 |
|---|---|
|
|
|
|
|
Stable sürüm kanalındaki Nginx imajıdır. |
|
|
Alpine Linux tabanlı Nginx imajıdır. |
|
|
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
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.
-
:roparametresi 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 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.htmlolarak belirlenir. -
Bulunamayan dosyalar için HTTP 404 yanıtı döndürülür.
-
404.htmldosyası 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?
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.






