Wi-Fi 6 / 7 (802.11ax/be)
本页介绍 RouterOS 中的 WiFi 配置菜单,涵盖密码保护接入点和 OWE 过渡模式接入点的基本设置。它说明了配置配置文件、安全设置,并包含用于重置配置的示例。
Wi-Fi 6 / 7 (802.11ax/be)
本节涵盖 MikroTik Wi-Fi 6 / 6E / 7(802.11ax/be) 设备,它们都通过共享的 /interface/wifi 菜单进行配置。设备需要哪个驱动程序包取决于其无线芯片组和标准。同一菜单也涵盖运行 wifi-qcom-ac 包的 Wi-Fi 5(802.11ac) 设备。
这个部分适合我的设备吗?
此菜单(以及本手册)适用于运行以下某个驱动程序包的每一台设备:
Package Devices Examples wifi-qcomWi-Fi 6 / 6E (Qualcomm) wAP ax, cAP ax, hAP ax³ wifi-qcom-beWi-Fi 7 (Qualcomm) hAP be3 media wifi-mediatekWi-Fi 6 / 7 (MediaTek) hAP ax S, hAP be lite wifi-qcom-acWi-Fi 5 / 802.11ac (Qualcomm) 参见 Wi-Fi 5 (802.11ac) 标准通常编码在型号名称中——Wi-Fi 6 为 ax,Wi-Fi 7 为 be。对于
wifi-qcom-ac设备,请参阅 Wi-Fi 5 (802.11ac) 以确认你的设备应使用此菜单还是旧版/interface/wireless菜单。如果你的设备改用旧版
/interface/wireless菜单,请参阅 802.11 a/b/g/n。 说明在 7.13 之前的 RouterOS 版本中,此菜单是名为
wifiwave2的独立包的一部分。
入门
刚开始接触这些设备?请先阅读面向任务的指南,然后使用本页后面的属性参考来了解各个设置:
WiFi 术语
在继续之前,让我们先熟悉一些对理解此菜单操作很重要的术语。这些术语将在整篇文章中使用。
- Profile - 指在这些 WiFi 子菜单之一下创建的配置预设:aaa、channel、security、datapath 或 interworking。
- Configuration profile - 在
/interface/wifi/configuration下定义的配置预设,它可以引用各种 profile。 - Station - 无线客户端。
Basic Configuration
完全配置兼容设备的最简单方法是通过 /interface/wifi/network 菜单,它将 SSID、security、datapath 和 radio 设置捆绑到单个配置实体中。或者,也可以按下文示例所示逐接口应用设置。
Network
network 应用于与其 labels 匹配的 WiFi 接口。如果未指定 labels,则 network 的配置将应用于所有接口。
有关 network 配置用法的示例,请参阅以下内容:
# Creating a network preset with SSID, security and datapath settings, which gets applied to all available interfaces
/interface/wifi/network
add ssid=MikroTik mode=ap security.authentication-types=wpa2-psk,wpa3-psk security.passphrase="strong_password" datapath.bridge=bridge1 disabled=no
# Create a network radio preset, which gets applied to the whole radio.
/interface/wifi/network/radio
add configuration.country=Latvia
启用 Multi-Link Operation(MLO)的示例:
/interface/wifi/network
add datapath.bridge=bridge1 disabled=no mlo=yes mode=ap security.authentication-types=wpa3-psk ssid="MikroTik" security.passphrase="strong_password"
| Property | Description |
|---|---|
| mlo (no | yes; default: yes) | 为 Wi-Fi 7 启用 Multi-Link Operation。 |
| labels (comma-separated strings) | 在与所提供的任一 label 匹配的 radio 上启用 network 配置。 |
| ssid (string) | 无线网络名称(ESSID)。 |
| mode (ap | station | station-bridge | station-pseudobridge; default: ap*) | 接口运行模式。 |
| disabled (no | yes; default: no) | network 是否被禁用。 |
所有安全、认证和加密参数(passphrase、WPA3/SAE、EAP 等)都共享 Security Properties 中描述的相同属性。Datapath 参数(bridge、VLAN、客户端隔离、流量处理)遵循 Datapath Properties。
Network radio 属性
/interface/wifi/network/radio 下的每个 radio 设置:
| Property | Description |
|---|---|
| labels (object) | 将 radio 配置与具有给定 label 的物理 radio 匹配。 |
| extra-labels (multi string) | 用于匹配的附加 label,扩展主 labels 字段。 |
| disabled (no | yes; default: no) | radio 条目是否被禁用。 |
Radio 参数(country、band、frequency、width、chains、power 等)使用 Channel Properties 和 Configuration Properties 中描述的相同属性。
基本的密码保护 AP
当 /interface/wifi/network 菜单不可用或需要逐接口覆盖时,直接逐接口设置可用于每台设备,并仍然得到完全支持。
/interface/wifi
set wifi1 disabled=no configuration.country=Latvia configuration.ssid=MikroTik security.authentication-types=wpa2-psk,wpa3-psk security.passphrase=8-63_characters
使用 OWE 过渡模式的开放 AP
机会性无线加密(OWE)允许创建无需知道密码即可连接,但仍提供流量加密和管理帧保护优势的无线网络。它是对常规开放接入点的改进。
然而,由于一个网络不能同时加密和不加密,因此需要 2 个独立的接口配置,才能为不支持 OWE 的旧设备提供连接,并为支持 OWE 的设备提供 OWE 的优势。
这种配置称为 OWE 过渡模式。
/interface/wifi
add master-interface=wifi1 name=wifi1_owe configuration.ssid=MikroTik_OWE security.authentication-types=owe security.owe-transition-interface=wifi1 configuration.hide-ssid=yes
set wifi1 configuration.country=Latvia configuration.ssid=MikroTik security.authentication-types="" security.owe-transition-interface=wifi1_owe
enable wifi1,wifi1_owe
使用这种设置时,AP 将广播两个 SSID → 可见的 MikroTik SSID,它应具有 "unencrypted" 访问(适用于不支持 OWE 的旧设备),以及隐藏的 SSID MikroTik_OWE,它应具有 "OWE" 安全(无密码保护,但加密)。客户端设备(在客户端的 WiFi 列表中)将看不到隐藏的 MikroTik_OWE SSID,但是,可见 MikroTik SSID 的 beacon 数据包将改为使用 "OWE Transition mode" 参数(在 beacon 数据包中)通告到隐藏 MikroTik_OWE 网络的链接。因此,客户端设备应通过 owe-transition-interface 设置优先连接到 "OWE" 网络。
支持 OWE 的客户端设备将偏好 OWE 接口。如果你在 registration table 中看不到任何与常规开放 AP 关联的设备,你可能希望从运行过渡模式设置转向单个 OWE 加密接口:
/interface/wifi
set wifi1 configuration.country=Latvia configuration.ssid=MikroTik_OWE security.authentication-types=owe
信息
802.11r(快速漫游)在 OWE 网络上无法工作。
重置配置
WiFi 接口配置可以使用 'reset' 命令重置。
/interface/wifi/reset wifi1
物理接口 MAC 地址可以通过 'reset-mac-address' 命令重置为默认值。
/interface/wifi/reset-mac-address wifi1
配置配置文件
WiFi 新增的功能之一是配置配置文件。你可以创建各种预设,并根据需要分配给接口。WiFi 的配置设置根据本页末尾找到的参数部分分组到 profiles 中——aaa、channel、configuration、datapath、interworking 和 security,然后可以分配给接口。Configuration profiles 可以包含其他 profile 以及来自其他类别的单独参数。
这种可选的灵活性旨在让每个用户以其最合理的方式安排配置,但这也意味着每个参数在配置的不同部分可能被赋予不同的值。
以下优先级决定使用哪个值:
- 接口设置中的值。
- 分配给接口的 profile 中的值。
- 分配给接口的配置 profile 中的值。
- 分配给配置 profile(其又分配给接口)的 profile 中的值。
如果在任何时候你不确定某个接口将使用哪个参数值,可以执行 "/interface/wifi/print detail"。print 命令将显示接口将具有的所有值,包括继承的值。
要仅查看直接在接口上配置的值,而不显示继承的值,请使用 "/interface/wifi/print config"。
有关配置 profile 用法的示例,请参阅以下内容(双频家庭 AP 示例):
# Creating a security profile, which will be common for both interfaces
/interface/wifi/security
add name=common-auth authentication-types=wpa2-psk,wpa3-psk passphrase="diceware makes good passwords" wps=disable
# Creating a common configuration profile and linking the security profile to it
/interface/wifi/configuration
add name=common-conf ssid=MikroTik country=Latvia security=common-auth
# Creating separate channel configurations for each band
/interface/wifi/channel
add name=ch-2ghz frequency=2412,2432,2472 width=20mhz
add name=ch-5ghz frequency=5180,5260,5500 width=20/40/80mhz
# Assigning to each interface the common profile as well as band-specific channel profile, in case of "no supported channels" message on interfaces, make sure that correct (channel) configuration is applied to each.
set wifi1 channel=ch-5ghz configuration=common-conf disabled=no
set wifi2 channel=ch-2ghz configuration=common-conf disabled=no
#"print detail" will show all values that the interface will use, including inherited ones
[admin@c52i] > /interface/wifi/print detail
Flags: M - master; D - dynamic; B - bound; X - disabled, I - inactive, R - running
0 M B default-name="wifi1" name="wifi1" l2mtu=1560 mac-address=18:FD:74:AF:F4:28 arp-timeout=auto radio-mac=18:FD:74:AF:F4:28 configuration=common-conf
configuration.mode=ap .ssid="MikroTik" .country=Latvia
security.authentication-types=wpa2-psk,wpa3-psk .passphrase="diceware makes good passwords" .wps=disable
channel=ch-5ghz
channel.frequency=5180,5260,5500 .width=20/40/80mhz
1 M B default-name="wifi2" name="wifi2" l2mtu=1560 mac-address=18:FD:74:AF:F4:29 arp-timeout=auto radio-mac=18:FD:74:AF:F4:29 configuration=common-conf
configuration.mode=ap .ssid="MikroTik" .country=Latvia
security.authentication-types=wpa2-psk,wpa3-psk .passphrase="diceware makes good passwords" .wps=disable
channel=ch-2ghz
channel.frequency=2412,2432,2472 .width=20mhz
#using "print detail config" will show only the values that were directly configured on the interface
[admin@c52i] > /interface/wifi/print detail config
Flags: M - master; D - dynamic; B - bound; X - disabled, I - inactive, R - running
0 M B default-name="wifi1" name="wifi1" l2mtu=1560 mac-address=18:FD:74:AF:F4:28 arp-timeout=auto radio-mac=18:FD:74:AF:F4:28 configuration=common-conf
configuration.mode=ap
channel=ch-5ghz
1 M B default-name="wifi2" name="wifi2" l2mtu=1560 mac-address=18:FD:74:AF:F4:29 arp-timeout=auto radio-mac=18:FD:74:AF:F4:29 configuration=common-conf
configuration.mode=ap
channel=ch-2ghz
信息
print detail和print detail config也可以在/interface/wifi/configuration上使用,其工作方式与在/interface/wifi/菜单中相同。
Access List
access list 提供了多种过滤和管理无线连接的方式。
RouterOS 将检查每个新连接,看其参数是否匹配任何 access list 规则中指定的参数。
规则按它们在列表中的出现顺序进行检查。每个连接仅应用第一个匹配规则中指定的管理操作。
已被 access list 规则接受的连接将被定期检查,看它们是否仍处于允许的 time、days 和 signal-range 内。如果不在,它们将被终止。
警告
编写拒绝客户端的 access list 规则时要小心。在被 AP 反复拒绝后,客户端设备可能会开始避开它。在为 wifi-qcom-ac 接口的客户端配置 pvid 值之前,access list 无法为其设置 VLAN ID。 access list 有两类参数——filtering 和 action。Filtering 属性仅用于匹配应应用 access list 规则的客户端。Action 参数可以更改该特定客户端的连接参数,并可能用 access list 规则中指定的参数覆盖其默认连接参数。
MAC 地址认证
MAC 地址认证通过 query-radius 操作实现,是一种使用 RADIUS 服务器实现客户端 MAC 地址集中白名单的方式。
当客户端设备尝试与配置为执行 MAC 地址认证的 AP 关联时,AP 将向 RADIUS 服务器发送 access-request 消息,其中使用设备的 MAC 地址作为用户名,密码为空。如果 RADIUS 服务器对此类请求以 access-accept 应答,则 AP 继续执行接口配置的任何常规认证过程(passphrase 或 EAP 认证)。
访问规则示例
仅在营业时间内接受来自附近设备到访客网络的连接:
/interface/wifi/access-list/print detail
Flags: X - disabled
0 signal-range=-60..0 allow-signal-out-of-range=5m ssid-regexp="MikroTik Guest" time=7h-19h days=mon,tue,wed,thu,fri action=accept
1 ssid-regexp="MikroTik Guest" action=reject
拒绝来自本地管理('anonymous'/'randomized')MAC 地址的连接:
/interface/wifi/access-list/print detail
Flags: X - disabled
0 mac-address=02:00:00:00:00:00 mac-address-mask=02:00:00:00:00:00 action=reject
如果需要对特定客户端提供无线访问,但不想共享无线密码,或不想创建单独的 SSID,则为特定客户端分配不同的 passphrase 会很有用。当匹配的客户端连接到此网络时,access list 将使该客户端使用不同的密码,而不使用接口配置中定义的密码。只需确保该特定客户端不会先被更通用的 access list 规则匹配。
或者拒绝所有未知 MAC 地址,可以作为最终规则添加在 access list 的末尾。- 如果你只想允许特定客户端在网络上,请务必在 access-list 末尾也添加一条 reject 规则,因为默认没有隐式 reject 规则。
/interface/wifi/access-list
add action=accept disabled=no mac-address=22:F9:70:E5:D2:8E interface=wifi1 passphrase=StrongPassword
频率扫描
/interface/wifi/frequency-scan wifi1 命令提供有关可用信道上 RF 状况的信息,这些信息可以通过运行 frequency-scan 命令获得。用于近似估计频谱使用情况,它有助于找到不太拥挤的频率。

