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، یک load balancer یا هر reverse proxy را جلویش بگذارید تا اتصالی که سرور شما می‌پذیرد از پروکسی بیاید. حالا هر خط لاگ، هر rate limit و هر بررسی «ورود از مکان جدید» آدرس پروکسی را می‌بیند.

آدرس بازدیدکننده گم نشده است. پروکسی آن را دیده و در درخواستی که ارسال می‌کند، در یک سرآیند می‌نویسد. کل بحث به دو پرسش برمی‌گردد: کدام سرآیند را بخوانیم و کی باورش کنیم، چون یک سرآیند فقط متن است و هر کس بتواند مستقیم به سرور شما برسد هر متنی را که بخواهد می‌نویسد.

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 روی آدرس اتصالی که پذیرفته‌اند تنظیم می‌کنند. edge ما آن را در هر درخواست تنظیم می‌کند.

X-CDN-Client-IP آدرس بازدیدکننده است، همان‌طور که edge ما دیده: یک مقدار واحد، IPv4 یا IPv6، که edge در هر درخواست می‌نویسد. سرآیندی با همین نام که بازدیدکننده بفرستد جایگزین می‌شود، نه اینکه منتقل شود. این ساده‌ترین سرآیند برای خواندن است.

X-CDN-Client-Port پورت مبدأ بازدیدکننده است. جایی که کاربران بسیاری یک آدرس عمومی را به اشتراک می‌گذارند، مثل شبکه‌های موبایل و carrier-grade NAT، آدرس به‌تنهایی یک بازدیدکننده را مشخص نمی‌کند؛ آدرس به‌علاوهٔ پورت این کار را می‌کند، و این همان چیزی است که وقتی یک خط لاگ باید به یک اتصال واحد اشاره کند لازم دارید.

X-CDN-Edge-IP آدرس سرور edgeی است که بازدیدکننده به آن وصل شده، برای وقتی لاگ‌های خودتان را با لاگ‌های ما تطبیق می‌دهید یا می‌خواهید ثبت کنید اتصال کجا برقرار شده است.

این سرآیندها در هر درخواست استاندارد هستند؛ چیزی برای روشن کردن وجود ندارد. edge همچنین X-Forwarded-For را با آدرس اتصال اضافه‌شده می‌فرستد، و X-Forwarded-Proto، X-Forwarded-Host و X-Forwarded-Port را برای پروتکل، نام میزبان و پورتی که بازدیدکننده استفاده کرده.

سرآیند را فقط از CDN خودتان باور کنید

سرآیندی که edge می‌نویسد فقط وقتی قابل اعتماد است که درخواست واقعاً از edge گذشته باشد. اگر مبدأ شما به هر کسی در اینترنت پاسخ می‌دهد، یک مهاجم می‌تواند مستقیم به آن وصل شود و X-CDN-Client-IP: 127.0.0.1 یا هر آدرس دلخواه دیگری بفرستد. دو اقدام این شکاف را می‌بندند و با هم بهتر کار می‌کنند.

به وب‌سرور بگویید کدام آدرس‌ها پروکسی هستند. nginx، Apache و بیشتر فریم‌ورک‌ها آدرس کلاینت را فقط برای درخواست‌هایی که از آدرس‌هایی که مورد اعتماد فهرست کرده‌اید می‌آیند بازمی‌گردانند؛ از دیگران سرآیندها نادیده گرفته می‌شوند. آدرس‌های edge حساب خود را فهرست کنید؛ آدرس‌های فعلی را در صورت درخواست به شما می‌دهیم.

مبدأ را به CDN قفل کنید. یک سرآیند محرمانه را که نام و مقدارش را خودتان انتخاب می‌کنید و به هر قانون تحویل اضافه می‌کنید الزامی کنید، یا گواهی کلاینت edge را با mTLS الزامی کنید. آنگاه یک درخواست مستقیم هرگز به برنامهٔ شما نمی‌رسد و سرآیندهای forward‌شده روی درخواست‌هایی که می‌رسند از edge هستند.

سرآیند محرمانه یا گواهی را قفل اصلی کنید و فهرست آدرس را قفل دوم: آن‌ها هر طور که آدرس‌های edge تغییر کنند به کار خود ادامه می‌دهند، در حالی که یک فهرست باید به‌روز نگه داشته شود.

nginx: set_real_ip_from و real_ip_header

ماژول realip در nginx مقدار $remote_addr را با آدرس یک سرآیند جایگزین می‌کند، اما فقط وقتی اتصال از آدرسی بیاید که در set_real_ip_from فهرست شده است. پس از آن، access log، قواعد allow و deny و limit_req شما همه بازدیدکننده را می‌بینند.

با X-CDN-Client-IP فهرستی برای پارس کردن وجود ندارد. اگر X-Forwarded-For را ترجیح می‌دهید، مثلاً چون یک load balancer خودتان بین CDN و nginx است، از real_ip_header X-Forwarded-For; با real_ip_recursive on; استفاده کنید و هم آدرس‌های edge و هم load balancer خود را در set_real_ip_from فهرست کنید. آنگاه nginx فهرست را از راست می‌پیماید، هر آدرس مورد اعتماد را رد می‌کند و در اولین آدرسی که مورد اعتماد نیست می‌ایستد: بازدیدکننده.

