Skip to content

Releases

v1.2.5 —— 安全更新:工具链升到 Go 1.27.4

Choose a tag to compare

@hakureiyuyuko hakureiyuyuko released this 11 Nov 15:36

v1.2.5 —— 安全更新:工具链升到 Go 1.27.4

功能零变化:只换了编译器版本,代码逻辑、界面、配置、数据库都没有改动。
升级就是换二进制,重启即可。

为什么发这一版

用 govulncheck(v1.9.0,漏洞库 2026-11-11)扫 v1.2.4 的构建环境
(Go 1.27.1),报出 14 项会影响项目代码的漏洞,另有 1 项不可达。
全部来自 Go 标准库,第三方依赖 0 项 —— 所以不用改任何依赖,升工具链即可。

影响面 内容 修复版本
net/http + 内置 HTTP/2(10 项) HTTP/1 请求走私(CONNECT 拒绝后、2xx CONNECT 后不同步)、Trailer 头导致内存耗尽、Range 头无长度限制、反复 initial window 更新耗 CPU、HTTP/2 流量控制重复退款、HPACK 编码器竞态导致崩溃、恶意 framing 头被接受、MaxBytesReader 头竞态导致崩溃 1.27.2(MaxBytesReader 要 1.27.4)
html/template(2 项) 连续模板表达式不重置上下文追踪;yield 未被识别为 regexp 前置关键字(模板注入) 1.27.2
crypto/x509 不信任被攻陷的中间证书 1.27.3
crypto/tls ECH 外层扩展引用校验 1.27.2
net/textproto / mime/multipart MIME 头解析绕过内存限制 1.27.2

另有 os 的 Windows junction 逃逸问题(1.27.2 修复),但这个符号本项目走不到,不可达。

对 ACS 来说最要紧的三处

  1. html/template 的模板注入:面板把设备上报的字符串(型号、SerialNumber、
    ProductClass、参数值)直接喂进模板,一台被劫持的 CPE 就是不可信输入源;
  2. net/http 那一组:CWMP 端口本来就对设备(甚至公网)开放,面板端口对局域网开放,
    请求走私 / 内存耗尽 / 崩溃这几条都是直接打这两个端口的;
  3. crypto/x509:主动唤醒设备时会去连设备的 ConnectionRequestURL,
    证书链校验是这条路上的第一道闸。

改了什么

  • 构建工具链:Go 1.27.1 → 1.27.4;
  • go.mod 增加 toolchain go1.27.4 —— 以后谁用旧版本 Go 构建,go 会自动拉 1.27.4,
    避免再编出带这批漏洞的二进制;
  • README.md / README-en.md 的构建要求写成 Go 1.27.4+;
  • 实现笔记新增「依赖漏洞扫描」一节(清单、影响面、复现方式)。

升级

tar xzf acs-1.2.5-linux-amd64.tar.gz && cd acs-1.2.5-linux-amd64
sudo ./install.sh     # 或 sudo ./update.sh

配置与数据库完全不动;从 v1.2.4 升级没有迁移。

如果你在用 v1.2.4 的发布包,建议升级:那批二进制是用 Go 1.27.1 编译的,
带着上面列的全部问题。

验收

  • govulncheck ./...(Go 1.27.4)→ No vulnerabilities found
  • go vet ./...、gofmt -l 干净;go test ./... 全过
  • scripts/verify-s1.sh 398 / 0
  • scripts/verify-interop.sh 8 / 0
  • scripts/dev/verify-restart.sh 20 / 0

v1.2.4 —— 以太网口、主动唤醒派发器、概览随设备周期刷新、参数映射表

Choose a tag to compare

@hakureiyuyuko hakureiyuyuko released this 09 Oct 13:10

v1.2.4 —— 以太网口、主动唤醒派发器、概览随设备周期刷新、参数映射表

七件事 + 一份协作说明。这次有数据库结构变化:启动时自动建 param_aliases 表并
种入 10 条华为映射(幂等,不动现有数据),所以升级只需换二进制。

1. 以太网口:详情页新区块

