Loading...

دليل عملي

X-Forwarded-For وعنوان IP الحقيقي للزائر خلف CDN

ضع CDN أو أي وسيط عكسي (reverse proxy) أمام خادم، وستمتلئ سجلاته بالعناوين القليلة نفسها: عناوين الوسيط لا عناوين زوارك. العنوان الحقيقي ما زال موجودًا، في ترويسة الطلب. يشرح هذا الدليل كيف يُبنى X-Forwarded-For، وأي قيمة فيه يمكنك الوثوق بها ولماذا، والترويسات الأبسط التي يضيفها cdn.com.tr، والإعدادات الدقيقة لـ nginx وApache وLaravel.

قراءة 9 دقائق متوسط آخر تحديث

X-Forwarded-For وعنوان IP الحقيقي للزائر خلف CDN

لماذا يرى خادمك عنوان IP خاطئًا

دون وسيط، يتصل متصفح الزائر بخادمك مباشرةً، وعنوان ذلك الاتصال — REMOTE_ADDR في PHP، و$remote_addr في nginx — هو عنوان الزائر. ضع CDN أو موازن تحميل أو أي وسيط عكسي (reverse proxy) أمامه، فيأتي الاتصال الذي يقبله خادمك من الوسيط. وكل سطر سجل، وكل حد معدل، وكل فحص "تسجيل دخول من موقع جديد" يرى الآن عنوان الوسيط.

عنوان الزائر لم يضع. رآه الوسيط ويكتبه في الطلب الذي يمرّره، في ترويسة. والموضوع كله يختصر في سؤالين: أي ترويسة تقرأ، ومتى تصدّقها — لأن الترويسة مجرد نص، ومن يستطيع الوصول إلى خادمك مباشرةً يستطيع كتابة أي نص يشاء.

كيف يُبنى X-Forwarded-For

X-Forwarded-For (XFF) قائمة مفصولة بفواصل. كل وسيط يعالج الطلب يأخذ القيمة الموجودة ويُلحق بها العنوان الذي تلقى منه الطلب. زائر على 198.51.100.7 يمرّ عبر وسيط واحد يصل إلى خادمك هكذا:

X-Forwarded-For: 198.51.100.7

وعبر وسيطين، يُلحق الثاني عنوان الأول:

X-Forwarded-For: 198.51.100.7, 203.0.113.20

وإليك الجزء المهم أمنيًا: الوسيط يُلحق؛ ولا يفحص ما كان موجودًا. يستطيع الزائر إرسال X-Forwarded-For: 1.2.3.4 من عنده، وبعد أن يُلحق CDN عنوان الاتصال الحقيقي يرى خادمك:

X-Forwarded-For: 1.2.3.4, 198.51.100.7

القيمة الأولى من اليسار هي ما كتبه الزائر. أما القيمة التي يمكنك الوثوق بها فهي التي أضافها الوسيط الموثوق — القيمة في أقصى اليمين، أو، مع عدة وسطاء موثوقين متتالين، أول قيمة من اليمين ليست من وسطائك. الشيفرة التي تأخذ أول قيمة في XFF على أنها "IP العميل" يخدعها أي شخص يملك curl.

X-Real-IP وترويسات cdn.com.tr

يحمل X-Forwarded-For تاريخًا كاملًا؛ وغالبًا ما تريد جوابًا واحدًا فقط. ولهذا توجد الترويسات أحادية القيمة.

X-Real-IP تضبطه وسطاء كثيرة قائمة على nginx على عنوان الاتصال الذي قبلته. وتضبطه حافتنا في كل طلب.

X-CDN-Client-IP هو عنوان الزائر كما رأته حافتنا: قيمة واحدة، IPv4 أو IPv6، تكتبها الحافة في كل طلب. وترويسة بالاسم نفسه يرسلها الزائر تُستبدل ولا تُمرَّر. وهي أبسط ترويسة للقراءة.

X-CDN-Client-Port هو منفذ المصدر لدى الزائر. حيث يتشارك مستخدمون كثيرون عنوانًا عامًا واحدًا — شبكات الجوال، وNAT على مستوى مزوّد الخدمة — لا يحدّد العنوان وحده زائرًا؛ أما العنوان مع المنفذ فيحدّده، وهذا ما تحتاجه حين يجب أن يشير سطر سجل إلى اتصال واحد.

X-CDN-Edge-IP هو عنوان الخادم الطرفي الذي اتصل به الزائر، ويفيد حين تطابق سجلاتك مع سجلاتنا أو تسجّل أين أُجري الاتصال.

هذه الترويسات قياسية في كل طلب؛ لا شيء تفعّله. وترسل الحافة أيضًا X-Forwarded-For مع إلحاق عنوان الاتصال، وX-Forwarded-Proto وX-Forwarded-Host وX-Forwarded-Port للبروتوكول واسم المضيف والمنفذ التي استخدمها الزائر.

ثق بالترويسة من CDN وحده

