OpenWrt UCI 设置无线 BSSID 完全指南：从基础到排错

## 前言

在OpenWrt路由器系统中，UCI(Unified Configuration Interface)是管理网络配置的核心工具。本文将详细介绍如何使用UCI设置无线网络的BSSID，以及遇到问题时如何进行有效排查。

## 什么是BSSID？

BSSID(Basic Service Set Identifier)实质上是无线接入点(AP)的MAC地址。在OpenWrt配置中，正确设置BSSID对于：

- 客户端模式(STA)下连接特定AP
- AP模式下标识自己的无线网络
- 实现无线网络隔离
- 进行精准的无线网络管理

都至关重要。

## 基础配置方法

### 标准UCI命令格式

```bash
uci set wireless.<section>.<option>=<value>
```

### 1. 确认无线接口配置节

首先需要确定正确的配置节(section)名称：

```bash
uci show wireless
```

典型输出示例：
```
wireless.radio0=wifi-device
wireless.@wifi-iface[0]=wifi-iface
wireless.@wifi-iface[1]=wifi-iface
```

### 2. 设置BSSID的基础命令

```bash
uci set wireless.@wifi-iface[0].bssid='00:0a:5a:64:21:cf'
uci commit wireless
wifi reload
```

## 高级配置技巧

### 不同模式下的BSSID设置

| 工作模式 | 配置参数 | 说明 |
|---------|---------|------|
| STA模式 | bssid | 指定要连接的AP的MAC地址 |
| AP模式 | macaddr | 设置AP自身的MAC地址 |
| Mesh模式 | bssid | 用于Mesh网络节点识别 |

### 多无线接口配置

如果有多个无线接口，需要分别设置：

```bash
# 第一个无线接口
uci set wireless.@wifi-iface[0].bssid='00:0a:5a:64:21:cf'

# 第二个无线接口
uci set wireless.@wifi-iface[1].bssid='00:0b:5b:75:32:df'

uci commit wireless
wifi reload
```

## 常见问题排查指南

### 问题1：设置后不生效

**排查步骤：**

1. 确认配置已提交：
```bash
uci changes wireless
```
如果显示有未提交的更改，运行：
```bash
uci commit wireless
```

2. 检查无线接口状态：
```bash
iwconfig
```

3. 查看系统日志：
```bash
logread | grep wifi
```

### 问题2：MAC地址无效

**可能原因：**

- MAC地址格式错误
- 设备不支持设置的MAC地址
- 驱动限制

**解决方案：**

1. 验证MAC地址格式：
```bash
ifconfig wlan0 | grep HWaddr
```

2. 尝试使用`iw`命令直接设置：
```bash
iw dev wlan0 set addr 00:0a:5a:64:21:cf
```

### 问题3：驱动不支持

**判断方法：**

查看内核日志：
```bash
dmesg | grep wifi
```

**解决方案：**

1. 更新无线驱动：
```bash
opkg update
opkg install kmod-ath9k # 示例，根据实际硬件选择
```

2. 考虑更换兼容性更好的无线网卡

## 配置示例

### 示例1：强制连接指定AP

```bash
uci set wireless.@wifi-iface[0].mode='sta'
uci set wireless.@wifi-iface[0].ssid='MyWiFi'
uci set wireless.@wifi-iface[0].bssid='00:0a:5a:64:21:cf'
uci set wireless.@wifi-iface[0].encryption='psk2'
uci set wireless.@wifi-iface[0].key='mypassword'
uci commit wireless
wifi reload
```

### 示例2：设置AP的MAC地址

```bash
uci set wireless.@wifi-iface[0].mode='ap'
uci set wireless.@wifi-iface[0].ssid='MyAP'
uci set wireless.@wifi-iface[0].macaddr='00:0a:5a:64:21:cf'
uci set wireless.@wifi-iface[0].encryption='psk2'
uci set wireless.@wifi-iface[0].key='apassword'
uci commit wireless
wifi reload
```

## 最佳实践建议

1. **配置备份**：
```bash
cp /etc/config/wireless /etc/config/wireless.bak
```

2. **变更记录**：
建议在修改配置前记录原始值：
```bash
uci show wireless > wireless_config_$(date +%Y%m%d).log
```

3. **测试方法**：
修改配置后，建议先测试而不保存：
```bash
wifi down
wifi up
```
确认无误后再执行：
```bash
uci commit wireless
```

## 进阶技巧

### 使用脚本批量修改

```bash
#!/bin/sh

INTERFACE=0 # 0表示第一个无线接口
NEW_BSSID="00:0a:5a:64:21:cf"

uci set wireless.@wifi-iface[$INTERFACE].bssid=$NEW_BSSID
uci commit wireless
wifi reload

echo "BSSID已修改为 $NEW_BSSID"
```

### 定时切换BSSID

```bash
# 在crontab中添加
0 3 * * * uci set wireless.@wifi-iface[0].bssid='00:0a:5a:64:21:cf' && uci commit wireless && wifi reload
```

## 常见问题FAQ

**Q：BSSID和SSID有什么区别？**

A：SSID是无线网络名称(如"HomeWiFi")，BSSID是AP的物理MAC地址(如"00:0a:5a:64:21:cf")。

**Q：为什么修改后无线连接会断开？**

A：修改BSSID/MAC地址会导致无线接口重启，这是正常现象。建议在维护时段进行修改。

**Q：如何恢复默认设置？**

A：
```bash
rm /etc/config/wireless
wifi config
```

## 总结

通过本文，您应该已经掌握了：

1. OpenWrt中BSSID的基本概念和配置方法
2. 不同无线模式下的BSSID设置技巧
3. 常见问题的排查方法
4. 一些实用的进阶配置技巧

正确配置BSSID对于网络管理和安全都很重要。如果在实际操作中遇到问题，可以参考本文的排查指南，或者查阅OpenWrt官方文档获取更多信息。

**延伸阅读：**
- [OpenWrt官方无线配置文档](https://openwrt.org/docs/guide-user/network/wifi/basic)
- [Linux无线网络高级配置](https://wireless.wiki.kernel.org/)
- [IEEE 802.11标准详解](https://standards.ieee.org/standard/802_11-2016.html)

希望这篇指南对您的OpenWrt网络配置有所帮助！如果有任何问题，欢迎在评论区留言讨论。