真机(HN8145X6N / 两台 V271-20)都报了 4 个网口 × 32 个字段。

  • 区块显示 端口名 / 状态 / 协商速率 / 双工 / MAC / 收发流量 / 采集时间,
    表头写「共 N 个口,已连接 M 个」;没有网口对象的设备整块不显示(不摆空表)。
  • 速率/双工给人话,原文放悬停:MaxBitRate=2500 → 「2.5 Gbps」,
    X_HW_Speed=Auto_10 → 「自动协商(10 Mbps)」,X_HW_DuplexMode=Auto_Full → 「自动协商(全双工)」;
    数字优先、协商值兜底。流量按 1024 进制换算(35376428045 → 「32.9 GB」)。
  • 只取状态类字段:枚举时用 include 白名单筛(含 Stats.BytesSent/BytesReceived,
    能看出哪个口在扛流量),不把一百多个计数器全拉回来。TR-181 的 Device.Ethernet.Link.{i}
    不算网口(它也有 Status/MACAddress,串台就会多几行)。
  • 块的位置:一开始放在「基本信息」前面,按反馈改成**「基本信息」下方、「FTTR 子设备」上方**
    —— 网口是设备本体的属性,贴着基本信息看更顺。

2. 概览数据改成随设备周期上报刷新

起因:设备 9 在 22:56 上报过,但「以太网口」的采集时间还停在 22:49、FTTR 也是旧的。
因为当时概览只有一条固定兜底间隔(-auto-refresh-wifi,默认 10 分钟),22:56 那次上报
只是没到点。期望的是「设备多久报一次,界面就多久新一次」。

现在 无线概况 / 以太网口 / FTTR 子设备三块共用 overviewDue:

  • 设备自己的周期上报(Inform 事件 2 PERIODIC)→ 顺手刷 —— 这就是「随周期更新」;
  • 兜底:距上次采集超过 -auto-refresh-wifi(默认 10 分钟)也刷一次,
    防止有些设备不报 2 PERIODIC(或上报的是我们主动唤醒开的会话)导致数据永远不动;
  • 周期那条路径还要过新增的 -overview-refresh-min(ACS_OVERVIEW_REFRESH_MIN,默认 30 秒)
    下限,上报很密的设备不至于每个会话都枚举一遍(0 = 不设下限)。

关键前提:Inform 处理里入队的任务会在同一个会话接着下发,所以顺手刷不会额外叫醒设备,
也不会和下面的派发器形成循环(设备自己上报时正好有任务在跑,且唤醒事件是
6 CONNECTION REQUEST,不是 2 PERIODIC)。实测设备 9 由每 12 分钟刷一次变成
22:59:17 → 23:01:17,与它 2 分钟的上报周期对齐。

3. 我们发起的动作一律主动唤醒设备

以前「入队任务 → 等设备下次 Inform」:真机上报周期可以长到几十分钟,界面上点一下要等很久,
看着像坏了。现在有一条统一的任务派发器(internal/cwmp/dispatch.go),每
-task-wake-interval(ACS_TASK_WAKE_INTERVAL,默认 10 秒,0 = 关)扫一次,
对「还有 pending 任务」的设备四条全过才发 Connection Request:

  1. 在线(离线的交给离线巡检去探,别白叫);
  2. 没有任务正在 running —— 设备就在会话里,后续任务会被接着下发,不用叫;
  3. 不是刚上报完(5 秒内)—— 留点时间让这次会话把任务取走;
  4. 距上次唤醒超过冷却(30 秒)—— 人工点、离线探测、派发三路共用这个冷却。

为什么做成派发器而不是在十几个入队点各调一次唤醒:靠「记得调用」早晚会漏。派发器只看
「谁还有任务排队」,天然覆盖所有路径。实测:周期 300 秒的模拟器排一条任务后
几秒内被执行。

4. FTTR 子设备也定期刷新

子设备(子光猫)子树以前只在纳管那次能力探测时采一次,于是界面上的「采集」永远停在
那一刻 —— 子光猫的在线状态 / 终端数 / 信号是几天前的数据却还挂在页面上,看着像实时的。
现在跟无线概况一个节奏刷(见第 2 节的触发规则),子机离线时界面会如实显示离线,
而不是纳管时的旧快照。

5. 厂商私有参数映射表放数据库

光功率 / 温度 / 电压 / 偏流这些参数各家名字都不一样,同一台设备上还有按光模块寄存器
(SFF-8472)编码的原始值(如 RXPower=254 其实是 −15.95 dBm)。把这些知识写死在代码里,
支持一台新光猫就得改代码发版。

