核心内容摘要
告别复杂配置：用轻量级虚拟机工具实现极速部署与跨系统体验
开源TR-069 ACS自动配置服务器GenieACS 的四个主要模块详细介绍GenieACS 是一个开源的 TR-069CWMP自动配置服务器ACS广泛用于管理宽带终端设备如光猫、机顶盒、路由器等。
它采用模块化设计共分为四个核心模块genieacs-cwmp、genieacs-nbi、genieacs-fs和genieacs-ui。
每个模块独立运行通过 MongoDB 和 Redis 共享数据。
下面分别详细说明每个模块的功能、配置和使用方式。
genieacs-cwmpCWMP Server功能这是 GenieACS 的核心模块负责处理 CPE终端设备发起的 TR-069 协议会话。
接收和响应 Inform、GetParameterValues、SetParameterValues、Download、Reboot 等 RPC 请求。
维护设备会话状态执行预设Presets、任务Tasks和虚拟参数Virtual Parameters的逻辑。
支持 Connection Request主动唤醒设备实现 ACS 主动下发指令。
与 MongoDB 交互存储设备数据、会话历史与 Redis 缓存实时状态。
配置主要配置文件config.json 或环境变量CWMP_INTERFACE/CWMP_PORT监听接口和端口默认 7547SSL 可配 7557。
CWMP_SSL是否启用 HTTPS需提供证书。
CONNECTION_REQUEST_PORTConnection Request 监听端口默认 3000。
MAX_WORKERS处理并发会话的工作进程数建议根据服务器性能设置。
LOG_LEVEL日志级别debug/info/error。
MongoDB/Redis 连接字符串MONGODB_CONNECTION_URL、REDIS_URL。
示例环境变量exportCWMP_PORT7547exportCONNECTION_REQUEST_PORT3000exportMONGODB_CONNECTION_URLmongodb://localhost:27017/genieacsexportREDIS_URLredis://localhost:6379/0使用启动命令genieacs-cwmp或使用 PM2/Systemd。
CPE 必须在设备端配置 ACS URL 为http://your-server:7547/或 HTTPS。
支持大量并发数万设备适合生产环境核心服务。
调试时可查看日志中的会话交互细节。
genieacs-nbiNorthbound Interface功能提供 RESTful API北向接口用于外部系统如 OSS/BSS、前端页面、脚本对设备进行批量管理。
支持设备查询、参数读取/设置、任务下发、固件升级、批量操作、事件订阅Webhook等。
API 路径通常为/devices、/tasks、/presets、/files等。
支持过滤器强大的查询语法如SerialNumber: 123* AND SoftwareVersion:
0。
可触发 Provision脚本执行复杂逻辑。
配置NBI_INTERFACE/NBI_PORT监听接口和端口默认 7557。
NBI_SSL是否启用 HTTPS。
AUTHENTICATIONAPI 认证方式基本认证、JWT 等可通过 config 或环境变量配置用户。
同样需要 MongoDB/Redis 连接。
示例exportNBI_PORT7557exportUSERNAMEadminexportPASSWORDsupersecret使用启动命令genieacs-nbi。
示例 API 调用使用 curl# 查询所有设备curl-u admin:supersecret http://localhost:7557/devices# 对设备下发 GetParameterValuescurl-u admin:supersecret -X POST http://localhost:7557/devices/123456/tasks\-d{name: getParameterValues, parameterNames: [InternetGatewayDevice.DeviceInfo.SerialNumber]}# 添加固件升级任务curl-u admin:supersecret -X POST http://localhost:7557/devices/?queryModelName:ABC\-d{name: download, file: firmware-v
bin}常用于与第三方系统集成或自定义前端调用。
genieacs-fsFile Server功能专用的文件服务模块用于向 CPE 提供固件、配置文件、脚本等文件的 HTTP 下载。
支持文件元数据管理版本、设备类型匹配。
在 Download RPC 中ACS 会返回该模块的下载 URLCPE 再从此模块下载文件。
支持文件缓存、断点续传部分设备支持和访问日志。
配置FS_INTERFACE/FS_PORT监听端口默认 7567。
FS_SSL是否启用 HTTPS。
DOWNLOAD_TIMEOUT下载超时时间。
文件存储路径默认./files可通过FILES_DIRECTORY指定。
示例exportFS_PORT7567exportFILES_DIRECTORY/var/genieacs/files使用启动命令genieacs-fs。
将固件或配置文件放入文件目录或通过 API 上传。
通过 NBI API 注册文件curl-u admin:supersecret -X POST http://localhost:7557/files\-Ffilefirmware-v
bin\-Fmetadata{\version\:\
0\,\deviceType\:\ONT\}在任务中引用文件名即可触发下载。
genieacs-uiUser Interface功能官方提供的 Web 图形化管理界面基于 React。
提供设备列表、实时参数查看、任务下发、固件管理、预设配置、图表统计、日志查看等功能。
支持多用户权限管理员/只读。
通过调用 NBI API 实现所有操作适合运维人员日常使用。
配置UI_PORTWeb 服务端口默认 3000。
JWT_SECRET用于用户登录的 JWT 密钥。
NBI_URL指向 genieacs-nbi 的地址默认 http://localhost:7557。
示例环境变量exportUI_PORT3000exportJWT_SECRETyour_very_secure_secretexportNBI_URLhttp://localhost:7557使用构建并启动先npm install npm run build然后genieacs-ui或使用 Docker。
访问地址http://your-server:3000。
默认管理员账号admin / secret首次登录后建议修改。
主要页面Devices设备列表、搜索、批量操作。
Presets/Provision配置自动化脚本。
Files固件/文件管理。
Tasks查看任务执行状态。
Dashboard概览统计。
总结四个模块相互独立可分别部署在不同服务器上推荐生产环境分离 cwmp 和其他模块以提升安全性。
所有模块共享同一个 MongoDB存储设备数据、任务、预设等和 Redis缓存、会话状态。
典型部署方式使用 Docker Compose 或 PM2 Systemd 管理服务。
官方文档https://docs.genieacs.com