Traefik Service Management (Go & React):
- Added backend logic (models, handlers, fetcher, watcher, config generator) for creating, reading, updating, deleting, and assigning custom Traefik services (LoadBalancer, Weighted, Mirroring, Failover).
- Implemented new UI components (ServicesList, ServiceForm, ServiceSelectModal in ResourceDetail) for managing services and assigning them to resources.
- Service configurations are now loaded from templates_services.yaml and persisted in the database.
- The config generator now includes a services section in the dynamic Traefik configuration.
Traefik Plugin Hub (Go & React):
- Added backend API endpoints to list available plugins (from a configurable JSON URL), install/remove plugins by modifying Traefik's static configuration file, and manage the path to this static config.
- Implemented a "Plugin Hub" page in the UI allowing users to browse, install, and remove plugins.
- Added TRAEFIK_STATIC_CONFIG_PATH and PLUGINS_JSON_URL environment variables for configuration.
Backend Enhancements:
- main.go: Updated to initialize and start the new ServiceWatcher, and to load service templates. Corrected ServiceInterval usage. Passes static config path and plugins URL to API server.
- ConfigManager: Now handles TRAEFIK_STATIC_CONFIG_PATH.
- ConfigGenerator: Now processes and includes custom service definitions in the generated resource-overrides.yml.
- ResourceFetcher and ServiceFetcher: Refined to handle different data source types (Pangolin, Traefik API) more robustly for both resources and services.
- Database migrations updated for services and resource_services tables.
- Models for Service, TraefikService, and plugin structures introduced.
Frontend Enhancements:
- New contexts (ServiceContext, PluginContext) and updates to AppContext and api.js service layer.
- New UI components for service and plugin management.
- Improved error handling and loading states across relevant components.
- Enhanced ResourceDetail page to include service assignment and more detailed configuration modals.
- Updated main.css for new components and improved dark mode compatibility.
Documentation (README.md):
- Fully rewritten to include detailed information and examples for the new Service Management and Plugin Hub features.
- Updated Docker Compose examples, including a more comprehensive Pangolin stack example.
- Clarified environment variables and configuration steps.
Added styles in main.css the were missing for dark mode by @oidebrett in #28
Traefik int by @oidebrett in #30
Traefik Services by @hhftechnology in #34
Integrate Traefik Services and Plugin Management by @hhftechnology in #35
Integrate Traefik Services and Plugin Management by @hhftechnology in #36

New Contributors

@oidebrett made their first contribution in #28

Contributors

oidebrett and hhftechnology

Assets 2

29 Apr 07:13

hhftechnology

v2.0.0

6f1d414

v2.0.0

Middleware Manager v2.0.0 Release Documentation

Release Date: April 29, 2025

Overview

We are excited to announce the release of Middleware Manager v2.0.0, which introduces significant architectural improvements and new features, most notably the ability to operate completely independently of Pangolin by connecting directly to the Traefik API.

This major update transforms the Middleware Manager into a versatile tool suitable for any Traefik deployment, whether as part of the Pangolin stack or as a standalone service with any Traefik instance.

Key New Features

Dual Data Source Architecture

Traefik API Integration: Connect directly to Traefik's API without requiring Pangolin
Runtime Switching: Toggle between Pangolin and Traefik data sources through the UI
Connection Testing: Built-in connection testing for both data sources
Auto-Discovery: Attempts to automatically locate Traefik API endpoints

Enhanced Configuration Management

Config.json Support: External configuration file for data source settings
Environment Variable Control: Set the active data source via environment variables
Persistent Settings: Data source configurations are saved across restarts

Improved Router Configuration

Enhanced TCP SNI Routing: Better support for TCP services with custom SNI rules
TLS Certificate Management: Configure additional Subject Alternative Names (SANs)
Router Priority Management: Control precedence when multiple routers match
Custom Headers Configuration: Add custom headers to backend service requests

User Interface Improvements

Dark Mode Support: Toggle between light and dark themes
Data Source Settings Panel: Manage connections through a dedicated UI
Connection Status Indicators: Visual feedback for data source connectivity
Improved Error Messages: Better troubleshooting information

Breaking Changes

Default File Paths: The default file paths for configuration have changed. If you used custom paths, you may need to update your volume mappings.
Router IDs: The format of router IDs generated by the Middleware Manager has changed. This will not affect existing setups but may impact any scripts or tools that interact with the generated configuration files.

Upgrade Instructions

Docker Compose

Update your docker-compose.yml file:

middleware-manager:
  image: hhftechnology/middleware-manager:latest  # No change to image reference
  container_name: middleware-manager
  restart: unless-stopped
  volumes:
    - ./data:/data
    - ./config/traefik/rules:/conf
    - ./config/middleware-manager/templates.yaml:/app/config/templates.yaml  # Optional
    - ./config/middleware-manager/config.json:/app/config/config.json  # New volume for config
  environment:
    - PANGOLIN_API_URL=http://pangolin:3001/api/v1
    - TRAEFIK_API_URL=http://traefik:8080  # New environment variable
    - TRAEFIK_CONF_DIR=/conf
    - DB_PATH=/data/middleware.db
    - PORT=3456
    # Optional: Set default data source
    # - ACTIVE_DATA_SOURCE=traefik
  ports:
    - "3456:3456"

Manual Installation

Stop your existing Middleware Manager instance
Back up your database and configuration files
Update to the latest version
Create a config.json file if you want to use the Traefik API
Start the Middleware Manager with updated environment variables

Migration Notes

Moving from Pangolin to Standalone Traefik

If you want to use the Middleware Manager with a standalone Traefik instance:

Create a config.json file in your configuration directory:

{
  "active_data_source": "traefik",
  "data_sources": {
    "traefik": {
      "type": "traefik",
      "url": "http://traefik:8080",
      "basic_auth": {
        "username": "",
        "password": ""
      }
    }
  }
}

Update your environment variables to include ACTIVE_DATA_SOURCE=traefik
Ensure your Traefik instance has the API enabled
Start the Middleware Manager and verify the connection in the settings panel

Database Compatibility

The database schema has been updated to support the new features. The Middleware Manager will automatically migrate your existing database on startup.

Fixed Issues

Fixed empty string handling in header middleware configurations
Fixed router priority not being properly applied in generated configurations
Fixed issues with TCP SNI router generation
Improved connection error handling and reporting
Resolved issues with middleware ordering and chaining

Known Issues

When switching between data sources, you may need to refresh the browser to see the updated resource list
Some complex middleware configurations may require manual adjustment
Very large installations may experience performance issues when loading many resources