现在放库里(迁移 #5 建表、#6 种数据):param_aliases(field / vendor / match_contains /
match_suffix / decode / priority)。加机型只加数据:

acs alias ls                 # 列出全部映射
acs alias add ...            # 加一条
acs alias rm <id>            # 删一条
acs alias kinds              # 看有哪些字段与换算方式
  • 详情页「基本信息」多了 光模块温度 / 光模块电压 / 光模块偏流(此前只有收/发光)。
  • 映射优先、启发式兜底:映射命中的解码值还要过物理区间闸(收光 −40~+10 dBm、
    温度 −40120 ℃、电压 010 V、偏流 0~200 mA),一条映射都没命中时才退回按叶子名认方向的
    启发式。没数据就显示 -,不编数字。
  • 换算已与设备自己的页面逐项对上:11008 → 43.0 ℃、32260 → 3.226 V、14500 → 29.0 mA。

6. CONTRIBUTING(中文 + 英文)

新增 CONTRIBUTING.md,顶部加粗说明只在中华人民共和国工作日处理 issue/PR;
另有英文版 CONTRIBUTING-en.md(与中文版顶部互链),里面补了一节
「中国的节假日大概在什么时候」(按季度排表 + 调休说明),省得非中文区贡献者干等。

7. 其它

  • 派发日志改成打印目标 URL,排障时不用再猜叫的是哪台、哪个地址。

升级

tar xzf acs-1.2.4-linux-amd64.tar.gz && cd acs-1.2.4-linux-amd64
sudo ./install.sh     # 或 sudo ./update.sh

配置不动。数据库会在启动时自动加一张 param_aliases 表并种入 10 条华为映射,
幂等、不动现有数据。

验收

  • go test ./... 全过(新增 dispatch_test、fttr_refresh_test、laneth_test、
    params_map_test、optical_test、aliases_test、index_optical_test 等)
  • scripts/verify-s1.sh 398 / 0
  • scripts/verify-interop.sh 8 / 0(独立实现的 CPE 端到端互通)
  • scripts/dev/verify-restart.sh 20 / 0(改端口自动重启,含浏览器实证跳转)

v1.2.3 —— 收/发光功率、改完端口自己重启、纳管凭据自愈、无线概览去掉假行

Choose a tag to compare

@hakureiyuyuko hakureiyuyuko released this 30 Sep 13:08

v1.2.3 —— 收/发光功率、改完端口自己重启、纳管凭据自愈、无线概览去掉假行

四件事,都是真机用出来的。没有数据库结构变化(升级只换二进制,库和配置不动)。

1. 光功率:详情页两行 + 列表页两列

新接了一台 PON 接入的 V271-20(联通定制,V5R023C10S200),它在 TR-069 里确实报收/发光,
但位置和名字都很"私有",所以这版的做法是枚举位置 + 按语义辨认,而不是猜参数名。

实测踩到的三个坑(都写进了 docs/notes/implementation-notes.md):

情况 真机表现
TR-098 里 PON 接口的常规位置 WANPONInterfaceConfig. 整棵回 9005 Invalid parameter name,枚举不了
读数真正在哪 …WANDevice.1.X_GponInterafceConfig.RXPower / TXPower(对象名确实是拼错的 Interafce)
同一棵里的 X_CU_…OpticalTransceiver.RXPower / TXPower 报的是没换算的原始值(254 / 10000),当 dBm 显示就是错的

所以采集侧枚举 WANDevice.1. 整棵(用叶子名后缀只留"像功率的"那几个,取值名单很小)+
Optical. 整棵;辨认侧(web.hostOpticalFrom)三道闸:① 排除无线路径
(LANDevice.1.WiFi.X_HW_Txpower 这类会被认成发光功率)② 值必须落在光模块讲得通的
−40 ~ +10 dBm(私有百分比、原始 ADC 值、语音 Tone 的 −100 全挡掉)③ 同方向多候选时优先
路径里有 pon / optical 的。FTTR 子光猫的功率不算在主机头上(它们在 FTTR 表格里按行显示)。

  • 详情页「基本信息」多了 收光 / 发光 两行;读不到就写 -(不编数字,也不隐藏这一行,
    免得「没做这个功能」和「设备没上报」分不清)。
  • 设备列表页多了「收光 / 发光」两列 —— 只在真有设备报过时才出现,一台都不报就不摆空列。
    列表页本来就要为无线概况扫一次参数表(5 秒自刷一次),所以光功率是并进同一条查询的,
    没有新开第二条全表扫描。
  • 采集时机:首次纳管 / 0 BOOTSTRAP 自动采一次;详情页「重新获取」也会顺带采一次。

