交付与部署
大坔部署在客户自己的服务器上,设备台账、告警、工单与审计数据不出内网。下面给出三种落地路径、前置条件与上线检查项。
三种方式,按现场条件选一种
不要同时启动两份运维服务:它们会争用端口与状态文件。容器与裸机二选一,再加一层 HTTPS 网关。
容器(推荐)
Docker / Compose镜像基于 Alpine、非 root 运行、cap_drop: ALL、只读根文件系统,仅数据卷可写。三个角色口令使用必填变量,缺失时 compose 直接报错退出,不回落演示口令。
docker compose -f docker-compose.ops.yml up -d --build
裸机 + systemd
独立用户安装到独立目录,使用专用系统用户与 ProtectSystem=strict;首次安装生成随机口令写入 600 权限文件,重复执行即升级并保留 env 与数据。
sudo bash scripts/install.sh --systemd --port 8090
HTTPS 网关
NginxTLS 1.2/1.3、HSTS、CSP、登录接口 10 次/分钟限流、API 30 次/秒、健康检查免限流、令牌显式透传、源码与数据路径 404 兜底。
nginx -t && systemctl reload nginx
OPS_API_BASE 与跨域白名单对接。
服务器与网络准备
软件
Linux 服务器;Docker Engine + Compose v2(容器方式)或 Node.js ≥ 18(裸机方式);Nginx(网关)。若同机编译上游 wvp,还需要 JDK 17 + Maven 3。
网络与端口
运维服务默认 8090;上游 wvp HTTP 18978;SIP 信令 8116 tcp/udp;收流端口与 RTP 端口段按现场配置放通。公网只暴露 80/443,应用端口只绑回环或内网。
设备侧
摄像头 / NVR 需支持 GB28181-2016,并填写 SIP 服务器 ID、域、地址与端口、注册密码。外网设备接入时,SIP 与收流地址必须是设备可达的公网 IP。
域名与证书
为管理端准备域名与证书;启用 HTTPS 后把 OPS_ALLOWED_ORIGINS 收敛到真实前端域名,确认应用端口未直接暴露公网。
随产品一起交付的内容
| 交付物 | 内容 | 验证方式 |
|---|---|---|
| 发布包 | tar.gz + SHA256SUMS + 包内 MANIFEST;自动排除运行态数据、卷目录与 .env | sha256sum -c SHA256SUMS |
| 容器镜像 | 非 root、只读根、cap_drop ALL、健康检查、仅数据卷可写 | docker compose ps / healthcheck |
| 安装脚本 | 幂等安装、随机口令、systemd 单元、独立用户 | systemctl status dadi-ops |
| 备份脚本 | gzip + SHA256 + 保留 N 份轮转;源文件损坏时仍备份并以退出码告警 | scripts/backup.sh |
| 探活脚本 | 纯 Node fetch,退出码 0/1,可接 systemd、Docker 或监控系统 | scripts/healthcheck.sh --json |
| 网关模板 | TLS、HSTS、CSP、限流、令牌透传、源码路径兜底 | nginx -t |
| 合规自查 | 许可证清单、等保差距、个人信息处理要求、上线检查清单 | 随交付文档提供 |
正式启用前,这些项必须打勾
以下为最低限度清单。完整版包含许可证归档、个人信息告知与应急预案,随交付文档提供。
身份与权限
已用安装脚本或 compose 部署,未使用演示口令;三个角色已按人建号并登记台账(或接入 SSO);鉴权保持开启;复核查看器不可写、不可看审计、不可导出。
网络与传输
HTTPS 已启用且 HTTP 全量跳转;TLS 仅 1.2/1.3;HSTS、CSP、X-Content-Type-Options 生效;跨域白名单只含真实域名;应用端口未直接暴露公网;容器非 root 且丢弃全部 capability。
审计与数据
审计链校验返回通过;当日链头已锚定到独立只读存储;审计留存满足 6 个月;业务数据磁盘或卷已加密;备份已配定时任务且成功告警;完成一次异地恢复演练。
合规与交付
已归档上游许可证原文;已核验 ZLMediaKit 标识未被去除;界面与文档声明「基于 wvp-GB28181-pro(MIT)二次开发」;自有代码许可方式已确定;视频区域已张贴告知牌。
underscores_in_headers on 才能透传上游的 access-token;设备注册不上通常是 SIP / 收流地址仍为 127.0.0.1;流媒体 hook 401 是密钥与配置文件不一致;登录 401 多因口令未转换为 32 位 MD5。联调时先用探活与逐项诊断脚本,不要直接点播。