SuperAPI AI 工具集

pp-tailscale

智能体与模型

查看项目

更新于 10-16 01:32

技能介绍

用途:在终端或由智能体驱动地管理 Tailscale tailnet,覆盖几乎所有 Tailscale 管理 API 端点(刻意不含 tailnet 删除)。适合审批子网路由与出口节点、编辑策略文件、审计或撤销机器共享、检查密钥到期,以及查询某条连接由哪条规则放行。不适用于把本机接入 tailnet 或修改本机设置(应使用本地 tailscale up / tailscale set)、Taildrop 传文件与本地端口服务(tailscale file / serve),也不用于 Headscale 等自托管控制服务器。

安装:需先安装 CLI 再调用本技能命令。优先使用 Printing Press 安装器(macOS/Linux 默认装到 $HOME/.local/bin,Windows 为 %LOCALAPPDATA%\Programs\PrintingPress\bin):npx -y @mvanhorn/printing-press-library install tailscale --cli-only,然后用 tailscale-pp-cli --version 验证,并确保安装目录在运行时 $PATH 中。若 npx 失败,可回退到 Go 直接安装(需 Go 1.26.6 或更高):go install github.com/mvanhorn/printing-press-library/library/cloud/tailscale/cmd/tailscale-pp-cli@latest,安装到 $GOPATH/bin。若 --version 提示 command not found,说明 $PATH 不可见,验证成功前不要继续执行技能命令。

主要能力:整对象端点的安全写入——routes approve 在保留设备已有路由的前提下批准子网路由或出口节点(如 tailscale-pp-cli routes approve self --all-advertised),routes unapprove 只撤销指定路由或出口节点对而保留其它已批准路由(如 --exit-node);policy add-entry 追加 nodeAttrs、grants、acls 或 ssh 条目,保留注释并做本地备份、校验、diff 与并发检查(支持 --dry-run);policy restore 校验并显示 diff 后回滚到本地备份(--list 可列出备份)。可推理的 tailnet 状态——routes overview 一表查看所有设备的已批准、待处理、陈旧路由与出口节点状态(--pending);devices expiry 按密钥到期天数列出设备并标记窗口内设备(--within 14);shares audit 列出全 tailnet 机器共享邀请的接受者与仍可兑换项(--pending);shares revoke 按 ID 或按设备与接受者撤销共享邀请(如 --device self --pending)。智能体原生网络操作——access check 展示允许某用户访问某设备与端口的策略规则,可对当前策略或候选文件校验(如 --to self:22);devices inspect 一次返回单个设备的身份、路由、密钥到期、共享与近期变更(如 devices inspect self --agent)。

使用方式与限制:设备选择器 self 表示本机,需要本地 tailscale 命令;否则传主机名、MagicDNS 名、Tailscale IP 或 nodeId。routes approve/unapprove、shares revoke、policy add-entry/restore 仅在 --yes 时写入,作为 MCP 工具时为 plan-only;在 --agent 模式下其它变更默认演练,除非加 --yes。命令覆盖 device、device-invites、organizations、posture、tailnet(含 acl、dns、keys、logging、oauth-apps、services、settings、webhooks 等)与 user-invites 等资源;写操作包括 POST/PUT/PATCH/DELETE。每条命令可加 --help 查看参数。部分端点标注了对应 OAuth Scope。资料未提供收费、价格或平台支持范围等信息。