kravietz.wpa_supplicant

角色名称

用于管理 wpa_supplicant 配置的角色，支持所有选项和 systemd。

要求

无。

角色变量

大多数变量（除了第一个）与 wpa_supplicant.conf 参考中的选项直接对应。配置文件通过将 Ansible 字典变量转换生成，例如将 country: GB 转换为配置文件变量 country=GB。请注意，wpa_supplicant 期望一些变量用引号括起来（如 username="[email protected]"），在这种情况下 Ansible 变量必须用双引号括起来（username: '"[email protected]"'）。

这个选项决定了 wpa_supplicant 将在哪个接口上运行：

wpa_supplicant_interface: wlan0

全局 wpa_supplicant 配置选项：

wpa_supplicant_config:
  update_config: 1
  country: GB

可以有多个 creds 块：

wpa_supplicant_credentials:
  - realm: '"example.com"'
    username: '"[email protected]"'

可以有多个 network 块：

wpa_supplicant_networks:
  - scan_ssid: 1
    ssid: '"MySSID"'
    key_mgmt: WPA-PSK
    psk: '"Kohjioqu5Iefae1iedee"'

psk 密钥应使用 ansible-vault 加密，或者更好地使用 wpa_passphrase 工具进行哈希处理，此时无需引号。

依赖关系

你可以将此角色与 shibumi.systemd-conf 一起使用，以便完全通过 Ansible 管理网络配置：

systemd_conf_network:
  10-wlan:
    - Match:
        - Name: wlan0
    - Network:
        - Address: '192.168.1.251/24'
        - Gateway: '192.168.1.252'

示例剧本

假设在 host_vars 中配置如下：

- hosts: access_point
  roles:
    - role: kravietz.wpa_supplicant
      wpa_supplicant_interface: wlan0
      wpa_supplicant_config:
        ctrl_interface: DIR=/var/run/wpa_supplicant GROUP=netdev
        country: GB
      wpa_supplicant_networks:
        - scan_ssid: 1
          ssid: '"TEST"'
          psk: '"TEST-TEST-TEST"'
          key_mgmt: WPA-PSK
    - role: shibumi.systemd-conf