This is an automated archive made by the Lemmit Bot.
The original was posted on /r/selfhosted by /u/hhftechtips on 2025-05-19 12:53:35+00:00.
Hey everyone,
It's been an exciting journey since we first introduced Middleware Manager to simplify adding custom protections to your Pangolin deployments. We then took a major leap in v2.0.0, making it independent by allowing direct connections to the Traefik API, benefiting any Traefik user.
(Links to previous posts can be seen here " Our v1 Journey | v2.0.0 Announcement")
Today, we're absolutely thrilled for Middleware Manager v3.0.0! This is our most ambitious update yet, evolving Middleware Manager into a comprehensive control plane for your Traefik setup by adding full Traefik Service Management and a brand new Traefik Plugin Hub.
The Evolution: From Pangolin Helper to Traefik Powerhouse
- v1.x Rewind: Middleware Manager started as a specialized microservice to bridge the gap for Pangolin users, making it easy to attach custom Traefik middlewares (like Authelia, Basic Auth, Security Headers) to individual resources that Pangolin created. The goal was simple: enhance security and customization without manually wrestling with Traefik dynamic configuration files.
- v2.0.0 - : We listened to the broader Traefik community! v2.0.0 introduced the ability to connect directly to the Traefik API. This meant you no longer needed Pangolin to leverage Middleware Manager's user-friendly interface for middleware management. It became a valuable tool for any Traefik deployment, alongside UI improvements like Dark Mode and enhanced router controls (Priority, TCP SNI, TLS SANs, Custom Headers).
- v3.0.0 - Full Spectrum Traefik Management: We're not stopping there! With v3.0.0, Middleware Manager now empowers you to:
- Master Your Traffic Flow with Custom Traefik Services: Go beyond default service routing. Now you can create, update, and manage sophisticated Traefik service definitions (LoadBalancer, Weighted, Mirroring, Failover) directly within the UI and assign them to your resources. This gives you granular control over how traffic is distributed to your backends, including health checks and sticky sessions for various protocols (HTTP, TCP, UDP).
- Unlock a Universe of Functionality with the Traefik Plugin Hub: Traefik's plugin ecosystem is rich and constantly growing. The new Plugin Hub in Middleware Manager allows you to browse available plugins, install or remove them with a click (by managing declarations in your Traefik static configuration file), and then easily configure them as middlewares.
Key Highlights of v3.0.0:
- Full Traefik Service Management:
- CRUD Operations: Create, view, edit, and delete custom Traefik services (
LoadBalancer,Weighted,Mirroring,Failover). - Protocol Support: Configure services for HTTP, TCP, and UDP backends within LoadBalancers.
- Assign to Resources: Override default service routing by assigning your custom services to specific resources.
- Template Library:
templates_services.yamlprovides a starting point for common service configurations, which are loaded into the database on first run. - Dynamic Configuration: Your custom service definitions are automatically generated into Traefik's dynamic configuration files.
- CRUD Operations: Create, view, edit, and delete custom Traefik services (
- Integrated Traefik Plugin Hub:
- Discover & Install: Browse a list of available Traefik plugins (fetched from a configurable JSON URL).
- One-Click Management: Install or remove plugins by having Middleware Manager update your Traefik static configuration file (
traefik.ymlortraefik.toml). A Traefik restart is required for these changes to take effect. - Configuration Path Management: Set and update the path to your Traefik static configuration file directly from the UI (environment variable
TRAEFIK_STATIC_CONFIG_PATHrecommended for persistence). - Seamless Usage: Once a plugin is installed and Traefik restarted, configure it as a standard middleware of type
pluginin the Middleware Manager UI.
- Backend & Engine Enhancements:
- Robust fetchers and watchers for both resources and the new services.
ConfigGeneratornow intelligently includes custom service definitions and ensures correct provider references.- Database schema updated to support service definitions and their relationships with resources.
- UI/UX Refinements:
- New dedicated sections for "Services" and "Plugin Hub".
- Service selection modals integrated into the "Resource Detail" page.
- Contexts and API service layers expanded for new functionalities.
- Continued improvements to overall usability and dark mode.
- Comprehensive Documentation:
- Our
README.mdhas been updated with new Docker Compose examples (including a full Pangolin stack), detailed usage guides for service and plugin management, and troubleshooting tips.
- Our
Why This Matters:
Middleware Manager v3.0.0 aims to be your central hub for fine-tuning how Traefik handles your traffic.
- For Pangolin Users: You get even more control over the services that Pangolin helps you deploy, layering on custom routing and backend behaviors.
- For Standalone Traefik Users: Middleware Manager is now an even more compelling alternative for managing complex Traefik setups without diving deep into YAML files for every change, especially for middlewares, custom service definitions, and plugin declarations.
How It Works (A Quick Refresher & Update):
- Data Source Connection: Middleware Manager connects to your chosen data source (Pangolin or Traefik API) to discover existing routers/resources and services.
- UI Management: You use the web UI to:
- Create/edit middlewares (from templates or custom).
- Create/edit Traefik services (e.g., a LoadBalancer with specific health checks).
- Install/Remove Traefik plugins (updates Traefik's static config).
- Configuration Generation:
- Middlewares & Services: Definitions are stored in Middleware Manager's database and written to dynamic Traefik configuration files (e.g.,
resource-overrides.ymlin the/confdirectory). - Plugins: Declarations are written to your main Traefik static configuration file.
- Middlewares & Services: Definitions are stored in Middleware Manager's database and written to dynamic Traefik configuration files (e.g.,
- Traefik Applies Changes:
- Traefik watches its dynamic configuration directory and applies middleware/service changes automatically.
- Traefik requires a restart to load new plugins or reflect the removal of plugin declarations from its static configuration.
- Resource Association: When you assign middlewares or custom services to a resource (router), Middleware Manager updates the router's configuration in the dynamic files to reference them correctly (e.g.,
middlewares: my-auth@file, my-headers@file,service: my-custom-lb@file).
Get v3.0.0 & Dive In!
We're incredibly excited for you to try out these new capabilities. Head over to our GitHub repository for the latest release and the updated README.md:
https://github.com/hhftechnology/middleware-manager
(Ensure you're pulling the latest tag or the upcoming v3.0.0 release tag )
Your feedback has been instrumental in shaping Middleware Manager. If you encounter any issues, have suggestions, or just want to share how you're using it, please join our GitHub Discussions or our Discord server.
Thank you for being part of this journey. We believe v3.0.0 makes Middleware Manager an indispensable tool for anyone looking to get the most out of their Traefik proxy.
Thank You.
List of Traefik Plugins we support
=====================================
Statiq - Webserver Plugin for Traefik v3
TLSGuard - Authentication Plugin for Traefik v3
[hhftechnology/tlsguard: TLS...
Content cut off. Read original on https://old.reddit.com/r/selfhosted/comments/1kqaxwj/middleware_manager_v300_total_traefikpangolin/