SuperAPI AI 工具集

tailscale-operator

部署与运维

查看项目

更新于 10-15 10:25

技能介绍

用途

Tailscale Operator 是一个用于在 Tailscale tailnet 上管理、连接和排查设备的技能。其目标不是产出冗长的诊断报告,而是尽快恢复可用的远程访问路径。适用于用户要求通过 Tailscale 连接设备、查找设备 IP、SSH 登录设备或排查远程访问故障的场景。

主要能力

  • 根据设备别名、昵称或人名映射到已记录的设备条目,获取 Tailscale IP、SSH 用户名和已知可用的 SSH 命令。
  • 测试 tailnet 连通性,区分“tailnet 故障/离线”与“tailnet 正常但 SSH 故障”。
  • 按 SSH 错误文本快速分类故障原因,并给出最快的下一步命令。
  • 处理主机密钥不匹配、公钥认证失败、连接被拒绝、超时无路由、密码提示、sudo 权限不足等常见问题。
  • 在发现新的可用路径后,将确认的 Tailscale IP、SSH 用户名、可用 SSH 命令等信息写回设备记录。

使用方式

默认数据源包括:共享 tailnet 清单 /home/aa/.openclaw/shared/tailnet/README.md、设备记录 /home/aa/.openclaw/shared/tailnet/devices/*.md、本地笔记 /home/aa/.openclaw/workspace-ops/TOOLS.md。共享 tailnet 清单被视为设备别名、Tailscale IP、SSH 用户名、已知可用 SSH 命令和平台注意事项的权威来源。

快速启动流程:

  1. 先查找已记录的设备条目。
  2. 测试 tailnet 可达性:tailscale ping 100.x.y.z。
  3. 尝试已知可用的 SSH 路径:ssh -o IdentitiesOnly=yes -i ~/.ssh/id_ed25519 user@100.x.y.z。
  4. 登录后验证身份:ssh -o IdentitiesOnly=yes -i ~/.ssh/id_ed25519 user@100.x.y.z 'hostname; whoami; uname -a'。

如果第 2 步失败,优先修复 Tailscale;如果第 2 步成功但第 3 步失败,则修复 SSH 认证、sshd 或 Tailscale SSH。

适用场景

  • 需要通过 Tailscale 连接远程设备。
  • 需要查找设备的 Tailscale IP 或 SSH 用户名。
  • SSH 登录失败,需要快速定位并修复。
  • 需要恢复无密码登录或配置 Tailscale SSH。
  • 需要处理 sudo 权限或用户权限问题。

限制

  • 如果目标设备未被记录,需要用户提供 Tailscale IP、设备名、SSH 用户名或确切的 SSH 命令。
  • 如果多个设备匹配同一别名,需先确认具体主机再操作。
  • 不默认修改 sudo 策略、不未经明确批准提升用户权限、不清除或替换远程 ~/.ssh 目录、不在确认实际故障模式前更改防火墙或网络设置、不对匹配不明确的设备名进行操作。
  • 如果 sudo 需要密码且无可用密码,应停止提权并明确说明。
  • 如果访问需要用户操作(密码、物理解锁、管理员批准),应明确说明所需内容。

成功标准

理想结果包括:SSH 现在可用、Tailscale SSH 现在可用、公钥已安装且未来登录无需密码、sudo/管理员路径已知并记录、阻塞点明确且最小化。