gitwtfhub

wtf is traefik-cloudflarewarp-plugin?

n8n-io/traefik-cloudflarewarp-plugin — explained in plain English

Analysis updated 2026-07-17 · repo last pushed 2026-04-01

2GoAudience · ops devopsComplexity · 3/5MaintainedSetup · moderate

TL;DR

A Traefik plugin that restores real visitor IP addresses when your site sits behind Cloudflare, so logs and analytics show actual users instead of Cloudflare's servers.

Mindmap

mindmap
  root((repo))
    What it does
      Fixes hidden client IPs
      Reads CF-Connecting-IP header
      Restores real IP to Traefik
      Fixes redirect loops
    Tech stack
      Go
      Traefik plugin system
      Cloudflare
    Use cases
      Accurate analytics
      Accurate logging
      Security checks
      Trusted IP list
    Audience
      Ops and DevOps
      Site operators
      Traefik users

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

See real visitor IPs in logs and analytics when Traefik sits behind Cloudflare.

REASON 2

Fix WordPress or app redirect loops caused by hidden HTTP/HTTPS info behind Cloudflare.

REASON 3

Apply security or rate-limiting rules based on actual client IPs, not Cloudflare's.

REASON 4

Use the built-in Cloudflare IP list instead of maintaining your own trusted-IP list.

What's in the stack?

GoTraefikCloudflare

How it stacks up

n8n-io/traefik-cloudflarewarp-pluginanomalroil/1keydanterolle/loqi
Stars222
LanguageGoGoGo
Last pushed2026-04-012019-05-17
MaintenanceMaintainedDormant
Setup difficultymoderatemoderatemoderate
Complexity3/53/52/5
Audienceops devopsops devopsdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · moderate Time to first run · 30min

Requires an existing Traefik + Cloudflare proxy/tunnel setup to plug into.

Yoink these prompts

Prompt 1
Help me add this Traefik plugin as middleware to a route in my Traefik configuration.
Prompt 2
Explain how CF-Connecting-IP works and why my Traefik logs only show Cloudflare IPs without this plugin.
Prompt 3
Show me how to disable the built-in Cloudflare IP list in this plugin and supply my own trusted IPs.
Prompt 4
Why is my WordPress site stuck in a redirect loop behind Traefik and Cloudflare, and how does this plugin fix it?

Frequently asked questions

wtf is traefik-cloudflarewarp-plugin?

A Traefik plugin that restores real visitor IP addresses when your site sits behind Cloudflare, so logs and analytics show actual users instead of Cloudflare's servers.

What language is traefik-cloudflarewarp-plugin written in?

Mainly Go. The stack also includes Go, Traefik, Cloudflare.

Is traefik-cloudflarewarp-plugin actively maintained?

Maintained — commit in last 6 months (last push 2026-04-01).

How hard is traefik-cloudflarewarp-plugin to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is traefik-cloudflarewarp-plugin for?

Mainly ops devops.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.