omrieival/ktunnel

ktunnel Docker镜像文档

镜像概述

ktunnel是一个轻量级工具，用于在Kubernetes集群与本地机器之间建立反向隧道，解决本地开发环境与远程Kubernetes集群的网络连接问题，支持双向网络通信，便于开发测试和远程调试。

核心功能和特性

• 反向隧道建立：在Kubernetes集群与本地机器间创建安全的网络通道
• 双向通信支持：实现本地服务暴露给Kubernetes集群，以及从集群访问本地资源
• 轻量级部署：容器化设计，可直接通过Docker运行，无需复杂依赖
• Kubernetes集成：原生支持Kubernetes环境，可与集群内服务无缝交互

使用场景和适用范围

• 本地开发Kubernetes应用时，将本地服务暴露给集群进行实时测试
• 远程调试运行在Kubernetes集群中的应用，访问本地调试工具或资源
• 在无公网IP环境下，建立Kubernetes集群与本地机器的安全网络连接
• 临时打通集群与本地环境的网络，进行数据传输或服务验证

使用方法和配置说明

基本使用方式

通过Docker运行ktunnel容器，基本命令格式：

bash
docker run --rm -it omrikiei/ktunnel [command] [options]

主要命令

1. 启动隧道服务端（在Kubernetes集群内）

bash
docker run --rm -it omrikiei/ktunnel server

2. 启动隧道客户端（在本地机器）

bash
docker run --rm -it omrikiei/ktunnel client --server [集群内服务端地址] [本地端口]:[集群端口]

环境变量配置

示例：将本地服务暴露给Kubernetes集群

1. 在Kubernetes集群内启动服务端：

   bash
   docker run --rm -it omrikiei/ktunnel server
   

2. 在本地机器启动客户端，将本地8080端口暴露为集群内80端口：

   bash
   docker run --rm -it omrikiei/ktunnel client --server tunnel-service.default.svc.cluster.local 8080:80
   

3. 集群内服务即可通过http://tunnel-service.default.svc.cluster.local:80访问本地8080端口服务