pi-fleet
基于Tailscale的跨设备Pi集群远程执行与编排工具
安装使用
复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:
帮我安装这个 AI Skill:pi-fleet。 它的用途是:基于Tailscale的跨设备Pi集群远程执行与编排工具 完整的 Skill 内容见:https://321skill.com/skills/pi-fleet/raw/index.md 请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
‘帮我在pi-fleet管理的所有设备上检查磁盘使用情况。’ 它会引导你运行相应的pi-fleet命令,例如 `pi-fleet exec --command 'df -h'`,该命令会通过Tailscale网络向列表中的所有Pi发送`df -h`指令,并将各设备的返回结果汇总展示给你。
介绍
pi-fleet 解决了在分布式树莓派(Pi)集群中进行统一管理和远程命令执行的难题。传统方式需要分别登录每台设备,操作繁琐且难以协同。该工具通过集成Tailscale构建安全的虚拟网络,让用户能够从一个中心节点,直接、安全地向网络中的所有Pi设备发送指令并获取结果。
它的使用方式非常直接。用户首先需要确保所有Pi设备都已加入同一个Tailscale网络。然后,在主控设备上通过npm安装pi-fleet,配置好目标设备列表后,即可使用简单的命令行工具,向整个“舰队”批量执行Shell命令、部署脚本或同步文件,所有通信都经由Tailscale加密通道完成。
这个工具非常适合拥有多台树莓派,并用于搭建分布式计算节点、物联网传感器网络、家庭实验室或小型教育集群的开发者、极客和研究人员。它极大地简化了集群的运维复杂度。
使用建议方面,请确保所有节点的Tailscale客户端运行正常且网络互通。由于依赖Tailscale,在完全离线的内网环境中无法使用。建议初次使用时先在一两台设备上测试命令,确认无误后再进行批量操作,以避免误操作影响整个集群。
核心特点
核心区别在于深度集成Tailscale,无需复杂的SSH密钥配置或暴露公网IP,即可在Tailscale建立的加密Mesh网络内实现安全的直接远程执行;同时它专注于树莓派设备集群的批量编排场景,而非通用的服务器管理。
注意事项
完全依赖Tailscale网络,不适用于无法安装或连接Tailscale的设备或封闭内网环境。
常见问题
pi-fleet必须使用Tailscale吗?
是的,它完全基于Tailscale网络实现设备发现和安全通信。
它能管理非树莓派的Linux设备吗?
理论上可以,但它主要针对和优化了树莓派的使用场景。
给 AI 助手的安装指引
如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:
请访问 https://321skill.com/skills/pi-fleet/raw/index.md 读取 pi-fleet 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址:/skills/pi-fleet/raw/index.md(查看排版版本)