freshwebio/kubectl-proxy

kubectl-proxy镜像文档

镜像概述

本镜像基于官方kubectl镜像构建，核心功能是暴露kubectl的proxy组件，提供便捷的Kubernetes集群API代理访问能力。通过运行此镜像，用户可快速建立从本地或外部环境到Kubernetes集群API的代理连接，简化集群访问配置流程。

核心功能与特性

• 基于官方kubectl：继承kubectl的完整功能，确保与Kubernetes集群版本兼容性
• 原生proxy暴露：直接集成并暴露kubectl proxy功能，无需额外配置
• 轻量级设计：基于官方最小化kubectl镜像，镜像体积小，资源占用低
• 灵活访问控制：支持通过kubectl原生参数配置代理端口、访问IP、认证方式等

使用场景

• 本地开发调试：开发环境需访问远程Kubernetes集群API时，通过此镜像快速建立代理通道
• 跨网络环境访问：在无法直接访问Kubernetes集群API的网络环境中，通过代理实现间接访问
• 简化权限管理：利用kubectl的认证机制，无需额外配置复杂的网络转发规则
• CI/CD流水线集成：在自动化流程中临时建立集群API代理，用于部署或监控操作

使用方法

基本使用（docker run）

bash
docker run -d \
  --name kubectl-proxy \
  -v ~/.kube/config:/root/.kube/config \  # 挂载本地kubeconfig文件
  -p 8001:8001 \                         # 映射代理端口（默认8001）
  [镜像名称] \
  kubectl proxy --address=0.0.0.0 --port=8001

参数说明：

• -v ~/.kube/config:/root/.kube/config：挂载本地Kubernetes配置文件，用于认证集群访问
• -p 8001:8001：将容器内代理端口映射到主机，默认使用8001端口
• --address=0.0.0.0：允许从容器外部访问代理（默认仅本地访问）
• --port=8001：指定代理服务端口

docker-compose配置示例

yaml
version: '3'
services:
  kubectl-proxy:
    image: [镜像名称]
    volumes:
      - ~/.kube/config:/root/.kube/config
    ports:
      - "8001:8001"
    command: kubectl proxy --address=0.0.0.0 --port=8001
    restart: unless-stopped

访问验证

代理启动后，可通过以下地址访问Kubernetes集群API：

http://localhost:8001/api/v1/namespaces

配置参数

kubectl proxy支持的主要参数：

镜像概述

本镜像基于官方kubectl镜像构建，核心功能是暴露kubectl的proxy组件，提供便捷的Kubernetes集群API代理访问能力。通过运行此镜像，用户可快速建立从本地或外部环境到Kubernetes集群API的代理连接，简化集群访问配置流程。

核心功能与特性

• 基于官方kubectl：继承kubectl的完整功能，确保与Kubernetes集群版本兼容性
• 原生proxy暴露：直接集成并暴露kubectl proxy功能，无需额外配置
• 轻量级设计：基于官方最小化kubectl镜像，镜像体积小，资源占用低
• 灵活访问控制：支持通过kubectl原生参数配置代理端口、访问IP、认证方式等

使用场景

• 本地开发调试：开发环境需访问远程Kubernetes集群API时，通过此镜像快速建立代理通道
• 跨网络环境访问：在无法直接访问Kubernetes集群API的网络环境中，通过代理实现间接访问
• 简化权限管理：利用kubectl的认证机制，无需额外配置复杂的网络转发规则
• CI/CD流水线集成：在自动化流程中临时建立集群API代理，用于部署或监控操作

使用方法

基本使用（docker run）

bash
docker run -d \
  --name kubectl-proxy \
  -v ~/.kube/config:/root/.kube/config \  # 挂载本地kubeconfig文件
  -p 8001:8001 \                         # 映射代理端口（默认8001）
  [镜像名称] \
  kubectl proxy --address=0.0.0.0 --port=8001

参数说明：

• -v ~/.kube/config:/root/.kube/config：挂载本地Kubernetes配置文件，用于认证集群访问
• -p 8001:8001：将容器内代理端口映射到主机，默认使用8001端口
• --address=0.0.0.0：允许从容器外部访问代理（默认仅本地访问）
• --port=8001：指定代理服务端口

docker-compose配置示例

yaml
version: '3'
services:
  kubectl-proxy:
    image: [镜像名称]
    volumes:
      - ~/.kube/config:/root/.kube/config
    ports:
      - "8001:8001"
    command: kubectl proxy --address=0.0.0.0 --port=8001
    restart: unless-stopped

访问验证

代理启动后，可通过以下地址访问Kubernetes集群API：

http://localhost:8001/api/v1/namespaces

配置参数

kubectl proxy支持的主要参数：

可根据实际需求在启动命令中添加上述参数，例如限制访问来源或开放特定API路径。