nmcli设置wifi参数


802-11-无线 — 无线网络设置

键名值类型默认值值描述
ap-isolation
NMTernary (int32)
  配置 AP 隔离,这会阻止连接到此 AP 的无线设备之间的通信。仅当接口配置为 AP 模式时,才能将此属性设置为不同于 NM_TERNARY_DEFAULT (-1) 的值。如果设置为 NM_TERNARY_TRUE (1),则设备无法相互通信。这提高了安全性,因为它可以保护设备免受来自网络中其他客户端的攻击。同时,它可以防止设备访问与文件共享,打印机等相同的无线网络上的资源。如果设置为 NM_TERNARY_FALSE (0),设备可以相互通信。设置为 NM_TERNARY_DEFAULT (-1) 时,将使用全局默认值;如果未指定全局默认值,则假定为NM_TERNARY_FALSE (0)。
assigned-mac-address
string
  克隆的 MAC 地址的新字段。它可以是 ASCII 表示形式的硬件地址,也可以是特殊值“保留”、“永久”、“随机”或“稳定”之一。此字段替换 D-Bus 上已弃用的“克隆 mac 地址”,该地址只能包含显式硬件地址。请注意,此属性仅存在于 D 总线 API 中。libnm 和 nmcli 继续将此属性称为“克隆的 mac 地址”。
band
string
  网络的802.11频带。“a”表示 5GHz 802.11a,“bg”表示 2.4GHz 802.11。这会将与Wi-Fi网络的关联锁定到特定频段,即如果指定“a”,则即使网络设置兼容,设备也不会与2.4GHz频段中的同一网络关联。此设置取决于特定的驱动程序功能,可能不适用于所有驱动程序。
bssid
byte array
  如果指定,则指示设备仅与给定的接入点关联。此功能高度依赖于驱动程序,并非所有设备都支持此功能。注意:此属性不控制创建临时网络时使用的 BSSID,将来也不太可能控制。
channel
uint32
0
用于无线网络连接的无线通道。设备将仅加入(或为 Ad-Hoc 网络创建)指定信道上的 Wi-Fi 网络。由于频带之间的信道号重叠,因此此属性还需要设置“band”属性。
cloned-mac-address
byte array
  此 D-Bus 字段已弃用,取而代之的是“分配的 mac 地址”,它更灵活,允许指定特殊变体,如“随机”。对于 libnm 和 nmcli,此字段称为“克隆的 mac 地址”。
generate-mac-address-mask
string
  使用“克隆的 mac 地址”设置“随机”或“稳定”,默认情况下,MAC 地址的所有位都会被打乱,并创建一个本地管理的单播 MAC 地址。此属性允许指定某些位是固定的。请注意,第一个 MAC 地址的最低有效位将始终未设置以创建单播 MAC 地址。如果该属性为 NULL,则有资格被默认连接设置覆盖。如果该值仍为 NULL 或空字符串,则默认创建本地管理的单播 MAC 地址。如果该值包含一个 MAC 地址,则将此地址用作掩码。掩码的设置位将填充设备的当前MAC地址,而未设置的位将被随机化。设置“FE:FF:FF:00:00:00”意味着保留当前 MAC 地址的 OUI,并且仅使用“随机”或“稳定”算法随机化较低的 3 个字节。如果该值在掩码后包含一个额外的 MAC 地址,则使用此地址而不是当前 MAC 地址来填充不应随机化的位。例如,值“FE:FF:FF:00:00:00 68:F7:28:00:00:00”会将 MAC 地址的 OUI 设置为 68:F7:28,而较低的位是随机的。值“02:00:00:00:00:00:00 00:00:00:00:00:00”将创建一个完全加扰的全局管理、烧录的 MAC 地址。如果该值包含多个附加 MAC 地址,则随机选择其中一个。例如,“02:00:00:00:00:00 00:00:00:00:00:00:00 02:00:00:00:00”将创建一个完全加扰的 MAC 地址,随机本地或全局管理。
hidden
boolean
FALSE
如果为 TRUE,则表示该网络是隐藏其 SSID 的非广播网络。这在基础结构和 AP 模式下都有效。在基础结构模式下,各种解决方法用于更可靠地发现隐藏的网络,例如探测扫描 SSID。但是,这些变通办法暴露了隐藏 SSID 网络固有的不安全感,因此应谨慎使用隐藏的 SSID 网络。在 AP 模式下,创建的网络不会广播其 SSID。请注意,将网络标记为隐藏网络对于您(在基础设施模式下)或客户端工作站(在 AP 模式下)来说可能是一个隐私问题,因为显式探测扫描在空中是可识别的。
mac-address
byte array
  如果指定,此连接将仅适用于其永久 MAC 地址匹配的 Wi-Fi 设备。此属性不会更改设备的 MAC 地址(即 MAC 欺骗)。
