SuperAPI AI 工具集

routeros-fundamentals

通用与其它

查看项目

更新于 10-16 01:12

技能介绍

用途:为 AI 智能体提供 MikroTik RouterOS v7 的领域知识,适用于编写 RouterOS CLI/脚本命令、调用 REST API、排查配置等场景。

核心认知:RouterOS 虽运行 Linux 内核(5.6.3),但内核之上是 MikroTik 专有的 nova 系统,并非 GNU/Linux。不存在 /bin、/usr、/etc 等 FHS 布局,没有 bash/sh 等 Unix shell,没有 coreutils、glibc、busybox,没有 apt/opkg 包管理器(软件包为 .npk,上传后重启安装),没有 systemctl/init,用户态无法访问 /proc、/sys,也没有 docker/podman(7.x+ 有自有 /container 子系统)。

存在的能力:RouterOS CLI(自有语言,经 SSH、串口、WinBox、WebFig 访问)、/rest/ REST API(默认 HTTP 80 端口)、.rsc 脚本语言、WebFig(80 端口)、WinBox 协议(8291 端口)。

CLI 语法:基于路径导航,如 /ip/address/print、/ip/address/add address=192.168.1.1/24 interface=ether1、/ip/address/set [find interface=ether1] ...、/ip/address/remove [find ...]。= 赋值,[find ...] 为查询表达式,字符串用双引号,注释用 #,变量用 :local 与 $。无管道、重定向、子 shell。

REST API:GET=print、PUT=add(创建而非更新)、PATCH=set、DELETE=remove、POST=command。空密码认证为 admin:(需冒号)。WebFig 根路径 GET / 无需认证返回 200,可作健康检查;/rest/ 需认证。.id 为 *HEX 格式。

版本与架构:版本格式 MAJOR.MINOR[.PATCH][betaN|rcN],分 stable/long-term/testing/development 通道。架构标识为 x86、arm64、arm、mipsbe、mmips、smips、ppc、tile;CHR 仅支持 x86 与 arm64。默认凭据为 admin、空密码。

限制与注意:不要尝试 ssh 后执行 ls /,不要建议 mount/fdisk/mkfs(用 /disk),配置存于 RouterOS 数据库而非 /etc/,ping 用 /tool/ping,安装包需 SCP 上传 .npk 后执行 /system/package/apply-changes(7.18+)或 /system/reboot(<7.18)。更多细节可参考官方手册 https://manual.mikrotik.com/ 及相关参考文件。