آدرس اتصال اصلی را هم در لاگ نگه دارید ($realip_remote_addr). وقتی لازم است بدانید کدام edge یک درخواست را تحویل داده، همان‌جاست.

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 برای بازه‌های خصوصی است.

در log format از %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 را خودشان می‌خوانند، با همان قاعده: سرآیندهای forward‌شده فقط از پروکسی‌های مورد اعتماد به حساب می‌آیند. در Laravel 11 و بعد از آن آن‌ها را در bootstrap/app.php تعریف می‌کنید؛ $request->ip() آنگاه بازدیدکننده را برمی‌گرداند، و $request->secure() و URLهای تولیدشده از 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. یک صفحه را درخواست کنید و access log را ببینید: آدرس باید آدرس عمومی خودتان باشد، نه آدرس یک edge.

جعلش کنید. دستور curl -H 'X-Forwarded-For: 1.2.3.4' -H 'X-CDN-Client-IP: 1.2.3.4' https://www.example.com/ را بفرستید. لاگ باید همچنان آدرس واقعی شما را نشان دهد: edge مقدار X-CDN-Client-IP را جایگزین می‌کند و آدرس شما را بعد از مقدار XFFی که فرستادید اضافه می‌کند.

CDN را دور بزنید. همان درخواست را با --resolve مستقیم به مبدأ بفرستید. اگر مبدأ قفل باشد، درخواست رد می‌شود؛ اگر نباشد، لاگ باید آدرس واقعی شما را نشان دهد، نه 1.2.3.4، چون آدرس شما در فهرست مورد اعتماد نیست. اگر 1.2.3.4 را نشان داد، فهرست مورد اعتماد بیش‌ازحد گسترده است.

IP واقعی کجا اهمیت دارد

لاگ‌ها و تحلیل

access logها، تحلیل‌ها و گزارش‌های سوءاستفاده بازدیدکنندگان شما را می‌شمارند، نه سرورهای edge جلوی آن‌ها را.

Rate limit و مسدودسازی

محدودیت‌های به‌ازای IP و مسدودسازی‌های به سبک fail2ban به سوءاستفاده‌گر می‌خورند، نه به همهٔ کسانی که از همان edge به شما می‌رسند.

بررسی و پیگیری

آدرس، پورت مبدأ، زمان و آدرس edge با هم به یک اتصال واحد اشاره می‌کنند، حتی پشت آدرس‌های مشترک موبایل.

نحوه راه‌اندازی

راهنماهای گام‌به‌گام در مرکز راهنما:

پرسش‌های پرتکرار دربارهٔ X-Forwarded-For

کدام مقدار X-Forwarded-For همان IP کلاینت است؟

راست‌ترین مقداری که یک پروکسی مورد اعتماد اضافه کرده است. مقدارهای سمت چپ آن وقتی درخواست به آن پروکسی رسید از قبل در سرآیند بودند، پس ممکن است بازدیدکننده نوشته باشدشان. با یک CDN جلوی سرور شما، این همان آخرین مقدار است.

با سرآیند X-Forwarded-For که بازدیدکننده می‌فرستد چه می‌شود؟

edge آن را نگه می‌دارد و آدرسی را که درخواست را از آن گرفته اضافه می‌کند، همان‌طور که پروکسی‌ها می‌کنند. برای همین راست‌ترین مقدار را می‌خوانید، یا X-CDN-Client-IP را که یک مقدار واحد است که edge خودش می‌نویسد و بازدیدکننده نمی‌تواند تنظیمش کند.

تفاوت X-Forwarded-For و X-Real-IP چیست؟

X-Forwarded-For فهرستی است که هر پروکسی به آن اضافه می‌کند، پس کل مسیر را ثبت می‌کند. X-Real-IP یک آدرس واحد است که یک پروکسی تنظیم می‌کند. هر دو قرارداد هستند؛ سرآیند استاندارد Forwarded (RFC 7239) همین اطلاعات را با نحوی سخت‌گیرانه‌تر حمل می‌کند.

چرا به X-CDN-Client-Port نیاز داشته باشم؟

چون بازدیدکنندگان بسیاری در شبکه‌های موبایل و پشت carrier-grade NAT یک آدرس IP عمومی را به اشتراک می‌گذارند. پورت مبدأ، همراه با آدرس و زمان، آن بازدیدکنندگان را از هم جدا می‌کند، که همان چیزی است که وقتی یک خط لاگ باید به یک اتصال اشاره کند لازم دارید.

آیا می‌توانم از هر آدرسی به X-CDN-Client-IP اعتماد کنم؟

فقط وقتی مبدأ شما جز از CDN هیچ ترافیکی نپذیرد و با یک سرآیند محرمانه یا mTLS قفل شده باشد. اگر مستقیم بتوان به مبدأ رسید، هر کسی می‌تواند آن سرآیند را بفرستد، پس آن را به آدرس‌های edge هم محدود کنید.

آدرس‌های edge را که باید به آن‌ها اعتماد کنم از کجا بگیرم؟

آدرس‌های فعلی سرورهای edge متصل به حساب شما را در صورت درخواست به شما اعلام می‌کنیم. مبدأ را با سرآیند محرمانه یا mTLS هم قفل کنید تا حفاظت شما به به‌روز نگه داشتن یک فهرست وابسته نباشد.