部署与运维 · 穹光 ACS

1. 运行环境要求

项目	推荐配置
操作系统	Linux（Ubuntu 22.04 / 24.04 LTS 等主流发行版），亦可在 Windows 上以同样的启动方式运行
CPU / 内存	2 核 / 2 GB 起步；纳管设备规模较大时按在线设备数提升内存
磁盘	20 GB 起；预留数据库与日志增长空间
运行时	Python 3 环境；前端为构建后的静态资源，运行期不需要 Node
数据库	内置轻量数据库，随服务启动自动初始化，无需单独安装 MongoDB
网络	服务器需能被光猫访问到 CWMP 端口；管理界面需能被运维终端访问

端口	用途	说明
`8007`	管理前端 + 业务接口	浏览器访问的入口，同时提供全部业务 REST 接口。防火墙需对外开放。
`8008`	装维助手 H5	手机端装维入口。施工现场需要时对外开放。
`9090`	CWMP 南向服务	光猫的 ACS 地址指向此端口。只需对设备网段开放，无需对公网暴露。

安全建议：仅对外放行必要的端口；CWMP 端口尽量限制在设备管理网段，管理界面可通过跳板机或 VPN 访问。

系统以单一入口启动，三个端口由同一个进程提供：

# 在程序目录下启动
python run.py

# 以服务方式托管（推荐）
systemctl start  tr069acs
systemctl status tr069acs
systemctl restart tr069acs
systemctl stop   tr069acs

启动完成后：

首次部署务必修改默认管理员密码，并按需创建各自的运维账号。

备份建议：至少每天备份数据库文件，并把备份复制到另一台机器；升级、授权变更、大批量操作之前额外做一次快照。

出厂即免费：系统出厂默认为免费版，无需导入授权即可使用。内置永久免费额度为——可管理光猫 10 台、可管理 OLT 1 台、单台 OLT 可注册 ONT 10 个（三组额度互相独立，无到期日）。仅当需要超出该额度时，才需按下述步骤申请并导入正式授权。

获取机器码
在「系统设置 → 系统授权」页面查看当前授权状态，获取本机的机器码信息。
申请授权
凭机器码申请授权文件。授权与机器码绑定，换机或重装需要重新申请。
导入授权
在授权页面导入授权文件，导入成功后刷新页面，确认客户名称、有效期、可管理光猫数量、可管理 OLT 数量与单台 OLT 可注册 ONT 数量均已更新。
核对额度
确认名额使用进度条与实际上线规模匹配，超出额度将无法继续纳管设备。

额度含义：「可管理光猫数量」约束直接纳管的终端设备；「可管理 OLT 数量」与「每台 OLT 可注册 ONT 数量」是 PON 侧的独立额度，与光猫名额互不挤占。

升级会中断全部业务，请安排在维护窗口，并提前备份数据库。

周期	检查内容
每日	设备在线率与掉线设备清单；未确认告警数量；服务进程与端口是否正常
每周	磁盘剩余空间与日志增长；数据库备份是否成功且可恢复；关键模板是否被误改
每月	授权有效期；账号与权限复核（离职人员账号清理）；管理员密码轮换
变更前	数据库快照；确认回退方案；确认变更窗口与影响范围