الترويسة التي تكتبها الحافة جديرة بالثقة فقط حين يكون الطلب قد مرّ فعلًا عبر الحافة. إن كان أصلك يجيب أي أحد على الإنترنت، فبإمكان مهاجم أن يتصل به مباشرةً ويرسل X-CDN-Client-IP: 127.0.0.1 أو أي عنوان يشاء. وتسدّ هذه الثغرة خطوتان، وتعملان معًا على أفضل وجه.

أخبر خادم الويب أي العناوين وسطاء. يستعيد nginx وApache ومعظم أطر العمل عنوان العميل فقط للطلبات القادمة من عناوين تدرجها موثوقة؛ ومن أي جهة أخرى تُتجاهل الترويسات. اذكر عناوين الحافة الخاصة بحسابك — نعطيك العناوين الحالية عند الطلب.

اقفل الأصل على CDN. اشترط ترويسة سرّية تختار اسمها وقيمتها وتضيفها إلى كل قاعدة تسليم، أو اشترط شهادة عميل الحافة عبر mTLS. عندها لا يصل الطلب المباشر إلى تطبيقك أصلًا، وتكون الترويسات المُمرَّرة في الطلبات التي تصل هي ترويسات الحافة.

اجعل الترويسة السرّية أو الشهادة القفل الرئيسي، وقائمة العناوين القفل الثاني: فهما يواصلان العمل مهما تغيّرت عناوين الحافة، بينما يجب تحديث القائمة باستمرار.

nginx: set_real_ip_from وreal_ip_header

تستبدل وحدة realip في nginx $remote_addr بالعنوان من ترويسة — لكن فقط حين يأتي الاتصال من عنوان مدرج في set_real_ip_from. بعد ذلك يرى سجل الوصول لديك وقواعد allow وdeny وlimit_req الزائر.

مع X-CDN-Client-IP لا توجد قائمة لتحليلها. وإن فضّلت X-Forwarded-For — مثلًا لأن موازن تحميل خاصًا بك يقع بين CDN وnginx — فاستخدم real_ip_header X-Forwarded-For; مع real_ip_recursive on;، واذكر عناوين الحافة وموازن التحميل معًا في set_real_ip_from. يمشي nginx حينئذٍ في القائمة من اليمين، ويتخطى كل عنوان موثوق ويتوقف عند أول عنوان ليس منها: الزائر.

احتفظ بعنوان الاتصال الأصلي في السجل أيضًا ($realip_remote_addr). وحين تحتاج إلى معرفة أي حافة سلّمت طلبًا، فهو هناك.

nginx: استعادة عنوان الزائر من CDN

# in http {} or server {}
# the edge addresses for your account (placeholders)
set_real_ip_from 203.0.113.0/24;
set_real_ip_from 2001:db8:100::/48;
real_ip_header   X-CDN-Client-IP;

log_format cdn '$remote_addr:$http_x_cdn_client_port via $realip_remote_addr '
               '[$time_local] "$request" $status $body_bytes_sent';
access_log /var/log/nginx/access.log cdn;

Apache: mod_remoteip

يؤدي mod_remoteip في Apache المهمة نفسها. فعّله (a2enmod remoteip على Debian وUbuntu)، وسمِّ الترويسة، واذكر الوسطاء الموثوقين. استخدم RemoteIPTrustedProxy للعناوين العامة؛ أما RemoteIPInternalProxy فمخصص للنطاقات الخاصة.

استخدم %a في تنسيق السجل: مع إعداد mod_remoteip يكون هو عنوان الزائر المستعاد. وقواعد الوصول مثل Require ip ترى هي أيضًا عنوان الزائر متى أُعدّت الوحدة.

Apache 2.4 مع mod_remoteip

RemoteIPHeader        X-CDN-Client-IP
# the edge addresses for your account (placeholders)
RemoteIPTrustedProxy  203.0.113.0/24
RemoteIPTrustedProxy  2001:db8:100::/48

LogFormat "%a %{X-CDN-Client-Port}i %l %u %t \"%r\" %>s %b" cdn
CustomLog ${APACHE_LOG_DIR}/access.log cdn

Laravel وأطر العمل الأخرى: الوسطاء الموثوقون

تقرأ أطر العمل X-Forwarded-For بنفسها، بالقاعدة نفسها: الترويسات المُمرَّرة تُعتدّ فقط من الوسطاء الموثوقين. في Laravel 11 وما بعده تعلنهم في bootstrap/app.php؛ فيعيد $request->ip() عندئذٍ الزائر، ويتبع $request->secure() والروابط المولَّدة قيمة X-Forwarded-Proto.

يقرأ Laravel، عبر Symfony، X-Forwarded-For من اليمين ويتخطى العناوين الموثوقة — وهذه تمامًا قاعدة أقصى قيمة موثوقة من اليمين. لا تثق بـ * على أصل يصل إليه الإنترنت مباشرةً؛ فهذا يخبر الإطار أن يصدّق ترويسات أي عميل. ويتبع Express (app.set('trust proxy', ...)) وRails (config.action_dispatch.trusted_proxies) الفكرة نفسها بأسماء أخرى.