信息
运行频率扫描将断开所有已连接的客户端,或者如果接口处于 station 模式,它将断开与 AP 的连接。
Scan 命令
/interface/wifi/scan 命令将扫描接入点,并打印出它检测到的任何 AP 的信息。它不显示每个信道的频率使用情况,但会显示所有正在发送的接入点。你可以使用 "connect" 按钮发起与特定 AP 的连接。
scan 命令接受与 frequency-scan 命令相同的所有参数。

Sniffer
sniffer 命令在无线接口上启用 monitor 模式。这会将接口变为所有 WiFi 传输的被动接收器。 该命令持续打印接收到的数据包信息,并可以将它们本地保存到 pcap 文件,或使用 TZSP 协议进行流式传输。
sniffer 将在所选接口配置的任何信道上运行。

Spectral scan
spectral scan 可以扫描 wifi 接口支持的频率,并直接在控制台中绘制它们。
信息
Spectral scan 仅由 wifi-qcom 驱动程序支持;wifi-qcom-ac 驱动程序不支持它。
/interface/wifi/spectral-scan <wifiinterface name> range=

此命令持续监控频谱数据。此命令使用与 spectral-history 相同的数据源,并共享许多参数。
要使用 spectral scan,必须使用 range= 属性。
每一行显示一个频谱图桶——频率、幅度(dBm)、峰值和一个字符图形条。条形用 ':' 字符显示功率值,用 '.' 字符显示平均峰值保持。
data - min/max/avg,默认情况下数据使用平均值。在大多数情况下应使用平均值,但在某些情况下 "min" 可用于检查是否存在任何具有恒定信号输出的频率。Max 表示在扫描间隔期间检测到的最强信号,类似于峰值。
duration - 在指定时间后终止命令。默认是无限期;
freeze-frame-interval - 更新命令输出的时间间隔
interval - 更新主要数据值(而非峰值)的频率间隔
peak-mode - avg/max/disabled - 峰值反映 peak-hold-duration 期间的最强信号。默认使用 "avg"。它是 "peak-hold-duration" 期间最大值的平均值。如果使用 "max",则显示最高值,直到下一次 "peak-hold-duration" 更新。
peak-hold-duration - 更改 peak-mode 使用的峰值保持持续时间,默认 5 秒。
range - 扫描特定范围,必需;
resolution - spectral scan 的频率步长
show-interference - yes/no
可能的分类干扰类型:
- Microwave oven (
MWO)。 - Continuous Wave (
CW)。 - WLAN (Wideband) (
WIFI)。 - Cordless phone 2.4 (
CORDLESS24)。 - Cordless phone 5 (
CORDLESS5)。 - Bluetooth (
BLUETOOTH)。 - Frequency hopping spread spectrum (
FHSS)。
Spectral history
/interface/wifi/spectral-history <wifi interface name> range=

