verajm/kubernetes-zerotier-bridge

Kubernetes ZeroTier Bridge

镜像概述

Kubernetes ZeroTier Bridge镜像是一个ZeroTier网关工具，用于通过ZeroTier子网访问Kubernetes集群中的非公开服务。支持Helm Chart部署DaemonSet、单Pod部署及本地运行测试，帮助用户无需直接安装ZeroTier客户端即可实现集群服务的外部访问。

核心功能

1. 作为ZeroTier与Kubernetes集群的网络桥接
2. 支持Helm Chart快速部署DaemonSet
3. 提供单Pod部署配置模板
4. 本地运行测试ZeroTier连接
5. 可配置网络ID、认证令牌、自动加入等参数

使用场景

1. 企业内部通过ZeroTier访问Kubernetes集群非公开服务
2. 测试ZeroTier网络连接无需安装客户端
3. 跨网络环境下访问K8s集群私有服务

配置说明

需设置以下环境变量：

• NETWORK_IDS：逗号分隔的ZeroTier网络ID
• ZTAUTHTOKEN：ZeroTier网络认证令牌（用于自动加入和设置主机名）
• AUTOJOIN：是否自动接受新主机（true/false）
• ZTHOSTNAME：ZeroTier客户端主机名（可选）

部署时需注意：

• 启用securityContext的特权模式及添加NET_ADMIN等能力
• 挂载/dev/net/tun卷

部署示例

Helm Chart部署

bash
helm repo add kubernetes-zerotier-bridge https://leunamnauj.github.io/kubernetes-zerotier-bridge/
helm repo update
helm install --name kubernetes-zerotier-bridge kubernetes-zerotier-bridge/kubernetes-zerotier-bridge

说明：可配置persistentVolume.enabled=true启用持久化存储。

单Pod部署

yaml
---
apiVersion: v1
kind: ConfigMap
metadata:
  name: zerotier-networks
data:
  NETWORK_IDS: <<你的子网ID>>
  ZTAUTHTOKEN: <<你的令牌>>
  AUTOJOIN: "true"
  ZTHOSTNAME: <<期望主机名>>
---
apiVersion: v1
kind: Pod
metadata:
  name: kubernetes-zerotier-bridge
spec:
  containers:
    - name: kubernetes-zerotier-bridge
      image: verajm/kubernetes-zerotier-bridge
      env:
      - name: NETWORK_IDS
        valueFrom:
          configMapKeyRef:
            name: zerotier-networks
            key: NETWORK_IDS
      - name: ZTHOSTNAME
        valueFrom:
          configMapKeyRef:
            name: zerotier-networks
            key: ZTHOSTNAME
      - name: ZTAUTHTOKEN
        valueFrom:
          configMapKeyRef:
            name: zerotier-networks
            key: ZTAUTHTOKEN
      - name: AUTOJOIN
        valueFrom:
          configMapKeyRef:
            name: zerotier-networks
            key: AUTOJOIN
      securityContext:
        privileged: true
        capabilities:
          add:
          - NET_ADMIN
          - SYS_ADMIN
          - CAP_NET_ADMIN
      volumeMounts:
      - name: dev-net-tun
        mountPath: /dev/net/tun
  volumes:
  - name: dev-net-tun
    hostPath:
      path: /dev/net/tun

本地运行

修改docker-compose文件配置环境变量后执行：

bash
docker-compose up

ZeroTier配置

需在ZeroTier管理后台添加路由规则，将Kubernetes服务/Pod子网指向该Pod的ZeroTier地址。