bootstrap/app.php (Laravel 11+)

use Illuminate\Foundation\Configuration\Middleware;
use Illuminate\Http\Request;

->withMiddleware(function (Middleware $middleware) {
    $middleware->trustProxies(
        at: ['203.0.113.0/24', '2001:db8:100::/48'], // edge addresses (placeholders)
        headers: Request::HEADER_X_FORWARDED_FOR
            | Request::HEADER_X_FORWARDED_HOST
            | Request::HEADER_X_FORWARDED_PORT
            | Request::HEADER_X_FORWARDED_PROTO,
    );
})

// anywhere in the application
$ip   = $request->ip();                         // the visitor
$port = $request->header('X-CDN-Client-Port');  // the visitor's source port

تحقق من أنه يعمل

ثلاثة اختبارات سريعة تؤكد الإعداد.

عبر CDN. اطلب صفحة وانظر إلى سجل الوصول لديك: يجب أن يكون العنوان عنوانك العام أنت، لا عنوان حافة.

انتحل الترويسة. أرسل curl -H 'X-Forwarded-For: 1.2.3.4' -H 'X-CDN-Client-IP: 1.2.3.4' https://www.example.com/. يجب أن يُظهر السجل عنوانك الحقيقي رغم ذلك: تستبدل الحافة X-CDN-Client-IP وتُلحق عنوانك بعد قيمة XFF التي أرسلتها.

التفّ حول CDN. أرسل الطلب نفسه مباشرةً إلى الأصل بالخيار --resolve. إن كان الأصل مقفلًا، يُرفض الطلب؛ وإن لم يكن، فيجب أن يُظهر السجل عنوانك الحقيقي لا 1.2.3.4، لأن عنوانك ليس في القائمة الموثوقة. وإن أظهر 1.2.3.4، فالقائمة الموثوقة واسعة جدًا.

أين يهمّ عنوان IP الحقيقي

السجلات والتحليلات

تعدّ سجلات الوصول والتحليلات وتقارير الإساءة زوّارك، لا الخوادم الطرفية التي أمامهم.

حدود المعدل والحظر

تصيب حدود كل IP وحظر على نمط fail2ban المسيء، لا كل من يصل إليك عبر الحافة نفسها.

التحقيقات

العنوان ومنفذ المصدر والوقت وعنوان الحافة معًا تشير إلى اتصال واحد، حتى خلف عناوين الجوال المشتركة.

كيفية الإعداد

أدلة خطوة بخطوة في مركز المساعدة:

الأسئلة الشائعة حول X-Forwarded-For

أي قيمة في X-Forwarded-For هي IP العميل؟

أقصى قيمة من اليمين أضافها وسيط تثق به. القيم على يسارها كانت موجودة في الترويسة حين وصل الطلب إلى ذلك الوسيط، فقد يكون الزائر هو من كتبها. ومع CDN واحد أمام خادمك، هي ببساطة القيمة الأخيرة.

ماذا يحدث لترويسة X-Forwarded-For التي يرسلها الزائر؟

تحتفظ بها الحافة وتُلحق بها العنوان الذي تلقت منه الطلب، كما تفعل الوسطاء. ولهذا تقرأ القيمة في أقصى اليمين — أو X-CDN-Client-IP، وهي قيمة واحدة تكتبها الحافة بنفسها ولا يستطيع الزائر ضبطها.

ما الفرق بين X-Forwarded-For وX-Real-IP؟

X-Forwarded-For قائمة يُلحق بها كل وسيط، فتسجّل المسار كله. أما X-Real-IP فعنوان واحد يضبطه وسيط واحد. كلاهما عُرف متّبع؛ والترويسة القياسية Forwarded (RFC 7239) تحمل المعلومات نفسها بصياغة أكثر صرامة.

لماذا أحتاج X-CDN-Client-Port؟

لأن زوارًا كثيرين قد يتشاركون عنوان IP عامًا واحدًا في شبكات الجوال وخلف NAT على مستوى مزوّد الخدمة. ومنفذ المصدر، مع العنوان والوقت، يفرّق بين أولئك الزوار، وهذا ما تحتاجه حين يجب أن يشير سطر سجل إلى اتصال واحد.

هل يمكنني الوثوق بـ X-CDN-Client-IP من أي عنوان؟

فقط حين لا يقبل أصلك أي حركة إلا من CDN، مقفلًا بترويسة سرّية أو mTLS. وإن كان الوصول إلى الأصل مباشرةً ممكنًا، فيستطيع أي شخص إرسال تلك الترويسة، فقيّدها أيضًا بعناوين الحافة.

من أين أحصل على عناوين الحافة الموثوقة؟

نخبرك بالعناوين الحالية للخوادم الطرفية المرتبطة بحسابك عند الطلب. واقفل الأصل أيضًا بترويسة سرّية أو mTLS، حتى لا تعتمد حمايتك على إبقاء قائمة محدَّثة.