txn2/kubefwd
Kubefwd
kubefwd es una utilidad de túnel de red y reenvío de servicios de Kubernetes que mapea servicios de clúster remotos a direcciones de loopback locales. Sincroniza el archivo hosts local para resolver nombres de servicios de Kubernetes a direcciones IP locales, permitiendo que los entornos de desarrollo locales usen nombres de host de producción.
El proyecto implementa un servidor de Model Context Protocol, permitiendo a asistentes de IA externos descubrir, navegar y controlar el reenvío de red a través de una interfaz estandarizada. También proporciona una interfaz de usuario de terminal para gestionar reenvíos de servicios, monitorear el tráfico de red en tiempo real y transmitir logs de pods.
El sistema maneja la gestión de conexiones multiclúster, enrutamiento de servicios headless y persistencia de conexión automatizada usando sincronización basada en eventos y retroceso exponencial (exponential backoff). Incluye una API REST para el control programático de namespaces y registros de servicios, junto con herramientas para diagnosticar problemas de conexión e inspeccionar el estado de los pods.
La utilidad puede desplegarse como un contenedor privilegiado o mediante Docker Compose para gestionar interfaces de red locales y modificaciones de archivos de host.
Features
- Loopback DNS Overrides - Assigns unique local IP addresses to remote services and synchronizes the hosts file to mimic cluster DNS.
- Local Development Environments - Enables local application code to connect to remote Kubernetes services using production hostnames.
- Service Port Forwarding - Maps remote Kubernetes services to unique local IP addresses and updates the hosts file for seamless access.
- Event-Driven Synchronization - Automatically synchronizes network tunnels by watching real-time Kubernetes cluster events.
- Hostname Configurations - Ensures cluster services are reachable using production hostnames by defining custom domain names and network protocols.
- Local Hosts File Management - Appends domain suffixes to hostnames and modifies the local hosts file to enable service name resolution.
- DNS-Based Service Discovery - Mimics in-cluster DNS by mapping Kubernetes service names to unique local loopback IP addresses.
- Local Hostname Assignments - Allows assigning specific IP addresses or domain suffixes to generated hostnames for easier local service discovery.
- Local DNS Mapping - Automatically synchronizes the local hosts file to resolve Kubernetes service names to local IPs.
- Cluster Network Troubleshooting - Provides a suite of tools for diagnosing connectivity and monitoring traffic between local machines and clusters.
- Kubernetes Pod Port Forwarding - Establishes bidirectional TCP tunnels between local ports and remote Kubernetes service endpoints.
- Local Port Mapping - Maps local ports to remote Kubernetes service endpoints for tunneling traffic.
- Network Resource Discovery - Queries available cluster contexts, namespaces, and services to identify targets for network tunneling.
- Kubernetes Service Domain Resolutions - Resolves Kubernetes service names to local loopback addresses via automated hosts file synchronization.
- Automatic Connection Recovery - Re-establishes port forwards with exponential backoff when pods restart or churn by monitoring cluster events.
- Bulk Service Forwarding - Maps multiple remote services to local loopback addresses using service names to avoid port conflicts.
- Event-Driven State Synchronization - Automatically synchronizes port forwards by watching Kubernetes cluster events to start or stop connections as services and pods change.
- Service Loopback Forwarders - Maps remote Kubernetes services to local loopback addresses to enable local development with production hostnames.
- Service Tunnels - Establishes bidirectional network tunnels between local ports and remote Kubernetes service endpoints.
- Tunnel Connection Persistence - Re-establishes broken tunnels using pod lifecycle event watches and exponential backoff during network outages.
- AI Assistant Integrations - Implements a standardized interface allowing AI assistants to discover and control network forwarding services.
- Model Context Protocol Integrations - Uses the Model Context Protocol to expose network forwarding functions and cluster data to external AI models.
- Model Context Protocol Servers - Implements a standardized server interface that exposes network forwarding controls to AI assistants.
- REST APIs - Provides a REST API for programmatically updating active services and integrating with AI assistants.
- Resource Browsers - Allows selecting specific services for forwarding by browsing cluster namespaces through a terminal user interface.
- AI-Assisted DevOps - Implements a Model Context Protocol server to automate network forwarding tasks through AI assistants.
- Connectivity Control APIs - Exposes programmatic endpoints to add namespaces, register services, and query real-time connection metrics.
- Control Plane APIs - Provides a REST-based control plane for managing namespace watchers and forwarding states.
- TUI Resource Explorers - Provides a terminal-based resource explorer for browsing namespaces and managing active service forwards.
- Context Management - Toggles between different Kubernetes environment configurations to manage service forwarding across remote targets.
- Multi-Cluster Dashboard Managers - Allows switching between and managing network tunnels for multiple Kubernetes clusters from a single interface.
- Forwarding Traffic Logging - Streams live pod logs while tracking HTTP request metadata and bandwidth metrics for active network forwards.
- Container IP Assignments - Assigns fixed local IP addresses to remote services via configuration or command-line flags.
- Multi-Cluster Forwarding Management - Enables simultaneous connections to multiple environments to forward services from different remote clusters.
- Headless Pod Routing - Forwards traffic to all pods backing a service to enable pod-specific addressing for StatefulSets and databases.
- Headless Service Forwarding - Routes traffic to all pods backing a service or targets specific pods using unique pod hostnames.
- Local Port Remapping - Maps cluster service ports to specific local ports to avoid conflicts or bypass privileged port restrictions.
- Forwarding Target Selectors - Allows selecting specific services to forward using namespaces, label selectors, or metadata fields.
- Exponential Backoff Retries - Implements exponential backoff retries to automatically restore broken network tunnels during pod churn.
- Kubernetes Resource Browsers - Provides an interactive interface to browse Kubernetes namespaces and services to select forwarding targets.
- Privileged Container Execution - Runs as a privileged container to manage host network interfaces and modify the local hosts file.
- Active Connection Monitors - Provides a TUI for managing active port forwards and viewing real-time connection status.
- Forwarding Connection Managers - Provides a terminal interface to browse namespaces and manage active network connections.
- REST Management APIs - Offers a REST management API to control the addition, removal, and reconnection of service forwards.
- Tunnel Throughput Monitoring - Tracks byte counts and request rates for forwarded traffic using sparkline visualizations.
- Real-Time Traffic Monitoring - Displays real-time network traffic metrics and byte throughput via a terminal user interface.
- Forwarding Health Metrics - Provides real-time and historical metrics and HTTP traffic captures for active network forwards.
- Traffic Monitoring Tools - Tracks bandwidth statistics and HTTP request metadata for all active service forwards.
- Terminal-Based Dashboards - Features a terminal-based dashboard for streaming real-time network metrics and pod logs.
- Interactive Terminal Interfaces - Provides an interactive TUI to filter services, monitor bandwidth, and stream logs for active forwards.
- Cloud Platforms - Listed in the “Cloud Platforms” section of the Awesome Mcp Servers awesome list.
- Developer Workspaces - Bulk forwards Kubernetes services for local development.
- Developer Productivity Tools - Bulk port forwarding for Kubernetes services during development.
