ap远程配置同步

需要的

H3C V7 AC AP 远程配置同步 remote‑configuration
文档对比两个下发 AP 本地命令方式
map‑configuration（旧方式）：上传配置文件到 AC 存储，隧道 run 后下发，AP 执行，不保存到 AP 的 startup‑config；操作繁琐，适合少量场景。
remote‑configuration（远程配置同步，新功能）：直接在 AC 上编写 AP 要执行的命令，通过 CAPWAP 隧道下发，适合批量 AP；注意：只支持 FIT‑AP，部分老 AP 硬件不支持该特性。
完整配置示例
shell
#1、进入AP视图，可以单台AP，也可以ap‑group批量组
wlan ap ap‑01 model WA5320‑C
remote‑configuration
#在这里输入需要在AP本地执行的命令（就是AP自己命令行的命令）
system‑view
interface GigabitEthernet 1/0
port link‑mode trunk
port trunk permit vlan 100
dhcp trust port
quit
quit

#2、【关键】执行同步，把上面所有命令下发到在线AP上执行
remote‑configuration synchronize ap‑name ap‑01

#如果是ap‑group，对组内全部AP批量下发
remote‑configuration synchronize ap‑group ap‑group‑1
重要特性 & 坑点
执行之后，AP 会运行这些命令，但是默认不会自动保存到 AP 的 startup‑config！
⚠️AP 重启后 remote‑configuration 下发的配置会丢失！
如果希望永久生效，需要在 remote‑configuration 块内加上save force强制保存 AP 配置。
shell
wlan ap ap‑01 model WA5320‑C
remote‑configuration
save force
quit
remote‑configuration synchronize ap‑name ap‑01
对比 map‑configuration：
表格
项目 map‑configuration remote‑configuration
配置来源 外部上传 txt 配置文件 AC 上直接写命令
保存 AP 执行，不自动保存 默认不保存，需要手动写 save force
批量 麻烦 支持 ap‑group 批量同步
依赖 文件上传 CAPWAP 隧道 Run 状态
查看同步结果
shell
#查看远程配置下发状态
display wlan remote‑configuration status

#查看AP实际运行配置，登录AP或者AC上
display ap name ap‑01 running‑configuration
清除已经配置的远程模板
shell
wlan ap ap‑01 model WA5320‑C
undo remote‑configuration all
quit
适用 / 不适用场景
✅适合：本地转发场景，需要修改 AP 有线口 wired‑port 之外的物理网口、开启端口隔离、在 AP 上配置 ACL 等 AP 本地命令。
❌不能写 AC 侧 wlan 模板命令（service‑template、radio 这些 AC 业务模板不要写在这里，这些是 AC 统一下发，不是 remote‑configuration）。
remote‑configuration 里面写的命令，全部是AP 设备自身的系统命令，不是 AC 的配置。
高频踩坑
AP 不支持该功能：老款 AP（部分早期 WA4xxx）硬件不支持 remote‑configuration，执行同步直接报错。文档提示：本功能支持情况和 AP 型号有关。
忘记写 save force，AP 重启配置全部丢失。
AP 状态不是 Run 状态，隧道 down，同步失败。
把 AC 的 wlan 业务配置写进 remote‑configuration，下发会报错，这部分是 AC 模板下发，不属于 AP 本地命令。
补充：map‑configuration 与 remote‑configuration 二者不要混用，二选一。