GBHub 国标视频平台 — 定时截图与定时录像功能解决方案 文档信息项目内容文档版本v1.0更新日期2026 年 8 月适用产品GBHub 国标视频平台 (v0.8.0)文档类型产品功能解决方案目标读者系统集成商、企业 IT 管理员、安防负责人、运维工程师一、功能概述在视频监控管理中定时截图与定时录像是最常用、最刚需的自动化运维能力。无论是为了降低存储成本、提升巡检效率还是为了满足合规留存要求自动化任务都是不可或缺的工具。GBHub 国标视频平台内置了完整的定时任务调度引擎支持对国标设备通道和拉流代理两种目标类型灵活配置定时截图和定时录像两种自动化任务。核心价值价值点说明 全自动化无需人工干预按 Cron 表达式精准执行 灵活调度支持每秒/每分钟/每小时/每天/每周/每月任意时间点 双目标支持支持国标设备通道 拉流代理 移动端查看截图和录像结果可在移动端直接查看 任务回调完成后自动推送结果到指定 URL 降本增效大幅降低人工巡检成本提升管理效率二、核心功能详解2.1 定时截图自动抓拍指定通道的当前画面保存为 JPG 图片用于日常巡检、证据留存、对比分析等场景。功能特点特点说明支持目标类型国标设备通道NVR/摄像头 拉流代理RTSP/RTMP 源截图精度从 ZLMediaKit 拉取原始帧保证截图清晰度存储方式本地存储默认static/snapshots/可选 S3 云存储历史查看按日期目录存储支持通过 API 查询历史截图移动端查看截图结果在移动端 App 自动展示批量操作支持设备通配符*一次性对所有通道截图截图质量示例参数说明格式JPEG分辨率与原始视频流一致文件大小约 50-200 KB视分辨率而定存储路径static/snapshots/{app}/{stream}/{YYYYMMDD}/{HHMMSS}.jpg2.2 定时录像自动录制指定通道的实时视频流保存为 MP4 文件用于完整记录、事件回放、合规审计等场景。功能特点特点说明支持目标类型国标设备通道NVR/摄像头 拉流代理RTSP/RTMP 源录制格式MP4H.264/H.265 编码录制时长可自定义支持任意秒数典型值 60s/300s/600s存储位置ZLMediaKit 录制目录自动记录到数据库播放方式支持 Web 端直接播放、移动端播放、下载自动清理配合定时清理任务自动删除过期录像录制参数配置参数说明示例duration_secs录制时长秒必填60concurrency并发截图/录像数5默认auto_stop_live截图完成后是否停止拉流true/falsecallback_url完成后回调通知地址https://example.com/callbacknode_id指定 ZLM 节点留空则自动轮询2.3 任务管理通过统一的任务管理界面或 API轻松管理所有定时任务。管理功能功能说明创建任务选择目标类型设备/代理、动作截图/录像、Cron 表达式、录制时长等任务列表查看所有任务支持分页、搜索查看详情查看单个任务的完整配置启用/禁用无需删除一键启停任务更新任务修改 Cron 表达式、录制时长、并发数等删除任务永久移除任务执行记录任务执行完成后可通过回调获取执行结果Cron 表达式示例需求Cron 表达式说明每天 8:000 8 * * *每天早上 8 点执行每小时0 * * * *每小时整点执行每 30 分钟*/30 * * * *每 30 分钟执行一次每周一 9:000 9 * * 1每周一上午 9 点执行每月 1 日 0:000 0 1 * *每月 1 日凌晨执行三、典型应用场景3.1 日常巡检需求安保人员每天定时检查重点区域画面确认设备正常运行。方案设置定时截图任务每天 8:00、12:00、18:00 自动抓拍重点通道画面。收益无需人工逐个查看5 分钟完成全厂区巡检问题早发现早处理。3.2 证据留存需求对关键出入口、财务室等敏感区域定期留存画面用于审计追溯。方案设置定时截图任务每小时自动截图一次永久保留。收益满足合规审计要求发生异常时可直接追溯历史画面。3.3 值班交接需求每个班次交接时需要记录当前所有重点区域状态。方案设置定时截图任务每班次交接时刻8:00/16:00/0:00自动截图。收益交接记录可追溯减少推诿扯皮。3.4 夜间无人值守需求夜间无人值守时对重点区域进行录像次日复查。方案设置定时录像任务每晚 22:00-06:00 每小时录制 5 分钟片段。收益降低存储压力同时保留关键时段证据。3.5 关键事件记录需求对重要事件如领导视察、大型活动保留完整视频记录。方案设置定时录像任务在活动期间对覆盖通道持续录制。收益完整留存活动视频便于后期制作或审计。3.6 代理流监控需求对 RTSP/RTMP 拉流代理进行定时监控确保流源正常。方案设置定时截图任务对拉流代理通道定时截图检查画面是否正常。收益提前发现流源异常保障业务连续性。四、操作指南4.1 创建定时截图任务方式一通过 Web 管理后台登录管理后台 → 点击「任务」标签点击「添加任务」按钮选择任务类型国标设备选择设备 ID 和通道 ID拉流代理选择 app/stream选择动作为「截图」填写 Cron 表达式如0 8 * * *设置并发数默认 5可选填写回调 URL点击「保存」方式二通过 API# 对国标设备通道定时截图POST /api/schedule/tasks Authorization: Bearertoken{action:snapshot,device_id:34020000001320000001,channel_id:34020000001310000001,cron_expr:0 8 * * *,concurrency:5}4.2 创建定时录像任务# 对国标设备通道定时录像POST /api/schedule/tasks Authorization: Bearertoken{action:record,device_id:34020000001320000001,channel_id:34020000001310000001,cron_expr:0 8 * * *,duration_secs:60,concurrency:5}# 对拉流代理定时截图POST /api/schedule/tasks Authorization: Bearertoken{action:snapshot,app:live,stream:camera1,cron_expr:0 8 * * *}4.3 查看截图结果通过 Web 后台设备管理 → 点击设备 → 截图历史标签 通过移动端通道列表 → 点击通道 → 查看截图 通过 APIGET /api/snapshot-list?device_idxxxchannel_idxxx4.4 查看录像结果通过 Web 后台云端录像标签 → 查询 通过移动端通道列表 → 点击通道 → 查看录像 通过 APIPOST /api/records五、技术架构系统架构任务生命周期创建任务 → 存入Redis → 调度器扫描 → Cron匹配 → 执行任务 → 保存结果 → 回调通知可选六、产品优势6.1 对比传统人工操作对比项 传统人工操作 GBHub 定时任务执行时间 依赖人员到位 全自动分秒不差执行精度 容易遗漏、忘记 精准执行人力成本 需专人值守 零人力成本可追溯性 手工记录易丢失 自动记录永久可查一致性 因人而异 每次完全一致6.2 对比其他产品对比项 其他产品 GBHub定时截图 部分支持 ✅ 支持国标代理定时录像 部分支持 ✅ 支持国标代理并发控制 少 ✅ 支持可配置并发Cron 表达式 固定间隔 ✅ 完整 Cron 支持回调通知 少 ✅ HTTP 回调移动端查看 少 ✅ 原生支持任务管理 API 少 ✅ 完整 RESTful API6.3 技术亮点亮点 说明防重入机制 同一任务不会重复执行避免资源浪费并发控制 可配置最大并发数保护系统资源容错机制 单任务失败不影响其他任务实时监控 任务执行状态可通过回调获取灵活扩展 支持通过 API 集成第三方系统七、部署要求7.1 软件环境组件 版本要求 说明操作系统 Linux / macOS / Windows 推荐 Linux (Ubuntu 20.04)Rust 1.70 编译环境Redis ≥ 6.0 任务存储与调度ZLMediaKit 最新 stable 媒体服务浏览器 Chrome/Firefox/Edge 最新版 管理后台7.2 服务组件服务 说明 是否必须gbhub-mgr 管理服务处理任务创建与执行 ✅ 必须gbhub-sip 信令服务处理国标设备通信 ✅ 必须gbhub-scheduler 调度服务定时触发任务 ✅ 必须ZLMediaKit 媒体服务提供截图与录制能力 ✅ 必须7.3 关键环境变量变量名 说明 默认值SCHEDULER_SCAN_INTERVAL_SECS 调度器扫描间隔秒 30附录常用 Cron 表达式参考需求 表达式每分钟 * * * * *每 5 分钟 */5 * * * *每 30 分钟 */30 * * * *每小时整点 0 * * * *每天 8:00 0 8 * * *每天 12:00 和 18:00 0 12,18 * * *每天 8:00-18:00 每小时 0 8-18 * * *每周一 9:00 0 9 * * 1每月 1 日 0:00 0 0 1 * *每年 1 月 1 日 0:00 0 0 1 1 *工作日 8:00 0 8 * * 1-5官方网站 https://gb.automate.org.cn© 2026 GBHub 国标视频平台 · 保留所有权利 GBHub 国标视频平台 — 定时截图与定时录像功能解决方案
GBHub 国标视频平台 — 定时截图与定时录像功能解决方案 文档信息项目内容文档版本v1.0更新日期2026 年 8 月适用产品GBHub 国标视频平台 (v0.8.0)文档类型产品功能解决方案目标读者系统集成商、企业 IT 管理员、安防负责人、运维工程师一、功能概述在视频监控管理中定时截图与定时录像是最常用、最刚需的自动化运维能力。无论是为了降低存储成本、提升巡检效率还是为了满足合规留存要求自动化任务都是不可或缺的工具。GBHub 国标视频平台内置了完整的定时任务调度引擎支持对国标设备通道和拉流代理两种目标类型灵活配置定时截图和定时录像两种自动化任务。核心价值价值点说明 全自动化无需人工干预按 Cron 表达式精准执行 灵活调度支持每秒/每分钟/每小时/每天/每周/每月任意时间点 双目标支持支持国标设备通道 拉流代理 移动端查看截图和录像结果可在移动端直接查看 任务回调完成后自动推送结果到指定 URL 降本增效大幅降低人工巡检成本提升管理效率二、核心功能详解2.1 定时截图自动抓拍指定通道的当前画面保存为 JPG 图片用于日常巡检、证据留存、对比分析等场景。功能特点特点说明支持目标类型国标设备通道NVR/摄像头 拉流代理RTSP/RTMP 源截图精度从 ZLMediaKit 拉取原始帧保证截图清晰度存储方式本地存储默认static/snapshots/可选 S3 云存储历史查看按日期目录存储支持通过 API 查询历史截图移动端查看截图结果在移动端 App 自动展示批量操作支持设备通配符*一次性对所有通道截图截图质量示例参数说明格式JPEG分辨率与原始视频流一致文件大小约 50-200 KB视分辨率而定存储路径static/snapshots/{app}/{stream}/{YYYYMMDD}/{HHMMSS}.jpg2.2 定时录像自动录制指定通道的实时视频流保存为 MP4 文件用于完整记录、事件回放、合规审计等场景。功能特点特点说明支持目标类型国标设备通道NVR/摄像头 拉流代理RTSP/RTMP 源录制格式MP4H.264/H.265 编码录制时长可自定义支持任意秒数典型值 60s/300s/600s存储位置ZLMediaKit 录制目录自动记录到数据库播放方式支持 Web 端直接播放、移动端播放、下载自动清理配合定时清理任务自动删除过期录像录制参数配置参数说明示例duration_secs录制时长秒必填60concurrency并发截图/录像数5默认auto_stop_live截图完成后是否停止拉流true/falsecallback_url完成后回调通知地址https://example.com/callbacknode_id指定 ZLM 节点留空则自动轮询2.3 任务管理通过统一的任务管理界面或 API轻松管理所有定时任务。管理功能功能说明创建任务选择目标类型设备/代理、动作截图/录像、Cron 表达式、录制时长等任务列表查看所有任务支持分页、搜索查看详情查看单个任务的完整配置启用/禁用无需删除一键启停任务更新任务修改 Cron 表达式、录制时长、并发数等删除任务永久移除任务执行记录任务执行完成后可通过回调获取执行结果Cron 表达式示例需求Cron 表达式说明每天 8:000 8 * * *每天早上 8 点执行每小时0 * * * *每小时整点执行每 30 分钟*/30 * * * *每 30 分钟执行一次每周一 9:000 9 * * 1每周一上午 9 点执行每月 1 日 0:000 0 1 * *每月 1 日凌晨执行三、典型应用场景3.1 日常巡检需求安保人员每天定时检查重点区域画面确认设备正常运行。方案设置定时截图任务每天 8:00、12:00、18:00 自动抓拍重点通道画面。收益无需人工逐个查看5 分钟完成全厂区巡检问题早发现早处理。3.2 证据留存需求对关键出入口、财务室等敏感区域定期留存画面用于审计追溯。方案设置定时截图任务每小时自动截图一次永久保留。收益满足合规审计要求发生异常时可直接追溯历史画面。3.3 值班交接需求每个班次交接时需要记录当前所有重点区域状态。方案设置定时截图任务每班次交接时刻8:00/16:00/0:00自动截图。收益交接记录可追溯减少推诿扯皮。3.4 夜间无人值守需求夜间无人值守时对重点区域进行录像次日复查。方案设置定时录像任务每晚 22:00-06:00 每小时录制 5 分钟片段。收益降低存储压力同时保留关键时段证据。3.5 关键事件记录需求对重要事件如领导视察、大型活动保留完整视频记录。方案设置定时录像任务在活动期间对覆盖通道持续录制。收益完整留存活动视频便于后期制作或审计。3.6 代理流监控需求对 RTSP/RTMP 拉流代理进行定时监控确保流源正常。方案设置定时截图任务对拉流代理通道定时截图检查画面是否正常。收益提前发现流源异常保障业务连续性。四、操作指南4.1 创建定时截图任务方式一通过 Web 管理后台登录管理后台 → 点击「任务」标签点击「添加任务」按钮选择任务类型国标设备选择设备 ID 和通道 ID拉流代理选择 app/stream选择动作为「截图」填写 Cron 表达式如0 8 * * *设置并发数默认 5可选填写回调 URL点击「保存」方式二通过 API# 对国标设备通道定时截图POST /api/schedule/tasks Authorization: Bearertoken{action:snapshot,device_id:34020000001320000001,channel_id:34020000001310000001,cron_expr:0 8 * * *,concurrency:5}4.2 创建定时录像任务# 对国标设备通道定时录像POST /api/schedule/tasks Authorization: Bearertoken{action:record,device_id:34020000001320000001,channel_id:34020000001310000001,cron_expr:0 8 * * *,duration_secs:60,concurrency:5}# 对拉流代理定时截图POST /api/schedule/tasks Authorization: Bearertoken{action:snapshot,app:live,stream:camera1,cron_expr:0 8 * * *}4.3 查看截图结果通过 Web 后台设备管理 → 点击设备 → 截图历史标签 通过移动端通道列表 → 点击通道 → 查看截图 通过 APIGET /api/snapshot-list?device_idxxxchannel_idxxx4.4 查看录像结果通过 Web 后台云端录像标签 → 查询 通过移动端通道列表 → 点击通道 → 查看录像 通过 APIPOST /api/records五、技术架构系统架构任务生命周期创建任务 → 存入Redis → 调度器扫描 → Cron匹配 → 执行任务 → 保存结果 → 回调通知可选六、产品优势6.1 对比传统人工操作对比项 传统人工操作 GBHub 定时任务执行时间 依赖人员到位 全自动分秒不差执行精度 容易遗漏、忘记 精准执行人力成本 需专人值守 零人力成本可追溯性 手工记录易丢失 自动记录永久可查一致性 因人而异 每次完全一致6.2 对比其他产品对比项 其他产品 GBHub定时截图 部分支持 ✅ 支持国标代理定时录像 部分支持 ✅ 支持国标代理并发控制 少 ✅ 支持可配置并发Cron 表达式 固定间隔 ✅ 完整 Cron 支持回调通知 少 ✅ HTTP 回调移动端查看 少 ✅ 原生支持任务管理 API 少 ✅ 完整 RESTful API6.3 技术亮点亮点 说明防重入机制 同一任务不会重复执行避免资源浪费并发控制 可配置最大并发数保护系统资源容错机制 单任务失败不影响其他任务实时监控 任务执行状态可通过回调获取灵活扩展 支持通过 API 集成第三方系统七、部署要求7.1 软件环境组件 版本要求 说明操作系统 Linux / macOS / Windows 推荐 Linux (Ubuntu 20.04)Rust 1.70 编译环境Redis ≥ 6.0 任务存储与调度ZLMediaKit 最新 stable 媒体服务浏览器 Chrome/Firefox/Edge 最新版 管理后台7.2 服务组件服务 说明 是否必须gbhub-mgr 管理服务处理任务创建与执行 ✅ 必须gbhub-sip 信令服务处理国标设备通信 ✅ 必须gbhub-scheduler 调度服务定时触发任务 ✅ 必须ZLMediaKit 媒体服务提供截图与录制能力 ✅ 必须7.3 关键环境变量变量名 说明 默认值SCHEDULER_SCAN_INTERVAL_SECS 调度器扫描间隔秒 30附录常用 Cron 表达式参考需求 表达式每分钟 * * * * *每 5 分钟 */5 * * * *每 30 分钟 */30 * * * *每小时整点 0 * * * *每天 8:00 0 8 * * *每天 12:00 和 18:00 0 12,18 * * *每天 8:00-18:00 每小时 0 8-18 * * *每周一 9:00 0 9 * * 1每月 1 日 0:00 0 0 1 * *每年 1 月 1 日 0:00 0 0 1 1 *工作日 8:00 0 8 * * 1-5官方网站 https://gb.automate.org.cn© 2026 GBHub 国标视频平台 · 保留所有权利