kubefwd

kubefwd（Kube Forward）

文档 | 快速入门 | 用户指南 | API 参考 | MCP（AI 集成）

在本地开发，连接到 Kubernetes

kubefwd 让开发者能够在本地机器上工作，同时无缝访问 Kubernetes 集群中运行的服务。例如，你正在构建一个新 API，它需要连接到 db:5432 上的数据库、auth:443 上的身份验证服务，以及 redis:6379 上的缓存，这些服务都运行在你的开发集群中。kubefwd 会让它们在本地通过服务名称访问，和在集群内部时完全一样。无需针对不同环境配置，无需设置本地服务，也无需 Docker Compose 文件。只需运行 kubefwd，应用现有的连接字符串即可正常工作。

这是其核心用途：减少或消除本地开发中针对不同环境的连接设置和配置。生产环境中代码使用 http://api-gateway:8080？借助 kubefwd，在你的笔记本电脑上也能以相同方式使用。

批量转发 Kubernetes 端口，提供交互式 TUI、每个服务独有的 IP，以及自动重新连接功能。

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 重启或连接断开时自动重新连接
• 批量转发：通过一条命令转发命名空间中的所有服务
• 实时流量监控：查看传入和传出字节数以及 HTTP 活动
• Pod 日志流：在 TUI 中查看容器日志
• REST API：通过 HTTP 端点进行程序化控制
• MCP 支持：与 AI 助手集成（Claude Code、Cursor）

安装

macOS：

brew install kubefwd

Linux： 从 releases 下载 .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
每条命令处理的服务	一个	命名空间中的全部服务
IP 分配	仅 localhost	每个服务使用唯一 IP
端口冲突	手动管理	无（使用唯一 IP）
服务名称解析	不支持	自动处理（/etc/hosts）
自动重新连接	否	是
实时监控	否	带指标的 TUI

请参阅比较，了解与 Telepresence、mirrord 及其他工具的详细比较。

文档

完整文档请访问 kubefwd.com：

• 入门指南 - 安装和设置
• 用户指南 - 界面和快捷键
• 配置 - CLI 选项
• 高级用法 - 多集群、选择器
• REST API - API 参考
• MCP 集成 - AI 助手设置
• 故障排除 - 常见问题
• 架构 - 技术细节
• 比较 - 与 Telepresence、mirrord 的比较

要求

• 已配置 kubectl 并具有集群访问权限
• Root/sudo 访问权限（用于 /etc/hosts 和网络接口）

参与贡献

欢迎提交错误修复、测试和文档方面的贡献。功能开发仅限维护者参与。请参阅 CONTRIBUTING.md。

许可证

Apache License 2.0

---

由 Craig Johnston 开源，赞助方为 Deasil Works, Inc.