名称： starlink
版本： 1.0.0
描述： 通过本地 gRPC API 控制星链天线。获取状态、列出 WiFi 客户端、运行速度测试、收起/展开天线、重启以及获取 GPS 位置。当用户询问星链、网络状态、已连接设备或卫星连接时使用。
主页： https://github.com/danfedick/starlink-cli
元数据： {"clawdbot":{"emoji":"📡","requires":{"bins":["starlink"]},"install":[{"id":"cargo","kind":"cargo","git":"https://github.com/danfedick/starlink-cli","bins":["starlink"],"label":"安装 starlink-cli (cargo)"}]}}

Starlink 命令行工具

通过本地 gRPC API (192.168.100.1:9200) 从命令行控制你的星链天线。

安装

cargo install --git https://github.com/danfedick/starlink-cli

需要 Rust 和 protoc (Protocol Buffers 编译器)。

命令

状态

获取天线状态、运行时间、信噪比、延迟、吞吐量和遮挡信息：

starlink status
starlink status --json

WiFi 客户端

列出连接到星链路由器的设备：

starlink clients
starlink clients --json

输出包含：设备名、MAC 地址、IP 地址、信号强度、接口类型 (2.4GHz/5GHz/ETH) 和连接时间。

速度测试

通过天线运行速度测试：

starlink speedtest
starlink speedtest --json

返回下载/上传速度 (Mbps) 和延迟。

收起/展开

将天线放平以便运输或存放：

starlink stow           # 收起
starlink stow --unstow  # 展开并恢复工作

重启

重启天线：

starlink reboot

位置

获取 GPS 坐标（需先在星链应用中启用：设置 → 高级 → 调试数据 → “允许在本地网络上访问”）：

starlink location
starlink location --json

输出格式

• 默认：人类可读的彩色输出
• --json：适用于脚本处理或解析的 JSON 格式

JSON 解析示例：

starlink status --json | jq '.latency_ms'
starlink clients --json | jq '.[] | .name'

要求

• 已连接到星链网络
• 天线可通过 192.168.100.1:9200 访问
• 获取位置功能：需先在星链应用中启用

故障排除

“无法连接到星链天线”
- 确认你已连接到星链 WiFi 或通过有线方式连接到路由器
- 检查：ping 192.168.100.1
- 如果使用旁路模式连接自己的路由器，请确保 192.168.100.1 仍然可路由

位置信息返回为空
- 在星链应用中启用：设置 → 高级 → 调试数据 → “允许在本地网络上访问”

限制

• 不支持 设备暂停/恢复功能（此为仅限通过星链应用在云端操作的功能）
• 仅限在本地网络使用，无法远程操作

源码

https://github.com/danfedick/starlink-cli