遗留:这台 V271 的 TXPower 自报 0。0 dBm 在合理区间内(GPON 通常在 +2~+3 dBm),
所以界面如实显示 0 dBm,但它也可能是固件"没测到就填 0"的占位值 —— 待第二台同型号对照
或用光功率计核对。

2. 改完监听地址可以点「立即重启服务」

以前设置页只能写一句「重启服务后生效」,剩下的让用户自己去命令行。
现在保存过监听地址后,提示里多一个「立即重启服务」按钮(二次确认),确认后服务自己换进程生效,
浏览器自动跳到新地址;失败当场回滚(新端口被占、地址写错都拦在动手之前),不会把人晾在命令行前。

实现上最关键的一点:端口不是配置,是内核里那个 socket。第一版"起新进程重新 bind"必然失败 ——
没变的 CWMP 端口还被老进程听着(address already in use)。现在是句柄交接:
老进程把要用的监听句柄经 ExtraFiles 递给新进程,新进程 net.FileListener 接管,
所以换进程时 CWMP 端口零断点,设备那头看不到抖动。systemd 托管时不能自己 spawn
(单元是 Restart=always,会两个进程抢端口),改成干净退出交给 systemd 拉起。

3. 新设备接入的 ConnectionRequest 凭据:自愈

复核结论:凭据一直是全自动的,而且是在 0 BOOTSTRAP, 1 BOOT 那次上报的同一次会话里写下去
(真机耗时 6 秒完成全套纳管)。用户名设备会回读、密码永远回空串 —— 任务结果里那句
「设置成功;1 个参数设备未回读,无法核对」是成功的固有描述,不是失败。

这版补了两处洞:

  • 判"规范好没有"改看任务历史(密码读不回来,看库里的值永远判成"没写"):写成功且值就是当前
    这套才算数;失败隔 10 分钟重试、连败 3 次停手并 WARN;设备自报用户名跟我们配置的不一致
    (运营商改过)→ 不管历史如何都重写。
  • 顺带修掉"每次重启都白写一遍":真机复核重启后设备 2、9 各上报一次,凭据下发 0 次,唤醒照旧成功。

4. 无线概况里那行「5G | - | 开 | -」是假的

现象:详情页多出一行 5G、射频「开」、其余全空,还带一个点开什么都没有的「修改」。

原因:华为 TR-098 设备挂了两套无线对象 —— SSID 一级的 WLANConfiguration.{i}
(真机实例号 1 / 5)和射频一级的 WiFi.Radio.{i}(实例号 1 / 2)。代码里为兼容 TR-181
把两者按实例号合并,于是 WiFi.Radio.2 凭空造出一个「实例 2」,只带开关与频段两个字段。

改法:射频 / 接入点对象只能补充已有实例,不能自己造一行;另外什么都不报的实例不显示。
真机 1 / 2 / 9 三台的详情页与概览页都回到了「每台 2 行」。

5. 英文 README

新增 README-en.md(README.md 的完整英文对照,顶部互加语言链接)。

升级

tar xzf acs-1.2.3-linux-amd64.tar.gz && cd acs-1.2.3-linux-amd64
sudo ./install.sh     # 或 sudo ./update.sh

配置与数据库完全不动。升级后在设置页里改监听地址就能直接点「立即重启服务」了。

验收

  • go test ./... 全过(新增 internal/restart、internal/web/optical*、wifi_instances、
    index_optical、internal/store/summary、internal/cwmp/connreq_provision 等测试)
  • scripts/verify-s1.sh 368 / 0;scripts/verify-interop.sh 8 / 0
  • scripts/dev/verify-restart.sh 20 / 0:用独立临时实例真跑「改端口 → 自动重启」,
    含 CWMP 端口仍在听(零断点)、失败回滚不换进程、无头浏览器实证倒计时跳转
  • 真机验证(4 台:HN8145X6N、V271-20 ×2、自研 CPE 客户端):
    光功率读数、无线概况无假行、唤醒成功、重启不重复下发凭据

v1.2.2 —— 无线概况自动刷新 + 面板不再吃浏览器缓存

