SuperAPI AI 工具集

debug-node

测试与质量

查看项目

更新于 10-16 01:33

技能介绍

用途:当 Hetzner 节点无法连接、SSH 失败、cloud-init 疑似损坏或初始化卡住时,使用救援模式从外部检查节点,无需可用 SSH。调用方式为 /debug-node,需先询问服务器名称或 IP,以及具体症状。前提是已安装并配置有效令牌的 hcloud CLI,且服务器存在于 Hetzner Cloud。

主要能力:通过 hcloud server enable-rescue 与 reboot 进入救援模式,再以 SSH 登入并挂载文件系统。对 Leap Micro / MicroOS(btrfs)使用 mount -o subvolid=5 /dev/sda3 /mnt,快照位于 /mnt/@/.snapshots/N/snapshot;自定义 ext4 镜像使用 mount /dev/sda1 /mnt。

检查项覆盖:cloud-init 状态与日志(/mnt/@/var/lib/cloud/data/result.json、status.json、user-data.txt、cloud-init.log、cloud-init-output.log)、SSH 授权密钥、sshd 配置、root 账户锁定状态(/etc/shadow)、journal 日志、网络连接、Kubernetes 配置、SELinux。

修复与收尾:在活动快照中修改文件;解锁 root、修复 authorized_keys、重建主机密钥;随后卸载、禁用救援模式并重启,最后用带 IdentitiesOnly=yes 的 SSH 验证。

限制:救援模式编辑仅为即时修复,长期修复应回写到 packer 模板或 cloud-init;不应把全局关闭 SELinux 作为首要方案;节点销毁应使用 scripts/destroy.sh,cleanup.sh 仅作强制回退。