Cloudflare Real IP: Gerçek Ziyaretçi IP Adresini Alma

BalHost
8 dk
9 görüntüleme
Cloudflare Real IP: Gerçek Ziyaretçi IP Adresini Alma

Cloudflare real IP, Cloudflare proxy'si (turuncu bulut) etkin bir siteye gelen isteklerde ziyaretçinin gerçek IP adresinin web sunucusunda ve uygulamada görünmesini sağlayan yapılandırmadır. Proxy kapalıyken sunucu doğrudan ziyaretçiyle konuşur; proxy açıldığında araya Cloudflare kenar sunucuları girer ve TCP bağlantısı Cloudflare IP'lerinden gelir. Bu yazı, Nginx ve Apache'de CF-Connecting-IP başlığını güvenli biçimde okumayı, yapılandırmayı doğrulamayı, IP listesini güncel tutmayı ve sık karşılaşılan sorunları ele alıyor.

Cloudflare arkasında gerçek IP neden kaybolur?

Cloudflare proxy'si, ziyaretçi ile sizin sunucunuz arasında ters vekil (reverse proxy) gibi çalışır. Ziyaretçi Cloudflare'in kenar sunucusuna bağlanır, Cloudflare de isteği sizin sunucunuza iletir. Sunucunun gördüğü TCP bağlantısının kaynak adresi artık ziyaretçi değil, Cloudflare'in o an kullandığı kenar IP'sidir.

Bu durumda Nginx veya Apache erişim logları, uygulama içindeki istemci IP'si ve fail2ban gibi araçlar Cloudflare IP'lerini görür. Sonuç olarak log analizi yanıltıcı olur, hız sınırlama (rate limiting) yanlış çalışır ve fail2ban gerçek saldırganı değil Cloudflare'i engellemeye çalışabilir. Cloudflare bu bilgiyi kaybetmemek için gerçek istemci IP'sini CF-Connecting-IP başlığında iletir; yapılacak iş bu başlığı güvenli biçimde okumaktır.

Aşağıdaki tablo, yapılandırma öncesi ve sonrası sunucunun hangi adresi gördüğünü özetler:

Katman Proxy açık, ayar yok Proxy açık, real IP ayarlı
Nginx $remote_addr Cloudflare kenar IP'si Ziyaretçinin gerçek IP'si
Apache istemci adresi Cloudflare kenar IP'si Ziyaretçinin gerçek IP'si
fail2ban eşleşmesi Cloudflare IP'leri Gerçek saldırgan IP'leri
Erişim logu analizi Yanıltıcı Doğru

Başlamadan önce: gereksinimler ve güvenlik kuralı

Başlamadan önce sunucuda Nginx veya Apache'nin kurulu ve site trafiğinin Cloudflare üzerinden aktığından emin olun. DNS kaydında turuncu bulut (proxy) etkin olmalı; gri bulut kullanılıyorsa istekler doğrudan gelir ve bu yapılandırmaya gerek kalmaz. Web sunucusu yönetimiyle ilgili temel bilgi için web sunucusu yazısına göz atabilirsiniz.

En kritik kural şudur: CF-Connecting-IP başlığına yalnızca istek Cloudflare IP aralıklarından geliyorsa güvenin. Başlık herkese açık bir HTTP alanıdır; sunucu doğrudan erişilebiliyorsa bir saldırgan bu başlığa istediği IP'yi yazıp logları ve fail2ban kurallarını kandırabilir. Bu nedenle yapılandırma, "başlığı oku" değil "yalnızca güvenilen proxy'lerden gelen başlığı oku" biçiminde olmalıdır.

Cloudflare'in yayınladığı IP listeleri cloudflare.com/ips adresinde bulunur ve zamanla değişebilir. Listeyi elle bir kez kopyalamak yerine düzenli güncellenen bir kaynaktan çekmek veya değişiklikleri takip etmek gerekir. Aşağıdaki adımlarda bu liste hem Nginx hem Apache için kullanılıyor.

Sunucunuz henüz hazır değilse, Cloudflare arkasında çalışacak bir sanal sunucu üzerinde bu ayarı kurulumdan sonra ilk işlerden biri olarak planlayabilirsiniz.

Nginx'te Cloudflare real IP nasıl yapılandırılır?

