kubefwd (Kube Forward)

Dokümantasyon | Başlarken | Kullanıcı Rehberi | API Referansı | MCP (AI Entegrasyonu)

Yerel Olarak Geliştirin, Kubernetes'e Bağlanın

kubefwd, geliştiricilerin yerel bilgisayarlarında çalışırken bir Kubernetes kümesinde çalışan servislere sorunsuz bir şekilde erişmelerini sağlar. db:5432 adresinde bir database, auth:443 adresinde bir auth servisi ve redis:6379 adresinde bir cache ile bağlantı kurmak isteyen yeni bir API geliştiriyorsanız ve bunların tümü geliştirme kümenizde çalışıyorsa, kubefwd bunları yerel olarak servis isimleriyle, tam olarak küme içinde görüneceği şekilde kullanılabilir hale getirir. Ortama özel konfigürasyon yok, yerel servis kurulumu yok, Docker Compose dosyaları yok. Sadece kubefwd çalıştırın ve uygulamanızın mevcut bağlantı stringleri çalışır.

Bu temel kullanım durumudur: yerel geliştirme sırasında ortama özel bağlantı kurulumunu ve konfigürasyonları azaltın veya tamamen ortadan kaldırın. Kodunuz production ortamında http://api-gateway:8080 kullanıyorsa? kubefwd ile dizüstü bilgisayarınızda da aynı şekilde çalışır.

Interactive TUI ile toplu Kubernetes port forwarding, servis başına benzersiz IP'ler ve otomatik yeniden bağlantı.

kubefwd Kubernetes servislerini yerel çalışma istasyonunuza toplu olarak port forward eden bir komut satırı aracıdır. Her servis kendi benzersiz loopback IP'sini (127.x.x.x) alır; bu sayede port çatışmaları ortadan kalkar ve küme servisleriyle isimle erişilebilen gerçekçi yerel geliştirme mümkün olur.

Hızlı Başlangıç

# Kurulum (macOS)
brew install kubefwd

# Namespace'deki tüm servisleri interactive TUI ile forward edin
sudo -E kubefwd svc -n my-namespace --tui

Yardım için ?, çıkmak için q tuşlarına basın. Detaylı kurulum ve ayarlar için Başlarken kısmına bakın.

Nasıl Çalışır?

kubefwd namespace'deki servisleri keşfeder, her birine benzersiz loopback IP atar, /etc/hosts dosyasını servis isimleriyle günceller ve Kubernetes API üzerinden port forward bağlantıları kurar. Servislere tam olarak küme içinde olduğu gibi isimle erişin:

curl http://api-service:8080
mysql -h database -P 3306
redis-cli -h cache -p 6379

Özellikler

• Interactive TUI: Gerçek zamanlı servis monitoring ve trafik metrikleri
• Servis Başına Benzersiz IP: Her servis kendi 127.x.x.x adresini alır
• Otomatik Yeniden Bağlantı: Pod'lar yeniden başladığında veya bağlantı kesildiğinde yeniden bağlanır
• Toplu Forwarding: Bir komutla namespace'deki tüm servisleri forward edin
• Canlı Trafik Monitoring: Byte in/out ve HTTP aktivitesini görün
• Pod Log Streaming: TUI'de container loglarını görüntüleyin
• REST API: HTTP endpoint'leri aracılığıyla programlı kontrol
• MCP Desteği: AI asistanlarıyla entegrasyon (Claude Code, Cursor)

Kurulum

macOS:

brew install kubefwd

Linux: releases sayfasından .deb, .rpm veya .tar.gz indiriniz

Windows:

winget install txn2.kubefwd
# veya
scoop install kubefwd

Docker:

docker run -it --rm --privileged \
  -v "$HOME/.kube:/root/.kube:ro" \
  txn2/kubefwd services -n my-namespace --tui

Kullanım

# Interactive mod (önerilen)
sudo -E kubefwd svc -n default --tui

# Birden çok namespace
sudo -E kubefwd svc -n default,staging --tui

# Label'a göre filtreleme
sudo -E kubefwd svc -n default -l app=api --tui

# REST API etkinleştirilmiş halde
sudo -E kubefwd svc -n default --tui --api

Neden kubefwd?

kubectl port-forward aksine, kubefwd:

Özellik	kubectl port-forward	kubefwd
Komut başına servis sayısı	Bir	Namespace'deki tümü
IP tahsisi	Sadece localhost	Servis başına benzersiz IP
Port çatışmaları	Manuel yönetim	Yok (benzersiz IP'ler)
Servis adı çözümleme	Desteklenmez	Otomatik (/etc/hosts)
Otomatik yeniden bağlantı	Hayır	Evet
Gerçek zamanlı monitoring	Hayır	TUI ile metrikler

Telepresence, mirrord ve diğer araçlarla detaylı karşılaştırmalar için Karşılaştırma bölümüne bakın.

Dokümantasyon

Tam dokümantasyon kubefwd.com adresinde:

• Başlarken - Kurulum ve ayarlar
• Kullanıcı Rehberi - Arayüz ve kısayollar
• Konfigürasyon - CLI seçenekleri
• Gelişmiş Kullanım - Çok kümeli, seçiciler
• REST API - API referansı
• MCP Entegrasyonu - AI asistan kurulumu
• Sorun Giderme - Sık karşılaşılan sorunlar
• Mimari - Teknik detaylar
• Karşılaştırma - Telepresence, mirrord ile karşılaştırma

Gereksinimler

• kubectl configured with cluster access
• Root/sudo erişimi (/etc/hosts ve network interface'leri için)

Katkı Sağlama

Hata düzeltmeleri, testler ve dokümantasyon için katkıları memnuniyetle karşılıyoruz. Özellik geliştirmesi yalnızca bakıcılarla sınırlıdır. CONTRIBUTING.md dosyasına bakınız.

Lisans

Apache License 2.0

---

Craig Johnston tarafından açık kaynak, Deasil Works, Inc. tarafından desteklenmiştir.