kubefwd

kubefwd（Kube Forward）

ドキュメント | はじめに | ユーザーガイド | API リファレンス | MCP（AI 統合）

Kubernetes に接続してローカルで開発

kubefwd を使うと、開発者はローカルマシンで作業しながら、Kubernetes クラスターで実行中のサービスにシームレスにアクセスできます。開発クラスターで動作している db:5432 のデータベース、auth:443 の認証サービス、redis:6379 のキャッシュに接続する新しい API を構築する場合、kubefwd を使えばクラスター内と同じサービス名で、それらをローカルから利用できます。環境ごとの設定も、ローカルサービスのセットアップも、Docker Compose ファイルも必要ありません。kubefwd を実行するだけで、アプリケーションに既存の接続文字列をそのまま使えます。

これが重要なユースケースです。ローカル開発時の環境ごとに異なる接続設定や構成を削減、または不要にします。本番環境でコードが http://api-gateway:8080 を使っているなら、kubefwd を使えばノート PC でも同じように動作します。

インタラクティブな TUI、サービスごとの一意な IP、自動再接続に対応した Kubernetes の一括ポートフォワーディング。

kubefwd は、Kubernetes サービスのポートを一括でローカルワークステーションに転送するコマンドラインユーティリティです。各サービスに専用のループバック IP（127.x.x.x）が割り当てられるため、ポートの競合を解消し、サービス名でクラスターのサービスにアクセスできる、実環境に近いローカル開発が可能になります。

クイックスタート

# Install (macOS)
brew install kubefwd

# Forward all services in a namespace with the interactive TUI
sudo -E kubefwd svc -n my-namespace --tui

? を押すとヘルプが表示され、q を押すと終了します。インストールとセットアップの詳細については、はじめにをご覧ください。

仕組み

kubefwd は名前空間内のサービスを検出し、それぞれに一意なループバック IP を割り当て、サービス名を /etc/hosts に追加して、Kubernetes API 経由でポートフォワーディングを確立します。クラスター内と同じように、サービス名でアクセスできます。

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

機能

• インタラクティブな TUI：トラフィック指標付きのリアルタイムサービス監視
• サービスごとの一意な IP：各サービスに専用の 127.x.x.x アドレスを割り当て
• 自動再接続：Pod の再起動や接続切断時に再接続
• 一括フォワーディング：1 つのコマンドで名前空間内のすべてのサービスを転送
• リアルタイムのトラフィック監視：送受信バイト数と HTTP アクティビティを表示
• Pod ログのストリーミング：TUI でコンテナログを表示
• REST API：HTTP エンドポイントによるプログラムからの制御
• MCP サポート：AI アシスタント（Claude Code、Cursor）との統合

インストール

macOS:

brew install kubefwd

Linux: リリースから .deb、.rpm、または .tar.gz をダウンロードしてください

Windows:

winget install txn2.kubefwd
# or
scoop install kubefwd

Docker:

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

使用方法

# Interactive mode (recommended)
sudo -E kubefwd svc -n default --tui

# Multiple namespaces
sudo -E kubefwd svc -n default,staging --tui

# Filter by label
sudo -E kubefwd svc -n default -l app=api --tui

# With REST API enabled
sudo -E kubefwd svc -n default --tui --api

なぜ kubefwd なのか？

kubectl port-forward とは異なり、kubefwd は次のことができます。

機能	kubectl port-forward	kubefwd
コマンドあたりのサービス数	1つ	ネームスペース内のすべて
IP 割り当て	localhost のみ	サービスごとに固有の IP
ポート競合	手動管理	なし（固有の IP）
サービス名の解決	非対応	自動（/etc/hosts）
自動再接続	いいえ	はい
リアルタイム監視	いいえ	メトリクス付き TUI

Telepresence、mirrord、その他のツールとの詳細な比較については、比較をご覧ください。

ドキュメント

完全なドキュメントは kubefwd.com にあります。

• はじめに - インストールとセットアップ
• ユーザーガイド - インターフェースとショートカット
• 設定 - コマンドラインオプション
• 高度な使用方法 - マルチクラスター、セレクター
• REST API - API リファレンス
• MCP 統合 - AI アシスタントのセットアップ
• トラブルシューティング - よくある問題
• アーキテクチャ - 技術的な詳細
• 比較 - Telepresence、mirrord との比較

要件

• クラスターアクセスが設定された kubectl
• root/sudo アクセス（/etc/hosts およびネットワークインターフェース用）

コントリビューション

バグ修正、テスト、ドキュメントへのコントリビューションを歓迎します。機能開発はメンテナーに限定されています。詳細は CONTRIBUTING.md をご覧ください。

ライセンス

Apache License 2.0

---

Craig Johnston によるオープンソース、Deasil Works, Inc. がスポンサー