# TraefikShaper

TraefikShaper is a self-hosted network services app. Docker container to manipulate Traefik's IpAllowList middleware for dynamic IP whitelisting It is open source and self-hosted, installable on Proxmox, Docker Hub and Unraid.

Canonical page: https://ourlocalhost.com/app/2400/traefikshaper

## Description

Docker container to manipulate Traefik's IpAllowList middleware for dynamic IP whitelisting

## Platform availability

Available on 2 of 10 platforms: Unraid, Proxmox.

## Health score

37/100 (Low), based on 4 of 5 factors.
- Maintained: 17 (last commit 561 days ago)
- Popular: 33 (44 GitHub stars)
- Easy to install: 35 (1 install platform, install notes, Docker image)
- Security check: 85 (no serious findings, CI)

## Links

- GitHub: https://github.com/l4rm4nd/TraefikShaper
- Proxmox: https://community-scripts.github.io/ProxmoxVE/scripts?id=traefik
- Official website: https://blog.lrvt.de/traefikshaper/
- Docker Hub: https://hub.docker.com/r/l4rm4nd/traefikshaper
- Unraid: https://ca.unraid.net/apps/traefikshaper-1j6szlw11s3tjs?q=TraefikShaper

## Common questions

### What Traefik provider setting is required before using TraefikShaper?

You need to enable and use Traefik’s dynamic configuration files via the file provider.

### Where is the dynamic IP whitelist stored?

It is stored in a custom Traefik dynamic configuration file named dynamic-ipwhitelist.yml. That file is bind-mounted into the Flask container so it can be changed by the application.

### Do I need to restart Traefik after an IP is added or removed?

No. Traefik monitors the dynamic configuration file for changes and applies them without restarting Traefik or the containers behind it.

### How does an external client request temporary access?

The client requests the /knock-knock endpoint, which generates an approval link based on its IP address. That link is sent to the admin through a configured Apprise notification channel.

---
Source: Our Local Host (https://ourlocalhost.com/app/2400/traefikshaper), the self-hosted and open-source app directory.
