env-check 配置文件（config.json）各检查项含义与影响分析 ​

env-check 通过 run 命令分发到各节点执行 run-local，在每台节点上执行以下 8 项检查（run.go:167）：

kernel, port, disk, clock, fileQuery, programCheck, route, iptables

log_file ​

含义：所有检查过程的日志输出到此文件，包括每项检查的开始、通过、警告、失败信息。

影响：仅影响 env-check 工具自身的日志记录，与 BKE 初始化无关。

output_format ​

含义：控制检查结果的输出格式。text 适合命令行查看，json 适合程序解析。

影响：仅影响报告展示格式，与 BKE 初始化无关。

paths（文件冲突检查 — fileQuery） ​

检查机制 ​

通过 pkg/query/query.go 的 FileQuery.Execute() 实现：对每条路径展开环境变量（如 $HOME）和通配符（如 kube*），然后检测文件/目录是否存在。若存在则标记为"冲突"。

检查结果判定（run.go:360-367）：

• TotalExists == 0 → pass（所有残留路径均不存在）
• TotalExists > 0 → fail（存在残留文件）

当前配置的 14 条路径 ​

clean_force ​

含义：

• false：删除每个残留文件前交互式询问用户 [y/n]
• true：跳过确认，直接删除所有残留文件

影响：仅影响 fileClean 模式的行为。当前配置为 false，删除操作需要用户逐个确认，防止误删。

program_list（程序检查 — programCheck） ​

检查机制 ​

通过 pkg/program/check.go 的 ApplicationChecker.Execute() 实现：对每个程序使用 exec.LookPath(name) 检测是否在 PATH 中可找到，然后与 should_exist 期望值比较。

检查结果判定（run.go:396-403）：

• TotalFailed == 0 → pass（所有程序符合预期状态）
• TotalFailed > 0 → fail（有程序不符合预期）

当前配置的 4 个程序 ​

程序检查总结 ​

hosts（主机列表） ​

当前配置 ​

含义：定义 env-check 需要检查的目标主机列表。每台主机的 role 决定执行哪些端口检查（port_check.ports 中对应角色的端口列表）。

影响：

• dispatch 模式下，env-check 将自身二进制分发到每台主机，通过 SSH 远程执行检查
• role 用于端口检查的角色匹配（port/check.go:130-155）：bootstrap 角色执行"引导节点端口检查"，master 执行"Master 节点端口检查"，worker 执行"Worker 节点端口检查"
• clock_threshold 时钟检查也需要 hosts 列表（通过 SSH 获取各主机时间并与本地比较）

clock_threshold（时钟同步检查 — clock） ​

检查机制 ​

通过 pkg/clock/clock.go 的 CheckerClock.Execute() 实现：通过 SSH 连接每台主机获取远程时间，与本地时间比较，计算时间差。若任意两台主机间时间差超过 clock_threshold 秒，则检查失败。

影响 ​

说明：当前 run.go:327-333 中的 runClockCheck() 仅返回本地时间并标记为 pass，实际的多主机时钟比较在 dispatch 模式中由 CheckerClock.Execute() 完成。

kernel_check（内核版本检查 — kernel） ​

检查机制 ​

通过 pkg/kernel/check.go 的 Checker.Execute() 实现：使用 gopsutil/host.Info() 获取内核版本，与 min_version 按 operator 比较。

特殊处理（check.go:97-115）：对 CentOS 7 的 3.10.0-xxx 内核（带有旧式 build number）特殊判断——即使版本号 >= 4.19，若检测到 3.10.0 前缀且带旧式 build number，也判定为不满足 >= 条件。

影响 ​

port_check（端口占用检查 — port） ​

检查机制 ​

通过 pkg/port/check.go 的 Checker.Execute() 实现：根据节点角色选择对应端口列表，对每个端口 TCP 拨号 127.0.0.1:<port>，若连接成功则端口被占用。还能通过 gopsutil 识别占用进程。

检查结果判定（run.go:274-280）：

• Used == 0 → pass（所有端口空闲）
• Used > 0 → fail（存在被占用端口）

当前配置 ​

Bootstrap 端口（5 个） ​

其中36443、40080、40443、38080这些端口是支持可配置的，如果在bke init使用了指定的端口时，需要替换为检查对应的端口。

Master 端口（13 个） ​

1338 端口绑定在 127.0.0.1（环回地址），由 ContainerdConfig CR 配置（metricsAddress: "127.0.0.1:1338"），capbke 读取此 CR 渲染到集群节点的 containerd config.toml。引导节点的 containerd 使用 bkeadm 自有模板（[metrics] address = ''），不启用 metrics，因此 bootstrap 端口列表不含 1338。

Worker 端口（7 个） ​

端口检查总结 ​

disk_check（磁盘空间检查 — disk） ​

检查机制 ​

通过 pkg/disk/check.go 的 Checker.Execute() 实现：对每个 check_items 条目，使用 gopsutil/disk.Usage() 获取指定路径的磁盘使用情况，比较 Free 空间与 MinFreeGB * 1GB。

若路径不存在，自动向上查找父目录的挂载点。若 check_items 条目配置了 roles 字段，则仅对匹配角色的节点检查（当前配置未设置 roles，对所有节点检查）。

检查结果判定（run.go:315-322）：

• InsufficientPath == 0 → pass（所有路径空间充足）
• InsufficientPath > 0 → fail（存在空间不足的路径）

当前配置分析 ​

影响 ​

dispatch（分发配置） ​

各字段含义 ​

影响 ​

说明：dispatch 配置仅影响 env-check 工具的分发行为，与 BKE 初始化无关。

route 和 iptables 检查 ​

这两项检查在 run-local 中默认执行（run.go:167），但不在 config.json 中显式配置——它们使用固定逻辑，不依赖配置参数。

route（默认路由检查） ​

检查机制（pkg/route/route.go）：执行 route -n 命令解析路由表，检查是否存在默认路由。若无默认路由，节点网络配置异常，可能导致 BKE 组件间通信失败。

影响：无默认路由的节点无法访问外部网络（拉取镜像、下载二进制等），BKE 初始化失败。

iptables（FORWARD 链策略检查） ​

检查机制（pkg/iptables/iptables.go）：执行 iptables -L FORWARD -n 命令，检查 FORWARD 链的默认策略是否为 ACCEPT。

影响：若 FORWARD 链策略为 DROP，Kubernetes Pod 间跨节点通信会被 iptables 丢弃，导致网络不通。Calico CNI 依赖 FORWARD 链转发 Pod 流量。bkeadm 的 prepareEnvironment() 会安装 iptables 并切换到 legacy 模式，但不设置 FORWARD 策略——这由 capbke env init 负责（init.go 中设置 iptables 规则）。