twingate/kubernetes-access-gateway

Twingate Kubernetes Access Gateway 镜像文档

镜像概述

Twingate Kubernetes访问网关（Twingate Kubernetes Access Gateway）是一款基于零信任安全架构的容器化解决方案，专为安全访问Kubernetes集群设计。该镜像通过零信任模型实现对K8s集群资源的安全访问控制，无需将集群暴露至公网，有效替代传统***或网络层访问控制手段，适用于现代云原生环境下的集群访问安全管理。

核心功能与特性

零信任安全架构

• 遵循"永不信任，始终验证"原则，基于用户身份、设备状态和权限策略动态授予访问权限
• 实现最小权限访问控制，仅允许授权用户访问特定Kubernetes资源
• 持续验证访问主体的合法性，降低凭证泄露风险

集群安全增强

• 无需将Kubernetes API服务器暴露至公网，通过Twingate中继服务建立加密隧道
• 所有集群访问流量均通过TLS 1.3加密，确保传输层安全
• 与Kubernetes RBAC原生集成，支持基于集群角色的细粒度权限控制

部署与运维优化

• 轻量级容器化设计，资源占用低，适合各类Kubernetes环境
• 支持通过Helm Chart或kubectl快速部署，与Kubernetes生态深度集成
• 提供详细访问日志，支持安全审计与合规性检查

使用场景与适用范围

典型应用场景

• 远程开发/运维团队安全访问Kubernetes集群
• 多团队共享集群环境下的资源隔离与权限控制
• 生产环境Kubernetes集群的公网访问防护
• 满足***、***等行业合规要求的集群访问管理

适用环境

• 自管理Kubernetes集群（On-Premises、私有云）
• 托管Kubernetes服务（EKS、GKE、AKS等）
• 混合云与多云Kubernetes环境
• 对访问安全性要求较高的生产/预发环境

使用方法与配置说明

前置条件

• 已注册Twingate账户并创建网络（Network）
• 具备目标Kubernetes集群的管理员访问权限（kubectl配置）
• 集群已安装CoreDNS等基础网络组件

部署步骤

通过Helm部署（推荐）

1. 添加Twingate Helm仓库

   bash
   helm repo add twingate https://twingate.github.io/helm-charts
   helm repo update
   

2. 部署访问网关

   bash
   helm install twingate-gateway twingate/twingate-k8s-access-gateway \
     --namespace twingate --create-namespace \
     --set twingate.network=<YOUR_TWINGATE_NETWORK> \
     --set twingate.accessToken=<YOUR_ACCESS_TOKEN>
   

通过kubectl部署

1. 创建命名空间与配置

   bash
   kubectl create namespace twingate
   
   kubectl create secret generic twingate-credentials -n twingate \
     --from-literal=network=<YOUR_TWINGATE_NETWORK> \
     --from-literal=access-token=<YOUR_ACCESS_TOKEN>
   

2. 应用部署清单

   bash
   kubectl apply -f https://raw.githubusercontent.com/twingate/twingate-k8s-access-gateway/main/deploy/gateway.yaml -n twingate
   

核心配置参数

部署验证

1. 检查Pod运行状态

   bash
   kubectl get pods -n twingate
   

2. 查看网关日志

   bash
   kubectl logs -n twingate deployment/twingate-k8s-access-gateway
   

3. 验证访问：通过Twingate客户端连接后，使用kubectl测试集群访问

   bash
   kubectl get pods --context=twingate
   

注意事项

• 访问令牌需定期轮换，建议配置自动轮换机制
• 生产环境部署时应启用资源限制，避免影响集群稳定性
• 需确保Twingate中继服务与Kubernetes集群间的网络连通性
• 支持与Prometheus/Grafana集成，监控网关运行状态与访问指标

详细配置与高级功能请参考Twingate官方文档