Nginx'te gerçek IP'yi almak için ngx_http_realip_module modülü kullanılır. Bu modül, güvenilen proxy'lerden gelen isteklerde istemci adresini belirtilen başlıktan okur ve $remote_addr değişkenini buna göre günceller. Modülün derlenmiş olup olmadığını aşağıdaki komutla kontrol edebilirsiniz; çoğu dağıtımın paketlediği Nginx'te etkindir.

nginx -V 2>&1 | grep -o with-http_realip_module

1. Cloudflare IP aralıklarını indirin

Listeyi sunucuya çekin ve set_real_ip_from satırlarını üretin. Aşağıdaki komut, Cloudflare'in IPv4 ve IPv6 listelerini alıp Nginx yapılandırmasına uygun satırlara dönüştürür. Listelerin son satırında satır sonu olmayabildiği için her listeden sonra echo ile satır sonu eklenir; aksi halde IPv4'ün son aralığı IPv6'nın ilkiyle aynı satıra yapışır:

{ curl -fsS https://www.cloudflare.com/ips-v4; echo; curl -fsS https://www.cloudflare.com/ips-v6; echo; } \
  | grep -v '^$' | sed 's/^/set_real_ip_from /; s/$/;/' \
  | sudo tee /etc/nginx/conf.d/cloudflare-realip.conf

Bu dosya yalnızca güvenilen aralıkları tanımlar; gerçek IP başlığını henüz okumaz.

2. Başlığı ve güvenilen proxy'leri tanımlayın

Aynı dosyaya real_ip_header ve real_ip_recursive satırlarını ekleyin. real_ip_recursive on ayarı, birden fazla proxy zinciri olduğunda güvenilen aralıklar dışındaki ilk adresi seçmeye yardımcı olur:

sudo tee -a /etc/nginx/conf.d/cloudflare-realip.conf <<'EOF'
real_ip_header CF-Connecting-IP;
real_ip_recursive on;
EOF

Bu satırlar http bağlamında geçerli olacak biçimde conf.d altında durur; böylece tüm sunucu blokları aynı ayarı kullanır.

3. Yapılandırmayı test edip yeniden yükleyin

Değişikliği uygulamadan önce sözdizimini doğrulayın ve Nginx'i kesintisiz yeniden yükleyin:

sudo nginx -t && sudo systemctl reload nginx

nginx -t çıktısında "syntax is ok" ve "test is successful" görmelisiniz. Hata varsa dosyadaki noktalı virgülleri ve yolun doğruluğunu kontrol edin.

Apache'de Cloudflare real IP nasıl yapılandırılır?

Apache'de gerçek IP'yi almak için mod_remoteip modülü kullanılır. Bu modül, RemoteIPHeader ile belirtilen başlığı okur ve bağlantının istemci adresini buna göre değiştirir; RemoteIPTrustedProxy ise hangi proxy'lere güvenileceğini belirler. Modülün yüklü olduğunu aşağıdaki komutla kontrol edebilirsiniz.

apache2ctl -M 2>/dev/null | grep remoteip

1. Cloudflare IP aralıklarını güvenilen proxy olarak ekleyin

Aşağıdaki komut, Cloudflare listesini Apache yapılandırma satırlarına dönüştürür:

{ curl -fsS https://www.cloudflare.com/ips-v4; echo; curl -fsS https://www.cloudflare.com/ips-v6; echo; } \
  | grep -v '^$' | sed 's/^/RemoteIPTrustedProxy /' \
  | sudo tee /etc/apache2/conf-available/cloudflare-remoteip.conf

Dağıtıma göre dizin conf.d olabilir; Debian/Ubuntu tabanlı sistemlerde conf-available ve a2enconf yaygın yoldur.

2. Başlığı tanımlayıp yapılandırmayı etkinleştirin

Aynı dosyaya RemoteIPHeader CF-Connecting-IP satırını ekleyin ve yapılandırmayı etkinleştirip Apache'yi yeniden yükleyin:

sudo tee -a /etc/apache2/conf-available/cloudflare-remoteip.conf <<'EOF'
RemoteIPHeader CF-Connecting-IP
EOF
sudo a2enconf cloudflare-remoteip
sudo apache2ctl configtest && sudo systemctl reload apache2

configtest çıktısında "Syntax OK" görmelisiniz. Bu noktadan sonra uygulamanın gördüğü istemci adresi ziyaretçinin IP'si olur. Debian/Ubuntu'daki varsayılan log biçimi %h kullanır; loglarda hâlâ Cloudflare IP'si görüyorsanız LogFormat satırlarında %h yerine %a yazın.

Yapılandırma doğru çalışıyor mu, nasıl doğrulanır?

Doğrulamanın en doğrudan yolu, kendi genel IP adresinizi bilerek siteye erişmek ve erişim logunda bu adresi aramaktır. Genel IP'nizi öğrenmek için curl -s https://ifconfig.me gibi bir komut kullanabilirsiniz; ardından sunucuda erişim logunu izleyin:

sudo tail -f /var/log/nginx/access.log

Apache'de log yolu dağıtıma göre değişir; Debian/Ubuntu'da genellikle /var/log/apache2/access.log altındadır. Log satırında Cloudflare IP'si yerine kendi IP'nizi görüyorsanız yapılandırma çalışıyor demektir.

İkinci bir kontrol, uygulama tarafında istemci adresini okuyan bir betikle yapılabilir. Örneğin PHP'de $_SERVER['REMOTE_ADDR'] değerinin kendi IP'niz olduğunu görmek, web sunucusu düzeyindeki değişikliğin uygulamaya yansıdığını doğrular. fail2ban kullanıyorsanız günlük eşleşme kalıplarının artık gerçek IP'leri yakaladığını fail2ban-client status çıktısından izleyebilirsiniz; fail2ban tarafındaki ayrıntılar için VDS güvenliği yazısına bakabilirsiniz.

Doğrulamayı üç maddede özetleyebiliriz:

  1. Tarayıcınızdan siteye erişin ve kendi genel IP'nizi not edin.
  2. Sunucuda erişim logunu izleyin; satırda bu IP görünmeli.
  3. Uygulama REMOTE_ADDR değerini okuyorsa aynı IP'yi döndürmeli.

Cloudflare IP listesi değişince ne yapmalı?

Cloudflare IP aralıkları sabit değildir; yeni aralıklar eklenebilir veya mevcutlar güncellenebilir. Liste eskidiğinde yeni bir Cloudflare aralığından gelen istekler güvenilen proxy sayılmaz ve o ziyaretçiler için gerçek IP okunmaz. Bu yüzden listeyi tek seferlik bir kopya olarak değil, düzenli güncellenen bir yapılandırma olarak ele alın.

Pratik yaklaşım, listeyi çeken küçük bir betiği zamanlanmış görevle (cron) çalıştırmak ve değişiklik olduğunda web sunucusunu yeniden yüklemektir. Aşağıdaki örnek, Nginx için listeyi yenileyip yapılandırmayı test eder ve yalnızca başarılıysa yeniden yükler:

#!/bin/bash
set -e
{ curl -fsS https://www.cloudflare.com/ips-v4; echo; curl -fsS https://www.cloudflare.com/ips-v6; echo; } \
  | grep -v '^$' | sed 's/^/set_real_ip_from /; s/$/;/' > /tmp/cf-realip.conf
# Liste boş geldiyse (ağ hatası) mevcut yapılandırmaya dokunma
grep -q set_real_ip_from /tmp/cf-realip.conf
echo 'real_ip_header CF-Connecting-IP;' >> /tmp/cf-realip.conf
echo 'real_ip_recursive on;' >> /tmp/cf-realip.conf
install -m 644 /tmp/cf-realip.conf /etc/nginx/conf.d/cloudflare-realip.conf
nginx -t && systemctl reload nginx

Bu betiği günlük veya haftalık çalıştırmak, listeyi makul ölçüde güncel tutar. Değişiklikleri daha sıkı takip etmek istiyorsanız Cloudflare'in IP listesi duyurularını izleyin ve betiği buna göre güncelleyin.

Sık karşılaşılan sorunlar

En sık görülen sorun, yapılandırma uygulandıktan sonra loglarda hâlâ Cloudflare IP'lerinin görünmesidir. Bunun yaygın nedeni, dosyanın yanlış bağlama konulması veya Nginx'in yeniden yüklenmemiş olmasıdır. nginx -t ve systemctl reload nginx adımlarını atlamayın; Apache'de ise a2enconf sonrası yeniden yükleme gerektiğini unutmayın.

İkinci sık sorun, gerçek IP'nin loglarda doğru görünmesine rağmen uygulamanın hâlâ eski adresi göstermesidir. Bu durumda uygulama, ters vekil başlıklarını kendi ayarlarında okumuyor olabilir; çerçevenin belgelerindeki güvenilen proxy ayarını kontrol edin. Üçüncü olarak, sunucuya Cloudflare dışından doğrudan erişim açıksa CF-Connecting-IP başlığı sahtelenebilir; güvenlik duvarında yalnızca Cloudflare aralıklarına izin vermek bu riski azaltır. Sunucuya erişimi kaybederseniz BalHost müşteri panelindeki konsol üzerinden bağlanabilirsiniz.

Son olarak, yalnızca IPv4 aralıklarını ekleyip IPv6 listesini atlamak da yaygın bir hatadır. Cloudflare IPv6 üzerinden gelen ziyaretçiler için de bağlantı kurar; liste çekilirken hem ips-v4 hem ips-v6 adresinin birlikte alınması gerekir. Aksi halde IPv6 ziyaretçilerin gerçek adresi loglarda görünmez.

Sık Sorulan Sorular

Cloudflare real IP ayarı neden gerekli?

Cloudflare proxy'si etkinken sunucuya gelen bağlantının kaynak adresi ziyaretçi değil Cloudflare kenar sunucusudur. Bu yüzden loglar, uygulama ve fail2ban Cloudflare IP'lerini görür. CF-Connecting-IP başlığını güvenilen proxy'lerden okumak, gerçek ziyaretçi adresini geri kazandırır ve log analizi ile engelleme kurallarını doğru çalıştırır.

CF-Connecting-IP başlığına her zaman güvenilir mi?

Hayır. Başlık herkese açık bir HTTP alanıdır ve sunucuya doğrudan erişilebiliyorsa sahtelenebilir. Yalnızca istek Cloudflare IP aralıklarından geliyorsa güvenin; Nginx'te set_real_ip_from, Apache'de RemoteIPTrustedProxy bu güveni sınırlar. Aksi halde saldırgan logları ve engelleme kurallarını kandırabilir.

Cloudflare IP listesi değişirse ne olur?

Liste güncellenmezse yeni Cloudflare aralıklarından gelen istekler güvenilen proxy sayılmaz ve o ziyaretçiler için gerçek IP okunmaz. Listeyi cloudflare.com/ips adresinden düzenli çeken bir betik ve zamanlanmış görev kullanmak, yapılandırmayı güncel tutar. Betik yapılandırmayı test edip yalnızca başarılıysa yeniden yüklemelidir.

Apache'de hangi modül kullanılır?

Apache'de gerçek IP için mod_remoteip modülü kullanılır. RemoteIPHeader CF-Connecting-IP başlığı tanımlar, RemoteIPTrustedProxy ise hangi proxy'lere güvenileceğini belirler. Modül etkin değilse a2enmod remoteip ile etkinleştirip Apache'yi yeniden yüklemeniz gerekir.

Nginx'te değişiklik neden loglara yansımıyor?

Çoğu durumda dosya yanlış bağlama konulmuştur ya da Nginx yeniden yüklenmemiştir. set_real_ip_from ve real_ip_header satırlarının http bağlamında, örneğin conf.d altında durduğunu doğrulayın. Ardından nginx -t ile sözdizimini test edip systemctl reload nginx ile yapılandırmayı yeniden yükleyin.

Sonuç

Cloudflare real IP yapılandırması, proxy arkasındaki bir sitenin loglarını, uygulamasını ve güvenlik araçlarını doğru çalıştırmasının temelidir. Nginx'te ngx_http_realip_module ile set_real_ip_from ve real_ip_header CF-Connecting-IP, Apache'de mod_remoteip ile RemoteIPHeader ve RemoteIPTrustedProxy satırları bu işi yapar. Kritik nokta, başlığa yalnızca Cloudflare aralıklarından gelen isteklerde güvenmek ve IP listesini güncel tutmaktır.

Yapılandırmayı uyguladıktan sonra erişim logunda kendi IP'nizi görerek doğrulayın; görmüyorsanız dosya bağlamını ve yeniden yükleme adımını kontrol edin. Cloudflare arkasında çalışacak bir sanal sunucu hazırlıyorsanız, kurulum sonrası bu ayarı ilk işlerden biri olarak planlayabilirsiniz.

İlgili Yazılar

Bu konuda hizmet mi arıyorsunuz?

Yazıda anlatılan altyapıyı BalHost sunucularında hazır bulabilirsiniz.