Choose a tag to compare

@hakureiyuyuko hakureiyuyuko released this 29 Sep 01:51

v1.2.2 —— 无线概况自动刷新 + 面板不再吃浏览器缓存

两个都是用户实测反馈出来的问题,没有数据库结构变化。

1. 无线 / 终端概况到期自动刷刷新

现象:详情页和终端弹窗里那个「采集 23:13:12」一直不动,只有手动点「采集 WiFi / 重新采集」
才会更新。

原因:无线概况(SSID、开关、信道、加密、关联终端)不是设备在 Inform 里主动报的,得 ACS
主动去读;原来只在首次纳管 / 0 BOOTSTRAP 时读一次,之后就没有任何机制再去读 ——
参数表的 updated_at 不变,界面上的「采集」时间自然就冻在纳管那一刻。

改法:新增 -auto-refresh-wifi(env ACS_AUTO_REFRESH_WIFI,默认 10 分钟,
0 = 只在首次纳管时采一次,即旧行为)。每次设备上报时看一眼该设备无线参数最近一次写入时间
(与界面显示的是同一个来源,不会出现「界面说 3 分钟前、实际 10 分钟前」),到期就把采集任务
再排一次 —— 顺带把终端主机名那批参数也带上。任务在本次会话里下发,设备上报后界面很快刷新。

2. 面板页面不再被浏览器缓存

现象:改了界面/参数,打开面板看着还是旧的,容易误判成「没生效」。

改法:面板 HTML 一律 Cache-Control: no-store;/static/ 用 no-cache(每次回源确认),
改了 app.js / style.css 刷新就能用上。

升级

tar xzf acs-1.2.2-linux-amd64.tar.gz && cd acs-1.2.2-linux-amd64
sudo ./install.sh     # 或 sudo ./update.sh

升级后如果浏览器里还留着旧页面,强刷一次(Ctrl+F5)即可 —— 之后不会再被缓存。

验收

  • go test ./... 全过;scripts/verify-s1.sh 353 / 0;scripts/verify-interop.sh 8 / 0
  • 新增第 37e 节:单独起一台 ACS_AUTO_REFRESH_WIFI=2s 的实例,注册模拟设备后什么都不点、
    等两个间隔,断言库里无线参数的写入时间确实前移(并能在日志里看到「无线概况到期,已安排刷新」)
  • 新增第 37d 节:断言面板 HTML 必须 no-store、静态资源必须 no-cache

v1.2.1 —— 修一处界面文案的格式化错误

Choose a tag to compare

@hakureiyuyuko hakureiyuyuko released this 28 Sep 15:11

v1.2.1 —— 修一处界面文案的格式化错误

只修显示,程序逻辑没动。

修了什么

终端弹窗的标题写成「主机 %!s(int=5) 台 · 子设备 %!s(int=6) 台 · 共 11 台」——
中英双语改造时,那句文案的模板里把整数值喂给了 %s(Go 的 Sprintf 于是把
%!s(int=5) 原样打了出来)。同一个坑的另一处(FTTR 那行,值是字符串)当时是对的,
所以只有弹窗这一处露了出来。

顺带加了道防线

verify-s1.sh 新增第 37c 节:把列表页、设备详情页、无线编辑页、设置页在中/英两种语言下
都渲染一遍,只要页面上出现 %!(…) 这类格式化错误标记就报失败(8 条断言)。
这类错只有在真渲染时才现形,之前那套断言(英文页面无中文残留)抓不到它。

升级

已经装了 v1.2.0 的机器直接覆盖即可(没有数据库结构变化):

tar xzf acs-1.2.1-linux-amd64.tar.gz && cd acs-1.2.1-linux-amd64
sudo ./install.sh     # 或 sudo ./update.sh

验收

  • go test ./... 全过;scripts/verify-s1.sh 348 / 0(含新增的 8 条格式化错误断言);
    scripts/verify-interop.sh 8 / 0
  • 发布包实测:用包里的二进制起实例、注册一台带无线频段的模拟设备,终端弹窗标题显示为
    「主机 5 台 · 子设备 6 台 · 共 11 台」,英文界面为「5 host clients · 6 sub-device clients · 11 clients」

v1.2.0 —— 登录页鉴权、自动刷新、中英双语,外加一套压测工具

Choose a tag to compare

@hakureiyuyuko hakureiyuyuko released this 28 Sep 14:59