mac-address-blacklist
array of string
  此连接永远不应应用的 Wi-Fi 设备的永久 MAC 地址列表。每个MAC地址应以标准的十六进制数字和冒号表示法给出(例如“00:11:22:33:44:55”)。
mac-address-randomization
uint32
0
NM_SETTING_MAC_RANDOMIZATION_DEFAULT (0)(除非用户已将全局默认值设置为随机化,并且请求方支持随机化),NM_SETTING_MAC_RANDOMIZATION_NEVER (1)(从不随机化 MAC 地址)或 NM_SETTING_MAC_RANDOMIZATION_ALWAYS (2)(始终随机化 MAC 地址)之一。此属性已弃用为“克隆的 mac 地址”。已弃用: 1
mode
string
  无线网络模式;“基础设施”,“网格”,“临时”或“ap”之一。如果为空,则假定基础结构。
mtu
uint32
0
如果不是零,则仅传输指定大小或更小的数据包,将较大的数据包分解为多个以太网帧。
powersave
uint32
0
NM_SETTING_WIRELESS_POWERSAVE_DISABLE (2) (禁用 Wi-Fi 节能)、NM_SETTING_WIRELESS_POWERSAVE_ENABLE (3) (启用 Wi-Fi 节能)、NM_SETTING_WIRELESS_POWERSAVE_IGNORE (1) (不触摸当前配置设置)或NM_SETTING_WIRELESS_POWERSAVE_DEFAULT (0)(使用全局配置的值)之一。所有其他值均保留。
rate
uint32
0
如果非零,则指示设备仅使用指定的比特率与接入点进行通信。单位以 Kb/s 为单位,即 5500 = 5.5 兆位/秒。此属性高度依赖于驱动程序,并非所有设备都支持设置静态比特率。
security
    此属性已弃用,但当连接字典中也存在无线安全设置时,可以将其设置为值“802-11-无线安全性”,以便与非常旧的 NetworkManager 守护程序兼容。
seen-bssids
array of string
  已检测为 Wi-Fi 网络的一部分的 BSSID 列表(每个 BSSID 的格式为 MAC 地址,如“00:11:22:33:44:55”)。网络管理器在内部跟踪以前看到的 BSSID。该属性仅用于读取,并反映网络管理器的 BSSID 列表。不会保留对此属性所做的更改。
ssid
byte array
  无线网络的固态硬盘。必须指定。
tx-power
uint32
0
如果不为零,则指示设备使用指定的发射功率。单位为分贝。此属性高度依赖于驱动程序,并非所有设备都支持设置静态发射功率。
wake-on-wlan
uint32
1
NMSetting无线唤醒启用选项。并非所有设备都支持所有选项。可以是NM_SETTING_WIRELESS_WAKE_ON_WLAN_ANY (0x2)、NM_SETTING_WIRELESS_WAKE_ON_WLAN_DISCONNECT (0x4)、NM_SETTING_WIRELESS_WAKE_ON_WLAN_MAGIC (0x8)、NM_SETTING_WIRELESS_WAKE_ON_WLAN_GTK_REKEY_FAILURE (0x10)、NM_SETTING_WIRELESS_WAKE_ON_WLAN_EAP_IDENTITY_REQUEST (0x20)、NM_SETTING_WIRELESS_WAKE_ON_WLAN_4WAY_HANDSHAKE (0x40) 的任意组合, NM_SETTING_WIRELESS_WAKE_ON_WLAN_RFKILL_RELEASE (0x80)、NM_SETTING_WIRELESS_WAKE_ON_WLAN_TCP (0x100) 或特殊值NM_SETTING_WIRELESS_WAKE_ON_WLAN_DEFAULT(0x1)和NM_SETTING_WIRELESS_WAKE_ON_WLAN_IGNORE(0x8000)(禁用网络管理器中的 LAN 唤醒管理)。

参考文献:

802-11-wireless: NetworkManager Reference Manual (gnome.org)

posted @ 2022-10-02 15:34  穿靴子的outman  阅读(501)  评论(0编辑  收藏  举报