k3d-proxy 是 k3d 生态中的网络代理工具,专为本地 Kubernetes 开发环境设计,主要解决集群内外的网络通信问题。简单说,当你用 k3d 在本地启动 Kubernetes 集群后,容器内的服务如何暴露给宿主机访问,或集群如何连接外部数据库、API 服务,这些网络互通的事儿,它都能帮你搞定。
它最核心的能力是处理“端口映射”和“流量转发”。比如你在集群里部署了一个端口为 8080 的 Web 服务,直接访问肯定不行——容器网络和宿主机网络是隔离的。这时候 k3d-proxy 能自动把容器内的 8080 端口“映射”到宿主机的空闲端口,你在浏览器输入 localhost:端口号 就能直接访问服务,不用手动敲命令配转发规则。
反过来,如果集群里的应用要连本地数据库(比如宿主机跑的 MySQL),k3d-proxy 也能把集群内的请求“转发”到宿主机的数据库端口,省去在容器里改 hosts 或配网络的麻烦。
本地开发时,大家常遇到“端口冲突”问题——比如同时跑两个服务都想用 8080 端口。k3d-proxy 支持“动态端口分配”,会自动挑宿主机的空闲端口用,不用你手动记端口号或改配置。
多集群场景下更有用。如果你用 k3d 起了多个集群(比如一个测开发环境、一个测生产环境),k3d-proxy 能帮不同集群的服务互相通信,不用手动配网络打通;要是跑了多个微服务,它还能统一管理所有服务的端口映射,启动集群时自动生效,省得挨个服务配一遍。
它和 k3d 一样走轻量路线,不用额外装依赖,启动集群时顺带就能用。部分场景还支持 HTTPS 代理——比如测试服务的 HTTPS 访问时,不用自己搭证书,直接用它就能模拟安全连接。
实际用下来,k3d-proxy 就像个“网络小助手”,把复杂的网络配置藏在背后。开发者不用再纠结“端口被占了怎么办”“集群连本地服务咋配”,专心写代码就行。对经常折腾本地 K8s 环境的人来说,确实能少踩不少网络坑,开发效率能提一截。
请登录使用轩辕镜像享受快速拉取体验,支持国内加速,速度提升50倍
docker pull ghcr.io/k3d-io/k3d-proxy:5.6.3来自真实用户的反馈,见证轩辕镜像的优质服务
免费版仅支持 Docker Hub 加速,不承诺可用性和速度;专业版支持更多镜像源,保证可用性和稳定速度,提供优先客服响应。
免费版仅支持 docker.io;专业版支持 docker.io、gcr.io、ghcr.io、registry.k8s.io、nvcr.io、quay.io、mcr.microsoft.com、docker.elastic.co 等。
当返回 402 Payment Required 错误时,表示流量已耗尽,需要充值流量包以恢复服务。
通常由 Docker 版本过低导致,需要升级到 20.x 或更高版本以支持 V2 协议。
先检查 Docker 版本,版本过低则升级;版本正常则验证镜像信息是否正确。
使用 docker tag 命令为镜像打上新标签,去掉域名前缀,使镜像名称更简洁。
探索更多轩辕镜像的使用方法,找到最适合您系统的配置方式
通过 Docker 登录认证访问私有仓库
在 Linux 系统配置镜像加速服务
在 Docker Desktop 配置镜像加速
Docker Compose 项目配置加速
Kubernetes 集群配置 Containerd
在宝塔面板一键配置镜像加速
Synology 群晖 NAS 配置加速
飞牛 fnOS 系统配置镜像加速
极空间 NAS 系统配置加速服务
爱快 iKuai 路由系统配置加速
绿联 NAS 系统配置镜像加速
QNAP 威联通 NAS 配置加速
Podman 容器引擎配置加速
HPC 科学计算容器配置加速
ghcr、Quay、nvcr 等镜像仓库
无需登录使用专属域名加速
需要其他帮助?请查看我们的 常见问题 或 官方QQ群: 13763429