绘制频谱图。落入不同范围的功率值以具有相同前景和背景颜色的不同颜色字符打印,因此可以复制和粘贴此命令的终端输出。
data - min/max/avg,默认情况下数据使用平均值。在大多数情况下应使用平均值,但在某些情况下 "min" 可用于检查是否存在任何具有恒定信号输出的频率。Max 将显示检测到的最强信号,而不是平均信号。
interv - 更新数据值的频率间隔;
interval - 打印频谱图行的间隔;
duration - 在指定时间后终止命令。默认是无限期;
range - 扫描特定范围,必需;
resolution - 频率步长;
show-interference - yes/no
可能的分类干扰类型:
- Microwave oven (
O)。 - Continuous Wave (
C)。 - WLAN (Wideband) (
W)。 - Cordless phone 2.4 (
T)。 - Cordless phone 5 (
T)。 - Bluetooth (
BB)。 - Frequency hopping spread spectrum (
F)。
WPS
WPS client
wps-client 命令用于从启用了 WPS 的 AP 获取认证信息。
/interface/wifi/wps-client/wifi1
WPS server
通过运行以下命令,可以使 AP 在 2 分钟内接受客户端设备的 WPS 认证。
/interface/wifi/wps-push-button wifi1
Radios
可以通过运行 /interface/wifi/radio/print detail 命令获取有关每个 radio 能力的信息。查看接口支持哪些频段以及可以选择哪些信道会很有用。应用于接口的 country profile 将影响结果。
/interface/wifi/radio/print detail
Flags: L - local
0 L radio-mac=48:A9:8A:0B:F7:4A phy-id=0 tx-chains=0,1 rx-chains=0,1
bands=5ghz-a:20mhz,5ghz-n:20mhz,20/40mhz,5ghz-ac:20mhz,20/40mhz,20/40/80mhz,5ghz-ax:20mhz,
20/40mhz,20/40/80mhz
ciphers=tkip,ccmp,gcmp,ccmp-256,gcmp-256,cmac,gmac,cmac-256,gmac-256 countries=all
5g-channels=5180,5200,5220,5240,5260,5280,5300,5320,5500,5520,5540,5560,5580,5600,5620,5640,5660,
5680,5700,5720,5745,5765,5785,5805,5825
max-vlans=128 max-interfaces=16 max-station-interfaces=3 max-peers=120 hw-type="QCA6018"
hw-caps=sniffer interface=wifi1 current-country=Latvia
current-channels=5180/a,5180/n,5180/n/Ce,5180/ac,5180/ac/Ce,5180/ac/Ceee,5180/ax,5180/ax/Ce,
5180/ax/Ceee,5200/a,5200/n,5200/n/eC,5200/ac,5200/ac/eC,5200/ac/eCee,5200/ax...
...5680/n/eC,5680/ac,5680/ac/eC,5680/ax,5680/ax/eC,5700/a,5700/n,5700/ac,5700/ax
current-gopclasses=115,116,128,117,118,119,120,121,122,123 current-max-reg-power=30
虽然 Radio 信息为我们提供了有关支持的信道宽度的信息,但也可以从产品页面推断此信息。为此,你需要检查以下参数:number of chains、max data rate。一旦你知道这些参数,就需要检查调制与编码方案(MCS)表,例如这里:https://mcsindex.com/。
如果我们以 hAP ax <sup>2</sup> 为例,可以看到链数为 2,max data rate 在 MCS 表中为 1200 - 1201。在 MCS 表中,我们需要找到 2 个空间流 - 链的条目以及相应的数据率,在本例中这表明 80MHz 是支持的最大信道宽度。
Registration table
/interface/wifi/registration-table/ 显示已连接无线客户端的列表及其详细信息。