v1.2.0 —— 登录页鉴权、自动刷新、中英双语,外加一套压测工具

这一版把面板打磨成「能给客户看」的样子:独立登录页(可退出)、5 秒自动刷新、
中英双语;同时把「大规模断电恢复」的压测脚本化,顺手量清了并发上限的瓶颈在哪。

面板鉴权:不再用 HTTP Basic

  • GET /login 独立登录页;登录后下发会话 cookie(HttpOnly + SameSite=Lax,7 天自动续期)
  • 顶栏加了退出按钮;未登录时页面 303 跳登录页、/api/* 回 401 JSON
  • 改账号密码会让所有旧登录态立刻失效(当前浏览器会补发新票,不会被自己踢出去)
  • 登录失败有固定延迟与同来源锁定;成功/失败都写日志
  • 忘了密码照旧救急:用 ACS_WEB_AUTH=off 起一次即可进来改

HTTP Basic 的三个硬伤(没法退出、改密码吊销不掉、密码随每个请求 Base64 发出)就此绕开。

5 秒自动刷新(全局开关)

设备列表与设备详情右上角各有一个开关,两边共用一个状态(存在浏览器里)。
开着的时候每 5 秒自动刷新,在线/离线、探测中、任务进度不用手点。
两个体贴处:正在输入时不刷、弹窗打开时不刷;分页位置与参数过滤词会跨刷新保留。

中英双语

右上角一键切换,选择记进 cookie;没选过就跟随浏览器语言,兜底中文。
模板、前端脚本、以及后端拼出来的提示语/任务结果全部双语,英文页面里不会有中文残留
(验收里有断言卡着)。加一种语言的步骤见 docs/notes/i18n.md。

压测工具(新增)

scripts/loadtest.sh                  # 阶梯 10/50/100/200/400 台,每档用全新的库
scripts/loadtest.sh -n 200 -e 4484   # 指定台数与每台参数规模

按真机华为 V271-20 的模板(TR-098、3 台 FTTR 子设备、X_HW_APDevice 子树 4484 个参数)
模拟集体上电。本机(4 核)实测结论:

  • 会话并发本身不是瓶颈:200 台小参数设备 10 秒内全部完成;
  • 瓶颈是写入吞吐:约 1.6–1.8 万参数行/秒 ≈ 3.5–4 台 V271 规模设备/秒,
    ACS 全程只用 ~1 个核(SQLite 单连接把所有 DB 操作串行化);
  • 100 台同时上电约 26 秒完成;200 台约 1 分钟、400 台约 2 分钟,期间数据全量入库,
    超出 CPE 30 秒超时的设备会在下次周期上报补完;
  • 不要靠调大数据库连接池提速:实测 4/8 连接快 2–3 倍,但出现 SQLITE_BUSY 并丢写入
    (参数只入库 44%/32%),所以 SetMaxOpenConns(1) 是正确性要求。

细节与复现方式见 docs/notes/loadtest.md。

升级

tar xzf acs-1.2.0-linux-amd64.tar.gz && cd acs-1.2.0-linux-amd64
sudo ./install.sh     # 原地升级,保留数据库与 /etc/default/acs
# 或者: sudo ./update.sh   # 从 GitHub 拉,带校验与失败回滚
  • 没有数据库结构变化,直接覆盖即可;升级后第一次打开面板会看到登录页(账号密码不变)。
  • 面板若跑在公网上,建议仍然放在内网或用反向代理加 TLS。

验收

  • go test ./... 全过(i18n 语言协商与译文、模板不漏翻、鉴权登录流程与锁定、离线判定 18 个边界…)
  • scripts/verify-s1.sh 340 / 0:含登录页/退出/改密码作废、5 秒自动刷新(真跑 JS)、
    中英切换(英文页面无中文残留)、离线判定的两个真跑场景
  • scripts/verify-interop.sh 8 / 0(与 GenieACS 官方 JS 模拟器互通)
  • 发布包已在真机路径上端到端验过:老版本安装 → update.sh 从 GitHub 升级 → 启动新版本 →
    库可用、面板登录页与语言切换正常

v1.1.0 —— 在线状态按设备周期判定 + 界面三态与筛选

Choose a tag to compare

@hakureiyuyuko hakureiyuyuko released this 28 Sep 13:44

v1.1.0 —— 在线状态按设备周期判定 + 界面三态与筛选

这一版改了在线状态的判定方式(含一次数据库自动迁移),并给离线设备加了操作限制。

在线判定:不再固定 10 分钟,改成按设备自己的上报周期

TR-069 里设备断电不会通知 ACS(设备只在有会话时说话),在线状态本来就只能靠
「多久没动静」推断。原来写死 10 分钟,对 120 秒周期的设备太钝、对 1 小时周期的又太急。
现在跟设备上报的 PeriodicInformInterval 挂钩:

最后一次上报 + 上报周期×2          → 开始主动探测:发 Connection Request
  ├─ 最多探 3 次(默认间隔 15s)
  ├─ 有一次连上 → 设备还活着:保持在线
  └─ 3 次都连不上 + 再等 30s      → 标记离线
设备没上报周期信息 / 关掉探测       → 退回 -offline-after(默认 10 分钟)纯超时
没有 ConnectionRequestURL          → 没法探,超期直接判离线

以 120 秒周期的设备为例:约 4 分钟开始探测,6 分钟左右判离线(原来要 10 分钟以上)。
探测并发发出,一批设备同时掉线也不会拖慢巡检。

新配置项(默认值就是上面这套,都能改):
-offline-probe、-offline-probe-factor、-offline-probe-attempts、-offline-probe-interval、
-offline-probe-grace、-offline-probe-max、-offline-check-interval。

界面上看得见状态

  • 设备状态三态:在线 / 探测中(超期了、正在探测)/ 离线
  • 概览「在线」卡片补一行「N 台正在探测」;设备详情页写明「超期未上报,已主动探测 N 次 + 最近一次时间」
  • 首页新增在线 / 离线 / 探测中筛选(?state=,可跟搜索叠加,地址随便分享)
  • 离线设备的操作按钮变灰:重新获取、立即唤醒、重启、诊断都禁用(并说明原因);
    删除设备仍可用(纯本地操作),备注也照旧可改

升级注意

  • 数据库会自动迁移(新增 devices.probe_count / probe_at 两列,user_version 2→4),
    设备数据、参数、任务、上报记录都不动。升级前建议照惯例备份一下 acs.db。
  • 行为变化:设备被判离线会比以前快(按周期算);-offline-probe false 可以退回旧行为。

下载

平台 安装包
Linux x86_64 acs-1.1.0-linux-amd64.tar.gz
Linux ARM64 acs-1.1.0-linux-arm64.tar.gz

升级

tar xzf acs-1.1.0-linux-amd64.tar.gz && cd acs-1.1.0-linux-amd64
sudo ./install.sh     # 原地升级,保留数据库与 /etc/default/acs
# 或者
sudo ./update.sh      # 从 GitHub 拉最新版(校验 SHA256、备份、失败自动回滚)

验收

  • go test ./... 全过(离线判定 18 个边界用例、探测状态存取、Web)
  • scripts/verify-s1.sh 309 / 0:新增离线判定两个真跑场景(杀掉模拟器 → 恰好探测 3 次后判离线;
    设备只停周期上报但仍能被唤醒 → 有探测记录但从不判离线),以及界面三态 / 筛选 / 禁用按钮的断言
  • scripts/verify-interop.sh 8 / 0(与 GenieACS 官方 JS 模拟器互通)
  • 真机现场验证过:断电判定、探测成功保持在线、真库迁移(3 台设备数据无损)

v1.0.1 —— 修掉发布包里的升级脚本

Choose a tag to compare

@hakureiyuyuko hakureiyuyuko released this 28 Sep 12:40

v1.0.1 —— 修掉发布包里的升级脚本

程序本身没有改动(二进制与 v1.0.0 完全一致),只修 update.sh 与两处脚本健壮性问题:

  • update.sh 找错下载地址:它去 GitHub 的 API JSON 里抠 browser_download_url 时正则贪婪,
    会跨过资产对象匹配到最后一个资产的地址 —— 于是「下载 tar.gz」实际下到的是 190 字节的
    SHA256SUMS。SHA256 校验闸拦住了它(哈希对不上直接拒装,不会装上坏东西),但升级完全走不通。
    现在改成按 release 资产的固定 URL 形状直接拼地址,API 只用来问「最新 tag 是哪个」。
  • 配置文件不存在时,读端口的 grep 返回码 2 会在 set -e / pipefail 下中断整个脚本;
    这类取值函数统一容错。
  • 解包加 --no-same-owner(容器 / 用户命名空间里 tar 还原属主会失败)。
  • 回滚时连 VERSION 一起回退:否则数据目录记着新版本、跑的却是旧二进制。

打包与部署脚本的设计取舍、以及这些坑是怎么被抓到的,记在
docs/notes/deploy.md。

下载

平台 安装包
Linux x86_64 acs-1.0.1-linux-amd64.tar.gz
Linux ARM64 acs-1.0.1-linux-arm64.tar.gz

升级到这一版

已经装了 v1.0.0 的机器(update.sh 在那一版走不通):下载 v1.0.1 的包,解压后用里面的脚本:

tar xzf acs-1.0.1-linux-amd64.tar.gz && cd acs-1.0.1-linux-amd64
sudo ./install.sh            # 原地升级,保留数据库与 /etc/default/acs
# 或者
sudo ./update.sh             # 从 GitHub 拉(这一版的下载逻辑已经修好)

验收

  • go test ./... 全过;scripts/verify-s1.sh 293 / 0;scripts/verify-interop.sh 8 / 0
  • 安装 / 升级 / 卸载三条路径都在本机真跑过(含假 root 下的完整 systemd 分支、
    「起不来自动回滚」、以及从真 GitHub release 下载并升级)

v1.0.0 —— 轻量 TR-069 ACS 首个发布

Choose a tag to compare

@hakureiyuyuko hakureiyuyuko released this 28 Sep 12:35

v1.0.0 —— 轻量 TR-069 ACS 首个发布

单二进制、零外部中间件的 TR-069/CWMP ACS,用来管一批光猫 / FTTR 主机:
纳管 → 看信息 → 改配置 → 诊断 → 子设备与终端管理。

下载

平台 安装包
Linux x86_64 acs-1.0.0-linux-amd64.tar.gz
Linux ARM64 acs-1.0.0-linux-arm64.tar.gz

校验和在同日的 SHA256SUMS 里;update.sh 会自动校验。

安装

tar xzf acs-1.0.0-linux-amd64.tar.gz
cd acs-1.0.0-linux-amd64
sudo ./install.sh

装完打印面板地址与要填进光猫的 ACS URL。想把面板挪到独立端口、顺便设面板账号密码:

sudo ./install.sh --web-listen :8080 --web-user admin --web-pass '改成你自己的'

默认落点在包内 README.md 里列全了(主程序 /usr/local/bin/acs、数据 /var/lib/acs、
配置 /etc/default/acs、systemd 服务 acs)。

升级与卸载

sudo ./update.sh          # 从 GitHub 拉新版:校验 SHA256 → 停服务 → 备份 → 换新 → 健康检查,起不来自动回滚
sudo ./update.sh --check  # 只看有没有新版本
sudo ./uninstall.sh       # 拆服务与程序,保留数据;--purge 连数据一起删

这个版本有什么

  • 协议:Inform / GetParameterValues / GetParameterNames / SetParameterValues / GetRPCMethods /
    Reboot / IPPingDiagnostics / Connection Request(含 HTTP Digest),任务队列持久化
  • 面板:设备概览与搜索、设备详情(基本信息、WAN 连接、无线概况、参数、任务与上报记录)、
    FTTR 子设备与关联终端(按主机/子机分组、信号强度)、设置页(ACS 与面板双监听、面板账号密码)
  • 运维:一键唤醒、重启设备、删除设备、备注、任务与上报记录保留上限
  • 部署:单文件静态二进制 + 一个 SQLite 文件,没有 Redis / MySQL / 消息队列

验收

  • go test ./... 全过(协议解析 / 存储 / Web)
  • scripts/verify-s1.sh 293 / 0:编译真实二进制、起真实 HTTP + SQLite,用真实 SOAP 报文端到端断言
  • scripts/verify-interop.sh 8 / 0:与 GenieACS 官方 JS 模拟器互通

说明

  • 许可证 AGPL-3.0:可自由使用、修改、分发(含商用);把修改后的版本作为网络服务提供给别人用时,
    需要以同样许可开放对应源码。
  • 仓库里的真机样本与文档均已脱敏(序列号、MAC、SSID、内网地址、终端名换成示例值);
    截图数据来自仓库自带的 CPE 模拟器,不含任何真实设备信息。