Wi-Fi
本页介绍 RouterOS 中的 WiFi 配置菜单,涵盖受密码保护的接入点和 OWE 过渡模式接入点的基本设置。它说明了配置模板、安全设置,并包含……
Wi-Fi
本节介绍 Wi-Fi 6 及更高版本(802.11ax/be)接口、Wi-Fi HaLow(802.11ah)接口,以及运行 wifi-qcom-ac 驱动软件包的 Wi-Fi 5(802.11ac)设备的管理。
这些接口在 /interface/wifi 菜单中配置。
设备需要哪个驱动软件包,取决于其无线芯片组和标准。
本节是否适用于我的设备?
运行以下任一驱动软件包的设备都使用此菜单(以及本手册):
软件包 设备 示例 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下定义的配置预设,它可以引用各种模板。 - Station(站点) - 无线客户端。
网络
完整配置兼容设备最简单的方法是通过 /interface/wifi/network 菜单,它将 SSID、安全、数据路径和射频设置打包到单个配置实体中。
网络会为与其 labels 匹配的射频提供接口配置。
有关网络配置用法的示例,请参阅以下内容:
# A network provisioned to all radios
/interface/wifi/network
add ssid=MikroTik security.authentication-types=wpa2-psk,wpa3-psk security.passphrase=[:rndstr] datapath.bridge=bridge
# Set the regulatory domain of all radios
/interface/wifi/network/radio
add configuration.country=Latvia
网络属性
| 属性 | 说明 |
|---|---|
| mlo(no | yes;默认:yes) | 为兼容射频(WiFi 7 及更高版本)启用多链路操作。 |
| labels(逗号分隔的字符串;默认:all) | 在匹配任一指定标签的射频上启用网络配置。RouterOS 会根据频段自动为每个射频分配 2ghz、5ghz 或 6ghz 等标签,以及一个等于其(大写)MAC 地址的标签。all 标签匹配所有射频。可以通过网络射频部分中的 extra-labels 参数为射频分配额外标签。在标签前加上 -(减号)会取消其匹配。 |
| ssid(string) | 无线网络名称(ESSID)。 |
| mode(ap | station | station-bridge | station-pseudobridge;默认:ap) | 接口运行模式。 |
所有安全、认证和加密参数都使用 安全属性 中所述的相同属性。数据路径参数(网桥、VLAN、客户端隔离、流量处理)遵循 数据路径属性。
网络射频属性
/interface/wifi/network/radio 下的每射频设置:
| 属性 | 说明 |
|---|---|
| labels(object) | 将射频配置与具有给定标签的物理射频匹配。 |
| extra-labels(逗号分隔的字符串) | 要分配给匹配射频的额外标签。 |
射频参数(国家、频段、频率、宽度、射频链、功率等)使用 信道属性 和 配置属性 中所述的相同属性。
转换为网络管理的 Wi-Fi 或从中转换
为了确定如何处理给定射频,RouterOS 会执行以下步骤:
- 在
/interface/wifi菜单中检查该射频 MAC 地址是否已有接口配置条目。如果找到,则应用它。 - 如果未找到此类条目,则查询
/interface/wifi/provisioning菜单以获取显式配置指令。如果找到,则遵循该指令。 - 如果既没有现有静态配置,也没有显式配置指令,则查询
/interface/wifi/network菜单,看它是否为该射频指定了任何网络。 - 最后,如果前面的步骤中没有找到显式指令,则为该射频 MAC 创建一个静态禁用的配置存根。
WiFi 网络配置只会影响已由 WiFi 网络管理的射频(其主配置标记有 N 标志的射频),或者主配置已禁用并标记为由前面第 4 步创建的射频。
因此,添加 WiFi 网络不会在以下射频上创建相应的接口配置:具有已启用的非网络主接口配置的射频,或具有由显式配置规则创建的配置的射频。
要将此类射频转换为由 WiFi 网络配置管理,请移除所有显式配置规则并重新配置它们。
/interface/wifi/provisioning/remove [find]
/interface/wifi/radio/provision [find]
由 WiFi 网络创建的接口不能通过其他配置方法调整。
要将网络管理的接口转换为静态接口配置,请使用 /interface/wifi/liberate 命令。
基本密码保护 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)允许创建不需要知道密码即可连接的无线网络,但仍然提供流量加密和管理帧保护的好处。它是对常规开放接入点的改进。
但是,由于一个网络不能同时加密和不加密,因此需要两个单独的接口配置,才能为不支持 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 应具有“不加密”的访问权限(供不支持 OWE 的旧设备使用),而隐藏的 MikroTik_OWE SSID 应具有“OWE”安全性(无密码保护,但已加密)。客户端设备不会在客户端的 WiFi 列表中看到隐藏的 MikroTik_OWE SSID,但可见 MikroTik SSID 的信标包会使用“OWE 过渡模式”参数(在信标包中)通告指向隐藏 MikroTik_OWE 网络的链路。因此,客户端设备应通过 owe-transition-interface 设置优先连接到“OWE”网络。
支持 OWE 的客户端设备会优先选择 OWE 接口。如果你在注册表中没有看到任何与常规开放 AP 关联的设备,可以不再使用过渡模式设置,改为单个 OWE 加密接口:
/interface/wifi
set wifi1 configuration.country=Latvia configuration.ssid=MikroTik_OWE security.authentication-types=owe
信息
802.11r(快速漫游)在 OWE 网络上无法工作。
重置配置
可以使用 reset 命令重置 WiFi 接口配置。
/interface/wifi/reset wifi1
可以使用 reset-mac-address 命令将物理接口 MAC 地址重置为默认值。
/interface/wifi/reset-mac-address wifi1
配置模板
WiFi 新增功能之一是配置模板。你可以创建各种预设,并根据需要分配给接口。WiFi 的配置设置按照本页末尾的参数部分分组到模板中:aaa、channel、configuration、datapath、interworking 和 security,然后可以分配给接口。配置模板可以包含其他模板以及来自其他类别的单独参数。
这种可选灵活性旨在让每位用户以最适合自己的方式安排配置,但也意味着每个参数在配置的不同部分可能被赋予不同的值。
以下优先级决定使用哪个值:
- 接口设置中的值。
- 分配给接口的模板中的值。
- 分配给接口的配置模板中的值。
- 分配给配置模板的模板中的值(该配置模板又分配给接口)。
如果你在任何时候不确定接口将使用哪个参数值,可以执行 /interface/wifi/print detail。print 命令会显示接口将具有的所有值,包括继承的值。
要仅查看直接在接口上配置的值而不显示继承值,请使用 /interface/wifi/print config。
有关配置模板用法的示例,请参阅以下内容(双频家庭 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/菜单中相同。
访问列表
访问列表提供了多种过滤和管理无线连接的方式。
RouterOS 会检查每个新连接,看其参数是否匹配任何访问列表规则中指定的参数。
规则按其在列表中出现的顺序进行检查。只有第一条匹配规则中指定的管理操作会应用于每个连接。
已被访问列表规则接受的连接会被定期检查,以确认它们仍处于允许的时间、星期和信号范围内。如果不再满足,它们将被终止。
警告
编写拒绝客户端的访问列表规则时要小心。客户端设备在被 AP 反复拒绝后,可能会开始避开它。对于 wifi-qcom-ac 接口的客户端,在未先为接口配置 pvid 值的情况下,访问列表无法设置 VLAN ID。 访问列表有两类参数:过滤和操作。过滤属性仅用于匹配应应用访问列表规则的客户端。操作参数可以更改特定客户端的连接参数,并可能使用访问列表规则中指定的参数覆盖其默认连接参数。
MAC 地址认证
MAC 地址认证通过 query-radius 操作实现,是使用 RADIUS 服务器实现客户端 MAC 地址集中白名单的一种方式。
当客户端设备尝试与配置为执行 MAC 地址认证的 AP 关联时,AP 会向 RADIUS 服务器发送访问请求消息,其中以设备 MAC 地址作为用户名,密码为空。如果 RADIUS 服务器对此类请求返回访问接受,AP 会继续执行接口配置的常规认证流程(密码短语或 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
拒绝来自本地管理(“匿名”/“随机化”)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 时。当匹配的客户端连接到此网络时,访问列表会让该客户端使用不同的密码,而不用接口配置中定义的密码。只需确保特定客户端不会被更通用的访问列表规则先行匹配。
或者拒绝所有未知 MAC 地址,可作为最终规则添加到访问列表末尾。如果你只想允许特定客户端上网,请确保在访问列表末尾也添加拒绝规则,因为默认没有隐式拒绝规则。
/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 命令提供有关可用信道射频状况的信息,可通过运行 frequency-scan 命令获取。它用于估算频谱使用情况,有助于找到不那么拥挤的频率。

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

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

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

此命令持续监视频谱数据。它使用与 spectral-history 相同的数据源,并共享许多参数。
每行显示一个频谱图桶:频率、幅度(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 - 频谱扫描的频率步长
show-interference - yes/no
可能分类出的干扰类型:
- 微波炉(
MWO)。 - 连续波(
CW)。 - WLAN(宽带)(
WIFI)。 - 无绳电话 2.4(
CORDLESS24)。 - 无绳电话 5(
CORDLESS5)。 - 蓝牙(
BLUETOOTH)。 - 跳频扩频(
FHSS)。
频谱历史
/interface/wifi/spectral-history <wifi interface name>

绘制频谱图。落在不同范围内的功率值会以相同前景色和背景色的不同颜色字符打印,因此可以复制并粘贴此命令的终端输出。
data - min/max/avg,默认数据使用平均值。大多数场景应使用平均值,但在某些情况下,“min”可用于检查是否存在恒定信号输出的频率。max 将显示检测到的最强信号,而不是平均信号。
interval - 打印频谱图行的间隔;
duration - 指定时间后终止命令。默认无限期;
range - 扫描特定范围,必填;
resolution - 频率步长;
show-interference - yes/no
可能分类出的干扰类型:
- 微波炉(
O)。 - 连续波(
C)。 - WLAN(宽带)(
W)。 - 无绳电话 2.4(
T)。 - 无绳电话 5(
T)。 - 蓝牙(
BB)。 - 跳频扩频(
F)。
WPS
WPS 客户端
wps-client 命令允许从启用了 WPS 的 AP 获取认证信息。
/interface/wifi/wps-client wifi1
WPS 服务器
通过运行以下命令,可以让 AP 在 2 分钟内接受客户端设备的 WPS 认证。
/interface/wifi/wps-push-button wifi1
射频
可以通过运行 /interface/wifi/radio/print detail 命令获取每个射频能力的信息。它有助于查看接口支持哪些频段以及可以选择哪些信道。应用于接口的国家/地区配置文件会影响结果。
/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
射频信息提供了支持的信道宽度信息,也可以从产品页面推断此信息。为此,需要检查以下参数:射频链数量、最大数据速率。了解这些参数后,需要查看调制与编码方案(MCS)表,例如这里:https://mcsindex.com/。
以 hAP ax <sup>2</sup> 为例,可以看到射频链数量为 2,最大数据速率为 1200 - 1201,在 MCS 表中。我们需要在 MCS 表中找到 2 个空间流(射频链)的条目及相应数据速率,在此例中它表明 80MHz 是支持的最大信道宽度。
注册表
/interface/wifi/registration-table/ 显示已连接无线客户端的列表及其详细信息。

取消认证
可以通过从注册表中移除无线对端来手动取消其认证(强制重新关联)。
/interface/wifi/registration-table/remove [find where mac-address=02:01:02:03:04:05]
WiFi CAPsMAN
新版 WiFi 菜单的 CAPsMAN(受控接入点系统管理器)允许你从中央控制器将无线设置应用到多台 MikroTik WiFi AP。请参阅专门页面:WiFi CAPsMAN。
高级示例
替换 '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 射频的替代驱动,使其兼容 WiFi 配置菜单。有关可能的 wifi-qcom-ac/wifi-qcom/wireless 软件包组合,请参阅此处的软件包类型部分。
一般来说,该软件包与采用 ARM CPU 的 802.11ac 产品兼容。它不兼容任何采用 MIPS CPU 的 802.11ac 产品。
| 兼容性 | 设备 |
|---|---|
| 兼容 | Audience、Audience LTE kit、Chateau(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 |
| 不兼容 | RB4011iGS+5HacQ2HnD-IN(不支持 2.4GHz 接口)、Cube 60Pro ac(不支持 60GHz 接口)、wAP ac(RBwAPG-5HacT2HnD)以及所有其他采用 MIPSBE CPU 的设备 |
优势
- WPA3 认证和 OWE(机会性无线加密)。
- 802.11w 标准管理帧保护。
- 802.11r/k/v。
- MU-MIMO 和波束成形。
- IPQ4019 接口在 2.4GHz 频段的最大数据速率为 400Mb/s。
信息
这些优势同时适用于 wifi-qcom 和 wifi-qcom-ac 软件包。
失去的功能
在 802.11ac 产品上运行兼容 'wifi' 管理接口的驱动时,会失去以下显著功能:
- Nstreme 和 Nv2 无线协议。
- 无线设置中的 VLAN 配置(可以在网桥设置中配置逐接口 VLAN)。
- 与 'wireless' 软件包中实现的 station-bridging 的兼容性。Station-bridge 仅在同一类型驱动之间工作:WiFi 到 WiFi,以及 Wireless 到 Wireless。
属性参考
AAA 属性
此类别中的属性配置接入点与 AAA(RADIUS)服务器的交互。
下表中的某些参数以 format-string 作为值。在 format-string 中,某些字符按以下方式解释:
| 字符 | 解释 |
|---|---|
| a | 组成客户端设备 MAC 地址的十六进制字符,小写 |
| A | 组成客户端设备 MAC 地址的十六进制字符,大写 |
| i | 组成 AP 接口 MAC 地址的十六进制字符,小写 |
| I(大写 'i') | 组成 AP 接口 MAC 地址的十六进制字符,大写 |
| N | AP 接口的完整名称(例如 'wifi1') |
| S | 完整的 SSID |
所有其他字符均按原样使用,不进行任何解释。有关示例,请参阅默认值。
| 属性 | 说明 |
|---|---|
| called-format(format-string;默认:II-II-II-II-II-II:S) | AP 发往 RADIUS 服务器的消息中 Called-Station-Id RADIUS 属性值的格式。 |
| calling-format(format-string;默认:AA:AA:AA:AA:AA:AA) | AP 发往 RADIUS 服务器的消息中 Calling-Station-Id RADIUS 属性值的格式。 |
| interim-update(time interval;默认:5m) | 向 RADIUS 服务器发送流量计费临时更新的间隔。 |
| mac-caching(time interval;默认:disabled) | 启用 MAC 地址认证时缓存 RADIUS 服务器回复的时间长度。这可以解决因 RADIUS 服务器回复延迟相对较高而导致客户端设备认证超时的问题。 |
| name(string;默认:no) | AAA 模板的唯一名称。 |
| nas-identifier(string) | AP 发往 RADIUS 服务器的消息中 NAS-Identifier 属性的值。默认为设备的主机名(/system/identity)。 |
| password-format(format-string) | 执行 MAC 地址认证时,计算 AP 发往 RADIUS 服务器消息中 User-Password 属性值所使用的格式。默认值:""(空字符串)。 |
| username-format(format-string;默认:AA:AA:AA:AA:AA:AA) | 执行 MAC 地址认证时,AP 发往 RADIUS 服务器消息中 User-Name 属性值的格式。 |
信道属性
此类别中的属性指定所需的无线信道。
| 属性 | 说明 |
|---|---|
| band(2ghz-g | 2ghz-n | 2ghz-ax| 2ghz-be | 5ghz-a | 5ghz-ac | 5ghz-an | 5ghz-ax | 5ghz-be| 6ghz-ax | 6ghz-be) | AP 将使用的频段和无线标准。默认为支持的最新标准。注意,频段支持受射频能力限制。 |
| deprioritize-unii-3-4(no | yes) | 是否降低控制频率为 5720 或 5825-5885 MHz 的信道优先级。某些客户端设备不支持这些信道,因此不希望自动选择它们。在 ETSI 监管域中默认为 'yes',其他地区默认为 'no'。 |
| frequency(数字列表或数字范围) | 对于 AP 模式接口,指定选择控制信道中心频率时要考虑的频率(MHz)。对于 station 模式接口,指定扫描 AP 的频率。保持未设置(默认)会考虑射频支持且适用监管配置文件允许的所有频率。该参数可以包含一个或多个逗号分隔的十进制数字值,或可选地包含使用 RangeBeginning-RangeEnd:RangeStep 语法表示的数字范围。有效的 channel.frequency 值示例:2412,2432,2472,5180-5240:20,5500-5580:20 |
| preamble-puncturing(no | yes;默认:no) | 在此接口上为 DFS/雷达启用打孔支持(仅 802.11be)。设置后,当检测到雷达信号时,接入点可以仅禁用(“打孔”)宽 80/160 MHz 信道中受影响的 20 MHz 部分,而不必切换整个信道。对于 80 MHz 信道,可以打孔单个 20 MHz 子信道。对于 160 MHz 信道,可以打孔一个 20 MHz 子信道或一个 40 MHz 块。可以在该接口的 /interface/wifi/monitor 输出中观察当前打孔状态,被打孔的子信道会用字母 o 标记。 |
| reselect-interval(time interval;默认:disabled) | 指定接口应运行“重新扫描信道可用性”并选择最合适信道的间隔。指定间隔后,系统会动态随机选择此间隔。这有助于避免许多 AP 同时扫描网络、选择同一信道并希望同时使用它的情况。reselect-interval 使用后台扫描。重新选择过程会考虑信道中的网络数量、信道使用情况以及与相邻信道网络的重叠情况来选择最合适的信道。它可以与已定义的频率列表一起使用,也可以在未设置 frequency 时使用所有支持的频率。示例:01:00..01:30 → 将信道重新扫描设置为每 1 小时运行一次,并随机增加最多 30 分钟。第一次可能在“1 小时 15 分钟”后运行重新扫描,之后可能是“1 小时 1 秒”,然后可能是“1 小时 29 分 59 秒”……随机地,重新扫描会在每 1 小时到 1 小时 30 分钟之间发生。 |
| reselect-time(time interval;默认:disabled) | 指定接口应运行“重新扫描信道可用性”并选择最合适信道的时钟时间。指定时钟时间后,系统会动态随机选择此时间。这有助于避免许多 AP 同时扫描网络、选择同一信道并希望同时使用它的情况。reselect-time 使用后台扫描。重新选择过程会考虑信道中的网络数量、信道使用情况以及与相邻信道网络的重叠情况来选择最合适的信道。它可以与已定义的频率列表一起使用,也可以在未设置 frequency 时使用所有支持的频率。示例:01:00..01:30 → 将信道重新扫描设置为每晚在系统时钟时间 01:00 AM 到 01:30 AM 之间随机运行一次。14:00..14:30 → 将信道重新扫描设置为每天(中午之后)在系统时钟时间 14:00:00 到 14:30:00 之间随机运行一次。 |
| secondary-frequency(整数列表 | 默认: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;默认: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) | 无线信道宽度。默认为射频硬件支持的最宽信道。 |
配置属性
本节包含与接口及相关射频运行有关的属性。
| 属性 | 说明 |
|---|---|
| antenna-gain(整数 0..30) | 覆盖默认天线增益。每个射频的主接口会为使用同一射频的每个接口设置天线增益。此设置不能将天线增益设置得低于射频的最小天线增益。没有默认值。 |
| beacon-interval(time interval 100ms..1s;默认:100ms) | AP 信标帧之间的间隔。⚠️ **警告:**同一射频上运行的每个 AP(即主 AP 及其所有“虚拟”/“从”AP)必须使用相同的信标间隔。 |
| chains(整数 0..7 的列表) | 用于接收信号的射频链。默认为相应射频硬件可用的所有射频链。 |
| country(国家/地区名称;默认:Latvia) | 确定应用于接口的监管域限制。⚠️ **警告:**正确设置此值以遵守当地法规并确保与其他设备的互操作性非常重要。在受控环境中,或者如果你拥有在所在地区使用它的特殊许可,可以选择 country=Superchannel(使用此国家/地区配置文件,路由器的 Tx 输出功率不受软件限制,路由器会输出其硬件芯片允许的最大功率,除非配置手动 tx-power 将其降低)。不适用于 wifi-qcom-ac 驱动。 |
| distance(十进制数) | 最大链路距离(公里),用于长距离室外链路时需要设置。该值应反映距设备最远的 AP 或 station 的距离。默认值取决于芯片组。通常不超过 2 km。⚠️ **警告:**并非所有芯片组都支持调整最大距离。将值设置得高于实际需要可能会对链路性能产生不利影响。 |
| dtim-period(整数 1..255;默认:1) | DTIM 是信标帧的一部分,用于通知省电(休眠)站点有传入的多播和广播流量。该设置配置当有处于省电模式的客户端设备连接到 AP 时,发送多播或广播流量的周期。以信标间隔的倍数表示(例如使用默认值 dtim-period=1 和 beacon-interval=100ms 时,每隔 1 x 100 ms = 100 ms 发送一次)。较高的值使客户端设备节省更多能量,但会增加网络延迟。较低的值使客户端更频繁地唤醒,消耗更多能量。 |
| hide-ssid(no | yes;默认:no) | yes - AP 不在信标帧中包含其 SSID,也不回复具有广播 SSID 的探测请求。no - AP 在信标帧中包含其 SSID,并回复具有广播 SSID 的探测请求。 |
| 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;默认:indoor) | 安装在室外的设备将避免使用仅限室内的无线信道。 |
| manager(capsman |capsman-or-local | local;默认:local) | capsman - 接口将仅充当 CAP;不应通过配置规则将此选项传递给 CAP。capsman-or-local - 接口将通过 CAPsMAN 获取配置,如果未启用 /interface/wifi/cap,则使用自己的配置。local - 接口不会联系 CAPsMAN 获取配置。 |
| max-clients(整数 1..1000;默认:1000) | 最大关联客户端数量。 |
| mode(ap | station) | 接口运行模式。ap(默认)- 接口作为接入点运行;station - 接口作为客户端设备运行,扫描通告已配置 SSID 的接入点;station-bridge - 接口作为客户端设备运行并支持 4 地址帧格式,因此该接口可用作网桥端口;station-pseudobridge - 接口跟踪出站 IP 连接,并执行类似 IP 伪装的 MAC 地址转换。🛈 重要:'wifi' 的 station-bridge 模式与运行旧版 'wireless' 软件包的 AP 不兼容,反之亦然。 |
| multicast-enhance(enabled| disabled;默认:disabled) | 启用 multicast-enhance 功能后,AP 会将每个多播地址的 IP 或 IPv6 数据包转换为面向每个已连接 station 的多个单播地址帧。这可能会提高链路吞吐量和可靠性,因为与多播帧不同,单播会得到 station 的确认,并以更高的数据速率传输。 |
| qos-classifier(dscp-high-3-bits| priority;默认:priority) | 指定遵循哪套 WMM 规则。AP 和客户端根据分配给数据包的优先级(按照 WMM 规范)对其进行分类 → 1,2 - background;0,3 - best effort;4,5 - video;6,7 - voice。“更好”的访问类别获得介质访问权的概率更高(例如语音帧在介质变为“空闲”后的“退避”时间更短,确保它们比“较差”类别的帧更早发送)。dscp-high-3-bits - 接口将使用等于 IP DSCP 字段最高 3 位值的 WMM 优先级发送数据包;priority - 接口将使用由 IP 防火墙或网桥过滤器设置的 WMM 优先级发送数据包。🛈 **重要:**802.11ac 无线芯片组不支持 dscp-high-3-bits 分类器模式。对于 802.11ac 接口,请参阅从优先级获取 DSCP。 |
| ssid(string;默认:no) | 无线网络名称,即 (E)SSID。 |
| station-roaming(no | yes;默认:no) | 以 station 或 station-bridge 模式运行的 WiFi 接口会定期扫描可漫游的候选 AP。到 AP 的信号越弱,扫描越频繁。如果找到信号更好的 AP,station 会漫游到它。支持 FT,并且如果启用了 steering.wnm,station 会响应 BSS Transition Request。 |
| tx-chains(整数 0..7 的列表) | 用于发送信号的射频链。默认为相应射频硬件可用的所有射频链。 |
| tx-power(整数 0..40) | 接口发射功率(dBm)的限制。不能用于设置高于监管配置文件所施加限制的功率。默认未设置。 |
数据路径属性
与向无线客户端设备转发数据包及从其接收数据包有关的参数。
| 属性 | 说明 |
|---|---|
| bridge(bridge interface) | 要作为网桥端口添加到的网桥接口。虚拟(“从”)接口默认添加到与相应主接口相同的网桥(如果有)。主接口默认不添加到任何网桥。 |
| bridge-cost(integer;默认:10) | 作为网桥端口添加时使用的网桥端口开销。 |
| bridge-horizon(none | integer;默认:none) | 作为网桥端口添加时使用的网桥水平分割。 |
| client-isolation(no | yes;默认:no) | 确定连接到此接口的客户端设备(默认)是否与其他客户端隔离。可以使用访问列表规则按客户端覆盖此策略,因此一个 AP 可以同时有隔离和非隔离客户端。来自隔离客户端的流量不会转发给其他客户端,来自非隔离客户端的单播流量也不会转发给隔离客户端。 |
| interface-list(interface list;默认:no) | 要将接口作为成员添加到的列表。 |
| traffic-processing(on-cap | on-capsman | on-capsman-secure) | <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 的流量处理。🛈 **重要:**使用 traffic-processing=on-capsman 设置时请注意,由于 CAP 的所有 WiFi 流量现在由 CAPsMAN 处理(被推入 CAPsMAN),会增加 CAPsMAN 的资源消耗(CPU 和 RAM 使用)。 |
| vlan-id(none | 整数 1..4095;默认:none) | 要分配给连接到此接口的客户端设备的默认 VLAN ID(仅与 AP 模式接口相关)。为客户端分配 VLAN ID 后,来自客户端的流量会自动标记该 ID,只有带有此 ID 标记的数据包才会转发给客户端。⚠️ **警告:**某些射频驱动不支持将 VLAN 卸载到 WiFi。示例包括 802.11ah HaLow 和 wifi-qcom-ac AP。此类设备可以在网桥设置中配置为 VLAN access 端口。 |
安全属性
与认证有关的参数。
| 属性 | 说明 |
|---|---|
| authentication-types(wpa-psk、wpa2-psk、wpa2-psk-sha2、wpa-eap、wpa2-eap、wpa3-psk、wpa3-psk-gd、owe、wpa3-eap、wpa3-eap-192 的列表) | 要在接口上启用的认证类型。未配置密码短语的接口默认为空列表(无认证,开放网络)。配置了密码短语的接口默认使用一组基于密码短语的认证类型,具体取决于其支持的 WiFi 标准、频段和接口模式。在 6-7GHz 频段运行的 AP 默认为 wpa3-psk 和 wpa3-psk-gd。在 2.4 和 5 GHz 频段运行的 WiFi 7 AP 默认为 wpa2-psk、wpa3-psk 和 wpa3-psk-gd。在 2.4 和 5 GHz 频段运行的 WiFi 5 和 6 AP 默认为 wpa2-psk。Station 模式接口默认为 wpa-psk 和 wpa2-psk。配置了 eap-username 和 eap-password 的 station 模式接口默认使用 wpa-eap 和 wpa2-eap 认证方法。 |
| beacon-protection(disabled| enabled) | 是否启用信标完整性保护。支持取决于 'beacon-protection' 射频能力。802.11be 接口默认启用。 |
| connect-group(string) | 同一连接组内的 AP 不允许超过 1 个具有相同 MAC 地址的客户端设备。这是为了防止恶意授权用户拦截发往其他用户的流量(“MacStealer”攻击),或通过伪造受害者 MAC 地址执行拒绝服务攻击。如何处理具有重复 MAC 地址的新连接取决于所涉及 AP 接口的 connect-priority。默认所有 AP 都分配相同的 connect-group。 |
| connect-priority(accept-priority/hold-priority(整数)) | 这些参数确定当客户端设备的 MAC 地址与另一个 AP 上另一活动连接的 MAC 地址相同时如何处理连接。如果(AP2 的 accept-priority)<(AP1 的 hold-priority),到 AP2 的连接会导致客户端从 AP1 掉线。如果(AP2 的 accept-priority)=(AP1 的 hold-priority),只有在无法再通过 AP1 到达该 MAC 地址时才允许到 AP2 的连接。如果(AP2 的 accept-priority)>(AP1 的 hold-priority),则不接受到 AP2 的连接。如果省略,hold-priority 与 accept-priority 相同。默认执行用户认证的 AP 比开放 AP 具有更高优先级(整数值更低)。 |
| dh-groups(19、20、21 的列表) | 用于 SAE(WPA3)认证的椭圆曲线密码组标识符。 |
| disable-pmkid(no | yes;默认:no) | 对于 AP 模式接口,禁用 EAPOL 帧中包含 PMKID。禁用 PMKID 可能导致使用它的客户端设备出现兼容性问题。yes - 不在 EAPOL 帧中包含 PMKID。no - 在 EAPOL 帧中包含 PMKID。 |
| eap-accounting(no | yes;默认:no) | 为 EAP 认证的对端向 RADIUS 服务器发送计费信息。 |
| eap-anonymous-identity(string;默认:none) | EAP 外部认证的可选匿名身份。🛈 与 EAP 相关的属性仅与 station 模式接口相关。AP 将 EAP 认证委派(透传)给 RADIUS 服务器。 |
| eap-certificate-mode(dont-verify-certificate | no-certificates | verify-certificate | verify-certificate-with-crl;默认:dont-verify-certificate) | 处理 RADIUS 服务器 TLS 证书的策略。verify-certificate - 要求服务器具有有效证书。检查它是否由受信任的证书颁发机构签名。dont-verify-certificate - 不对证书执行任何检查。no-certificates - 尝试通过执行匿名 Diffie-Hellman 密钥交换建立 TLS 隧道。用于 RADIUS 服务器完全没有证书的情况。verify-certificate-with-crl - 与 verify-certificate 相同,但还会通过检查证书吊销列表来验证证书是否有效。 |
| eap-methods(peap、tls、ttls 的列表) | 认证时要考虑的 EAP 方法。默认为所有支持的方法。 |
| eap-password(string;默认:none)敏感 | 所选 EAP 方法需要时使用的密码。 |
| eap-tls-certificate(certificate;默认:none) | 所选 EAP 认证方法需要时使用的设备证书存储中的证书名称或 ID。 |
| eap-username(string;默认:none) | 所选 EAP 方法需要时使用的用户名。 |
| encryption(ccmp、ccmp-256、gcmp、gcmp-256、tkip 的列表;默认:ccmp) | 用于加密单播流量所支持的加密算法列表。默认为 ccmp。⚠️ **注意:**配置加密算法时要小心。所有客户端设备必须支持 AP 使用的组加密算法才能连接,某些客户端设备(尤其是 Intel® 8260)如果单播加密算法列表包含它们不支持的算法,也会连接失败。 |
| ft(no | yes;默认:no) | 是否启用 802.11r 快速 BSS 转换(漫游)。⚠️ **警告:**客户端设备要在 2 个 AP 之间成功漫游,这些 AP 必须由同一 RouterOS 实例管理。有关集中管理多个 AP 的信息,请参阅 CAPsMAN。 |
| ft-mobility-domain(整数 0..65535;默认:44484 (0xADC4)) | 快速 BSS 转换移动域 ID。 |
| ft-nas-identifier(2..96 个十六进制字符的字符串) | 快速 BSS 转换 PMK-R0 密钥持有者标识符。默认:接口的 MAC 地址。 |
| ft-over-ds(no | yes;默认:no) | 是否启用通过 DS(分布式系统)的快速 BSS 转换。 |
| ft-preserve-vlanid(no | yes) | no - 当客户端通过 802.11r 快速 BSS 转换连接到此 AP 时,会根据访问和/或接口设置为其分配 VLAN ID;yes(默认)- 当客户端通过 802.11r 快速 BSS 转换连接到此 AP 时,会保留其在初始认证期间分配的 VLAN ID。当依赖 RADIUS 服务器为用户分配 VLAN ID 时,默认行为至关重要,因为 RADIUS 服务器仅用于初始认证。wifi-qcom-ac 驱动不支持。 |
| ft-r0-key-lifetime(time interval 1s..6w3d12h15m;默认:600000s(约 7 天)) | 快速 BSS 转换 PMK-R0 加密密钥的生命周期。 |
| ft-reassociation-deadline(time interval 0..70s;默认:20s) | 快速 BSS 转换重新关联截止时间。 |
| group-encryption(ccmp | ccmp-256 | gcmp | gcmp-256 | tkip;默认:ccmp) | 用于加密多播流量的加密算法。 |
| group-key-update(time interval;默认:24 hours) | 组临时密钥(用于加密广播流量的密钥)的更新间隔。 |
| management-encryption(cmac | cmac-256 | gmac | gmac-256;默认:cmac) | 用于加密受保护管理帧的加密算法。 |
| management-protection(allowed | disabled | required) | 是否使用 802.11w 管理帧保护。默认值取决于所选认证类型的值。WPA2 允许使用管理保护,WPA3 要求使用。 |
| multi-passphrase-group(string) | 将使用的 /interface/wifi/security/multi-passphrase/ 组名称。安全模板下只能定义一个组。 |
| owe-transition-interface(interface | auto) | 在 OWE 过渡模式下运行时,要通告其 MAC 地址和 SSID 作为匹配 AP 的接口名称。将值设置为 'auto' 会让 RouterOS 尝试自动匹配同一射频上的开放 AP 和 OWE AP。这是设置提供 OWE、同时兼容不支持该标准的旧设备的开放 AP 所必需的。请参阅上方配置示例。 |
| passphrase(最多 63 个字符的字符串)敏感 | 用于 PSK 认证类型的密码短语。默认为空字符串 - ""。WPA-PSK 和 WPA2-PSK 认证要求至少 8 个字符,而 WPA3-PSK 没有最小密码短语长度要求。 |
| sae-anti-clogging-threshold(disabled | integer;默认:5) | 由于 SAE(WPA3)关联消耗大量 CPU 资源,用伪造认证请求淹没 AP 会构成可行的拒绝服务攻击。此参数提供了一种缓解此类攻击的方法:指定正在进行中的 SAE 认证阈值,达到该值时 AP 会开始要求客户端设备在认证请求中包含绑定到其 MAC 地址的 cookie。之后它只处理包含有效 cookie 的认证请求。 |
| sae-max-failure-rate(disabled | integer;默认:40) | 每分钟失败的 SAE(WPA3)关联速率,达到该值时 AP 将停止处理新的关联请求。 |
| sae-pwe(both | hash-to-element | hunting-and-pecking;默认:both) | 支持的 SAE 密码元素推导方法。 |
| wps(disabled | push-button;默认:push-button) | push-button - 调用 'wps-push-button' 命令后,AP 将在 2 分钟内接受 WPS 认证。物理 WPS 按钮功能尚未实现。disabled - AP 不接受 WPS 认证。 |
安全多密码短语属性
/interface/wifi/security/multi-passphrase
multi-passphrase 允许使用 PPSK——私有预共享密钥。
可以通过创建访问列表条目并设置 multi-passphrase-group 名称来使用,或者将该组分配给接口使用的安全模板。
支持的密码短语总数上限为 10000。该限制在所有接口之间共享。当接口关联了多密码短语组时,启用后会开始缓存指定组中的所有密码短语。缓存期间认证会较慢。缓存完成后,使用多密码短语组不会带来可感知的额外延迟。
如果使用访问列表应用 multi-passphrase-group,缓存会在首次匹配该组时开始,并持续到找到匹配的密码短语为止。
如果单个组下有数千个可能的密码短语条目,根据设备配置和型号,缓存可能需要几分钟才能完成。
信息
multi-passphrase 不支持 WPA3-PSK 认证类型。 | 属性 | 说明 | | :-- | :-- | | group(string) | 将组分配给安全模板或访问列表会启用其下定义的所有密码短语 | | passphrase(最多 63 个字符的字符串)敏感 | 用于 PSK 认证类型的密码短语。多个用户可以使用相同的密码短语。与 WPA3-PSK 不兼容。 | | vlan-id(整数 0..4095;默认:none) | 分配给使用此密码短语的客户端的 vlan-id。⚠️ **注意:**不支持 VLAN 卸载的设备(例如 HaLow 或 wifi-qcom-ac AP)将拒绝分配了 vlan-id 的客户端连接。 | | expires(日期和时间;"YYYY-MM-DD HH:SS") | 此条目中指定密码短语的到期日期和时间,不影响整个组。到达该日期后,使用此密码短语的现有客户端将被断开,新客户端将无法使用它连接。如果未设置,密码短语可以无限期使用。 | | isolation(yes | no;默认:no) | 确定使用此密码短语的客户端设备是否与 AP 上的其他客户端隔离。来自隔离客户端的流量不会转发给其他客户端,来自非隔离客户端的单播流量也不会转发给隔离客户端。 | | disabled(yes | no;默认:no) | |
引导属性
信息
主动 802.11v BSS 转换管理请求功能从 7.21 开始支持。 此类别中的属性控制向客户端设备通告潜在漫游候选的机制。
| 属性 | 说明 |
|---|---|
| 2g-probe-delay(no | yes;默认:no) | 如果在 2.4GHz AP 上将此属性设置为 yes,并且该 AP 与至少一个 5GHz AP 处于同一引导邻居组中,则该 2.4GHz AP 将不响应每个客户端在 60 秒间隔内前 3 个信噪比 > 35 dB 的探测请求。 |
| neighbor-group(string) | 发送邻居报告和 BSS 转换管理请求时,AP 会将其邻居组内的所有其他 AP 列为潜在漫游候选。默认会为每组具有相同 SSID 和认证设置的 AP 创建动态邻居组。工作在 5GHz 频段的 AP 会表示为优于工作在 2.4GHz 频段的 AP。如果使用 EAP,则不会创建动态邻居组;需要手动定义。 |
| rrm(no | yes;默认:yes) | 启用发送 802.11k 邻居报告。当设备想要“探索/映射”其周围环境时,客户端可以向 AP 请求“邻居报告”(客户端设备可以存储该报告,并可用于立即或稍后漫游)。 |
| transition-threshold(integer;默认:-80) | 设置发送主动 802.11v BSS 转换管理请求的 RSSI 阈值。如果客户端设备在 transition-threshold-time 期间“低于”配置阈值,则会被标记为“转换候选”。 |
| transition-threshold-time(time interval;默认:10) | 定义客户端设备可以“低于”配置的 transition-threshold 值多长时间(秒),才会被标记为“转换候选”。 |
| transition-request-period(time interval;默认:30) | 定义一个间隔(秒),如果客户端设备是“转换候选”,AP 将按此间隔向客户端设备发送主动 802.11v BSS 转换管理请求。例如使用默认值(30s),将每隔 30 秒向客户端发送一次请求,总共发送 transition-request-count 次。 |
| transition-request-count(integer,unlimited;默认:3) | 定义应向被标记为“转换候选”的客户端发送多少次主动 802.11v BSS 转换管理请求。客户端获得“转换候选”状态后会立即发送一次请求(“-1”计数),其余“count”次将每隔 transition-request-period 发送。例如使用默认值(3),客户端获得“转换候选”状态时发送第 1 次请求;transition-request-period 秒后发送第二次请求,再过 transition-request-period 后发送第三次(最后一次)。如果希望不限制次数地发送请求,请设置为 unlimited。 |
| transition-time(time interval | immediate | unlimited;默认:unlimited) | 定义客户端设备在被强制取消认证之前可以保持“转换候选”状态多长时间。它可以是一个 time interval(秒)(客户端在设备成为“转换候选”后开始计时,到期后取消认证),也可以是 immediate(客户端成为“转换候选”后立即取消认证),或 unlimited(永不强制客户端,继续每隔 transition-request-period 秒发送 transition-request-count 数量的转换请求)。🛈 **重要:**请注意,使用 transition-time=immediate 时,transition-request-period 和 transition-request-count 将变得无用,因为客户端会在 transition-threshold-time 后立即被取消认证。 |
| wnm(no | yes;默认:yes) | 启用发送请求式 802.11v BSS 转换管理请求。客户端可以请求包含“邻居列表”的“漫游建议”数据包,以帮助设备切换 AP。客户端设备可以接受建议并立即漫游,也可以忽略建议并保持当前连接。 |
信息
请理解,客户端可以忽略 BSS 转换管理请求。BSS 转换请求是让客户端寻找其他信号更好 AP 的“建议”。收到转换请求后,完全由客户端决定是否切换 AP,还是保持与当前 AP 的连接。 信息
请求式 802.11v BSS 转换管理请求行为:
请求式 802.11v BSS 转换管理数据包根据客户端自己的请求发送给客户端。客户端设备“请求”AP 提供“漫游建议”(带有“邻居列表”),AP 以转换请求(包含“邻居列表”)响应。 信息
主动 802.11v BSS 转换管理请求行为:
主动 802.11v 请求无需等待客户端请求即可发送给客户端。即使客户端没有请求,也会发送该请求。
如果客户端信号低于
transition-threshold(默认值:-80 dBm)的时间超过transition-threshold-time(默认值:10 秒),则客户端会被标记为“转换候选”。如果客户端信号高于transition-threshold,则客户端的“转换候选”状态会被移除。如果客户端是“转换候选”,它将开始接收主动 802.11v BSS 转换管理请求数据包(“建议”移动到附近其他 AP 的数据包)。第一个此类数据包会在客户端状态变为“转换候选”后立即发送,后续数据包每隔
transition-request-period(默认值:30 秒)发送。总共会发送transition-request-count(默认值:3)次转换请求,之后 AP 将停止建议转换(除非配置了transition-request-count=unlimited,这会使 AP 不间断地发送请求,每隔transition-request-period发送一次)。transition-request-count次数用完后,客户端要么在自己的请求后收到下一次转换请求,要么在取消标记并再次被标记为“转换候选”后收到。
transition-time中的值定义客户端设备在被强制断开之前可以保持“转换候选”状态多长时间。可能的transition-time值:unlimited(继续按transition-request-period发送transition-request-count数量的转换请求,并且永不强制取消客户端认证)、可配置时间(秒)(继续按transition-request-period间隔和transition-request-count数量发送转换请求,然后在配置的transition-time到期后断开客户端),以及 immediate(客户端成为“转换候选”时向其发送转换请求,并立即断开连接)。
其他属性
| 属性 | 说明 |
|---|---|
| arp(disabled | enabled | local-proxy-arp | proxy-arp | reply-only;默认:enabled) | 地址解析协议模式:disabled - 接口不使用 ARP;enabled - 接口使用 ARP;local-proxy-arp - 路由器在接口上执行代理 ARP,并向同一接口发送回复;proxy-arp - 路由器在接口上执行代理 ARP,并向其他接口发送回复;reply-only - 接口仅回复来自匹配 IP 地址/MAC 地址组合的请求,这些组合作为静态条目输入到 ARP 表中。不会自动在 ARP 表中存储动态条目。因此,通信要成功,必须已经存在有效的静态条目。 |
| arp-timeout(time interval | auto;默认:30s) | 确定自上次从相应 IP 地址收到数据包以来,动态添加的 ARP 表条目被视为有效的时间。值 auto 等于 /ip/settings 中 arp-timeout 的值,默认为 30s。 |
| disable-running-check(no | yes;默认:no) | yes - 只要接口未禁用,接口的 running 属性就为 true;no - 只有当接口与另一设备建立链路时,接口的 running 属性才为 true。 |
| disabled(no | yes;默认:yes) | |
| mac-address(MAC) | 接口要使用的 MAC 地址(BSSID)。硬件接口默认为关联射频接口的 MAC 地址。虚拟接口的默认 MAC 地址生成方式为:取关联主接口的 MAC 地址,将第一个八位组的次低有效位设置为 1,得到本地管理的 MAC 地址;如有需要,递增地址的最后一个八位组,以确保它不与设备上另一个接口的地址重叠。 |
| mtu(整数 [32..2290];默认:1500) | 第 3 层最大传输单元。 |
| mld-interface(interface;默认:none) | 指定关联的 MLD(多链路设备)接口。当两个或多个 WiFi 接口分配了相同的 MLD 接口(例如 mld-interface=mld1)时,它们会作为单个逻辑 AP MLD 一起运行,从而启用多链路操作(MLO)。MLD 接口是逻辑数据转发点——流量在 MLD 接口层面处理,而不是在各个关联的 WiFi 接口上处理。所有关联的 WiFi 接口必须共享相同的 SSID,并且所有参与的射频必须属于同一设备。MLO 需要兼容的 Wi-Fi 7(802.11be)硬件。 |
| mld-name(string) | 唯一标识符,用于将此接口指定为 MLD 接口。手动创建 MLD 接口时必须唯一且显式设置。 |
| l2mtu(整数 [32..2290];默认:2290) | 第 2 层最大传输单元。 |
| master-interface(interface;默认:none) | 每个无线射频上可以同时运行多个接口配置。只有其中一个决定射频状态(是否启用、使用什么频率等)。这个“主”接口绑定到具有相应 radio-mac 的射频。要在射频上创建其他(“虚拟”)接口配置,需要将它们绑定到相应的主接口。 |
| name(string) | 接口名称。默认为 wifiN,其中 N 是尚未用于命名接口的最小整数。 |
只读属性
| 属性 | 说明 |
|---|---|
| bound(boolean)(B) | 对于当前可供 WiFi 管理器使用的主接口为 true。对于虚拟接口(链接到主接口的配置),当接口本身及其主接口均未禁用且主接口具有 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) | 关联射频的 MAC 地址。 |
| running(boolean)(R) | 当接口与另一设备建立链路时为 true。如果 disable-running-check 设置为 'yes',则只要接口未禁用就为 true。 |
访问列表
过滤参数:
| 参数 | 说明 |
|---|---|
| interface(interface | interface-list | any;默认:any) | 如果连接发生在指定接口或属于指定列表的接口上则匹配。 |
| mac-address(MAC address;默认:none) | 如果客户端设备具有指定 MAC 地址则匹配。 |
| mac-address-mask(MAC address) | 修改 mac-address 参数的匹配方式:将客户端 MAC 地址与给定地址掩码执行按位 AND 运算,如果结果等于 mac-address 则匹配。默认: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/ 组名称。一个访问列表条目下只能设置一个组。 |
操作参数:
| 参数 | 说明 |
|---|---|
| allow-signal-out-of-range(time period | always;默认:0s) | 允许已连接对端的信号强度超出 signal-range 参数所需范围的时间长度,超过后将被断开。如果值设置为 'always',则仅在关联期间检查对端信号强度。 |
| action(accept | reject | query-radius;默认:accept) | 是否授权连接。accept - 允许连接;reject - 不允许连接;query-radius - 如果客户端 MAC 地址的 MAC 地址认证成功,则允许连接。 |
| client-isolation(no | yes;默认:none) | 是否将客户端与连接到同一 AP 的其他客户端隔离。 |
| passphrase(string;默认:none)敏感 | 使用给定值覆盖默认密码短语。 |
| radius-accounting(no | yes;默认:none) | 使用给定值覆盖默认 RADIUS 计费策略。 |
| vlan-id(none | 整数 1..4095;默认:none) | 将给定 VLAN ID 分配给匹配的客户端。 |
频率扫描
可以通过运行 frequency-scan 命令获取有关可用信道射频状况的信息。 命令参数:
| 参数 | 说明 |
|---|---|
| duration(time interval;默认:none) | 退出前执行扫描的时间长度。适用于非交互式使用。 |
| freeze-frame-interval(time interval;默认:1s) | 更新命令输出的时间间隔。 |
| frequency(频率/范围列表) | 要执行扫描的频率。详情请参阅上方 channel.frequency 参数语法。默认为所有支持的频率。 |
| number(string;默认:none) | 用于执行扫描的接口名称或内部 ID。必填。 |
| rounds(integer;默认:none) | 退出前遍历可扫描频率列表的次数。适用于非交互式使用。 |
| save-file(string;默认:none) | 保存输出的文件名。 |
输出参数:
| 参数 | 说明 |
|---|---|
| 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 数量统计的频率使用情况。
输出参数:
| 参数 | 说明 |
|---|---|
| duration(time interval;默认:none) | 退出前执行扫描的时间长度。适用于非交互式使用。 |
| filter-type(bss | frequency | stas) | bss - 活动 AP 列表及其参数。frequency - 每个扫描频率的 station 和 AP 数量列表。stas - 每个扫描频率上 station 的详细列表。如果未指定 filter-type,则返回所有类型。 |
| freeze-frame-interval(time interval;默认:1s) | 更新命令输出的时间间隔。 |
Scan 命令
/interface/wifi/scan 命令会扫描接入点,并打印其检测到的任何 AP 的信息。
scan 命令接受与 frequency-scan 命令相同的所有参数。
输出参数:
| 参数 | 说明 |
|---|---|
| active(boolean)(A) | 这表示在过去 30 秒内收到了来自该 AP 的信标。 |
| address(MAC) | AP 的 MAC 地址(BSSID)。 |
| channel(string) | AP 使用的控制信道频率、其支持的无线标准以及控制/扩展信道布局。 |
| security(string) | AP 支持的认证方法。 |
| signal(integer) | AP 信标的信号强度(dBm)。 |
| ssid(string) | AP 的扩展服务集标识符。 |
| sta-count(integer) | 与该 AP 关联的客户端设备数量。仅当 AP 在其信标中包含此信息时才可用。 |
Sniffer
命令参数:
| 参数 | 说明 |
|---|---|
| duration(time interval;默认: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;默认:none) | 本地存储捕获帧时的文件大小限制(字节)。达到此限制后,不会向捕获文件添加新帧。 |
| stream-address(IP address;默认:none) | 通过 TZSP 协议将捕获的数据包流式传输到给定地址。没有默认值(默认不将捕获的数据包流式传输到任何位置)。 |
| stream-rate(integer) | 限制通过 TZSP 流式传输捕获帧的速率(每秒数据包数)。 |
WPS
/interface/wifi/wps-client
命令参数:
| 参数 | 说明 |
|---|---|
| duration(time interval) | 如果未找到 AP,命令超时前的时间长度。默认无限制。 |
| interval(time interval;默认:1s) | 更新命令输出的时间间隔。默认:1s。 |
| mac-address(MAC;默认:none) | 仅尝试连接到具有指定 MAC(BSSID)的 AP。 |
| number(string;默认:none) | 尝试连接所用接口的名称或内部 ID。 |
| ssid(string;默认:none) | 仅尝试连接到具有指定 SSID 的 AP。 |
射频
可以通过运行 /interface/wifi/radio/print detail 命令获取每个射频能力的信息。
| 属性 | 说明 |
|---|---|
| 2g-channels(整数列表) | 2.4GHz 频段支持的频率。 |
| 5g-channels(整数列表) | 5GHz 频段支持的频率。 |
| 6g-channels(整数列表) | 6GHz 频段支持的频率。 |
| bands(字符串列表) | 支持的频段、无线标准和信道宽度。 |
| ciphers(字符串列表) | 支持的加密算法。 |
| countries(字符串列表) | 接口支持的监管域。 |
| hw-caps(字符串列表) | 表示射频固件对某些功能支持的字符串。channel-switch - 能够在不中断当前信道上已建立连接的情况下切换射频工作信道。hw-protection-mode - 能够通过 configuration.hw-protection-mode 参数强制给定 RTS/CTS 策略。qos-classifier-dscp - 当 configuration.qos-classifier 设置为 'dscp-high-3-bits' 时,能够基于 IP DSCP 执行流量分类。sniffer - 能够在监视模式下运行,捕获 802.11 帧。spectral - 能够在 spectral-scan 和 spectral-history 工具要求时作为频谱仪运行。 |
| hw-type(string) | 射频硬件型号。 |
| 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(多链路)组的射频可以配置为利用多链路操作。 |
| phy-id(string) | 唯一标识符。 |
| radio-mac(MAC) | 射频接口的 MAC 地址。可用于将射频匹配到接口配置。 |
| rx-chains(整数列表) | 可用于接收射频信号的射频链 ID。 |
| tx-chains(整数列表) | 可用于发送射频信号的射频链 ID。 |
射频设置
可以在 /interface/wifi/radio/settings 菜单中更改若干射频相关设置。
| 属性 | 说明 |
|---|---|
| default-country(国家/地区名称) | 如果未为任何受管射频的主接口设置其他值,则应用的监管域 |
| external-antenna(yes | no;默认:no) | 是否切换到 LtAP ax 等设备上的外部天线连接器,这些设备同时具有内部天线和外部天线连接器。 |
| wifi-band(2.4GHz | 5GHz;默认:2GHz) | 多频段射频上使用的频段。 |
注册表
注册表包含有关已关联无线设备的只读信息。
| 参数 | 说明 |
|---|---|
| authorized(boolean)(A) | 当对端已成功认证时为 true。 |
| auth-type(string) | 特定客户端使用的认证类型。 |
| band(string) | 特定路由器与 AP 通信所用的频段。 |
| bytes(整数列表) | 发送给对端和从对端接收的数据包字节数。 |
| interface(string) | 用于与对端关联的接口名称。 |
| last-activity(time) | 接口上次数据 tx/rx 活动 |
| mac-address(MAC) | 对端的 MAC 地址。 |
| packets(整数列表) | 发送给对端和从对端接收的数据包数量。 |
| 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。 |