timotto/cheap-ingress

Cheap Ingress

镜像概述

Cheap Ingress是一款针对家庭规模Kubernetes集群设计的服务路由器，旨在将集群内的服务便捷地暴露到本地网络。它结合虚拟IP管理和内置DNS服务，提供类似专业Ingress控制器（如Traefik）的流量转发能力，同时更轻量、适配家庭网络场景。

核心功能

1. 虚拟IP与流量转发：通过ip命令添加虚拟IP，利用iptables将流量重定向至集群服务，支持任意端口转发（即使端口已绑定到主机）。
2. 内置DNS服务：解析配置的路由主机名到对应虚拟IP，支持自定义域名。
3. 灵活配置：通过环境变量设置IP池、网络接口、DNS参数等，适配不同家庭网络环境。
4. 高效性能：基于内核级iptables转发，减少用户空间上下文切换，提升转发效率。

使用场景

• 家庭树莓派Kubernetes集群中，将服务暴露到本地网络供家庭设备访问。
• 无需公网IP，通过自定义域名在本地网络内访问集群服务。
• 替代复杂的生产级Ingress控制器，适用于小规模非生产环境的流量管理。

配置说明

所有配置通过环境变量传递：

• STATE_FILENAME：路由配置存储文件路径，默认state.json。
• PORT：API服务器监听端口，默认8080。
• NODES：集群节点IP列表，默认169.254.123.125 169.254.123.126 169.254.123.127。
• INTERFACE：虚拟IP使用的网络接口，默认eth0。
• IPPOOL_PREFIX：虚拟IP池静态前缀（格式如AAA.BBB.CCC.），默认169.254.123.。
• IPPOOL_HOSTMIN：IP池起始主机号，默认100。
• IPPOOL_HOSTMAX：IP池结束主机号，默认200。
• DOMAIN：DNS服务域名，默认cheap-ingress.local。
• DNS_PORT：DNS服务器监听端口，默认53。
• DEBUG：调试输出模块名称（如util、cheap-ingress:*）。

部署与使用示例

Docker运行命令

bash
docker run --privileged --network=host \
  -e NODES="192.168.1.20 192.168.1.21" \
  -e INTERFACE=eth0 \
  -e IPPOOL_PREFIX=192.168.1. \
  -e IPPOOL_HOSTMIN=100 \
  -e IPPOOL_HOSTMAX=199 \
  -e DOMAIN=cloud.home \
  -e PORT=80 \
  -e DEBUG=cheap-ingress:* \
  docker.xuanyuan.run/timotto/cheap-ingress

添加路由示例

假设本地DNS已转发*.cloud.home到Cheap Ingress主机IP（如192.168.0.11），使用httpie添加路由：

bash
http POST 192.168.0.11/api/route hostname=futhek port=80 protocol=tcp nodePort=32412

添加后，可通过http://futhek.cloud.home/在本地网络访问集群内的futhek服务。