用途:管理 Tailscale 网状 VPN 网络,覆盖本地机器操作与 tailnet 全网管理。
主要能力:CLI 侧可查看状态(tailscale status)、网络诊断(tailscale netcheck)、查询本机 IP(tailscale ip -4)、识别 IP(tailscale whois)、连通性测试(tailscale ping)、连接与断开(tailscale up/down)、使用出口节点、Taildrop 文件收发(tailscale file cp/get)、暴露服务(tailscale serve 私有、tailscale funnel 公网)、SSH(tailscale ssh)。API 侧可列设备、查设备详情、检查在线状态、授权/删除设备、管理标签与路由、创建认证密钥(含可复用与临时密钥)、管理 DNS 与 MagicDNS、读写与校验 ACL。
使用方式:本地操作无需 API key,直接调用 tailscale CLI;全网操作需要 API key,配置存于 ~/.claude-homelab/.env,字段为 TAILSCALE_API_KEY 与 TAILSCALE_TAILNET(可为 - 自动检测、组织名或邮箱域名),API key 来自 Tailscale 管理控制台。脚本调用示例:./scripts/ts-api.sh devices、./scripts/ts-api.sh online、./scripts/ts-api.sh create-key --reusable --tags tag:server、./scripts/ts-api.sh dns、./scripts/ts-api.sh acl-validate <file>。通过 zsh-tool 调用脚本时需使用 pty: true,否则输出不可见。
限制:定位为读写但安全,不做破坏性操作;写操作包括创建认证密钥和切换网络功能。除上述内容外,收费、价格、平台支持与效果等事实暂未提供。