CLI 参考

CLI 参考按控制台路径记录 RouterOS 命令菜单与属性。可使用本节查询 RouterOS 功能的命令语法、配置对象与操作命令。

CLI 参考

CLI 参考按控制台路径记录 RouterOS 命令菜单与属性。可使用本节查询 RouterOS 功能的命令语法、配置对象与操作命令。

参数类型

• address：通用地址参数，显示为 address (flags=...)；请参阅下方 地址标志
• alt：替代类型，可接受多种不同值类型之一
• as：自治系统编号（用于 BGP 路由）
• bool：布尔值（true/false、yes/no）
• cfg：配置条目标识符
• composite：作为一组处理的多个参数组合
• date：日期与时间值
• enum：枚举器，括号中列出预定义值
• expr：表达式或条件（用于路由过滤器与脚本）
• file：文件路径或名称引用
• iface_enum：接口选择列表，通常可接受接口名称或 all、none、dynamic、slave 等预定义值；取值列在花括号中
• ipAddr：IPv4 地址
• ip6Addr：IPv6 地址
• ipPrefix：带前缀长度的 IPv4 地址
• ip6Prefix：带前缀长度的 IPv6 地址
• ipRange：IPv4 地址范围
• macAddr：MAC 地址（可指定完整地址或使用通配符）
• meter：信号质量级别，通常以 dBm 表示
• multi：多值参数，可从定义集合中接受多个值
• num：无符号整数，可通过范围限制（例如 [3 .. 20]、[.. 10]、[4 ..]）；未明确指定时为 32 位范围
• numericon：带单位后缀显示的数字值
• object：结构化值列表（例如地址表或配置项表）
• pic：图片/位图值
• range：数字范围（例如一组端口）
• remote：远程对象引用（例如路由过滤规则）
• string：文本字符串
• super：可接受多种不同参数类型的复合类型；子类型列在花括号中，例如 super { bool, time }
• switch：无需显式值参数的开关
• time：持续时间或间隔，通常以秒为单位，可包含 s、m、h、d 等单位
• timezone：时区或 UTC 偏移值
• ubit：带命名位的位字段，支持的位名称列在括号中，例如 ubit (ip, ipv6)
• value：独立值标识符（通常作为复合类型或枚举的一部分）
• varName：变量名引用（用于脚本）

参数类型可以嵌套，例如 super {num, time, super {bool, ip}}。

address-flags

address 类型显示为 address (flags=...)，其中标志定义可接受的地址格式：

i 与 % 标志的区别在于接口出现的位置。使用 i 时，裸接口名称替代地址。使用 % 时，接口只是附加到完整地址后的限定符，用于区分路由器范围内不唯一的地址，例如 IPv6 链路本地地址。

请注意，%interface 后缀是 IPv6 链路本地寻址本身的一部分：没有区域说明符时链路本地地址存在歧义，因此任何接受 IPv6 地址的参数（标志 6）都接受 link-local%interface，即使其标志列表不包含 %。% 标志表示该参数更广泛地支持此后缀，例如为 MAC ping 选择出接口。