解除认证
无线对等端可以通过从 registration table 中移除来手动解除认证(强制重新关联)。
/interface/wifi/registration-table/remove [find where mac-address=02:01:02:03:04:05]
WiFi CAPsMAN
适用于新 WiFi 菜单的 CAPsMAN(Controlled Access Point system Manager)允许你从中央控制器将无线设置应用于许多 MikroTik WiFi AP。请参阅专门页面:WiFi CAPsMAN。
高级示例
Enterprise wireless security with User Manager v5
替换 'wireless' 软件包
一些 MikroTik Wi-Fi 5 AP 出厂时其接口由 'wireless' 菜单管理,它们可以将 'wireless' 包替换为 'wifi-qcom-ac' 包,使其接口改为兼容 'wifi' 菜单。
为此,需要卸载 'wireless' 包,然后安装 'wifi-qcom-ac'。
信息
请注意,"wifi-qcom-ac" 驱动程序对资源的要求高得多。使用新包时可用 RAM 会更少,这是需要牢记的一点。
兼容性
wifi-qcom-ac 包包含 IPQ4018/4019 和 QCA9984 radio 的替代驱动程序,使它们兼容 WiFi 配置菜单。有关可能的 wifi-qcom-ac/wifi-qcom/wireless 包组合,请参阅此处的 package types 部分。
根据经验,该包与具有 ARM CPU 的 802.11ac 产品兼容。它与任何具有 MIPS CPU 的 802.11ac 产品都不兼容。
| Compatibility | Devices |
|---|---|
| Compatible | Audience, Audience LTE kit, Chateau (all variants of D53), hAP ac<sup>2</sup>, hAP ac<sup>3</sup>, cAP ac, cAP XL ac, LDF 5 ac, LHG XL 5 ac, LHG XL 52 ac, NetMetal ac<sup>2</sup>, mANTBox 52 15s, wAP ac (RBwAPG-5HacD2HnD), SXTsq 5 ac |
| Incompatible | RB4011iGS+5HacQ2HnD-IN (no support for the 2.4GHz interface), Cube 60Pro ac (no support for the 60GHz interface), wAP ac (RBwAPG-5HacT2HnD) and all other devices with a MIPSBE CPU |
优势
- WPA3 认证和 OWE(机会性无线加密)。
- 802.11w 标准管理帧保护。
- 802.11r/k/v。
- MU-MIMO 和 beamforming。
- IPQ4019 接口在 2.4GHz 频段中最大数据率为 400Mb/s。
信息
这些优势同时适用于 wifi-qcom 和 wifi-qcom-ac 包。
丢失的功能
在使用与 'wifi' 管理接口兼容的驱动程序运行 802.11ac 产品时,会丢失以下显著功能:
- Nstreme 和 Nv2 无线协议。
- 无线设置中的 VLAN 配置(逐接口 VLAN 可以在 bridge 设置中配置)。
- 与 'wireless' 包中实现的 station-bridging 的兼容性。Station-bridge 仅在相同类型的驱动程序之间工作。WiFi 到 WiFi,以及 Wireless 到 Wireless。
属性参考
AAA 属性
此类别中的属性配置接入点与 AAA(RADIUS)服务器的交互。
下表中的某些参数以 format-string 作为其值。在 format-string 中,某些字符按以下方式解释:
| Character | Interpretation |
|---|---|
| a | 构成客户端设备 MAC 地址的小写十六进制字符 |
| A | 构成客户端设备 MAC 地址的大写十六进制字符 |
| i | 构成 AP 接口 MAC 地址的小写十六进制字符 |
| I (capital 'i') | 构成 AP 接口 MAC 地址的大写十六进制字符 |
| N | AP 接口的完整名称(例如 'wifi1') |
| S | 完整的 SSID |
所有其他字符直接使用,不以任何方式解释。有关示例,请参阅默认值。
| Property | Description |
|---|---|
| called-format (format-string; Default: II-II-II-II-II-II:S) | 在 AP 发往 RADIUS 服务器的消息中,Called-Station-Id RADIUS 属性值的格式。 |
| calling-format (format-string; Default: AA:AA:AA:AA:AA:AA) | 在 AP 发往 RADIUS 服务器的消息中,Calling-Station-Id RADIUS 属性值的格式。 |
| interim-update (time interval; Default: 5m) | 向 RADIUS 服务器发送流量 accounting 临时更新的间隔。 |
| mac-caching (time interval; Default: disabled) | 启用 MAC 地址认证时,缓存 RADIUS 服务器响应的时长。这解决了由于 RADIUS 服务器响应延迟相对较高而导致客户端设备认证超时的问题。 |
| name (string; Default: no) | AAA profile 的唯一名称。 |
| nas-identifier (string) | 在 AP 发往 RADIUS 服务器的消息中,NAS-Identifier 属性的值。默认为设备的主机名(/system/identity)。 |
| password-format (format-string) | 在执行 MAC 地址认证时,用于计算 AP 发往 RADIUS 服务器的消息中 User-Password 属性值所使用的格式。默认值:""(空字符串)。 |
| username-format (format-string; Default: AA:AA:AA:AA:AA:AA) | 在执行 MAC 地址认证时,AP 发往 RADIUS 服务器的消息中 User-Name 属性值的格式。 |
Channel properties
此类别中的属性指定所需的 radio 信道。
| Property | Description |
|---|---|
| band (2ghz-g | 2ghz-n | 2ghz-ax| 2ghz-be | 5ghz-a | 5ghz-ac | 5ghz-an | 5ghz-ax | 5ghz-be| 6ghz-ax | 6ghz-be) | AP 将使用的频段和无线标准。默认为支持的最新标准。注意,频段支持受 radio 能力限制。 |
| deprioritize-unii-3-4 (no | yes) | 是否对控制频率为 5720 或 5825-5885 MHz 的信道分配较低优先级。这些信道不受某些客户端设备支持,因此自动选择它们并不可取。在 ETSI 监管域中默认为 'yes',其他地方为 'no'。 |
| frequency (list of numbers or number ranges) | 对于处于 AP 模式的接口,指定选择控制信道中心频率时要考虑的频率(以 MHz 为单位)。对于处于 station 模式的接口,指定扫描 AP 的频率。保持未设置(默认)以考虑 radio 支持且适用监管配置文件允许的所有频率。该参数可以包含 1 个或多个以逗号分隔的十进制数字值,或可选的数字范围,范围使用语法 RangeBeginning-RangeEnd:RangeStep 表示。有效 channel.frequency 值的示例:24122412,2432,24725180-5240:20,5500-5580:20 |
| preamble-puncturing (no | yes; Default: no) | 在此接口上为 DFS/radar 启用 puncturing 支持(仅限 802.11be)。设置后,当检测到雷达信号存在时,接入点可以仅禁用("puncture")宽 80/160 MHz 信道中受影响的 20 MHz 部分,而不是切换整个信道。对于 80 MHz 信道,可以 puncture 单个 20 MHz 子信道。对于 160 MHz 信道,可以 puncture 一个 20 MHz 子信道或一个 40 MHz 块。当前 puncturing 状态可以在此接口的 /interface/wifi/monitor 输出中观察,其中被 puncture 的子信道用字母 o 标记。 |
| reselect-interval (time interval; Default: disabled) | 指定接口应运行 "rescan channel availability" 并选择最合适信道的时间间隔。指定间隔将允许系统动态且随机地选择此间隔。这有助于避免许多 AP 同时扫描网络、选择相同信道并倾向于同时使用它的情况。reselect-interval 使用后台扫描。reselect 过程将考虑信道中的网络数量、信道使用情况以及与相邻信道中网络的重叠,选择最合适的信道。它可以与定义的频率列表一起使用,或在未设置 frequency 时使用——使用所有支持的频率。示例:01:00..01:30 → 将信道重新扫描设置为每 1 小时 + 最多 30 分钟的随机时间运行。第一次可能在 "1 小时 15 分钟" 后运行重新扫描,之后可能是 "1 小时 1 秒",然后可能是 "1 小时 29 分钟 59 秒"……随机地,重新扫描将在每 1 小时到 1 小时 30 分钟之间发生。 |
| reselect-time (time interval; Default: disabled) | 指定接口应运行 "rescan channel availability" 并选择最合适信道的时钟时间。指定时钟时间将允许系统动态且随机地选择此时间。这有助于避免许多 AP 同时扫描网络、选择相同信道并倾向于同时使用它的情况。reselect-time 使用后台扫描。reselect 过程将考虑信道中的网络数量、信道使用情况以及与相邻信道中网络的重叠,选择最合适的信道。它可以与定义的频率列表一起使用,或在未设置 frequency 时使用——使用所有支持的频率。示例:01:00..01:30 → 将信道重新扫描设置为每晚一次,随机在系统时钟时间的 01:00 AM 到 01:30 AM 之间运行。14:00..14:30 → 将信道重新扫描设置为每天(中午之后)一次,随机在系统时钟时间的 14:00:00 到 14:30:00(或下午 2 点到 2:30)之间运行。 |
| secondary-frequency (list of integers | Default: disabled) | 对于分离的 80+80MHz 信道,指定辅助 80MHz 段允许的中心频率。对于 320MHz 信道,指定允许的 320MHz 信道中心。未设置(默认)时,不限制信道选择。例如 'width=20/40/80+80mhz frequency=5180' 将允许信道 42 与任何其他支持的 80MHz 信道组合。'width=20/40/80+80mhz frequency=5180 secondary-frequency=5530' 将仅允许组合信道 42 和 106。'width=20/40/80/160/320mhz frequency=6115' 将允许使用信道 31 或 63。'width=20/40/80/160/320mhz frequency=6115 secondary-frequency=6265' 仅允许使用信道 63。有关有效的 5GHz 和 6GHz 信道列表,请参阅此处。 |
| skip-dfs-channels (10min-cac | all | disabled; Default: disabled) | 是否避免使用需要信道可用性检查(侦听雷达信号是否存在)的信道。10min-cac - 接口将避免使用需要 10 分钟长 CAC 的信道all - 接口将避免使用所有需要 CAC 的信道disabled - 接口可以选择任何支持的信道,无论 CAC 要求如何 |
| width ( 20mhz | 20/40mhz | 20/40mhz-Ce | 20/40mhz-eC | 20/40/80mhz | 20/40/80+80mhz | 20/40/80/160mhz| 20/40/80/160/320mhz) | radio 信道的宽度。默认为 radio 硬件支持的最宽信道。 |
Configuration properties
本节包含与接口及相关 radio 操作有关的属性。
| Property | Description |
|---|---|
| antenna-gain (integer 0..30) | 覆盖默认天线增益。每个 radio 的 master 接口为使用同一 radio 的每个接口设置天线增益。此设置不能将天线增益覆盖为低于 radio 的最小天线增益。无默认值。 |
| beacon-interval (time interval 100ms..1s; default: 100ms) | AP 的 beacon 帧之间的间隔。Important: 802.11 标准以时间单位定义 beacon 间隔(1 TU = 1.024 ms)。每配置 1 ms,beacon 之间的实际间隔为 1 TU。 Warning: 在同一 radio 上运行的每个 AP(即一个 master AP 及其所有 'virtual'/'slave' AP)必须使用相同的 beacon 间隔。 |
| chains (list of integer 0..7 ) | 用于接收信号的 Radio chains。默认为相应 radio 硬件可用的所有链。 |
| country (name of a country; default: Latvia) | 确定应用于接口的监管域限制。Warning: 正确设置此值以符合当地法规并确保与其他设备的互操作性非常重要。在受控环境中,或者如果你有在所在地区使用它的特殊许可,可以选择 country=Superchannel(使用此 country profile,路由器的 Tx 输出功率将不受软件限制,路由器将输出其硬件芯片允许的最大功率,除非配置了手动 tx-power 来降低它)。不适用于 wifi-qcom-ac 驱动程序。 |
| distance () | 最大链路距离(公里),长距离室外链路需要设置。该值应反映到距离设备最远的 AP 或 station 的距离。未配置的值允许使用 2 km 链路。Warning: distance 不被 wifi-qcom-ac 包使用。将 distance 设置为高于实际需要的值可能会对吞吐量和延迟产生不利影响。 |
| dtim-period (integer 1..255; default: 1) | DTIM 是 beacon 帧的一部分,用于通知省电(睡眠)station 即将到来的组播和广播流量。当有处于省电模式的客户端设备连接到 AP 时,此设置配置发送组播或广播流量的周期。表示为 beacon 间隔的倍数(例如使用默认值 dtim-period=1 和 beacon-interval=100ms,则每 1 x 100 ms = 100 ms 发送一次)。更高的值使客户端设备能够节省更多能量,但会增加网络延迟。更低的值使客户端更频繁地唤醒,使用更多能量。 |
| hide-ssid (no | yes; default: no) | yes - AP 不在 beacon 帧中包含其 SSID,也不回复广播 SSID 的 probe 请求。no - AP 在 beacon 帧中包含其 SSID,并回复广播 SSID 的 probe 请求。 |
| hw-protection-mode (cts-to-self | none | rts-cts) | 为减少帧冲突,可以使用:cts-to-self - 接口在发送 MPDU 之前向自己的地址发送 CTS 帧(以通知附近设备暂缓相互通信);none - 接口不使用任何硬件保护机制;rts-cts - 接口在每个 MPDU 之前发送 RTS 帧(RTS 之后是来自接收方的 CTS,之后通信发生——RTS 和 CTS 帧都可以让其他设备暂缓);默认(未设置):接口在重传的 MPDU 之前发送 RTS 帧。 |
| installation (indoor|outdoor; default: indoor) | 安装在室外的设备将避免使用仅限室内的无线信道。 |
| manager (capsman |capsman-or-local | local; default: local) | capsman - 接口将仅充当 CAP;此选项不应通过 provisioning 规则传递给 CAP capsman-or-local - 接口将通过 CAPsMAN 获取配置,或者如果未启用 /interface/wifi/cap,则使用自己的配置。local - 接口不会联系 CAPsMAN 以获取配置。 |
| max-clients (integer 1..1000; default: 1000) | 关联客户端的最大数量。 |
| mode (ap | station) | 接口运行模式 ap(默认)- 接口作为接入点运行station - 接口作为客户端设备运行,扫描通告所配置 SSID 的接入点station-bridge - 接口作为客户端设备运行并支持 4 地址帧格式,因此接口可用作桥接端口station-pseudobridge - 接口跟踪出站 IP 连接并执行 MAC 地址转换,类似于 IP masquerading 的工作方式Important: 'wifi' station-bridge 模式与运行较旧 'wireless' 包的 AP 不兼容,反之亦然。 |
| multicast-enhance (enabled| disabled; default: disabled) | 启用 multicast-enhance 功能后,AP 会将每个组播寻址的 IP 或 IPv6 数据包转换为针对每个已连接 station 的多个单播寻址帧。这可能提高链路吞吐量和可靠性,因为与组播帧不同,单播会被 station 确认并以更高的数据率发送。 |
| qos-classifier (dscp-high-3-bits| priority; default: priority) | 指定遵循哪个 WMM 规则集。AP 和客户端根据分配给数据包的优先级(依据 WMM 规范)对其进行分类 → 1,2 - background;0,3 - best effort;4,5 - video;6,7 - voice。"更好" 的接入类别有更高的概率获得介质访问权(例如 voice 帧在介质变为 "idle" 后将有更短的 "back off" 时间,确保它们比 "更差" 类别的帧更有可能更早发送出去)。dscp-high-3-bits - 接口将使用等于 IP DSCP 字段最高 3 位值的 WMM 优先级发送数据包priority - 接口将使用由 IP firewall 或 bridge filter 设置的 WMM 优先级发送数据包Important: 802.11ac 无线芯片组不支持 dscp-high-3-bits 分类器模式。对于 802.11ac 接口,请参阅 DSCP from priority。 |
| ssid (string; default: no) | 无线网络名称,即 (E)SSID。 |
| station-roaming (no | yes; Default: no) | 运行在 station 或 station-bridge 模式的 Wifi 接口将定期扫描可漫游到的 AP 候选。到 AP 的信号越弱,扫描执行得越频繁。如果找到信号更好的 AP,station 将漫游到它。支持 FT,如果启用了 steering.wnm,station 将响应 BSS Transition Request。 |
| tx-chains (list of integer 0..7) | 用于发送信号的 Radio chains。默认为相应 radio 硬件可用的所有链。 |
| tx-power (integer 0..40) | 接口发射功率(以 dBm 为单位)的限制。不能用于设置高于监管配置文件所施加限制的功率。默认未设置。 |
Datapath properties
与向无线客户端设备转发数据包以及从其转发数据包有关的参数。
| Property | Description |
|---|---|
| bridge (bridge interface) | 要将接口作为桥接端口添加到的桥接接口。默认情况下,虚拟('slave')接口会添加到与相应 master 接口相同的桥接(如果有)。默认情况下 master 接口不添加到任何桥接。 |
| bridge-cost (integer; default: 10) | 作为桥接端口添加时使用的桥接端口开销。 |
| bridge-horizon (none | integer; default: none) | 作为桥接端口添加时使用的桥接 horizon。 |
| client-isolation (no | yes; default: no) | 确定连接到此接口的客户端设备是否(默认)与其他客户端隔离。此策略可以使用 access list 规则按客户端覆盖,因此 AP 可以混合具有隔离和非隔离客户端。来自隔离客户端的流量不会转发给其他客户端,来自非隔离客户端的单播流量不会转发给隔离客户端。 |
| interface-list (interface list; default: no) | 要将接口作为成员添加到的列表。 |
| traffic-processing (on-cap | on-capsman | on-capsman-secure) | Important: 此设置仅从 7.21beta2 版本开始可用。<code>on-cap</code>,将使 CAP 本身负责处理所有 WiFi 流量(与任何独立 AP 相同);<code>on-capsman</code>,将使 CAP 的 WiFi 流量被转发到通往 CAPSMAN 的伪隧道,CAPsMAN 负责 CAP 的流量处理;<code>on-capsman-secure</code>,将使 CAP 的 WiFi 流量被转发到通往 CAPSMAN 的加密伪隧道,CAPsMAN 负责 CAP 的流量处理。Important: 使用 traffic-processing=on-capsman 设置时,请注意,由于 CAP 的所有 WiFi 流量现在由 CAPsMAN 处理(被推入 CAPsMAN),它将增加 CAPSMAN 的资源消耗(CPU 和 RAM 使用率)。 |
| vlan-id (none | integer 1..4095; default: none) | 分配给连接到此接口的客户端设备的默认 VLAN ID(仅与处于 AP 模式的接口相关)。当为客户端分配 VLAN ID 时,来自客户端的流量会自动用该 ID 标记,并且只有用此 ID 标记的数据包才会转发给客户端。Warning: 802.11ac 芯片组不支持这种类型的 VLAN 标记,但它们可以在 bridge 设置中配置为 VLAN access 端口。 |
Security Properties
与认证有关的参数。
| Property | Description |
|---|---|
| authentication-types (list of wpa-psk, wpa2-psk, wpa2-psk-sha2, wpa-eap, wpa2-eap, wpa3-psk, owe, wpa3-eap, wpa3-eap-192) | 要在接口上启用的认证类型。默认值为空列表(无认证,开放网络)。配置 passphrase 会将 wpa2-psk 认证方法添加到默认列表(如果接口是 AP),或将 wpa-psk 和 wpa2-psk 两者都添加(如果接口是 station)。配置 eap-username 和 eap-password 会将 wpa-eap 和 wpa2-eap 认证方法添加到默认列表。 |
| beacon-protection (disabled| enabled) | 是否启用 beacon 完整性保护。支持取决于 'beacon-protection' radio 能力。802.11be 接口默认启用。 |
| connect-group ( string) | 同一 connect group 内的 AP 不允许多于 1 个具有相同 MAC 地址的客户端设备。这是为了防止恶意授权用户拦截发往其他用户的流量('MacStealer' 攻击)或通过伪造受害者 MAC 地址执行拒绝服务攻击。如何处理具有重复 MAC 地址的新连接取决于所涉及 AP 接口的 connect-priority。默认情况下,所有 AP 被分配相同的 connect-group。 |
| connect-priority (accept-priority/hold-priority (integers)) | 这些参数确定如果客户端设备的 MAC 地址与另一个 AP 上另一个活动连接的 MAC 地址相同,如何处理该连接。如果 (accept-priority of AP2) < (hold-priority of AP1),则连接到 AP2 将导致客户端从 AP1 断开。如果 (accept-priority of AP2) = (hold-priority of AP1),则仅当无法再通过 AP1 到达该 MAC 地址时,才允许连接到 AP2。如果 (accept-priority of AP2) > (hold-priority of AP1),则不会接受连接到 AP2。如果省略,hold-priority 与 accept-priority 相同。默认情况下,执行用户认证的 AP 比开放 AP 具有更高的优先级(更低的整数值)。 |
| dh-groups (list of 19, 20, 21) | 用于 SAE(WPA3)认证的椭圆曲线密码学组标识符。 |
| disable-pmkid (no | yes; default: no) | 对于处于 AP 模式的接口,禁用将 PMKID 包含在 EAPOL 帧中。禁用 PMKID 可能会导致与使用它的客户端设备的兼容性问题。yes - 不在 EAPOL 帧中包含 PMKID。no - 在 EAPOL 帧中包含 PMKID。 |
| eap-accounting (no | yes; default: no) | 为 EAP 认证的对等端向 RADIUS 服务器发送 accounting 信息。Warning: 与 EAP 相关的属性仅与处于 station 模式的接口相关。AP 将 EAP 认证委托(passthrough)给 RADIUS 服务器。 |
| eap-anonymous-identity (string; default: none) | 用于 EAP 外部认证的可选匿名身份。 |
| eap-certificate-mode (dont-verify-certificate | no-certificates | verify-certificate | verify-certificate-with-crl; default: dont-verify-certificate) | 处理 RADIUS 服务器 TLS 证书的策略。verify-certificate - 要求服务器具有有效证书。检查它是否由受信任的证书颁发机构签名。dont-verify-certificate - 不对证书执行任何检查。no-certificates - 尝试通过执行匿名 Diffie-Hellman 密钥交换来建立 TLS 隧道。在 RADIUS 服务器完全没有证书时使用。verify-certificate-with-crl - 与 verify-certificate 相同,但还通过检查证书吊销列表来验证证书是否有效。 |
| eap-methods (list of peap, tls, ttls) | 用于认证时要考虑的 EAP 方法。默认为所有支持的方法。 |
| eap-password (string; default: none) sensitive | 当所选的 EAP 方法需要密码时使用的密码。 |
| eap-tls-certificate (certificate; default: none) | 当所选的 EAP 认证方法需要证书时,要使用的设备证书存储中的证书名称或 id。 |
| eap-username (string; default: none) | 当所选的 EAP 方法需要用户名时使用的用户名。Caution: 配置加密密码时要小心。所有客户端设备都必须支持 AP 用于连接的组加密密码,并且某些客户端设备(尤其是 Intel® 8260)如果单播密码列表包含它们不支持的任何密码,也会连接失败。 |
| encryption (list of ccmp, ccmp-256, gcmp, gcmp-256, tkip; default: ccmp) | 用于加密单播流量所支持的密码列表。默认为 ccmp。Warning: 要使客户端设备在 2 个 AP 之间成功漫游,这些 AP 需要由同一 RouterOS 实例管理。有关如何集中管理多个 AP 的信息,请参阅 CAPsMAN |
| ft (no | yes: default: no) | 是否启用 802.11r 快速 BSS 转换(漫游)。 |
| ft-mobility-domain (integer 0..65535; default: 44484 (0xADC4)) | 快速 BSS 转换移动域 ID。 |
| ft-nas-identifier (string of 2..96 hex characters) | 快速 BSS 转换 PMK-R0 密钥持有者标识符。默认:接口的 MAC 地址。 |
| ft-over-ds (no | yes; default: no) | 是否启用通过 DS(分发系统)的快速 BSS 转换。 |
| ft-preserve-vlanid (no | yes ) | no - 当客户端通过 802.11r 快速 BSS 转换连接到此 AP 时,它会根据 access 和/或接口设置被分配一个 VLAN IDyes(默认)- 当客户端通过 802.11r 快速 BSS 转换连接到此 AP 时,它保留在初始认证期间被分配的 VLAN ID。当依赖 RADIUS 服务器向用户分配 VLAN ID 时,默认行为至关重要,因为 RADIUS 服务器仅用于初始认证。 |
| ft-r0-key-lifetime (time interval 1s..6w3d12h15m; Default: 600000s (~7 days)) | 快速 BSS 转换 PMK-R0 加密密钥的生命周期。 |
| ft-reassociation-deadline (time interval 0..70s; default: 20s) | 快速 BSS 转换重新关联截止时间。 |
| group-encryption (ccmp | ccmp-256 | gcmp | gcmp-256 | tkip; default: ccmp) | 用于加密组播流量的密码。 |
| group-key-update (time interval; default: 24 hours) | 组临时密钥(用于加密广播流量的密钥)的续订间隔。 |
| management-encryption (cmac | cmac-256 | gmac | gmac-256; default: cmac) | 用于加密受保护管理帧的密码。 |
| management-protection (allowed | disabled | required) | 是否使用 802.11w 管理帧保护。与标准 wireless 包中的管理帧保护不兼容。默认值取决于所选认证类型的值。WPA2 允许使用管理保护,WPA3 要求使用它。 |
| multi-passphrase-group (string) | 将使用的 /interface/wifi/security/multi-passphrase/ 组名称。在 security profile 下只能定义一个组。 |
| owe-transition-interface (interface | auto) | 在 OWE 过渡模式下运行时,要将其 MAC 地址和 SSID 通告为匹配 AP 的接口名称。将值设置为 'auto' 将使 RouterOS 尝试自动匹配同一 radio 上的开放 AP 和 OWE AP。这是设置提供 OWE 但也适用于不支持该标准的旧设备的开放 AP 所必需的。请参阅上面的配置示例。 |
| passphrase (string of up to 63 characters) sensitive | 用于 PSK 认证类型的 passphrase。默认为空字符串 - ""。WPA-PSK 和 WPA2-PSK 认证要求至少 8 个字符,而 WPA3-PSK 没有最小 passphrase 长度要求。 |
| sae-anti-clogging-threshold (disabled | integer; default: 5) | 由于 SAE(WPA3)关联是 CPU 资源密集型操作,用虚假认证请求淹没 AP 可构成可行的拒绝服务攻击。此参数提供了一种缓解此类攻击的方法,它指定进行中的 SAE 认证阈值,达到该阈值时 AP 将开始要求客户端设备在其认证请求中包含绑定到其 MAC 地址的 cookie。然后它将仅处理包含有效 cookie 的认证请求。 |
| sae-max-failure-rate (disabled | integer; default: 40) | 每分钟 SAE(WPA3)关联失败率,达到该速率时 AP 将停止处理新的关联请求。 |
| sae-pwe (both | hash-to-element | hunting-and-pecking; default: both) | 用于派生 SAE 密码元素所支持的方法。 |
| wps (disabled | push-button; default: push-button) | push-button - 在调用 'wps-push-button' 命令后,AP 将在 2 分钟内接受 WPS 认证。物理 WPS 按钮功能尚未实现。disabled - AP 将不接受 WPS 认证 |
Security multi-passphrase 属性
/interface/wifi/security/multi-passphrase
multi-passphrase 允许使用 PPSK - 私有预共享密钥。
它可以通过创建 access list 条目并设置 multi-passphrase-group 名称来使用,也可以通过将组分配给接口使用的 security profile 来使用。
支持的 passphrase 总限制为 10000。该限制在所有接口之间共享。当接口具有关联的 multi-passphrase 组时,在启用时它将开始缓存指定组中的所有 passphrase。缓存进行期间,认证会较慢。一旦缓存完成,由于使用 multi-passphrase 组而增加的可感知延迟将不复存在。
如果使用 access-list 来应用 multi-passphrase-group,则缓存将在该组第一次匹配时开始,并持续到找到 passphrase 的匹配为止。
如果单个组下有数千个可能 passphrase 的条目——缓存可能需要几分钟才能完成,具体取决于设备配置和型号。
信息
multi-passphrase 不支持 WPA3-PSK 认证类型。 | Property | Description | | :-- | :-- | | group (string) | 将组分配给 security profile 或 access list 将启用其下定义的所有 passphrase | | passphrase (string of up to 63 characters) sensitive | 用于 PSK 认证类型的 passphrase。多个用户可以使用相同的 passphrase。与 WPA3-PSK 不兼容。 | | vlan-id (integer 0..4095; Default: none) | 将分配给使用此 passphrase 的客户端的 vlan-id Caution: 仅在 wifi-qcom 接口上受支持。如果 wifi-qcom-ac AP 有客户端使用带关联 vlan-id 的 passphrase,该客户端将无法加入。 | | expires (date and time; "YYYY-MM-DD HH:SS") | 此条目中指定的 passphrase 的过期日期和时间,不影响整个组。一旦到达该日期,使用此 passphrase 的现有客户端将被断开连接,新客户端将无法使用它连接。如果未设置,passphrase 可以无限期使用。 | | isolation (yes | no; Default: no) | 确定使用此 passphrase 的客户端设备是否与 AP 上的其他客户端隔离。来自隔离客户端的流量不会转发给其他客户端,来自非隔离客户端的单播流量不会转发给隔离客户端。 | | disabled (yes | no; Default: no) | |
Steering 属性
信息
非请求的 802.11v BSS 转换管理请求功能从 7.21 开始支持。 此类别中的属性管理向客户端设备通告潜在漫游候选的机制。
| Property | Description |
|---|---|
| 2g-probe-delay(no | yes; Default: no) | 如果在 2.4GHz AP 上将 This property 设置为 yes 且该 AP 与至少一个 5GHz AP 处于同一个 steering neighbor group 中,则该 2.4GHz AP 将放弃响应每个客户端在 60 秒间隔内信噪比 > 35 dB 的前 3 个 probe 请求。 |
| neighbor-group (string) | 在发送 neighbor report 和 BSS 转换管理请求时,AP 将列出其 neighbor group 内的所有其他 AP 作为潜在漫游候选。默认情况下,会为每组具有相同 SSID 和认证设置的 AP 创建动态 neighbor group。工作在 5GHz 频段的 AP 被指示为优于工作在 2.4GHz 频段的 AP。如果使用 EAP,则不会创建动态 neighbor group;需要手动定义。 |
| rrm (no | yes; Default: yes) | 启用发送 802.11k neighbor report。当设备希望 "探索/绘制" 其周围环境时,客户端可以向 AP 请求 "neighbor report"(客户端设备可以存储该报告,并可以立即或稍后使用它进行漫游)。 |
| transition-threshold (integer; Default: -80) | 设置用于发送非请求 802.11v BSS 转换管理请求的 RSSI 阈值。如果客户端设备在 transition-threshold-time 持续时间内处于所配置阈值 "以下",则将其标记为 "transition candidate"。 |
| transition-threshold-time (time interval; Default: 10) | 定义客户端设备可以在所配置 transition-threshold 值 "以下" 停留多长时间(秒),才会被标记为 "transition candidate"。 |
| transition-request-period (time interval; Default: 30) | 定义以秒为单位的间隔,AP 将使用该间隔向客户端设备发送非请求 802.11v BSS 转换管理请求(如果它是 "transition candidate")。例如,使用默认值(30s),将每隔 30 秒向客户端发送一次请求,总共发送 transition-request-count 次请求。 |
| transition-request-count (count, unlimited; Default: 3) | 定义应向被标记为 "transition candidate" 的客户端发送多少次非请求 802.11v BSS 转换管理请求。在客户端获得 "transition candidate" 状态后立即发送一次请求("-1" 计数),其余 "count" 将每隔 transition-request-period 发送一次。例如,使用默认值(3),当客户端获得 "transition candidate" 状态时发送第 1 次请求;第 2 次请求在 transition-request-period 秒后发送,第 3 次(最后一次)再经过一个 transition-request-period 后发送。如果想发送请求而没有计数限制,请设置为 unlimited。 |
| transition-time (time interval, immediate | unlimited; Default: unlimited) | 定义客户端设备在被强制解除认证之前可以成为 "transition candidate" 多长时间。它可以是秒为单位的 time interval(在该时间到期后解除客户端认证,该时间在设备成为 "transition candidate" 时开始运行/计时),可以是 immediate(在客户端成为 "transition candidate" 后立即解除其认证)或 unlimited(从不强制客户端,并每隔 transition-request-period 秒继续发送 transition-request-count 数量的转换请求)。Important: 请注意,使用 transition-time=immediate 时,transition-request-period 和 transition-request-count 将变得无用,因为客户端将在 transition-threshold-time 后立即被解除认证。 |
| wnm (no | yes; Default: yes) | 启用发送请求式 802.11v BSS 转换管理请求。客户端可以请求包含 "neighbor list" 的 "roaming suggestion" 数据包,以帮助设备切换 AP。客户端设备可以接受建议并立即漫游,也可以忽略建议并保持当前连接。 |
信息
请理解,客户端可以忽略 BSS 转换管理请求。BSS 转换请求是让客户端查找其他信号更好的 AP 的 "建议"。收到转换请求后,是否要切换 AP 或保持连接到当前 AP,完全由客户端决定。 信息
请求式 802.11v BSS 转换管理请求行为:
根据客户端自己的请求,向客户端发送请求式 802.11v BSS 转换管理数据包。客户端设备 "要求" AP 提供 "roaming suggestion"(带有 "neighbor list"),AP 用转换请求(包含 "neighbor list")进行响应。 信息
非请求式 802.11v BSS 转换管理请求行为:
向客户端发送非请求式 802.11v 请求,而无需等待客户端请求它。即使客户端没有要求,请求也会被发送。
如果客户端的信号在超过
transition-threshold-time(默认值:10 s)的时间内低于transition-threshold(默认值:-80 dBm),则客户端被标记为 "transition candidate"。如果客户端的信号高于transition-threshold,则客户端的 "transition candidate" 状态被移除。如果客户端是 "transition candidate",那么它将开始接收非请求式 802.11v BSS 转换管理请求数据包("建议" 移动到其他附近 AP 的数据包)。第一个这样的数据包将在客户端状态变为 "transition candidate" 后立即发送,后续数据包将每隔
transition-request-period(默认值:30 s)发送。总共将发送transition-request-count(默认值:3)次转换请求,之后 AP 将停止建议转换(除非配置了transition-request-count=unlimited,这会使 AP 不停地发送请求,每隔transition-request-period一次)。在transition-request-count次数用完后,客户端将在其自己请求之后,或在客户端再次被取消标记并标记为 "transition candidate" 之后,收到下一次转换请求。
transition-time中的值定义客户端设备在被强制断开之前可以保持为 "transition candidate" 多长时间。可能的transition-time值:unlimited(继续使用transition-request-period发送transition-request-count数量的转换请求,并且从不强制解除客户端认证)、以秒为单位的可配置时间(继续使用transition-request-period间隔和transition-request-count数量发送转换请求,然后在所配置的transition-time用完后断开客户端),以及 immediate(当客户端成为 "transition candidate" 时向其发送转换请求,并立即断开它)。
其他属性
| Property | Description |
|---|---|
| arp (disabled | enabled | local-proxy-arp | proxy-arp | reply-only; default: enabled) | 地址解析协议模式:disabled - 接口不使用 ARPenabled - 接口使用 ARPlocal-proxy-arp - 路由器在接口上执行代理 ARP 并将回复发送到同一接口proxy-arp - 路由器在接口上执行代理 ARP 并将回复发送到其他接口reply-only - 接口仅回复来自匹配 IP 地址/MAC 地址组合的请求,这些组合作为静态条目输入到 ARP 表中。不会自动将动态条目存储在 ARP 表中。因此,为了使通信成功,必须已存在有效的静态条目。 |
| arp-timeout (time interval | 'auto'; default: 30s) | 确定自最后一次从相应 IP 地址接收到数据包以来,动态添加的 ARP 表条目被认为有效的时长。值 auto 等于*/ip/settings* 中 arp-timeout 的值,其默认为 30s。 |
| disable-running-check (no | yes; default: no) | yes - 只要接口未被禁用,接口的 running 属性将为 trueno - 仅当接口已与另一设备建立链路时,接口的 running 属性才为 true |
| disabled (no | yes; default: yes) | |
| mac-address (MAC) | 用于接口的 MAC 地址(BSSID)。硬件接口默认为相关 radio 接口的 MAC 地址。虚拟接口的默认 MAC 地址通过以下方式生成:取相关 master 接口的 MAC 地址将第一个八位组的次最低有效位设置为 1,从而得到一个本地管理的 MAC 地址如果需要,递增地址的最后一个八位组,以确保它不与设备上另一个接口的地址重叠 |
| mtu (integer [32..2290]; Default: 1500) | 第 3 层最大传输单元。 |
| mld-interface (interface; default: none) | 指定附属的 MLD(Multi-Link Device)接口。当两个或多个 wifi 接口被分配相同的 MLD 接口(例如 mld-interface=mld1)时,它们一起作为单个逻辑 AP MLD 运行,从而启用 Multi-Link Operation(MLO)。MLD 接口是逻辑数据转发点——流量在 MLD 接口级别处理,而不是在单个附属 WiFi 接口上处理。所有附属 WiFi 接口必须共享相同的 SSID,并且所有参与的 radio 必须属于同一设备。MLO 需要兼容的 Wi-Fi 7(802.11be)硬件。 |
| mld-name (string) | 将此接口指定为 MLD 接口的唯一标识符。在手动创建 MLD 接口时,必须唯一并显式设置。 |
| l2mtu (integer [32..2290]; Default: 2290) | 第 2 层最大传输单元。 |
| master-interface (interface; default: none) | 每个无线 radio 上可以同时运行多个接口配置。只有其中一个决定 radio 的状态(是否启用、使用什么频率等)。此 'master' 接口 bound 到具有相应 radio-mac 的 radio。要在 radio 上创建额外的('virtual')接口配置,它们需要 bound 到相应的 master 接口。 |
| name (string) | 接口的名称。默认为 wifiN,其中 N 是尚未用于命名接口的最低整数。 |
只读属性
| Property | Description |
|---|---|
| bound (boolean) (B) | 对于当前可供 WiFi manager 使用的 master 接口为 True。对于虚拟接口(链接到 master 接口的配置),当接口本身及其 master 接口都未被禁用且 master 接口具有 bound 标志时为 True。 |
| cap (string) | 如果此路由器是 CAPsMAN 且接口不属于设备本身,而是属于受 CAPsMAN 控制的 CAP 设备,则显示有关 CAP 设备的信息。 |
| default-name (string) | 接口的默认名称。 |
| inactive (boolean) (I) | 对于处于 AP 模式的接口,当它们已选择用于工作的信道(即配置已成功应用)时为 False。对于处于 station 模式的接口,当它们已连接到 AP(即配置已成功应用,并且已找到具有匹配设置的 AP)时为 False。否则为 True。 |
| master (boolean) (M) | 对于路由器本身的物理接口,或作为 CAPsMAN 运行时检测到的 CAP 为 True。对于虚拟接口为 False。 |
| radio-mac (MAC) | 相关 radio 的 MAC 地址。 |
| running (boolean) (R) | 当接口已与另一设备建立链路时为 True。如果 disable-running-check 设置为 'yes',则只要接口未被禁用就为 true。 |
Access List
Filtering 参数:
| Parameter | Description |
|---|---|
| interface (interface | interface-list | any; default: any) | 如果连接发生在指定接口或属于指定列表的接口上,则匹配。 |
| mac-address (MAC address; default: none) | 如果客户端设备具有指定的 MAC 地址,则匹配。 |
| mac-address-mask (MAC address) | 修改 mac-address 参数,使其在等于对客户端 MAC 地址与给定地址掩码执行按位 AND 运算结果时匹配。默认:FF:FF:FF:FF:FF:FF(即客户端的 MAC 地址必须与 mac-address 的值完全匹配) |
| signal-range (min..max) | 如果从客户端设备接收到的信号强度在给定范围内,则匹配。允许的值:'-120..120' |
| ssid-regexp (regex) | 如果给定的正则表达式匹配 SSID,则匹配。 |
| time (start-end,days) | 在指定的时段和(可选)星期几匹配。允许的值:0s-1d |
| multi-passphrase-group (string) | 将使用的 /interface/wifi/security/multi-passphrase/ 组名称。在一个 access list 条目下只能设置一个组。 |
Action 参数:
| Parameter | Description |
|---|---|
| allow-signal-out-of-range (time period | always; default: 0s) | 已连接对等端的信号强度在被断开之前,允许超出 signal-range 参数所需范围的时间长度。如果值设置为 'always',则仅在关联期间检查对等端信号强度。 |
| action (accept | reject | query-radius; default: accept) | 是否授权连接 accept - 允许连接reject - 不允许连接query-radius - 如果客户端 MAC 地址的 MAC 地址认证成功,则允许连接 |
| client-isolation (no | yes; default: none) | 是否将客户端与连接到同一 AP 的其他客户端隔离。 |
| passphrase (string; default: none) sensitive | 用给定值覆盖默认 passphrase。 |
| radius-accounting (no | yes; default: none) | 用给定值覆盖默认 RADIUS accounting 策略。 |
| vlan-id (none | integer 1..4095; default: none) | 为匹配的客户端分配给定的 VLAN ID。 |
频率扫描
有关可用信道上 RF 状况的信息可以通过运行 frequency-scan 命令获得。 命令参数:
| Parameter | Description |
|---|---|
| duration (time interval; default: none) | 退出前执行扫描的时间长度。对非交互式使用很有用。 |
| freeze-frame-interval (time interval; default: 1s) | 更新命令输出的时间间隔。 |
| frequency (list of frequencies/ranges) | 要对其执行扫描的频率。有关更多详细信息,请参阅上面的 channel.frequency 参数语法。默认为所有支持的频率。 |
| number (string; default: none) | 要用于执行扫描的接口名称或内部 id。必需。 |
| rounds (integer; default: none) | 退出前遍历可扫描频率列表的次数。对非交互式使用很有用。 |
| save-file (string; default: none) | 保存输出到的文件名。 |
输出参数:
| Parameter | Description |
|---|---|
| channel (integer) | 所扫描信道的频率(以 MHz 为单位)。 |
| networks (integer) | 在该信道上检测到的接入点数量。 |
| load (integer) | 扫描期间信道繁忙的时间百分比。 |
| nf (integer) | 信道的噪声底限(以 dBm 为单位)。 |
| max-signal (integer) | 在该信道中检测到的 AP 的最大信号强度(以 dBm 为单位)。 |
| min-signal (integer) | 在该信道中检测到的 AP 的最小信号强度(以 dBm 为单位)。 |
| primary (boolean) (P) | 信道正被 AP 用作主(控制)信道。 |
| secondary (boolean) (S) | 信道正被 AP 用作辅助(扩展)信道。 |
Flat-snoop
/interface/wifi/flat-snoop 是用于勘察 AP 和 station 的工具。监控频率使用情况,并显示哪些设备占用每个频率。它提供比 scan 更详细的关于附近 AP 的信息,并便于按 station/AP 数量轻松概览频率使用情况。
输出参数:
| Parameters | Description |
|---|---|
| duration (time interval; default: none) | 退出前执行扫描的时间长度。对非交互式使用很有用。 |
| filter-type (bss | frequency | stas) | bss - 活动 AP 及其参数的列表。frequency - 每个扫描频率的 station 和 AP 数量列表 stas - 每个扫描频率上 station 的详细列表 如果未指定 filter-type,则返回所有类型。 |
| freeze-frame-interval (time interval; default: 1s) | 更新命令输出的时间间隔。 |
Scan 命令
/interface/wifi/scan 命令将扫描接入点,并打印出它检测到的任何 AP 的信息。
scan 命令接受与 frequency-scan 命令相同的所有参数。
输出参数:
| Parameter | Description |
|---|---|
| active (boolean) (A) | 这表示在过去 30 秒内已收到来自 AP 的 beacon。 |
| address (MAC) | AP 的 MAC 地址(BSSID)。 |
| channel (string) | AP 使用的控制信道频率、其支持的无线标准以及控制/扩展信道布局。 |
| security (string) | AP 支持的认证方法。 |
| signal (integer) | AP 的 beacon 的信号强度(以 dBm 为单位)。 |
| ssid (string) | AP 的扩展服务集标识符。 |
| sta-count (integer) | 与 AP 关联的客户端设备数量。仅当 AP 在其 beacon 中包含此信息时可用。 |
Sniffer
命令参数:
| Parameters | Description |
|---|---|
| duration (time interval; default: none) | 在指定时间过后自动中断 sniffer。 |
| filter (string) | 一个字符串,指定要应用于捕获帧的过滤器。只有被过滤器表达式匹配的帧才会被显示、保存或流式传输。这类似于 libpcap 中的过滤字符串。过滤器可以匹配 Address 字段(addr1、addr2、addr3)无线帧类型和子类型,包括诸如 'beacon'(type == 0 && subtype == 8)的快捷方式Flags(to-ds、from-ds、retry、power、protected)字符串可以包含以下运算符:==(精确匹配)!=(不等于)&&(逻辑 AND) || (逻辑 OR)()(用于对过滤器表达式分组) |
| number (interface) | 用于嗅探的接口。 |
| pcap-file (string) | 将捕获的帧保存到具有给定名称的文件。无默认值(默认情况下捕获的帧不会保存到文件)。 |
| pcap-size-limit (integer; default: none) | 本地存储捕获帧时的文件大小限制(以字节为单位)。达到此限制后,不再向捕获文件添加新帧。 |
| stream-address (IP address; default: none) | 通过 TZSP 协议将捕获的数据包流式传输到给定地址。无默认值(默认情况下捕获的数据包不会流式传输到任何地方)。 |
| stream-rate (integer) | 限制通过 TZSP 流式传输捕获帧的速率(以每秒数据包数为单位)。 |
WPS
/interface/wifi/wps-client/wifi
命令参数:
| Parameters | Description |
|---|---|
| duration (time interval) | 如果未找到 AP,命令将在此时间长度后超时。默认无限制。 |
| interval (time interval; default: 1s) | 更新命令输出的时间间隔。默认:1s。 |
| mac-address (MAC; default: none) | 仅尝试连接到具有指定 MAC(BSSID)的 AP。 |
| number (string; default: none) | 用于尝试连接的接口名称或内部 id。 |
| ssid (string; default: none) | 仅尝试连接到具有指定 SSID 的 AP。 |
Radios
有关每个 radio 能力的信息可以通过运行 /interface/wifi/radio/print detail 命令获得。
| Property | Description |
|---|---|
| 2g-channels (list of integers) | 2.4GHz 频段支持的频率。 |
| 5g-channels (list of integers) | 5GHz 频段支持的频率。 |
| 6g-channels (list of integers) | 6GHz 频段支持的频率。 |
| bands (list of strings) | 支持的频段、无线标准和信道宽度。 |
| ciphers (list of strings) | 支持的加密密码。 |
| countries (list of strings) | 接口支持的监管域。 |
| hw-caps (list of strings) | 附加支持的功能(例如 sniffer、qos-classifier-dscp)。 |
| hw-type (string) | Radio 硬件型号。 |
| max-interfaces (integer) | 逻辑接口的最大数量。 |
| max-peers (integer) | 关联对等端(已连接 station)的最大数量。 |
| max-station-interfaces (integer) | station 模式下逻辑接口的最大数量。 |
| max-vlans (integer) | 不同逐用户 VLAN 的最大数量。 |
| min-antenna-gain (integer) | 接口允许的最小天线增益。 |
| ml-group (MAC address) | 具有公共 ML(multi-link)组的 radio 可以配置为利用 multi-link 操作。 |
| phy-id (string) | 唯一标识符。 |
| radio-mac (MAC) | radio 接口的 MAC 地址。可用于将 radio 与接口配置匹配。 |
| rx-chains (list of integers) | 可用于接收无线电信号的 radio 链 ID。 |
| tx-chains (list of integers) | 可用于发送无线电信号的 radio 链 ID。 |
Registration table
registration table 包含有关已关联无线设备的只读信息。
| Parameter | Description |
|---|---|
| authorized (boolean) (A) | 当对等端已成功认证时为 True。 |
| auth-type (string) | 特定客户端使用的认证类型。 |
| band (string) | 特定路由器与 AP 通信的频段。 |
| bytes (list of integers) | 向对等端发送和从其接收的数据包字节数。 |
| interface (string) | 用于与对等端关联的接口名称。 |
| last-activity(time) | 最后一次接口数据 tx/rx 活动 |
| mac-address (MAC) | 对等端的 MAC 地址。 |
| packets (list of integers) | 向对等端发送和从其接收的数据包数。 |
| tx-bits-per-second (integer) | 向对等端发送数据的每秒速率。 |
| rx-bits-per-second (integer) | 从对等端接收数据的每秒速率。 |
| rx-rate (string) | 从对等端接收传输的比特率。 |
| signal (integer) | 从对等端接收到的信号强度(以 dBm 为单位)。 |
| ssid (string) | 客户端所连接的 SSID。 |
| tx-rate (string) | 用于向对等端发送的比特率。 |
| uptime (time interval) | 自关联以来的时间。 |
| vlan-id (integer) | 由 AP 或 RADIUS 为特定对等端流量分配的 VLAN。 |