| 项目 | 内容 |
|---|---|
| 手册版本 | V1.5.0 |
| 更新日期 | 2026-03-02 |
| 适用软件版本 | AIBox V1.4.0 及以上 |
| 适用范围 | AIBox 全功能版(macOS / Linux / Docker 部署) |
| 角色 | 建议阅读章节 |
|---|---|
| 普通用户 | 三 ~ 六 |
| 系统管理员 | 三 ~ 八 |
| 运维人员 | 三、七、八、九 |
| 符号 | 含义 |
|---|---|
| 【按钮名】 | 界面中可点击的按钮,如【保存】、【创建】 |
| 「菜单名」 | 左侧导航菜单项,如「任务管理」 |
字段名 |
表单中的输入字段名称 |
| ⚠️ | 重要注意事项 |
| 💡 | 操作技巧或提示 |
| 🔒 | 需要管理员权限的操作 |
AIBox(视频AI智能检测平台)是一款集视频流接入、AI智能检测、实时告警、流媒体输出于一体的智能视频分析平台。系统支持接入 RTSP 摄像头及视频流,利用多种 AI 算法对视频内容进行实时检测分析,并将检测结果通过 Webhook 回调、视频叠加输出等方式推送给第三方系统。
| 模块 | 功能说明 |
|---|---|
| 仪表板 | 系统运行状态总览,包括信号源、任务、检测统计、系统资源占用 |
| 视频墙 | 多画面实时视频监控,支持自定义网格布局 |
| 输入源管理 | 添加、管理 RTSP 摄像头/视频流地址 |
| 输出流管理 | 配置 FFmpeg 推流输出(RTSP/RTMP/RTP) |
| 模型管理 | 上传、管理 YOLO 检测模型文件 |
| 任务管理 | 创建、启动、停止、监控 AI 检测任务 |
| 检测结果 | 查看、筛选、导出检测结果和截图 |
| 回调管理 | 配置 Webhook 回调接口,支持 JWT 认证 |
| 大模型分析 | 使用 LLM 视觉模型对图片进行智能分析 |
| 大模型管理 | 配置 LLM 服务提供商(OpenAI / Ollama 等) |
| 用户管理 | 管理系统用户账户和角色 |
| 系统配置 | 全局系统参数设置 |
| 算法 | 说明 |
|---|---|
| YOLO 目标检测 | 通用物体识别(行人、车辆、动物等 80+ 类别) |
| 区域入侵检测 | 在指定区域内检测目标入侵 |
| 车牌识别 | 检测车牌位置并通过 OCR 识别号码 |
| 跨线计数 | 统计跨越指定线段的目标数量 |
| 开放词汇检测(YOLO-World) | 基于文本关键词的自定义目标检测 |
| 文本提示检测(GroundingDINO) | 基于自然语言描述的目标检测 |
| HuggingFace 模型 | 从 HuggingFace Hub 加载模型进行分类/检测 |
| 浏览器 | 最低版本 | 推荐 |
|---|---|---|
| Google Chrome | 90+ | ✅ 推荐 |
| Microsoft Edge | 90+ | ✅ 推荐 |
| Mozilla Firefox | 85+ | ✓ 支持 |
| Safari | 15+ | ✓ 支持 |
⚠️ 视频预览功能依赖 HTTP-FLV 播放(mpegts.js),建议使用 Chrome 或 Edge 以获得最佳体验。
系统支持两种角色:
| 角色 | 权限范围 |
|---|---|
| 普通用户 | 查看仪表板、视频墙、输入源、输出流、任务、检测结果、回调日志、大模型分析 |
| 管理员 | 以上全部 + 新增/编辑/删除操作 + 用户管理 + 系统配置 + 大模型管理 |
💡 默认管理员账户:用户名
admin,密码由部署时设定。首次使用请联系运维人员获取登录凭据。
在浏览器中输入平台访问地址,格式为:
例如:http://ai-box.your-domain.com 或 http://aibox.your-domain.com
打开浏览器,输入平台访问地址,进入登录页面
在 用户名 输入框输入您的用户名
在 密码 输入框输入密码(可点击右侧眼睛图标查看明文)
点击【登录】按钮
登录成功后自动跳转至仪表板首页
💡 登录页右上角可切换界面语言:简体中文 / 繁體中文 / English
支持通过 URL 参数携带 Token 实现免密登录,适用于第三方系统嵌入:
Token 会自动存储到浏览器本地,并从 URL 中移除。
普通用户无法自行重置密码,请联系系统管理员。管理员可在「用户管理」页面编辑用户信息并设置新密码。
点击页面右上角的【退出】按钮即可注销当前登录状态,页面会自动跳转回登录页。
⚠️ 登录 Token 有过期时间,长时间未操作后再访问会自动跳转到登录页面。
系统界面由三部分组成:
左侧导航栏展示所有功能模块菜单,可点击折叠/展开按钮收起侧边栏。
| 图标 | 菜单名称 | 说明 | 权限 |
|---|---|---|---|
| 📊 | 仪表板 | 系统总览 | 所有用户 |
| 🖥️ | 视频墙 | 多画面实时监控 | 所有用户(可在系统配置中隐藏) |
| 📹 | 输入源 | RTSP 信号源管理 | 所有用户(编辑需管理员) |
| 🔗 | 输出流 | 推流输出管理 | 所有用户(编辑需管理员) |
| 📦 | 模型管理 | AI 模型管理 | 所有用户(上传需管理员) |
| 📋 | 任务管理 | 检测任务管理 | 所有用户(创建需管理员) |
| 🖼️ | 检测结果 | 检测结果查看 | 所有用户 |
| 🔗 | 回调管理 | Webhook 回调配置 | 所有用户(编辑需管理员) |
| 🔍 | 大模型分析 | LLM 视觉智能分析 | 所有用户 |
| 🔗 | 大模型管理 | LLM 服务商配置 | 🔒 管理员 |
| 👤 | 用户管理 | 用户账户管理 | 🔒 管理员 |
| ⚙️ | 系统配置 | 全局系统设置 | 🔒 管理员 |
从左到右依次为:
| 操作 | 说明 |
|---|---|
| 新增 | 点击页面顶部的【添加】/【创建】按钮,在弹出对话框中填写信息后提交 |
| 编辑 | 点击表格行操作列中的 ✏️ 编辑按钮 |
| 删除 | 点击 🗑️ 删除按钮,系统会弹出确认对话框 |
| 批量删除 | 勾选多行后点击顶部【批量删除】按钮 |
| 查询/筛选 | 使用页面顶部的筛选条件(下拉选择、搜索框)过滤数据 |
| 分页 | 表格底部可切换每页条数(10/20/50/100)和翻页 |
| 导出 | 点击【导出】按钮将数据导出为 Excel 文件 |
功能用途:系统运行状态总览,展示关键指标和统计图表。
操作入口:登录后默认进入,或点击侧边栏「仪表板」。
页面内容:
统计卡片(顶部一行):
| 卡片 | 含义 |
|---|---|
| 在线信号源 | 当前在线/总数的输入源数量 |
| 运行中任务 | 正在运行/总数的检测任务数量 |
| 检测总数 | 系统累计检测结果数量 |
| CPU 使用率 | 服务器当前 CPU 占用百分比 |
统计图表(四宫格):
系统状态(底部卡片):
💡 仪表板数据每 10 秒自动刷新。
功能用途:多画面实时视频监控,可自定义网格布局并保存。
操作入口:侧边栏「视频墙」。
操作步骤:
注意事项:
功能用途:管理接入系统的 RTSP 摄像头和视频流地址。
操作入口:侧边栏「输入源」。
点击页面顶部【添加信号源】按钮
在弹出对话框中填写:
信号源名称:为摄像头取一个便于识别的名称(必填)RTSP地址:摄像头的 RTSP 流地址(必填),格式如 rtsp://用户名:密码@IP:端口/路径描述:备注信息(选填)点击【保存】
点击表格行中的【播放】按钮,可打开实时视频预览窗口。点击【测试连接】按钮可检测 RTSP 流是否可用,成功后显示分辨率、帧率、编码信息。
⚠️ 如果信号源已被检测任务引用,删除信号源可能影响相关任务运行。
功能用途:配置检测结果视频的推流输出地址(支持 RTSP / RTMP / RTP)。
操作入口:侧边栏「输出流」。
流名称:输出流的标识名称(必填)流类型:选择协议类型 — RTSP / RTMP / RTP(必填)流地址:推流目标地址(必填),例如:
rtsp://服务器IP:554/live/stream1rtmp://服务器IP:1935/live/stream1状态:是否启用描述:备注信息点击表格中的【播放】按钮,在弹出窗口中通过 HTTP-FLV 预览推流效果。
💡 输出流用于将叠加了检测结果的视频推送到流媒体服务器,在「任务管理」中可将检测任务绑定到输出流。
功能用途:上传和管理 YOLO 系列检测模型文件。
操作入口:侧边栏「模型管理」。
模型名称:模型的标识名称(必填)版本:模型版本号,如 v8n、v8s、v11n描述:模型用途说明模型文件:点击上传区域选择 .pt 格式的模型文件⚠️ 模型文件通常较大(几十 MB 到上百 MB),上传过程请耐心等待,不要关闭页面。
💡 系统预置了 YOLOv8n 和 YOLOv11n 模型,可直接用于检测任务。如需使用自定义训练的模型,请在此上传。
功能用途:创建、配置、启停 AI 检测任务,是系统最核心的功能模块。
操作入口:侧边栏「任务管理」。
基本信息:
| 字段 | 说明 |
|---|---|
任务名称 |
任务标识名称(必填) |
输入源 |
从已添加的信号源列表中选择(必填) |
算法配置(根据选择的算法类型动态显示不同配置项):
| 算法类型 | 可配置项 |
|---|---|
| YOLO 目标检测 | 模型选择、置信度阈值 |
| 区域入侵检测 | 模型选择、置信度阈值、检测区域绘制、仅检测人员 |
| 车牌识别 | 模型选择、置信度阈值、OCR 开关、OCR 语言、保存车牌图片 |
| 跨线计数 | 模型选择、置信度阈值、计数线绘制、计数方向、检测目标类型 |
| 开放词汇检测 | 检测关键词(逗号分隔)、置信度阈值 |
| 文本提示检测 | 检测关键词、置信度阈值 |
| HuggingFace 模型 | 模型仓库名、任务类型、Top-K、置信度阈值 |
高级配置:
| 字段 | 说明 |
|---|---|
跳帧数 |
每隔 N 帧检测一次,值越大性能越好但实时性降低(0 = 每帧检测) |
输出流 |
开关 + 选择输出流,将检测结果叠加后推流 |
叠加输出 |
是否在输出流上叠加检测框和标签 |
回调 |
开关 + 选择回调配置,检测到结果时触发 Webhook |
启用事件检测 |
仅在检测到目标时才记录结果(减少无效数据) |
启用视频录制 |
检测到事件时自动录制视频片段 |
视频片段时长 |
录制视频的时长(1–30 秒) |
点击【确定】保存任务
对于「区域入侵检测」和「跨线计数」算法,需要绘制检测区域或计数线:
每个任务有「自动启动」开关(表格中的切换按钮),开启后系统重启时会自动恢复该任务的运行。
点击 📋 日志按钮,弹出窗口显示任务运行的详细日志,可用于排查问题。
对于「开放词汇检测」和「文本提示检测」任务,运行中可点击 🪄 按钮实时更新检测关键词,无需重启任务。
对于已配置输出流的运行中任务,点击 🖥️ 按钮可预览叠加了检测结果的实时视频。
💡 建议跳帧数设置为 3~5,既能保证检测效果又不会过度占用系统资源。
功能用途:查看、筛选、导出 AI 检测产生的结果记录。
操作入口:侧边栏「检测结果」,或在任务管理中点击 📄 查看结果按钮。
页面顶部提供筛选条件:
点击页面顶部的【导出】按钮,将当前筛选结果导出为 Excel(.xlsx)文件。
💡 检测结果页面每 30 秒自动刷新,实时展示最新检测数据。
功能用途:配置 Webhook 回调接口,当检测任务产生结果时自动推送到第三方系统。
操作入口:侧边栏「回调管理」。
名称:回调配置名称(必填)URL:接收回调的 HTTP 接口地址(必填)方法:HTTP 请求方法(POST / GET / PUT / PATCH / DELETE)状态:启用 / 禁用切换JWT Token 中填入已有的 Token点击表格中的【测试】按钮,系统会向配置的 URL 发送一条测试消息,验证连通性。
点击【日志】按钮查看该回调配置的历史推送记录,包括:
💡 在创建检测任务时,可选择关联回调配置。任务检测到结果后会自动将数据 POST 到回调 URL。
功能用途:使用 LLM 视觉模型(如 GPT-4o)对上传的图片进行智能分析和目标检测。
操作入口:侧边栏「大模型分析」。
操作步骤:
提示词 输入框中输入检测指令(如"检测图中的所有车辆"、"识别图中的安全隐患")提供商 下拉框中选择已配置的 LLM 服务提供商⚠️ 使用大模型分析需要先在「大模型管理」中配置至少一个 LLM 服务提供商。
🔒 以下功能仅管理员(admin 角色)可见和操作。
功能用途:管理系统用户账户,包括创建、编辑和删除用户。
操作入口:侧边栏「用户管理」。
用户名:登录用户名(必填,不可重复)邮箱:用户邮箱(需符合邮箱格式)密码:登录密码(必填,建议 8 位以上)角色:普通用户 / 管理员点击用户行的编辑按钮,可修改用户名、邮箱、角色。修改密码时留空表示不更改。
点击删除按钮,确认后删除用户账户。
⚠️ 请勿删除所有管理员账户,否则将无法登录管理后台。
功能用途:配置 LLM(大语言模型)服务提供商的连接信息。
操作入口:侧边栏「大模型管理」。
| 字段 | 说明 |
|---|---|
提供商类型 |
OpenAI / Ollama |
提供商名称 |
自定义名称 |
Base URL |
API 接口地址(OpenAI 默认 https://api.openai.com/v1) |
API Key |
API 密钥(Ollama 不需要) |
Organization |
组织 ID(选填) |
Project |
项目 ID(选填) |
模型 |
模型名称(如 gpt-4o、gpt-4o-mini,支持手动输入自定义模型名) |
描述 |
备注说明 |
点击【测试】按钮,打开测试对话窗口:
💡 如使用兼容 OpenAI API 的第三方服务(如 Azure OpenAI、通义千问等),选择 OpenAI 类型并修改 Base URL 即可。
功能用途:全局系统参数设置。
操作入口:侧边栏「系统配置」。
可配置项:
| 配置项 | 说明 | 默认值 |
|---|---|---|
| 系统名称 | 显示在登录页和侧边栏的平台名称 | 视频AI智能检测平台 |
| 哈希比对时间窗口 | 相邻帧去重的时间窗口(秒) | 2.0 |
| 哈希差异阈值 | 判定为不同帧的差异阈值 | 0.3 |
| 启动时发送邮件 | 系统启动时是否发送通知邮件 | 关闭 |
| 检测告警提示音 | 检测到事件时是否播放提示音 | 开启 |
| 显示视频墙菜单 | 是否在侧边栏显示视频墙入口 | 开启 |
| ZLMediaKit 服务地址 | 流媒体服务器 HTTP 地址 | http://zlm.your-domain.com:8080 |
| ZLMediaKit API 密钥 | 流媒体服务器管理 API 密钥 | 预设值 |
修改后点击页面顶部的【保存】按钮使配置生效。
⚠️ 修改 ZLMediaKit 地址后,所有视频预览功能将使用新的服务器地址,请确保地址正确且可访问。
| 可能原因 | 解决方法 |
|---|---|
| 用户名或密码错误 | 确认输入正确,注意大小写。联系管理员重置密码 |
| 后端服务未启动 | 联系运维确认后端服务运行状态 |
| 网络不通 | 检查能否 ping 通服务器 IP |
| Token 过期 | 清除浏览器缓存后重新登录 |
| 可能原因 | 解决方法 |
|---|---|
| 前端服务未启动 | 联系运维确认 Nginx / 前端服务状态 |
| 浏览器缓存问题 | 按 Ctrl + Shift + R(Mac: Cmd + Shift + R)强制刷新 |
| 网络延迟大 | 检查网络连接质量 |
| 首次加载模型 | 首次启动任务需加载 AI 模型,可能需要 30–60 秒 |
| 可能原因 | 解决方法 |
|---|---|
| ZLMediaKit 未启动 | 联系运维确认流媒体服务运行状态 |
| ZLMediaKit 地址配置错误 | 管理员检查「系统配置」中的 ZLMediaKit 地址 |
| RTSP 源不在线 | 在「输入源」页面点击【测试连接】检查流可用性 |
| 浏览器不支持 | 建议使用 Chrome 或 Edge |
| 可能原因 | 解决方法 |
|---|---|
| RTSP 信号源离线 | 确认摄像头在线并检查 RTSP 地址 |
| 模型文件缺失 | 确认所选模型已上传且文件完整 |
| 系统资源不足 | 检查 CPU / 内存使用率,停止不需要的任务 |
| 算法配置错误 | 检查算法参数(如检测区域、关键词是否正确) |
| 可能原因 | 解决方法 |
|---|---|
| 任务未运行 | 确认任务状态为「运行中」 |
| 置信度阈值过高 | 降低算法配置中的置信度阈值(建议 0.3–0.5) |
| 检测关键词不匹配 | 检查开放词汇/文本提示算法的关键词设置 |
| 跳帧数过大 | 减小跳帧数以提高检测频率 |
| 启用了事件检测 | 事件检测模式下只在检测到目标变化时记录结果 |
| 可能原因 | 解决方法 |
|---|---|
| 数据量过大 | 使用筛选条件缩小导出范围后重试 |
| 模型文件过大 | 检查网络是否稳定,上传过程不要关闭页面 |
| 磁盘空间不足 | 联系运维清理服务器磁盘空间 |
普通用户无法执行新增、编辑、删除等管理操作,页面上对应按钮不会显示。如需相应权限,请联系系统管理员将您的角色提升为管理员。
| 可能原因 | 解决方法 |
|---|---|
| 回调配置未启用 | 检查回调配置的「状态」是否为启用 |
| 任务未关联回调 | 编辑任务,开启「回调」并选择回调配置 |
| 回调 URL 不可达 | 使用【测试】按钮验证连通性 |
| JWT Token 过期 | 检查回调日志中的错误信息,更新 JWT 配置 |
| 名词 | 解释 |
|---|---|
| RTSP | Real Time Streaming Protocol,实时流传输协议,用于摄像头视频流传输 |
| RTMP | Real Time Messaging Protocol,实时消息传输协议,常用于直播推流 |
| YOLO | You Only Look Once,一种高效的实时目标检测算法 |
| GroundingDINO | 基于文本提示的开放集目标检测模型 |
| YOLO-World | 基于开放词汇的 YOLO 目标检测模型 |
| ZLMediaKit | 高性能流媒体服务器,本系统用于视频流代理和 HTTP-FLV 转发 |
| HTTP-FLV | 基于 HTTP 协议的 FLV 视频流,用于浏览器低延迟视频播放 |
| OCR | Optical Character Recognition,光学字符识别 |
| LLM | Large Language Model,大语言模型 |
| JWT | JSON Web Token,一种身份认证令牌标准 |
| Webhook | 一种回调机制,事件发生时自动向指定 URL 发送 HTTP 请求 |
| 置信度 | 模型对检测结果的确信程度,范围 0–1,越高表示越确信 |
| 跳帧 | 每隔指定帧数执行一次检测,用于降低 CPU/GPU 负载 |
| 哈希去重 | 通过图像哈希比对,过滤重复帧的检测结果 |
系统支持通过 URL 查询参数控制界面行为:
| 参数 | 取值 | 作用 |
|---|---|---|
secret |
JWT 字符串 | 自动登录(token 存入后自动从 URL 中移除) |
redirect |
路径(如 /tasks) |
登录成功后跳转到指定页面 |
theme |
light / dark / system |
覆盖当前主题设置 |
show_content_only |
1 / true / yes / on |
隐藏侧边栏和顶栏(Kiosk 嵌入模式) |
示例:
| 操作 | 说明 |
|---|---|
Ctrl + Shift + R |
强制刷新页面(清除缓存) |
| 右键/双击 | 完成区域绘制 |
| 点击缩略图 | 查看检测结果大图 |
| 切换自动启动开关 | 直接在任务列表中切换,无需打开编辑 |
如遇到本手册无法解决的问题,请联系技术支持:
本手册最后更新于 2026 年 3 月 2 日,如有疑问请以系统实际功能为准。