liufumingren
|
031778c0e3
|
fix(camera): 认证被拒后按 host 静默 5 秒,避免重连风暴把设备限流越打越死
现场:9.101 对整队相机都报 `SOAP Fault: Authority failure`,而**同一刻从开发机(换来源 IP)
裸 ONVIF 探针全通**,说明不是凭据问题——是设备侧对来源的会话/频率限制。
我们每条指令会做 2 次端口连接 × 最多 3 次重试,高频下发时等于持续重连,
只会把限流窗口越拉越长。
改动:
- 新增 `_connBackoff`:host 收到 `Authority failure` 后静默 5 秒,这期间不再尝试建立连接,
直接快速失败并给出明确提示("已暂停重连 Xs(疑似设备限流)")
- 连接失败的报错信息里带上剩余静默时间,便于排查
- 保留原有的偶发错误重试(Parse Error / 网络类仍会断开重连)
另外本轮同时验证/修复的主问题:
**TP-Link 固件 bug——ContinuousMove 的 PanTilt 里 x=0 且 y≠0(纯抬头/低头)会返回畸形响应**
(Parse Error),表现为"上下没反应、左右正常"。修复方式:纯俯仰时发 ±0.001 的 x
(按 host 交替正负,pan 漂移 ~0.0006/次)。实测 9.226 从 0/6 全失败变为 6/6 全成功。
离线回归 46 断言全通过。
|
2026-09-16 17:47:34 +08:00 |
|
liufumingren
|
1a27402749
|
fix(camera): 修掉 TP-Link 纯俯仰失效(x=0 触发固件 bug)——"上下没反应"的真因
现象:192.168.8.85 / 192.168.9.226 上"上下操作没反应,左右正常"。
定位过程:
- 协议层看是成功的(返回 200/无异常)——不对,重新看日志发现失败全集中在 up/down:
cameraPtz.log 里 69 次 `Parse Error: Expected HTTP/, RTSP/ or ICE/` 全部发生在
control(up)/control(down),left/right/斜向 0 次(8.85 家族 22 次、9.226 18 次)。
- 用裸 ONVIF 做对照实验(9.226,各 6 次):
x=0, y=-0.4 → 成功 0/6 (Parse Error)
x=0.02,y=-0.4 → 成功 6/6
再测 x=0 → 成功 0/6
relativeMove 用 x=0 同样 0/4 失败,x=0.001 则 4/4 成功。
- 也就是说这是 **TP-Link 固件 bug:ContinuousMove 的 PanTilt 里 x=0 且 y≠0 时返回畸形响应**。
左右/斜向都带 x≠0,所以从不触发;纯抬头/低头必然 x=0,于是"上下没反应"。
不同机器严重程度不同(9.226 100% 复现、8.85 大量、8.82/8.86 基本正常)。
修复:纯俯仰时把 x 从 0 换成 ±0.001(按 host 交替正负,避免 pan 单向累积)。
实测 pan 漂移约 0.0006/次,可忽略;9.226 修复后 up/down 8/8 全成功(修复前 0/6)。
同时提交上一轮未入库的两处(已部署但没提交):
- `_parseTarget` 有 camera 块时优先用 camera.port(顶层 port 属于录像机)
- `_onvifSession` 的端口候选改为 [payload port, 2020, 80](payload 给 2020 时也要能回退 80)
离线回归 46 断言全通过。
|
2026-09-16 17:46:09 +08:00 |
|
liufumingren
|
fd2b1caf8b
|
fix(camera): ONVIF 连接阶段的失败也纳入重试(并把根因带进错误信息)
排查"往下不行"时发现:设备被高频点时会对 ONVIF 认证瞬时拒绝
(`SOAP Fault: Authority failure`,实测 8.85/8.86 都会偶发,几十秒后自恢复),
但这类失败发生在【连接阶段】,而原实现是 `if (!sess) return {ok:false,...}`——
不抛异常,重试包装根本拦不到,于是直接判失败。
改动:
- _onvifSession 记录每个 host 最近一次连接失败原因(超时/异常/取不到 profileToken)
- 连接失败改为 throw,并把根因拼进错误信息(否则重试逻辑按文案匹配不到"偶发")
- `Authority failure` 纳入偶发错误集合(配合 300ms/800ms 递增退避,
给设备留出从限流中恢复的时间,比快速重试更有效)
- 退避从 150/300ms 调整为 300/800ms
验证:错密码场景耗时 1242ms(3 次尝试后失败,错误信息含 Authority failure);
正确密码 138ms 成功;离线回归 46 断言全通过。
注意副作用:凭据真的错时也会多花约 1.1s 重试才报错——这是刻意取舍,
因为高频下把"限流"误判成"密码错"会让云台整个命令失效。
|
2026-09-16 17:37:26 +08:00 |
|
liufumingren
|
d302c16f13
|
fix(camera): 每台设备的云台操作串行执行(保障 control→stop 顺序)
背景:平台把 control/stop 挨得很近下发,而 core/wsClient.js 是并发处理 WS 消息的,
两个 SOAP 请求会同时打到同一台相机。风险不对称:
- 并发下若 stop 先于 control 执行完,云台会一直转(ONVIF 靠 30s 兜底超时才停,
ISAPI 路径没有兜底);
- 同一设备上重复建 ONVIF 会话/并发连接也没有必要。
现在同一 host 的操作排成一条链,串行执行,顺序与下发顺序一致。
诚实说明:8.85 那 16 次 `Parse Error` / `Authority failure` 不是这条改动能解释的——
本地用 0 间隔背靠背(甚至 Promise.all 并发)压 8.85 共 40 次请求,A/B 都是 0 失败,
复现不出来,判断是设备侧瞬时故障(那台相机同时在推流+被平台高频点)。
这条改动是顺序保障/防御,不宣称修掉了那 16 次。
另外:本次排查中我自己的测试脚本踩过一个坑并已修正——密码含 @ 时 rtspUrl 必须写成
`admin:qwe2024@@host`(或 %40),写成单个 @ 解析出来的密码是 `qwe2024`(错的),
会得到误导性的 Authority failure。
离线回归 46 断言全通过。
|
2026-09-16 17:35:27 +08:00 |
|
liufumingren
|
efeed362a4
|
fix(camera): 云台改为直连摄像机(NVR 报文里 data.ip 是录像机,不是摄像机)
线上整夜实测 215 条指令、13 台设备,暴露两个问题:
1) 带录像机的报文全打错设备(77 次 401)
平台对"挂在录像机上的摄像机"下发的形状是:
data.ip / username / password = 录像机;camera.ip = 摄像机;server.* = 录像机详情
(实测例:camera.ip=192.168.8.86,而 data.ip=192.168.8.241、password=ky666888)
原来把 data.ip 当摄像机地址,又用 rtspUrl 里的摄像机密码去连录像机 → 401 HTML。
现在 _parseTarget 的目标是【摄像机】(camera.ip → rtspUrl 的 host → data.ip 兜底),
凭据取 rtspUrl;录像机(server 块)只作兜底:摄像机失败才改试,且优先走 ContentMgmt 代理路径。
为什么录像机只能是兜底:实测 8.241(DS-7932N-R4) 的 /ISAPI/ContentMgmt/PTZCtrlProxy/channels
里 16 个 IP 通道全部 enabled=false、controlProtocol 为空(录像机没配云台),
/ISAPI/PTZCtrl/channels 还一直 503 Device Busy —— 走录像机根本驱动不了云台。
2) ONVIF 偶发错误重试不足
"Wrong ONVIF SOAP response" 没被识别为偶发错误(水星 MIPC332 那台会回这个),且只重试 1 次。
现在纳入偶发集合(Parse Error / Wrong ONVIF SOAP response / 连接重置类),
改为首次 + 最多 2 次重试、间隔递增;SOAP Fault(设备明确的拒绝)仍不重试。
顺带把 4 个动作的执行路径统一到 _runChain/_execOnce(原先每个函数各写一遍协议分支),
去掉明显重复。
真机验证(平台原报文形状):目标主机由 192.168.8.241 变为 192.168.8.86,ONVIF 认证通过,
左转 0.8 秒 Δx=-0.0867。离线回归 46 断言全通过(新增"摄像机优先 / 录像机兜底"4 条)。
|
2026-09-16 17:07:56 +08:00 |
|
liufumingren
|
22013959a4
|
fix(camera): ONVIF 偶发传输错误重连重试一次(避免丢掉 stop 导致云台一直转)
线上复验(修复凭据后)统计:ONVIF 连接失败 0、Authority failure 0,运动成功 4 + 停止成功 5。
但出现过 1 次 "Parse Error: Expected HTTP/, RTSP/ or ICE/"——设备在 control/stop 连得很快时
偶发返回非 HTTP 响应(TP-Link 侧问题),原实现直接判失败。
风险不对称:丢一次"动作"无所谓,丢一次 stop 就是云台一直转(虽然有 30s 兜底超时)。
新增 _withOnvifRetry:识别 Parse Error / ECONNRESET / socket hang up / EPIPE / timeout /
ECONNREFUSED 这类偶发传输错误 → 断开该设备的 ONVIF 会话 → 重建后重试一次。
control / stop / presetGoto / presetSet 全部走这个包装;这些操作本身幂等(stop 幂等、
同速度运动幂等、预置点幂等),重试安全。非传输类错误(如设备明确拒绝)不重试,直接上报。
离线回归 42 断言仍全通过;真机回归(8.165)仍正确返回"没有云台机构"。
|
2026-09-15 22:15:29 +08:00 |
|
liufumingren
|
0d0b0b8db2
|
fix(camera): 云台凭据以 rtspUrl 为准 + ISAPI 通道号以设备自报为准
线上实测(69 条指令、5 台相机)暴露两个问题:
1) ONVIF 全部报 "SOAP Fault: Authority failure"
平台下发的 username/password 字段不可靠:密码含 @ 时它把 @ 切给了 ip 字段
(下发 ip="@192.168.11.247" + password="qwe2024",而 rtspUrl 里是 admin:qwe2024@…)。
原来 _parseTarget 让显式字段优先,于是拿着错密码去连 → 认证失败(4 台全挂)。
改为凭据以 rtspUrl 解析结果为准,显式字段只在 rtspUrl 缺项时兜底
(ip / channel / port 仍以上层下发为准)。
2) 海康 IPC 直连时通道号错了 → 403
平台从 rtspUrl 的 /streamN 推出来的 channel 是它自己的相机编号。实测 192.168.8.165
(海康 DS-2XD8F826E 双目 IPC)只有 PTZ 通道 1,发通道 6 直接 403。
新增:枚举 GET /ISAPI/PTZCtrl/channels,以设备自报通道为准(下发编号在列表里就用它,
否则用第一个);枚举不到(如 NVR 不支持该接口)则沿用原推导逻辑;结果按 host 缓存。
3) 顺带:无云台机构的摄像机给出明确原因
同一台 8.165 的 panSupport/tiltSupport/zoomSupport 全是 false(没有云台机构),
发通道 1 设备会回 200 但什么也不动(属假成功)。现在直接返回
"该摄像机没有云台机构,已跳过发送",避免日志里出现误导性的成功。
另:上一版试验过的"ISAPI 二次确认"(要求 deviceInfo 返回 <DeviceInfo>)已撤除——
实测未发现 ISAPI 误判(8.165 本就是真海康),而它会把权限受限/返回体不含 DeviceInfo
的真海康设备误判成 ONVIF。
真机复验:11.247 用平台那条"错密码"报文 → ONVIF 认证通过并成功转向(凭据修复生效);
8.165 → 明确报无云台机构,不再 403。离线回归 42 断言全通过(新增通道回退 / 无云台 4 条)。
|
2026-09-15 22:13:58 +08:00 |
|
liufumingren
|
8fa511dfa1
|
feat(camera): 云台支持 ONVIF,兼容非海康设备(实测 TP-Link 可动)
背景:平台下发的 camera.ptz.* 目标实测是 TP-Link TL-IPC682P-A4(192.168.9.226 /
192.168.11.247),设备没有 ISAPI(/ISAPI/System/deviceInfo 404,PUT 返回 405 +
{"error_code":-10000} 的 JSON),纯 ISAPI 实现必然全失败(线上 20 条指令 0 成功)。
- 协议选路:先探海康 ISAPI(_isapiProbe),不通则走 ONVIF;结果按 host 缓存,
不会每条指令都多一次探测往返
- ONVIF 实现:continuousMove(方向用 onlySendPanTilt、变倍用 onlySendZoom,
速度档 1~7 → 0.15~1)/ stop / gotoPreset / setPreset;
聚焦、光圈、autoPan 在 ONVIF 下无对应接口,明确返回不支持(而不是静默失败)
- 新增 ONVIF_MOVE_TIMEOUT_MS=30s 兜底:ONVIF 的 ContinuousMove 不带 Timeout 时
设备会一直转,服务端漏发 stop 就停不下来;设 0 可关闭以与 ISAPI 行为完全一致
- 预置点:契约里的 presetId 先按 token 匹配、再按 Preset{id} / preset_{id} 名字匹配;
setPreset 优先指定 token,设备不接受时让它自行分配并把实际 token 写进日志
- 平台下发的 ip 字段实测是 "@192.168.11.247"(多一个前导 @),新增 _cleanHost
统一清洗,并兼容误传完整 rtsp:// 的情况
- utils/cameraOsd.js 导出 _isapiProbe 并支持自定义 port(默认 80,原调用行为不变)
真机实测(192.168.11.247,与生产同一台):协议探测 → ONVIF,会话 profileToken=profile_1,
left 1 秒后位置 x 由 0.6766 → 0.5717(Δx=0.1049,方向正确),设备预置点 token 1~8。
离线回归 38 断言仍全通过。
|
2026-09-15 22:03:22 +08:00 |
|
liufumingren
|
13872b0514
|
feat(camera): 云台优先使用服务端下发的 ip/账号密码/通道
- cameraPtz#_parseTarget(rtspUrl, opts) 改为优先使用 opts 的 ip/username/password/channel/port
(rtspUrl 仅作兜底,解析失败不再报错)
- services/camera.js 把 data.ip / data.username / data.password 透传给 cameraPtz
|
2026-09-15 21:57:50 +08:00 |
|
liufumingren
|
5258a84bee
|
fix(camera): 云台/OSD 日志目录改用 getAppDataDir(),修复 Linux 下落到字面量目录
cameraPtz.js/cameraOsd.js 自己用 process.env.ProgramData || SystemDrive/ProgramData 拼日志目录,非 Windows 上两者都为空 → path.join('C:','ProgramData') 变成相对路径,在 9.101 上实际写到 /opt/printserver/C:/ProgramData/printServer/*.log(cameraOsd 自 7/30 起如此)。
改用项目既有约定 utils/runtime.js#getAppDataDir()(frpc.js 同款):Windows 打包版仍为 %ProgramData%\\printServer(与文档一致),Linux/开发态为项目根目录,与 frpc.log/run.log 同级。
|
2026-09-15 19:05:57 +08:00 |
|
liufumingren
|
68d84351a5
|
feat(camera): 云台 PTZ WS 下发(ISAPI),修复预置点路径缓存串号与 port 透传
服务端(services.printer 中转)下发 camera.ptz.control/stop/presetGoto/presetSet/auto,客户端走海康 ISAPI 执行,路径与报文对齐官方无插件 SDK(webVideoCtrl.js)。
- utils/cameraPtz.js 新增:动作表/别名/SDK 索引、速度换算(<7 档 ×15,≥7 档 100,停止=0)、候选路径回退与缓存、Digest/Basic 自适应、独立 cameraPtz.log
- services/camera.js 新增 ptz 服务;这些方法一律不返回值,避免 wsClient 回显被服务端当成一次服务调用(服务路径 camera 不存在)
- utils/cameraOsd.js 导出 extractRTSPInfo/_isapiAuth/_isapiRequest 并给后两者加可选 port(默认 80,行为不变)
- 修复:路径缓存原来存整条 URI,预置点 URI 带 presetId,goto(3) 之后 goto(5) 会先命中 presets/3 调错预置点 → 改为缓存候选序号,presetGoto/presetSet 分键
- 修复:presetGoto/presetSet/auto 漏传 opts.port,非 80 端口设备这三个动作永远失败
- 修复:日志 _writeLog 只 join 参数,%s 占位符被原样写入日志 → 改用 util.format(cameraOsd/cameraPtz)
|
2026-09-15 19:03:12 +08:00 |
|