在Oxidized中实现对Ubiquiti AirOS 10设备的配置备份

Oxidized作为一款优秀的网络设备配置备份工具，支持多种网络设备的自动化配置备份。本文将介绍如何为Ubiquiti AirOS 10系列设备创建自定义模型，实现配置的自动备份。

AirOS 10设备特性分析

Ubiquiti AirOS 10是Ubiquiti Networks推出的新一代操作系统，运行在Wave Pro等设备上。与早期版本相比，AirOS 10在命令行接口上有显著变化：

1. 默认SSH会话会进入BusyBox的ash shell环境
2. 系统配置信息存储在/etc/config.json和/etc/board.json文件中
3. 提供了ucfg show命令，可以输出精简版的配置信息

创建Oxidized模型

针对AirOS 10的这些特性，我们可以创建一个专门的Oxidized模型来处理配置备份。以下是完整的模型实现代码：

class Airos10 < Oxidized::Model
  using Refinements

  # Ubiquiti AirOS circa 10.x

  prompt /^[^#]+# /
  comment '# '

  cmd 'ucfg show'

  cfg :ssh do
    exec true
  end
end

代码解析

1. 类定义：继承自Oxidized::Model基类，命名为Airos10
2. 提示符匹配：使用正则表达式/^[^#]+# /匹配设备命令行提示符
3. 注释符号：设置为#，用于在生成的配置文件中添加注释
4. 核心命令：使用ucfg show获取设备配置信息
5. SSH配置：设置exec true确保命令在SSH会话中正确执行

实现原理

该模型通过SSH连接到设备后，会执行以下操作：

1. 等待匹配到设备的命令行提示符
2. 发送ucfg show命令获取配置信息
3. 将获取的配置信息保存到Oxidized的配置仓库中

ucfg show命令的优势在于它能够输出精简而完整的配置信息，避免了直接解析JSON配置文件可能带来的复杂性。

部署建议

1. 将此模型代码保存为airos10.rb文件
2. 放置在Oxidized的模型目录中（通常为~/.config/oxidized/model/）
3. 在Oxidized的配置文件中为AirOS 10设备指定此模型

扩展可能性

对于需要更详细配置备份的场景，可以考虑扩展此模型：

1. 添加对/etc/config.json和/etc/board.json文件的备份
2. 实现配置差异比较功能
3. 添加设备健康状态信息的收集