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 环境的人来说,确实能少踩不少网络坑,开发效率能提一截。
请登录使用轩辕镜像享受快速拉取体验,支持国内访问优化,速度提升
docker pull ghcr.io/k3d-io/k3d-proxy:5.7.5探索更多轩辕镜像的使用方法,找到最适合您系统的配置方式
通过 Docker 登录认证访问私有仓库
无需登录使用专属域名
Kubernetes 集群配置 Containerd
K3s 轻量级 Kubernetes 镜像加速
VS Code Dev Containers 配置
Podman 容器引擎配置
HPC 科学计算容器配置
ghcr、Quay、nvcr 等镜像仓库
Harbor Proxy Repository 对接专属域名
Portainer Registries 加速拉取
Nexus3 Docker Proxy 内网缓存
需要其他帮助?请查看我们的 常见问题Docker 镜像访问常见问题解答 或 提交工单
manifest unknown
no matching manifest(架构)
invalid tar header(解压)
TLS 证书失败
DNS 超时
410 Gone 排查
402 与流量用尽
401 认证失败
429 限流
D-Bus 凭证提示
413 与超大单层
来自真实用户的反馈,见证轩辕镜像的优质服务