Architecture & Compliance
架构与合规
这一页写给技术评估、采购与安全审查。我们把能力归属、组件许可证、已实现与未实现的安全项逐条列出,方便你判断它是否适合你的现场。
01 / 分层
四层架构,能力归属逐层写清
避免把「接入」当成「自研」。业务层是客户真正买到的运维能力,接入层是成熟开源基座,底座与可选项按需启用。
业务与运维层大坔自研
驾驶舱 / 报表聚合告警降噪 / 关联洞察工单状态机
巡检视频质检(规则)资产台账
AI 规则与修复向导值班 / 通知RBAC / 会话
审计哈希链
接入与流媒体层上游开源
wvp-GB28181-proZLMediaKit
GB28181-2016 信令RTP / RTSP / RTMP 收流
设备注册 / 心跳 / 订阅 / 点播
运行与交付层基础依赖
Node.js ≥ 18(node:http)Nginx(HTTPS 网关)
Docker / Compose 或 systemdJSON 原子持久化
可选外部能力默认关闭
腾讯位置服务 GL JS(自备 key)LLM 网关(脱敏文本)
ONVIF 接入(非开源,需授权)
| 层 | 是否自研 | 依据 | 对外可用表述 |
|---|---|---|---|
| 运维业务层 server/ · assets/ · tests/ |
100% 自研 | 工单 / 巡检 / 质检 / 资产 / 报表 / AI 规则 / 审计 / RBAC 均为本仓代码,零 npm 运行时依赖,附单元与端到端测试。 | 「核心运维业务 100% 自研」 |
| 视频接入层 wvp + ZLMediaKit |
上游 | GB28181 信令、设备注册与流媒体转发由上游提供;本仓通过 REST 适配层对接,未改上游标识。 | 「基于 wvp-GB28181-pro(MIT)二次开发」 |
| 运行底座 Node.js · Nginx · Docker |
依赖 | 运行期依赖,随镜像或系统安装,不属产品自研代码。 | 「私有化部署,无 npm 运行时依赖」 |
| AI 能力 assets/ai.js · server/ai-service.js |
自研(规则) | 聚类、建议、风险、问答、复核均为本地规则;大模型仅可选润色,默认关闭。 | 「本地规则 AI,默认零外发」 |
| 地图底图 腾讯位置服务 |
第三方 | 可选卫星底图;平面示意图模式零网络依赖,不加载任何第三方脚本。 | 「示意图离线可用,卫星图为可选增强」 |
02 / 许可证
组件清单与逐项义务
每个第三方组件至少给出三件证据:包名与版本、许可证与原文出处、运行位置。当前仓库尚未内置上游许可证原文,这是上线前必须补齐的 G-01 项。
| 组件 | 版本 / 来源 | 许可证 | 运行位置 | 本项目义务 |
|---|---|---|---|---|
| wvp-GB28181-pro | master github.com/648540858/wvp-GB28181-pro |
MIT © 2020 swwhaha |
独立服务容器;本仓经 REST 适配层访问 | 保留 LICENSE 与版权声明;分发衍生作品随附 MIT 全文;标注「基于 wvp 二次开发」 |
| ZLMediaKit | 官方镜像 / master github.com/ZLMediaKit/ZLMediaKit |
MIT + 补充协议 | 随 wvp 部署的流媒体服务,负责收流与转发 | 不得去除 title / Server / User-Agent 中的 “ZLMediaKit” 标识,否则权利人保留起诉权利 |
| Node.js | ≥ 18 package.json engines |
MIT | 运维服务进程(node:http,零 npm 依赖) | 随镜像或安装包分发时附许可文本 |
| Nginx | 1.24+(本站网关 1.30.6) | BSD-2-Clause | 反向代理 / TLS 终止 / 限流 | 保留版权声明;不随产品包分发 |
| 腾讯位置服务 GL JS | 可选,自备 key | 以腾讯位置服务条款为准 | 仅浏览器卫星地图模式按需加载 | 配置 Referer 白名单;key 不入仓、不下发前端;无网自动回退 |
| ONVIF 接入 | 非开源内容 | 需单独授权 | 当前不随产品提供 | 如需要,单独采购授权或改用国标接入 |
| 大坔自研代码 | v0.1.0 | UNLICENSED(待定 EULA) | 业务服务与前端 | 对外发布前确定商业许可协议(G-10) |
版本固定与镜像扫描尚未完成(G-06)。上游按 master 或官方镜像部署,未按 digest 固定,也没有 CI 镜像扫描与依赖巡检流程。生产交付前应补上这两项,并把上游 LICENSE 原文归档到交付包的
licenses/ 目录(G-01)。
03 / 安全
已实现的安全能力
以下能力在代码中已实现并有测试覆盖;是否在现场生效,取决于部署时是否按要求配置。
| 控制点 | 实现 | 证据 / 落点 | 状态 |
|---|---|---|---|
| 身份鉴别 | 账号口令、scrypt + 随机 salt 哈希、失败锁定、会话 TTL | server/auth.js | 已实现 |
| 访问控制 | 三级角色,方法 + 路径 → 权限矩阵,服务端强制校验 | server/auth.js · requiredPermission() | 已实现 |
| 传输保密 | TLS 1.2/1.3、HSTS、CSP、HTTP 跳转 | deploy/nginx.ops.conf.example | 模板具备,需现场启用 |
| 入口收敛 | 静态白名单、拒绝路径穿越、请求体 64KB、CORS 白名单 | server/ops-server.js | 已实现 |
| 暴力破解 | 账号锁定 + 登录接口 10 次/分钟限流 | server/auth.js · nginx 模板 | 已实现 |
| 审计完整性 | SHA-256 链式校验、断点定位、外部锚定参数 | server/store.js · verifyAudit() | 部分:独立存储与链头外锚待落地 |
| 容器加固 | 非 root、cap_drop ALL、no-new-privileges、只读根、健康检查 | deploy/Dockerfile | 已实现 |
| 备份与探活 | gzip + SHA256 + 轮转;退出码 0/1 可接监控 | scripts/backup.sh · healthcheck.sh | 已实现 |
| 存储加密 | 业务数据为明文 JSON;口令仅存哈希 | server/data/state.json | 未实现(G-07) |
| 异地备份 / 恢复演练 | 仅本地目录,无 restore 脚本 | scripts/backup.sh | 未实现(G-08/G-09) |
04 / 边界
交付边界与等保差距
当前版本是原型与试点交付。等保三级结论须由测评机构出具,以下是工程自查的差距项,我们不在官网上模糊处理。
| 编号 | 事项 | 状态 | 上线前要求 |
|---|---|---|---|
| G-01 | 交付包 / 镜像内置 licenses 与 NOTICE | 待补 | 归档 wvp、ZLMediaKit、Node.js、Alpine 许可证原文 |
| G-02 | 按人建号或接入 SSO / LDAP | 待补 | 替换共享角色号,登记账号台账 |
| G-03 | 口令复杂度与定期更换 | 待补 | 强制长度 / 复杂度,90 天更换策略 |
| G-04 | 审计独立存储 + 每日链头外锚 | 哈希链已实现 | 链头写入独立只读存储 / WORM |
| G-05 | 审计留存 ≥ 6 个月 | 待补 | 调大保留上限或外送日志平台 |
| G-06 | 镜像按 digest 固定与扫描 | 待补 | CI 镜像扫描、基础镜像固定 digest |
| G-07 | 业务数据存储加密 | 待补 | 磁盘 / 卷加密或字段级加密 |
| G-08 | 备份异地保存 | 待补 | 对接对象存储或异机备份 |
| G-09 | 恢复脚本与季度演练 | 待补 | 提供 restore 脚本并留存演练记录 |
| G-10 | 自有代码商业许可(EULA) | 待定 | 法务确定许可方式并随包交付 |
| G-11 | 产品界面展示上游声明 | 部分 | 「关于 / 系统设置」同步声明 |
| G-12 | 数据行级 / 区域级权限 | 待补 | 细到区域与设备分组的授权 |
| G-13 | 日志接 SIEM / 集中监控 | 待补 | 接入集中日志与告警通道 |
| G-14 | 自由文本个人信息填写规范 | 待补 | 发布填写规范,避免告警描述写入个人信息 |
我们不这么宣称:「整套系统 100% 自研」「已通过等保三级」「已大规模商用」「AI 自动处置」「识别画面中的人脸车牌」。这些表述与当前代码和交付状态不符。视频画面中的人脸、车牌与行踪属于敏感个人信息,本系统不存储视频流、不做人脸识别;如后续接入抓拍能力,须先完成单独同意、留存期限、访问审计与影响评估。
AI 数据边界:默认零外部请求。显式开启大模型后,只发送脱敏后的问题、本地结论与事实卡(设备名替换为「点位#N」),不发送 IP、国标编号、资产编号、人员姓名、工单正文、图像与视频帧;模型返回的数字必须来自本地事实,否则回退本地结论。开启前须完成委托处理评估与协议,明确不将数据用于模型训练。