Use X-Forwarded-For headers on Magento

Use X-Forwarded-For headers on Magento

August 25, 2026 · Illustrated author avatarBy Stefan Bogdanescu
Use X-Forwarded-For headers on Magento

Understanding X-Forwarded-For Headers and Magento

The Challenge of Client IP Addresses with Google Page Speed and Magento

When implementing Google Page Speed to serve your Magento site, you may face a common challenge - losing visibility into the actual client IP addresses for user requests. This concern is valid as it can potentially impact core website functionalities like login/logout and checkout processes, as well as analytics tracking.

The Role of X-Forwarded-For Headers

To mitigate this issue, you may consider setting up X-Forwarded-For headers in either your Apache configuration or PHP environment. These headers allow the true client IP address to be passed through multiple proxies without being obfuscated by the Google Page Speed setup.

The Limitations of Your Host’s Approach with mod_rpaf

Your hosting provider is correct that using mod_rpaf typically requires knowledge of the forwarding servers, which Google does not provide. This makes it impossible to configure a list of servers for the module to process.

Setting Up X-Forwarded-For Headers in PHP

Given your host’s constraints with Apache, the next viable option is setting up X-Forwarded-For headers within your Magento environment using PHP. Here’s how you can achieve this:

  1. Access your Magento root directory via SFTP or SSH.

  2. Open or create a file named index.php (if it doesn’t exist already). Ensure you have a backup of the current file before proceeding with any modifications.

  3. Locate and add the following PHP snippet just above the line containing // {{{ Mage::run($mageRunCode, $mageRunType); }}:

$ip = getenv('HTTP_X_FORWARDED_FOR');
if ($ip !== null && strpos($ip, ', ') !== false) {
    $ips = explode(', ', $ip);
    $ip = trim($ips[0]);
}
else {
    $ip = getenv('REMOTE_ADDR');
}

$_SERVER['REMOTE_ADDR'] = $ip;
  1. Save the changes and upload the modified index.php file back to your server, replacing the existing one.

Utilizing Magento’s Session Validation Settings

You also mentioned the ‘Validate HTTP_X_FORWARDED_FOR’ setting in the Magento Admin (System > Configuration > Web > Session Validation Settings). Changing this to ‘Yes’ would indeed help in validating the X-Forwarded-For header information, adding an additional layer of security.

Conclusion: Ensuring Client IP Addresses in Your Magento Setup

By following these steps and setting up X-Forwarded-For headers in your PHP environment, you can preserve the visibility into your users’ actual client IP addresses. This ensures that essential Magento functionalities like user authentication and checkout processes remain unaffected by the Google Page Speed integration.

Remember to always test your implementation thoroughly after making any modifications to ensure it aligns with your specific setup and requirements.

Happy coding!

Checkout Performance Extensions Configuration

Our network