paralusio/relay

Kubernetes中继服务器与代理镜像

镜像概述

本镜像提供用于Kubernetes集群交互的中继服务器（Relay Server）和代理（Agent）功能，旨在实现Kubernetes集群内外、不同组件间的通信中继与代理，解决集群网络隔离、跨网络访问控制等场景下的通信需求。

核心功能与特性

• 中继服务器：提供Kubernetes集群通信请求的中继转发能力，支持集群内外网络流量的中转与路由
• 代理服务：作为代理层，转发对Kubernetes集群内部服务（如API Server、Pod、Service）的访问请求
• Kubernetes原生兼容：与Kubernetes API无缝集成，支持标准的集群认证与授权机制
• 轻量级设计：容器化优化，资源占用低，可部署于Kubernetes集群内部或边缘节点
• 灵活配置：支持通过环境变量或配置文件自定义中继规则、代理策略及网络参数

使用场景与适用范围

• 跨网络环境的集群管理：在网络隔离环境（如公网与私有集群、多区域网络）中，实现对Kubernetes集群的远程管理与监控
• 集群网络安全加固：通过中继代理层控制外部访问集群内部资源的权限，减少直接暴露集群端点的安全风险
• 多集群通信中继：作为中转节点，实现多个独立Kubernetes集群间的服务通信与数据交换
• 边缘-集群协同：部署于边缘节点，作为边缘设备与Kubernetes集群通信的代理中继点，支持边缘计算场景

使用方法与配置说明

基本部署（Docker Run）

通过以下命令快速启动中继服务器与代理容器：

bash
docker run -d \
  --name k8s-relay-agent \
  -e KUBERNETES_API_URL="https://<kube-apiserver-ip>:6443" \
  -e RELAY_LISTEN_PORT="8080" \
  -e AGENT_MODE="both" \  # 可选值：relay（仅中继）、agent（仅代理）、both（两者皆启用）
  -p 8080:8080 \
  [镜像名称]:[版本标签]

环境变量配置

Docker Compose配置示例

yaml
version: '3'
services:
  k8s-relay-agent:
    image: docker.xuanyuan.run/[镜像名称]:[版本标签]
    container_name: k8s-relay-agent
    ports:
      - "8080:8080"
    environment:
      - KUBERNETES_API_URL=https://kube-apiserver:6443
      - RELAY_LISTEN_PORT=8080
      - AGENT_MODE=both
      - LOG_LEVEL=info
    volumes:
      - ./certs:/certs  # 挂载TLS证书（如需启用TLS）
    restart: unless-stopped

功能验证

容器启动后，可通过以下方式验证服务状态：

1. 健康检查：访问中继服务健康检查端点

   bash
   curl http://localhost:8080/health
   

   预期返回：{"status":"healthy","mode":"both","api_server_connected":true}

2. 代理测试：通过代理访问Kubernetes API

   bash
   curl http://localhost:8080/api/v1/namespaces
   

   预期返回Kubernetes集群命名空间列表（需具备相应访问权限）

注意事项

• 确保容器能够访问KUBERNETES_API_URL指定的API Server地址，网络策略需允许相应端口通信
• 生产环境建议启用TLS加密（通过TLS_ENABLED=true及证书挂载），并限制容器暴露端口的访问范围
• 如需自定义中继规则或代理策略，可通过挂载配置文件（如/etc/relay/config.yaml）实现高级配置（具体配置格式请参考镜像官方文档）