Skip to main content
drupalreleases

Use direct release data with your AI assistant.

Learn more

Reverse Proxy Header

Security covered Maintenance fixes only 2,202 sites

This module allows you to specify a custom HTTP header that contains the client's real IP address. This is useful when your reverse proxy or CDN uses a non-standard header for this information.

This module is the simplest way to use the specific HTTP header name to determine the client IP.

The module provides an equivalent of reverse_proxy_header setting (which is deprecated from Drupal 8.7.0).

The most common usage is:

  • real client IP is stored in some custom (non-default) header;
  • you cannot affect this on reverse proxy or server sides.

The module does not provide any UI. How to use it:
Step 1) Install the module via composer and enable it.
Step 2) Add the `reverse_proxy_header` configuration to your setting.php file:

/**
 * Sets the HTTP header name which stores the real client IP.
 *
 * @see https://www.drupal.org/project/reverse_proxy_header
 */
$settings["reverse_proxy_header"] = "HTTP_X_FORWARDED_FOR_CUSTOM_HEADER";

Here is an example for setting.php file to configure the module to use Cloudflare header only for some instances:

/**
 * Reverse Proxy Header module configuration.
 *
 * Determines the specific header name for some environments only.
 * And skips for others.
 *
 * @see https://www.drupal.org/project/reverse_proxy_header
 */
if (getenv("ENVIRONMENT_SPECIFIC_VARIABLE") === "value") {
  $settings["reverse_proxy_header"] = "HTTP_CF_CONNECTING_IP";
}

What about available alternatives?

  1. rename the header name (or copy its value) to the supported header HTTP_X_FORWARDED_FOR on proxy or server side;
  2. copy the value from the custom header to $_SERVER['HTTP_X_FORWARDED_FOR'] in your index.php before Drupal initialization;

πŸ‡ΊπŸ‡¦

This module is maintained by Ukrainian developers.
Please consider supporting Ukraine in a fight for their freedom and safety of Europe.
Drupal 10–11

Ask your assistant about Reverse Proxy Header

Check compatibility with your Drupal and PHP version, maintenance and security coverage, from current release data. How it works

Depends on

Dependencies of the latest stable release

No dependencies recorded for this project.

Required by

Tracked projects that depend on this one

No tracked projects depend on this one yet.

Activity

Tracked releases
5
Tracked since
Jul 2023
Latest release
1 year ago
Releases (12 mo)
0 ▼ from 4
Maintenance
Active

Release Timeline

Releases

Version Type Core PHP Release date
1.1.2 Stable 10–11 Sep 24, 2025
1.1.1 Stable 10–11 Jan 9, 2025
1.1.0 Stable 10–11 Jan 9, 2025
1.1.x-dev Dev 10–11 Jan 9, 2025
1.0.1 Stable 9–10 Jul 7, 2023