Skip to main content
drupalreleases

Use direct release data with your AI assistant.

Learn more

Trusted Proxy Headers Debug

No security coverage Maintenance fixes only 216 sites

This module helps debug and configure trusted proxy headers, essential for accurately detecting client IPs on sites behind proxies. It provides a report detailing proxy settings and how they affect incoming requests, aiding in proper configuration.

This is a developer / utility module to help with configuring and debugging Trusted Proxy Headers.

Initially it has a very no-frills UI.

It produces a report which shows what Reverse / Trusted Proxy configuration has been found in settings, along with the Trusted Headers which Drupal passes through to Symfony's Request handling code, and some of the properties of the Request which Symfony/Drupal derived using the current settings.

This might help set up - for example - proper detection of Client IPs for sites running behind proxies.

See:

  • \Drupal\Core\StackMiddleware\ReverseProxyMiddleware::setSettingsOnRequest
  • \Symfony\Component\HttpFoundation\Request::setTrustedProxies

By default the report at admin/reports/status/trusted_proxy_headers_debug is only accessible to users with the 'administer site configuration' permission.

It's possible to override this restriction with the following setting:

D8/9(/10?):

$settings['trusted_proxy_headers_debug_free_access'] = TRUE;

D7:

$conf['trusted_proxy_headers_debug_free_access'] = TRUE;

For D7 you could alternatively set the variable using drush, e.g.:

$ drush vset trusted_proxy_headers_debug_free_access 1

Be careful doing so :)

This is a basic tool with lots of room for improvement.

Drupal 8–10 · not 11

Ask your assistant about Trusted Proxy Headers Debug

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
2
Tracked since
Apr 2025
Latest release
9 months ago
Releases (12 mo)
1
Maintenance
Active

Releases

Version Type Core PHP Release date
1.1.x-dev Dev 8–11 Jan 14, 2026
8.x-0.5 Stable 8–10 Apr 7, 2025