asl-control

📡 业余无线电节点远程控制终端

基于 AllStar Link ASL3 Agent 的业余无线电节点控制工具,支持节点监控、连接管理和审计追踪,为火腿族提供安全可靠的远程电台管理方案。

收藏
9.2k
安装
1.9k
版本
100.116.156
CLS 安全性认证2026-07-06
点击查看完整报告 >

使用说明

核心用法:本 Skill 作为 AllStar Link ASL3 Agent 的 Python 客户端,通过 REST API 实现对业余无线电节点的远程监控与控制。用户需在树莓派或独立主机上部署 asl-agent 后端服务,通过配置环境变量(ASL_PI_IPASL_API_KEY)建立连接。支持节点状态实时查询、连接/断开远程节点、收藏夹快速拨号、定时网络会话管理(Net profiles)及审计日志查看,输出格式支持 JSON(机器可读)与文本(人类可读)双模式,满足自动化脚本与日常交互需求。

显著优点:代码安全性表现优异,经审计无 eval/exec/system 等危险函数,采用环境变量管理 API 密钥杜绝硬编码风险;具备完善的 argparse 参数类型验证与异常处理机制,错误信息不暴露敏感系统路径;支持 Tailscale 虚拟组网,通过内网 IP 实现安全远程访问,避免公网暴露;状态文件(收藏夹、网络配置)持久化存储于用户主目录,更新后数据不丢失;原生支持 crontab 定时任务集成,可实现自动断线保护与定时网络管理。

潜在缺点与局限性:来源属 T3 级个人开发者账号,长期维护与更新稳定性存疑;缺少 requirements.txt 导致 Python 依赖版本未锁定,可能引发环境兼容性问题;受众高度垂直,仅适用于拥有 AllStar Link 节点及 ASL3 后端服务的业余无线电爱好者;需要用户具备 Linux 基础与网络配置能力(如 Tailscale 部署);部分节点可能因 AllStar 调度器机制在断开后自动重连,需额外修改 ASL 配置才能保持断开状态。

适合目标群体:持有业余无线电执照(HAM)的爱好者、部署了 AllStar Link 节点的电台管理员、需要远程管理节点连接的用户,以及参与应急通信网络(ARES、RACES 等)需要定时会话自动管理的无线电操作员。适合具备一定技术背景、熟悉 Linux 命令行与 REST API 概念的用户。

使用风险:API 密钥需妥善保管,建议将环境变量文件权限设为 600 防止泄露;依赖后端服务可用性,若树莓派或网络故障将导致控制失效;定时任务(net tick)配置不当可能导致意外断线或持续计费连接;状态文件存储于本地磁盘(~/.openclaw/state/asl-control/),多设备使用时需手动同步,否则可能产生数据不一致;虽然支持 Tailscale,但若使用公网 IP 且未配置防火墙,可能面临未授权访问风险。

安全解读

核心功能与用法

asl-control 是一个 AllStar Link 业余无线电节点控制客户端,通过 REST API 与本地部署的 ASL3 Agent 后端通信,实现远程节点监控、连接管理、收藏夹和网络会话自动化。

核心用法

1. 环境配置:需设置 ASL_PI_IP(Tailscale IP 推荐)和 ASL_API_KEY 环境变量,指向自建 ASL Agent
2. 状态监控statusnodesreportaudit 命令实时查看节点状态、连接列表、审计日志

3. 节点控制connect/disconnect 命令建立或断开与其他 ASL 节点的链接,支持 monitor-only 模式

4. 收藏夹管理:保存常用节点为收藏,通过 connect-fav 快速连接

5. 网络会话net 子命令创建定时会话(如应急演练),支持自动断开,需配合 Cron 使用

6. 事件流监听watch 命令持续输出 JSON 格式节点事件

显著优点

  • 功能完整:覆盖 ASL 节点日常操作全场景,收藏夹和网络会话设计贴合 Ham 实际使用习惯
  • 架构清晰:客户端-服务端分离,Agent 独立运行,Python 脚本结构良好,argparse 参数处理规范
  • 状态持久化:收藏夹、会话状态存储于 ~/.openclaw/state/,升级不丢失
  • 审计追踪:所有操作记录审计日志,便于追溯
  • Tailscale 原生支持:文档明确推荐 Tailscale IP,实现任意地点安全访问

潜在局限与风险

  • 部署门槛高:必须自建 ASL Agent 后端(Raspberry Pi),对非技术用户不友好
  • HTTP 明文传输:API 通信使用 HTTP(非 HTTPS),依赖网络层(Tailscale/VPN)加密保护
  • 外部依赖:自动断开功能需用户自行配置 Cron,非内置机制
  • 来源可信度:T3 个人开发者维护,GitHub 仓库信息有限

适合人群

  • 已部署 AllStar Link 节点的业余无线电爱好者(Ham)
  • 需要远程管理节点的应急通信(ARES/RACES)志愿者
  • 具备基础 Linux/网络知识的技术用户

常规风险

  • 配置风险:误配置 ASL_PI_IP 可能连接错误节点;API Key 泄露可导致节点被他人控制
  • 网络风险:若脱离 Tailscale/VPN 直接暴露 HTTP 端口,存在 API Key 嗅探和未授权访问风险
  • ASL 行为特性:部分节点会因 ASL 调度器自动重连,非 Skill 缺陷,需提前禁用调度器
  • 供应链风险:T3 来源,建议隔离环境先行测试

asl-control 内容

scripts文件夹
手动下载zip · 8.9 kB
asl-api.shtext/x-shellscript
请选择文件