cli-anything-rms 是面向 Teltonika RMS(Remote Management System,远程管理系统)的命令行工具,用于通过 RMS REST API 管理路由器、网关和 IoT 设备。
用途 该工具将 Teltonika RMS 的远程管理能力封装为命令行接口,便于在终端中批量或脚本化地管理设备、公司、用户、告警、配置、远程访问、日志、位置、积分、文件、报告、热点、密码和 SMTP 等资源。
安装 pip install git+https://github.com/HKUDS/CLI-Anything.git#subdirectory=rms/agent-harness
认证 可通过设置环境变量 RMS_API_TOKEN,或运行 cli-anything-rms config set api_token <token> 来配置 API 令牌。
主要能力(命令组)
- devices:列出设备(支持按状态 online/offline、标签、分页、排序过滤)、获取设备详情、更新设备(名称、标签)、删除设备。
- companies:列出、获取、创建、更新、删除公司。
- users:列出、获取、邀请(指定邮箱与角色)、更新(角色)、删除用户。
- tags:列出、获取、创建、更新、删除标签。
- alerts:列出告警(可按设备过滤)、获取告警详情、删除告警;以及告警配置的列出、获取、创建(--data JSON)、更新、删除。
- configs:列出设备配置、获取配置、更新配置(--data JSON)。
- remote-access:列出会话(可按设备过滤)、获取会话详情、创建会话(指定设备、协议、端口)、删除会话。
- logs:列出日志(可按设备过滤、分页)、获取日志详情、删除日志。
- location:获取设备当前位置、查询位置历史(分页)。
- credits:列出积分、转移积分(--code)、列出转移码。
- files:列出文件、获取文件详情、上传文件、删除文件。
- reports:列出报告、获取报告、创建报告(指定模板与名称)、删除报告;以及列出报告模板。
- hotspots:列出热点(可按设备过滤)、获取热点详情、创建热点(指定设备与名称)、更新热点(名称)、删除热点。
- passwords:获取设备密码、更新设备密码(--password 或 --password-stdin 从标准输入读取,更安全)。
- smtp:列出、获取、创建(指定主机、端口、用户名、密码)、更新、删除 SMTP 配置。
- auth:测试 API 连通性、显示当前认证信息。
- config:设置配置(api_token、default_limit)、获取配置、删除配置、显示配置文件路径。
使用方式 安装并配置 API 令牌后,通过 cli-anything-rms <命令组> <子命令> [选项] 执行操作。支持 --json 输出 JSON 格式,也支持交互模式(直接运行 cli-anything-rms)。示例:
- 列出所有在线设备:cli-anything-rms devices list --status online
- 以 JSON 获取设备详情:cli-anything-rms --json devices get 12345
- 查看指定设备的告警:cli-anything-rms alerts list --device 12345
- 交互模式:cli-anything-rms
适用场景 适用于需要通过命令行或脚本自动化管理 Teltonika RMS 中路由器、网关和 IoT 设备的场景,例如批量查询设备状态、管理用户与公司、处理告警与配置、创建远程访问会话、上传文件、生成报告等。
限制 资料未提供关于收费、价格、平台兼容性、性能或具体使用效果的说明,暂未提供相关信息。