twingate/kubernetes-access-gateway
twingate
Twingate Kubernetes访问网关实现对Kubernetes集群的安全零信任访问。
下载次数: 0状态：社区镜像维护者：twingate仓库类型：镜像最近更新：3 个月前
让 AI 帮你使用轩辕镜像？ · 展开查看说明 · 点击收起说明
如果你使用 DeepSeek、元宝 AI、Copilot、ChatGPT 等 AI 工具，协助配置轩辕镜像、编写 docker pull 命令、修改 Docker Compose 镜像地址、配置镜像加速、排查镜像拉取失败、分析报错日志等问题，请先让 AI 阅读并遵守轩辕镜像的规则文档。
只需在 AI 对话中先发送下面这句话即可：
请先完整阅读并严格遵守以下文档中的全部规则与要求：
https://xuanyuan.cloud/agents.md
在未充分阅读并理解该文档前，不要生成任何命令、配置、修改建议、故障排查方案或技术回答。后续所有输出都必须严格以该文档中的规范为最高优先级执行。查看 agents.md 用法指南与完整示范。国内用户首推 元宝 AI、DeepSeek 的深度思考模式，不推荐豆包 AI；Cursor 等编辑器可在对话 @ 该链接，或加入 User Rules。 若 AI 无法访问外链，可 打开说明文档 复制全文粘贴。文档会随站点更新，复制内容可能过期，建议定期检查。
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部署（推荐）
-
添加Twingate Helm仓库
bashhelm repo add twingate https://twingate.github.io/helm-charts helm repo update -
部署访问网关
bashhelm 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部署
-
创建命名空间与配置
bashkubectl create namespace twingate kubectl create secret generic twingate-credentials -n twingate \ --from-literal=network=<YOUR_TWINGATE_NETWORK> \ --from-literal=access-token=<YOUR_ACCESS_TOKEN> -
应用部署清单
bashkubectl apply -f https://raw.githubusercontent.com/twingate/twingate-k8s-access-gateway/main/deploy/gateway.yaml -n twingate
核心配置参数
| 参数名称 | 描述 | 必选 | 默认值 |
|---|---|---|---|
twingate.network | Twingate网络名称（在Twingate控制台创建） | 是 | - |
twingate.accessToken | Twingate访问令牌（用于服务认证） | 是 | - |
logLevel | 日志级别（debug/info/warn/error） | 否 | info |
resources.requests.cpu | CPU资源请求 | 否 | 100m |
resources.requests.memory | 内存资源请求 | 否 | 128Mi |
nodeSelector | 节点选择器配置 | 否 | {} |
部署验证
-
检查Pod运行状态
bashkubectl get pods -n twingate -
查看网关日志
bashkubectl logs -n twingate deployment/twingate-k8s-access-gateway -
验证访问：通过Twingate客户端连接后，使用kubectl测试集群访问
bashkubectl get pods --context=twingate
注意事项
- 访问令牌需定期轮换，建议配置自动轮换机制
- 生产环境部署时应启用资源限制，避免影响集群稳定性
- 需确保Twingate中继服务与Kubernetes集群间的网络连通性
- 支持与Prometheus/Grafana集成，监控网关运行状态与访问指标
详细配置与高级功能请参考Twingate官方文档
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本，请访问 标签列表页面。
轩辕镜像加速拉取命令点我查看更多 kubernetes-access-gateway 镜像标签
docker pull docker.xuanyuan.run/twingate/kubernetes-access-gateway:<标签>
DockerHub 原生拉取命令
docker pull twingate/kubernetes-access-gateway:<标签>
镜像拉取常见问题
功能
错误码
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
5
"Docker访问体验非常流畅，大镜像也能快速完成下载。"