starlink

核心用法

Starlink CLI Skill 是一个专门用于控制 Starlink 卫星天线的文档型工具，通过调用本地 gRPC API（192.168.100.1:9200）实现硬件管理。用户可通过该技能执行六大核心操作：使用 status 获取天线状态、运行时间、信噪比、延迟和遮挡信息；通过 clients 查看接入 WiFi 的终端设备详情（包括信号强度、频段、MAC 地址等）；运行 speedtest 进行网络测速；利用 stow/unstow 控制天线收纳与展开（适用于运输或存储场景）；执行 reboot 远程重启设备；以及获取 location GPS 坐标（需提前在 App 中授权）。所有命令均支持 --json 参数输出结构化数据，便于脚本集成与自动化处理。

显著优点

该技能的最大优势在于完全本地化的控制方式，所有操作均通过局域网直接与卫星天线通信，无需经过云端服务，有效降低了网络延迟并增强了隐私保护。其次，它提供了超越官方 App 的自动化能力，支持 JSON 格式输出，方便与 Home Assistant、Prometheus 等监控系统集成，实现网络质量的可观测性。此外，功能覆盖全面，从基础的信号监测到硬件级的收纳控制，满足了从日常使用到设备维护的全生命周期管理需求。对于网络管理员而言，能够快速排查连接设备、诊断信号遮挡问题，显著提升了运维效率。

潜在缺点与局限性

首先，该技能严格依赖本地网络环境，仅在连接 Starlink 路由器时可用，不支持远程访问，这限制了异地管理的可能性。其次，功能存在边界，如云端的设备暂停/恢复功能无法通过本地 API 实现，仍需使用官方 App。第三，外部依赖较重，需要用户自行通过 Cargo 安装 starlink-cli 二进制工具，且要求系统预装 Rust 和 Protocol Buffers 编译器，对非技术用户存在一定门槛。最后，GPS 位置获取功能需要手动在 Starlink App 中开启调试权限，操作流程相对繁琐。

适合的目标群体

该技能主要面向三类用户：Starlink 重度用户，特别是需要频繁监控网络状态或管理大量接入设备的家庭或小型办公室；网络技术爱好者与管理员，希望将 Starlink 集成到现有的网络监控体系中，实现自动化告警和数据分析；以及移动场景使用者，如房车、船舶等需要频繁收纳/展开天线的用户，可通过 CLI 快速控制硬件状态。对于开发者而言，JSON 输出格式也便于构建自定义的网络管理界面。

使用风险

使用该技能需注意以下风险：首先是网络连通性风险，若使用第三方路由器且未正确配置路由（如 bypass 模式），可能导致无法访问 192.168.100.1 管理地址；其次是外部依赖安全风险，虽然 starlink-cli 通过标准 Cargo 安装，但作为 T3 来源（个人开发者）的项目，建议审查代码后再部署；第三是硬件操作风险，reboot 和 stow 命令会中断网络服务，在关键业务运行期间需谨慎执行；最后是隐私合规风险，获取 GPS 坐标功能涉及位置信息，需确保符合当地数据保护法规，并妥善保管包含敏感坐标的 JSON 输出文件。