shantanupatil01/custom-kind-ttyd

带ttyd的自定义KinD镜像

这是一个自定义的KinD（Docker中的Kubernetes）镜像，预安装了ttyd（HTTP终端），支持通过Web浏览器访问Kubernetes集群节点的终端。

GitHub仓库： https://github.com/shantanu-p01/kind-ttyd-custom

可用镜像标签

✅ 建议： 除非需要固定Kubernetes版本，否则使用latest标签。

快速开始

使用KinD CLI（推荐）

1. 拉取镜像

固定版本

bash
docker pull shantanupatil01/custom-kind-ttyd:1.35.0

最新构建

bash
docker pull shantanupatil01/custom-kind-ttyd:latest

2. 创建集群配置文件

创建kind-cluster-with-ttyd.yml文件：

yaml
kind: Cluster
apiVersion: kind.x-k8s.io/v1alpha4
name: kind-cluster-ttyd
nodes:
  - role: control-plane
    image: shantanupatil01/custom-kind-ttyd:1.35.0
    # image: shantanupatil01/custom-kind-ttyd:latest
    extraPortMappings:
      - containerPort: 55555
        hostPort: 55555
        protocol: TCP
      - containerPort: 30001
        hostPort: 30001
        protocol: TCP
      - containerPort: 30010
        hostPort: 30010
        protocol: TCP
  - role: worker
    image: shantanupatil01/custom-kind-ttyd:1.35.0
  - role: worker
    image: shantanupatil01/custom-kind-ttyd:1.35.0

💡 若需自动升级，可将1.35.0替换为latest。

3. 创建集群

bash
kind create cluster --config kind-cluster-with-ttyd.yml

4. 访问ttyd

• URL： http://localhost:55555
• 用户名： kind
• 密码： kind123

使用Docker Run（独立模式）

固定版本

bash
docker run -d \
  --name kind-cluster-ttyd \
  --privileged \
  -p 55555:55555 \
  -p 30001-30010:30001-30010 \
  -v /var \
  -v /lib/modules:/lib/modules:ro \
  shantanupatil01/custom-kind-ttyd:1.35.0

最新构建

bash
docker run -d \
  --name kind-cluster-ttyd \
  --privileged \
  -p 55555:55555 \
  -p 30001-30010:30001-30010 \
  -v /var \
  -v /lib/modules:/lib/modules:ro \
  shantanupatil01/custom-kind-ttyd:latest

默认凭据

• 用户名： kind
• 密码： kind123

⚠️ 重要提示： 生产或共享环境中请修改默认密码。

配置

修改ttyd端口

KinD配置

yaml
extraPortMappings:
  - containerPort: 55555
    hostPort: 8080
    protocol: TCP

Docker Run

bash
docker run -p 8080:55555 ...

端口映射

常用命令

bash
# 查看所有集群
kind get clusters
# 删除集群
kind delete cluster --name kind-cluster-ttyd
# 获取集群信息
kubectl cluster-info --context kind-kind-cluster-ttyd
# 列出所有节点
kubectl get nodes
# 访问控制平面节点
docker exec -it kind-cluster-ttyd-control-plane bash

故障排除

ttyd无法访问

检查ttyd运行状态：

bash
docker exec -it kind-cluster-ttyd-control-plane ps aux | grep ttyd

查看日志：

bash
docker exec -it kind-cluster-ttyd-control-plane cat /var/log/ttyd.log

无法连接到Kubernetes

bash
kubectl get nodes

确保所有节点处于Ready状态。

注意事项

• ttyd在所有节点（控制平面和工作节点）运行
• 仅控制平面的ttyd通过55555端口暴露
• 工作节点访问方式：

  bash
  docker exec -it <工作节点容器名称> bash
  

源代码

完整代码、构建说明及自定义选项： https://github.com/shantanu-p01/kind-ttyd-custom

标签总结

• latest → 最新稳定构建（当前1.35.0）
• 1.35.0 → 当前稳定Kubernetes版本
• 1.34.0 → 上一版本