面向光猫与 PON 的
一体化 TR-069 自动配置管理系统

以自研直连 CWMP 内核为底层 ACS,配套自研业务层与 Vue3 管理前端, 在单一 Python 进程内即可承接真实光猫的注册、参数下发、配置备份、故障诊断与 OLT / ONT 一体化开通。不依赖 MongoDB、不需要 Node 运行时,开箱即可纳管现网设备。

3 个端口8007 业务前端 / 8008 装维 H5 / 9090 CWMP
单进程一条命令拉起全套服务
零外部依赖无需 MongoDB / Node
28 个功能页覆盖开局到运维全流程
永久免费 10 台出厂默认额度,无需授权即可纳管
Overview

系统是什么

一套可以真正接通现网光猫的 ACS(Auto Configuration Server,自动配置服务器)。

1自研 CWMP 内核

自行实现 TR-069/CWMP 服务端:接收设备 Inform、维护会话状态机,并在同一次会话内 顺次下发 GetParameterValues / SetParameterValues / AddObject / DeleteObject / Reboot / FactoryReset / Download / Upload 等 RPC。

  • 光猫 ACS URL 指向 http://<服务器IP>:9090/ 即可纳管,路径通配
  • 兼容厂商风格路径(如 /RMS-server/RMS
  • 设备参数树内存维护并落地持久化,重启不丢

2业务层与前端

业务层负责设备资产、模板、工单、告警、审计等业务语义;前端提供可视化操作界面, 把复杂的参数下发包装成「选设备 → 选模板 → 执行」三步操作。

  • 统一 REST 接口,业务层与内核之间走兼容 NBI 的契约
  • 三级角色:管理员 / 运营 / 装维,权限前后端同口径
  • 附带装维助手 H5,手机扫码即可现场纳管与排障
Architecture

系统架构

南向接设备、北向接界面,中间是一条清晰的 RPC 下发链路。

光猫 / ONT (CPE) ──── CWMP SOAP (9090) ────► 自研 CWMP 内核
光猫 / ONT (CPE) ◄─── RPC 下发(会话内)─── Inform / 会话状态机 / 任务队列
FastAPI 业务层 (8007) ◄── NBI 兼容 REST ──► CWMP 内核 (9090)
Vue3 管理前端 (8007 托管) ── HTTP ──► FastAPI 业务层 (8007)
装维助手 H5 (8008) ── HTTP ──► FastAPI 业务层 (8007)
OLT / ONT 侧:业务层独立维护 OLT 连接池,经 Telnet/CLI 完成 PON 口查询与 ONT 开通
关键点:真正的参数下发发生在设备主动发起的 Inform 会话内 —— 设备带凭据连 ACS, 因此下发与设备侧是否配置了 ConnectionRequest 账号无关。ConnectionRequest 主动唤醒只是 「把设备立刻拽上来」的加速手段,失败会自动降级等待下一次 Inform,绝不阻塞正常下发。
Capabilities

核心能力

从设备开局、业务开通,到日常巡检、故障处理与在线升级。

远程运维

重启、恢复出厂、单参数/批量参数下发、对象实例增删,受保护实例自动拦截。 所有写操作均为「入队 → 会话内下发」,避免带外强推导致设备侧状态不一致。

查询诊断

参数树全量/单值读取,WAN 连接、WiFi、SIP 等业务配置的结构化读取与展示, 诊断工具可对任意参数做定点查询与比对。

配置备份

触发设备上传配置文件、下发固件/配置下载任务,支持配置备份与恢复流程留痕。

分组纳管

设备标签与分组、扫码纳管,配合策略实现按分组批量化操作。

OLT / PON 一体化

OLT 清单与 PON 口面板、未注册 ONT 查询与注册、ONT 批量开通、模板库、 以及直接可用的 OLT CLI 调试台。

业务模板与工单

把多条参数下发封装成业务模板,工单通过 CSV 批量导入并绑定模板, 由系统按绑定值自动匹配设备后执行,全过程可追溯。

告警与通知

定时巡检设备状态与关键指标,产生分级告警;支持告警确认与短信通知渠道。

在线升级

升级包经数字签名校验,安装采用全量快照 + 目录级切换, 校验失败或安装异常自动回滚,避免设备变砖。

授权管理

授权文件与机器码绑定,分别约束可管理光猫数量与 OLT 数量、单台 OLT 可注册 ONT 数量。 出厂即为免费版:永久免费纳管 10 台光猫、1 台 OLT,单台 OLT 可注册 10 个 ONT

License

授权与永久免费额度

系统出厂即为免费版,内置永久有效的免费额度,无需申请授权即可直接纳管设备; 超出免费额度后,再凭机器码申请正式授权扩容。

永久免费 · 无到期日

可管理光猫

10

出厂默认授权额度。

永久免费 · 无到期日

可管理 OLT

1

与光猫额度相互独立,各自计算。

永久免费 · 无到期日

每台 OLT 可注册 ONT

10

按单台 OLT 计数,不占用光猫额度。

说明:以上三组额度互相独立,不合并计算;免费额度只限制新增, 已在管的光猫与 OLT 不会被回溯锁定。出厂新装的系统默认即为上述免费版; 已有历史授权记录的存量系统沿用其原有授权口径,不受本页额度影响。 需要超出时,在「系统设置 → 系统授权」页面凭机器码申请正式授权文件,导入后按授权文件中的额度执行。