这是一套专为 Kubernetes 集群设计的 DNS 解析测试工具，用于评估和诊断集群内外 DNS 解析功能的可靠性和性能。

• 多协议支持: 同时支持 UDP 和 TCP 协议的 DNS 查询测试
• 多场景测试: 覆盖集群内外 DNS 解析的完整场景
• 智能分析: 自动分析测试结果并提供故障诊断建议
• 容器化部署: 基于 Debian 12 的轻量级 Docker 镜像
• 灵活配置: 支持命令行参数和环境变量多种配置方式
• Unicode支持: 完整支持中文和emoji显示，优化用户体验

场景	DNS服务器	目标域名	测试目的
场景1	集群内DNS	集群内域名	测试集群内部DNS服务基本功能
场景2	集群内DNS	集群外域名	测试集群DNS上游转发功能
场景3	集群外DNS	集群外域名	对照组，测试外部DNS可用性

# 基本测试 - 使用默认配置测试所有场景
kubectl run dns-test --image=docker.cnb.cool/hzboiler/k8s-dns-test --rm -it --restart=Never

# 同时测试UDP和TCP协议
kubectl run dns-test --image=docker.cnb.cool/hzboiler/k8s-dns-test --rm -it --restart=Never \
  -- -p both -n 100 -t 3

# 快速测试 - 每个场景20次
kubectl run dns-test --image=docker.cnb.cool/hzboiler/k8s-dns-test --rm -it --restart=Never \
  -- -p both -n 20 -t 2

# 仅测试UDP协议
kubectl run dns-test-udp --image=docker.cnb.cool/hzboiler/k8s-dns-test --rm -it --restart=Never \
  -- -p udp -n 100

# 仅测试TCP协议
kubectl run dns-test-tcp --image=docker.cnb.cool/hzboiler/k8s-dns-test --rm -it --restart=Never \
  -- -p tcp -n 100

# 进入Pod内部进行调试
kubectl run dns-debug --image=docker.cnb.cool/hzboiler/k8s-dns-test --rm -it --restart=Never \
  -- /bin/bash

# 测试Unicode和emoji支持
kubectl run unicode-test --image=docker.cnb.cool/hzboiler/k8s-dns-test --rm -it --restart=Never \
  -- /app/test-unicode.sh

参数	说明	默认值	示例
-c	集群内DNS服务器	10.96.0.10	-c 10.96.0.10
-e	集群外DNS服务器	8.8.8.8	-e 114.114.114.114
-i	集群内域名	kubernetes.default.svc.cluster.local	-i my-service.default.svc.cluster.local
-x	集群外域名	google.com	-x baidu.com
-p	测试协议	both	-p udp / -p tcp / -p both
-n	每个场景测试次数	100	-n 200
-t	超时时间(秒)	2	-t 5

环境变量	对应参数	说明
CLUSTER_DNS_SERVER	-c	集群内DNS服务器地址
EXTERNAL_DNS_SERVER	-e	集群外DNS服务器地址
INTERNAL_DOMAIN	-i	集群内域名
EXTERNAL_DOMAIN	-x	集群外域名
PROTOCOL	-p	测试协议 (udp/tcp/both)
TOTAL	-n	每个场景测试次数
TIMEOUT	-t	超时时间(秒)

• UDP: 轻量级协议，响应速度快，但可能丢包
• TCP: 可靠传输协议，建立连接开销较大，但数据完整性更好

• 优秀: 成功率 ≥ 95%
• 良好: 成功率 ≥ 90%
• 需关注: 成功率 < 90%

1. 场景1成功率低: 集群内DNS服务问题，检查CoreDNS配置
2. 场景2成功率低: 上游DNS转发问题，检查网络策略和防火墙
3. TCP成功率明显低于UDP: 可能存在TCP连接限制或防火墙策略

• kubectl - K8s命令行工具
• 对集群的访问权限

# 使用默认配置
kubectl run dns-test --image=docker.cnb.cool/hzboiler/k8s-dns-test --rm -it --restart=Never

# 快速测试（每个场景20次）
kubectl run dns-test --image=docker.cnb.cool/hzboiler/k8s-dns-test --rm -it --restart=Never \
  -- -n 20 -t 1

# 仅测试UDP协议
kubectl run dns-test --image=docker.cnb.cool/hzboiler/k8s-dns-test --rm -it --restart=Never \
  -- -p udp -n 100

# 测试特定DNS服务器
kubectl run dns-test --image=docker.cnb.cool/hzboiler/k8s-dns-test --rm -it --restart=Never \
  -- -c 10.96.0.10 -e 114.114.114.114

# 测试特定域名
kubectl run dns-test --image=docker.cnb.cool/hzboiler/k8s-dns-test --rm -it --restart=Never \
  -- -i my-app.default.svc.cluster.local -x baidu.com

# 高强度测试
kubectl run dns-test --image=docker.cnb.cool/hzboiler/k8s-dns-test --rm -it --restart=Never \
  -- -n 500 -t 5

# 通过环境变量配置
kubectl run dns-test --image=docker.cnb.cool/hzboiler/k8s-dns-test --rm -it --restart=Never \
  --env="CLUSTER_DNS_SERVER=10.96.0.10" \
  --env="EXTERNAL_DOMAIN=baidu.com" \
  --env="PROTOCOL=both"

1. 网络访问: 确保测试环境能够访问目标DNS服务器
2. 防火墙: 检查53端口（UDP/TCP）是否开放
3. 权限: 某些环境可能需要特殊的网络权限
4. 资源消耗: 大量测试可能对DNS服务器造成负载

欢迎提交Issue和Pull Request！

1. Fork 项目
2. 创建特性分支 (git checkout -b feature/AmazingFeature)
3. 提交更改 (git commit -m 'Add some AmazingFeature')
4. 推送到分支 (git push origin feature/AmazingFeature)
5. 开启 Pull Request

本项目采用 MIT 许可证 - 查看 LICENSE 文件了解详情。