下载 PDF 版用户手册

发现手册中未涵盖的功能，或有任何疑问及建议？请告知我们。

目录：

第一章 简介
1.1. 简介
1.2. 核心功能与典型应用
1.3. 系统要求
1.4. 运行模式

第二章 快速上手
2.1. 快速上手
2.2. Xeoma 主窗口界面
2.2.1. Xeoma 主窗口界面
2.2.2. 快速设置窗口
2.2.3. 详细设置窗口
2.2.4. 模块设置窗口
2.3. 模块与链的工作原理
2.3.1. 模块与链的工作原理
2.3.2. 链分叉
2.4. 摄像机自动扫描与搜索
2.4.1. 首次启动 Xeoma 时的演示摄像机与摄像机搜索
2.4.2. 本地摄像机简单搜索
2.4.3. 通过 IP/密码搜索
2.4.4. 手动添加摄像机
2.4.5. 通过复制添加摄像机
2.4.6. 通过 POST 请求添加摄像机（仅限 Xeoma Pro）
2.4.7. 通过列表批量添加/删除摄像机
2.4.8. 用于添加新摄像机的模块链示例
2.5. 布局菜单（网格、可视化、解码设置）
2.5.1. 页面（摄像机标签页）
2.5.2. 消除空白边框
2.5.3. 自动滚动
2.5.4. 大网格模式
2.5.5. “仅显示活动摄像机”
2.5.6. “切换至活动页面”
2.5.7. 界面增强
2.5.8. 运动可视化
2.5.9. eMap 交互式地图
2.5.10. 解码设置
2.6. 更改摄像机顺序
2.7. 摄像机批量管理：设备列表
2.8. PTZ 控制与缩放
2.8.1. 基础 PTZ 控制与缩放
2.8.2. 数字缩放
2.8.3. 浏览器中的 PTZ 控制
2.8.4. PTZ 跟踪 – 目标自动跟随
2.8.5. 设置 PTZ 预置点与 PTZ 巡航
2.9. 摄像机批量管理：eMap
2.10. 更改预览中的摄像机名称
2.11. 直接保存至存档或“双流传输”

第三章 模块设置
3.1. 源设置
-3.1.1. 另一个 Xeoma
-3.1.2. ANPR 速度接收端
-3.1.3. 文件读取
-3.1.4. FTP 接收端
-3.1.5. HTTP 接收端
-3.1.6. 麦克风
-3.1.7. 屏幕捕捉
-3.1.8. 通用摄像机
3.2. 目标设置
-3.2.1. ANPR FTP 发送端
-3.2.2. ANPR 速度发送端
-3.2.3. 应用程序运行器
-3.2.4. FTP 上传
-3.2.5. HTTP 请求发送端
-3.2.6. HTTP 上传至另一个 Xeoma
-3.2.7. 移动通知
-3.2.8. 弹出窗口（客户端）
-3.2.9. 预览
-3.2.10. 预览与存档
-3.2.11. RTSP 广播
-3.2.12. 保存到文件
-3.2.13. 发送电子邮件
-3.2.14. 发送短信
-3.2.15. 声音报警
-3.2.16. 流式传输至 YouTube
-3.2.17. Telegram Bot 通知
-3.2.18. Web 服务器
3.3. 过滤器
-3.3.1. 360° 全景视图
-3.3.2. 年龄识别
-3.3.3. 自动车牌识别 (ANPR)
-3.3.4. 鸟类检测
-3.3.5. 按钮切换器
-3.3.6. 摄像机内置检测器
-3.3.7. 颜色识别
-3.3.8. 条件
-3.3.9. 越线检测
-3.3.10. 人群检测
-3.3.11. 白天检测
-3.3.12. 遗留物检测
-3.3.13. 工地安全检测
-3.3.14. 时长检测
-3.3.15. 眼动追踪
-3.3.16. 人脸检测（表情）
-3.3.17. 人脸识别
-3.3.18. FaceID
-3.3.19. 鱼眼矫正
-3.3.20. 货物卸载计数
-3.3.21. 性别识别
-3.3.22. GPIO 模块
-3.3.23. 心率监测
-3.3.24. HTTP 标记
-3.3.25. HTTP 切换器
-3.3.26. 图像裁剪
-3.3.27. 图像缩放
-3.3.28. 图像旋转
-3.3.29. 目标尺寸过滤
-3.3.30. 反相器
-3.3.31. 逗留检测
-3.3.32. 标记
-3.3.33. Modbus 控制器
-3.3.34. 移动侦测
-3.3.35. 移动至 PTZ 预设点
-3.3.36. 自定义检测器
-3.3.37. 目标检测
-3.3.38. 目标类型识别
-3.3.39. 车位监测
-3.3.40. 隐私遮蔽
-3.3.41. 异常检测
-3.3.42. PTZ 追踪
-3.3.43. 二维码识别
-3.3.44. 车速检测
-3.3.45. 继电器开关
-3.3.46. 餐厅客流计数
-3.3.47. 调度器
-3.3.48. Senstar PTZ 追踪
-3.3.49. 跌倒检测
-3.3.50. 智能卡读卡器
-3.3.51. SmartHome – RIF+
-3.3.52. 烟雾检测
-3.3.53. 声音检测
-3.3.54. 声音事件检测
-3.3.55. 体育赛事追踪
-3.3.56. 文本识别
-3.3.57. 热成像相机数据
-3.3.58. 定时器
-3.3.59. 统一器
-3.3.60. 访客计数
-3.3.61. 语音转文本
3.4.1. 通用相机
3.4.2. 移动侦测
3.5. 存档
-3.5.1. 存档设置与保存
-3.5.2. 存档回放
-3.5.3. 存档专业功能
3.6. 人脸检测与人脸识别
3.7. 访客计数
3.8. 标记
3.9. 继电器开关
3.10. 隐私遮蔽
3.11. 烟雾检测
3.12. 目标检测
3.13. HTTP 标记（POS 集成）
3.14. HTTP 请求发送器（智能家居集成）
3.15. HTTP 上传至其他 Xeoma
3.16. RTSP 广播

第 4 章 高级监控功能
4.1. 客户端-服务器架构
4.2. 安装
4.3. 授权
4.4. 激活
-4.4.1. 在线激活
-4.4.2. 离线激活
-4.4.3. 虚拟机激活
-4.4.4. 通过授权服务器在虚拟机上激活
-4.4.5. 硬件加密锁 (USB 闪存盘)
4.5. 更新
-4.5.1. 升级至新版本
-4.5.2. 降级至旧版本
4.6. 操作员与用户访问权限
-4.6.1. 用户访问权限
-4.6.2. 操作员/用户 PTZ 锁定
-4.6.3. 连接双重身份验证
-4.6.4. 用户锁定设置
-4.6.5. 显示预览水印
4.7. 设置还原（设置与存档备份）
4.8. 移动可视化
4.9. 热力图
4.10. TLS 安全连接
4.11. 录像自动备份（至 FTP）
4.12. 故障转移
4.13. 硬件加速
-4.13.1. 服务器
-4.13.2. 客户端
-4.13.3. 模块
4.14. 外部设备集成
-4.14.1. 外部设备集成：发送命令（如：道闸）
-4.14.2. 外部设备集成：接收命令（如：通过信号触发录像）
-4.14.3. 外部设备集成：叠加标题（如：收银机）
-4.14.4. 通过外部数据库集成外部设备
-4.14.5. 通过 GPIO 模块集成外部设备
-4.14.6. 通过 RIF+ 模块集成外部设备
-4.14.7. 通过 Modbus 控制器模块集成外部设备
-4.14.8. 通过 Senstar PTZ 追踪模块集成外部设备
-4.14.9. Xeoma API
-4.14.10. 将外部传感器绑定至摄像机信号输入端

第 5 章. 远程访问
5.1. 代理服务器配置
5.2. 远程访问选项
-5.2.1. 客户端至服务器的远程访问
— 1. 同一网络内连接
— 1.1. 手动连接（适用于任何设备）
— 1.2. 通过扫描二维码连接（仅适用于 Android 版 Xeoma 应用）
— 2. 跨网络连接
— 2.1. 通过公网 IP 地址跨网络连接
— 2.2. 通过 P2P 或其他公网 IP 替代方案跨网络连接
5.3. 中继器
5.4. Web 服务器
-5.4.1. 第一部分：通过浏览器远程查看摄像机
-5.4.2. Web 浏览器界面详解
-5.4.3. 第二部分：将视频素材保存至另一台计算机
-5.4.4. 第三部分：IP 摄像机模拟
-5.4.5. 第四部分：在您的网站上实现直播
5.5. Web 服务器自定义
5.6. Android 应用
5.7. iPhone/iPad 应用
5.8. VPN 连接

第 6 章. 其他产品
6.1. Xeoma Pro Your Cloud（您的 VSaaS）
6.2. Xeoma Cloud
6.3. Xeoma 定制开发

第 7 章. 总结
7.1. 卸载
7.1.1. 停止程序
7.1.2. 重新安装程序
7.1.3. 完全卸载程序
7.1.4. 删除 Xeoma 移动端应用
7.2. 降低 CPU 负载的技巧

第 8 章. 术语表

附录.
1 – 典型应用场景
2 – 典型视频监控目标及 Xeoma 实现方案
3 – 新手快速入门指南
4 – 控制台操作
5 – 支持的控制台命令
6 – 控制台启动故障排除
7 – Xeoma 摄像机在线查看的 Web 服务器自定义
8 – Xeoma 设置
9 – 更改摄像机顺序
10 – 多服务器模式
11 – 中继器
12 – Xeoma 免费品牌重塑分步指南
13 – 设备列表（按组分类）
14 – FTP 接收端：更简便的摄像机连接方式
15 – RTSP (h264) 摄像机的双流传输
16 – 如何在搭载 ARM 处理器的 Raspberry Pi 上安装 Xeoma
17 – 如何迁移 Xeoma 录像
18 – Xeoma 延时摄影
19 – 视频监控多显示器设置或 Xeoma 多屏模式（视频墙）自动启动

---

第 1 章. 简介

1.1. Xeoma 概览

Xeoma 是一款完整的视频监控解决方案，凭借其创新的积木式构建原则，具备无限的灵活性。无论非技术用户还是专业人士，均可轻松上手，它支持构建从小型到企业级的各类监控系统，真正拥有无限的摄像头接入能力（单台计算机最多可支持 数千个摄像头）。该程序可在 Windows、Linux、Mac OS 和 Android 设备上运行（全功能版本），并提供完整的远程访问功能，支持从任意移动设备或计算机实时查看。

Xeoma 提供自动检测并支持几乎所有摄像头——IP、ONVIF、USB 摄像头、H.264, H.265, H.264+, H.265+, MJPEG, MPEG4, PTZ, WiFi（支持市场上 99.9% 的摄像头）。借助 Xeoma，计算机和摄像头在短短几秒钟内即可转化为一套开箱即用的监控系统。

智能运动检测器具备先进的误报规避逻辑，支持运动触发或定时通知（短信、电子邮件、声音报警等）及屏幕截图，结合声音监测功能，是员工监控和家长控制的理想选择。

共享访问权限、加密机制、密码保护及网络集群功能，甚至支持在无图形界面操作系统上运行，确保即使是专业级监控系统也能高效稳定运行。无需安装，无需管理员权限。专业人士必将青睐其自动备份至 FTP 服务器、强大的 Web 服务器、带音频的全摄像头远程查看（Flash 视频流），以及支持导出的循环归档功能。

极致性价比：体验功能无限制的 Xeoma 演示版！您可以无限期使用。当您希望扩展系统时，只需以最优惠的价格购买许可证即可！通过替换和维护过时的监控设备，节省安保人员成本或昂贵的监控方案支出。

Xeoma 不含任何间谍软件、病毒或恶意软件，完全安全。

下载 购买 视频 联系我们

---

1.2. Xeoma 核心功能

摄像头/信号源处理：

• 兼容所有摄像头、模拟摄像头，包括 WiFi 无线监控摄像头
• 支持 IP 摄像头（涵盖 H.264、H.265、H.264+、H.265+、JPEG/MJPEG、MPEG-4、鱼眼镜头、PTZ 及 ONVIF 协议，以及无线摄像头），完美适配有线与无线监控场景
• 支持任意分辨率 (MPix)
• 同时截取所有显示器的屏幕画面
• 可调节音质和音量
• 单台计算机最多可连接 2,000 个摄像头！

专业监控，化繁为简：

• 免费品牌定制与个性化配置
• 快速部署：模块批量设置
• 借助设备列表实现摄像头的快速导航与控制
• Windows 和 Linux 系统支持硬件加速：QuickSync（Intel 处理器）与 CUDA（NVIDIA 显卡）
• 支持设置客户端解码，以降低 CPU 和网络负载
• 配置备份与还原
• 故障转移：当主服务器宕机时，自动切换至备用服务器
• 摄像头故障时的资源动态重分配
• 通过界面进行配置还原和备份（主菜单 – 安装 – 还原）
• Xeoma Cloud 服务
• Xeoma Pro – Xeoma 标准版的专业增强版
• 在 Xeoma Pro 配置文件中配置摄像机、模块与方案
• 利用 Web 服务器搭建 Xeoma 视频监控服务器网络
• 多服务器与多客户端连接架构，适用于各种规模的视频监控部署
• 灵活的访问权限（用户权限）配置
• 设置密码保护
• 全屏视图
• 支持多显示器协作（视频墙）
• 弹出监控模式：在指定显示器上显示活动摄像机及检测到的移动或其他事件（弹出窗口）
• 对象遮蔽/模糊（适用于私密区域）
• 声音检测器：可识别尖叫、枪声、玻璃破碎等声音
• 服务器与客户端间采用 TLS 加密
• 支持 IPv4 和 IPv6 协议
• 高活跃区域 热力图
• 实时或存档数字变焦
• 支持 PTZ 控制
• 360° 摄像机图像旋转
• 摄像机图像即时截图

智能模块与功能：

• 鱼眼摄像机图像去畸变
• eMap – 含交互式摄像机的视频监控站点地图
• 人脸检测器
• 对象检测器：即使对象静止也能持续跟踪
• 与摄像机 SD 卡同步
• 与收银机同步
• LDAP 活动目录同步
• 借助 HTTP 请求发送器和 HTTP 切换模块，轻松集成智能家居系统
• 可利用 Xeoma Pro 构建自有云视频监控服务
• 隐私遮蔽：模糊无需记录的区域或人脸
• 自动对象跟踪及变焦（PTZ 跟踪），并实现移动对象可视化
• 破坏检测器：检测到设备遭破坏时发出通知
• 浏览器端同样支持 PTZ 控制
• 远程（HTTP 切换器）和本地（按钮切换器）快速启停链路
• 按时间或在选定区域搜索存档中的移动事件
• RTSP 和 HTTP 广播：模拟以 MJPEG、JPEG、H.264 等格式流式传输的 IP 摄像机

远程访问：

• 通过移动设备远程查看（支持 Android、iPhone、iPad）
• 在线查看所有带音频的摄像机
• 从工作站 全面远程访问 设置、存档和摄像机
• 网络广播
• 支持将摄像机图像嵌入您的网站
• 即使使用动态 IP 地址也可远程访问
• 在 Web 浏览器中查看存档并进行基础设置

移动检测器：

• 设置任意大小和形状的区域以监控移动情况
• 可视化移动检测，预览界面显示最后一次检测到移动的时间
• 设置需忽略的最大物体尺寸以及传感器灵敏度级别
• 预录选项，存储运动检测前数秒的视频
• 后录功能，在事件结束后继续录像
• 录像延迟
• 增强算法，避免因宠物或天气变化引起的误报

档案：

• 循环录像
• 可调节档案最大容量及存储图像的压缩率
• 支持将档案存储在不同的硬盘或 RAID 阵列上
• 支持网络附属存储 (NAS)、Google Cloud 硬盘等
• 内置易用媒体播放器，具备多线程快速回放机制，支持搜索移动事件或特定时间点
• 直接从播放器导出选定片段
• 从播放器删除不需要的片段
• 按时间并在选定区域搜索移动事件
• 多个存档的同时同步查看

通知与响应：

• 发送短信 (SMS)
• 电子邮件通知（附带 JPEG 图像和 MJPEG 视频）
• 事件触发弹出窗口
• 声音报警
• 运行指定的外部程序
• 将带音频的图像和视频 上传至 FTP 服务器
• 将文件保存至指定路径并进行循环录像

所有高阶功能：

• 隐藏工作模式
• 支持 WEBM (VP8 和 VP9)、MPEG-4、MP4 和 MJPEG 视频格式
• 标记（在摄像机流中嵌入时间日期、自定义文本、GPS 坐标或图像水印）
• 计划程序：设置系统组件的启停时间
• 预览模式下可调节音量
• 快速设置：复制链路
• 可调预览模式（摄像机布局、窗口透明度、字体）
• 实时图像自动轮播
• 一键便捷更新
• 新版本通知

Xeoma 优势：

• 完美兼容 Windows、Mac OS X、Linux 和 Android，提供全功能体验
• 免费下载
• 全功能试用版可多次使用
• 无时间限制的免费版本
  限制
• 下载后使用默认设置即可立即投入使用
• 无需安装
• 无需管理员权限
• 简单的附加设置
• 灵活的控制方式，如同搭建积木般简单
• 创新的直观图形界面
• 持续迭代，不断引入前沿功能
• 支持 78 种语言，包括英语、西班牙语、意大利语、巴西葡萄牙语、中文、法语、德语、阿拉伯语、挪威语、希伯来语、日语、匈牙利语、波兰语、俄语、越南语、韩语、泰语、乌克兰语和白俄罗斯语。查看全部

典型应用场景：

• 非工作时间的目标监控（办公室、店铺、仓库）
• 安防监控（周界安全监控、车辆等）
• 智能家居系统集成
• 人员监控（工业工人、办公室员工、护理人员和家政人员）
• 监控儿童及办公人员的计算机活动，管控访问网站
• 宠物监控
• 工业设备监控

---

1.3. 最低系统要求：

官方支持的操作系统：

Windows – Windows 7、Windows 8、Windows 10、Windows 11（含 64 位和 32 位版本），Windows Server 2008 R2/2012/2016。

Linux – 支持 32 位和 64 位版本，含 XWindows 或控制台/服务器模式。适用于基于 ARM 处理器（如 Raspberry Pi）或 Intel 处理器的 Linux 系统。
支持的 Linux 发行版：
最新版 Ubuntu（12、13、14 及更高版本）；
Debian 7 及更高版本；
openSUSE 12.2 及更高版本；
Mint 13 及更高版本；
CentOS 7 或更高版本；
Red Hat Enterprise Linux 6 或更高版本；
Astra Linux (2.11.3 及以上版本)；
ALT OS (8.2 及以上版本)；
RED OS (7.2 及以上版本)；
Sailfish OS 3.0.3.9 及以上

注意：Linux 控制台声音支持需要 libasound2。在 Linux 上安装或运行 Xeoma 时，请确保在 Linux 机器上解压 xeoma_linux.tgz 归档文件。否则，需执行：chmod a+x xeoma.app，然后即可照常运行 Xeoma：./xeoma.app

若在 64 位 Linux 发行版上安装 32 位版本（尽管在此情况下建议直接下载 64 位版本），您可能需要安装 ia32-libs。

Mac OS X 10.9* 或更高版本

Android – Android OS 5.0（API LEVEL 10）或更高版本，20 MB 可用运行内存，屏幕分辨率 450×450 或更高。

iPhone/iPad – iOS 9 或更高版本

2016-02-29 或之后发布的 Raspbian（适用于 Raspberry Pi 2 或更高版本）。

HarmonyOS 3.0 及以上

非官方支持的操作系统：***
Linux Kali (18 及以上版本)；
RancherOS；
Fedora (31 及以上版本)；
Elbrus (1.4.3 及以上版本)；
PCLinuxOs (2018.06 及以上版本)；
elementary OS Linux (5.0 及以上版本)；
Arch Linux 2020.10.01 版本

欲了解更多详细信息，请访问我们的最低系统要求计算器页面。

*自 17.6.23 版本起，不再支持 Windows XP、Windows Vista 或更低版本、Ubuntu 11.10 或更低版本、32 位 Mac OS 以及 Raspberry Pi I 设备。若您计划使用 Xeoma 的后续版本，请确保届时已升级至较新的操作系统。
**自 17.7.31 版本起，Xeoma 需要 GLIBC_2.17 或更高版本，因此建议您使用 CentOS 7 或更高版本。
***官方支持的操作系统在每次发布前均经过 Xeoma 测试。非官方支持的操作系统系应用户需求经多次成功测试验证（但并非在每次发布 Xeoma 新版本前均进行测试）

可用语言：

查看您所用语言的 Xeoma 信息

---

1.4. Xeoma 运行模式

Xeoma 提供三种运行模式：免费版、试用版和商业版（商业版细分为 Starter、Lite、Standard 和 Pro 版本）。默认情况下，下载的 Xeoma 以试用版启动，您可激活相应许可证将其切换至商业版。

详见下文关于各模式特性的说明：

免费版支持查看无限数量的视频源（摄像机），且每个方案最多可添加三个模块。最多可使用 2 个预览与归档模块（归档数据保留 5 天后覆盖），以及 2 个发送电子邮件模块。请注意：免费版不支持远程连接。请观看免费版介绍视频

试用版在功能、视频源数量或模块方面无任何限制，但所有设置将在 8 小时后重置，且程序重启后不会保存。请注意，试用版的归档存储时间仅为 1 小时，随后将被覆盖。任何版本的 Xeoma 均可连接远程服务器。您可在此处观看试用版视频。若您在购买前需要更长的测试时间，请直接联系我们获取演示许可证。

Starter版是四款商业版本中的入门之选，也是 Xeoma 的现代化极简版本，非常适合初学者及高级用户。它适用于家庭或小型企业场景，包含视频监控所需的所有核心功能与模块：支持任意设备远程访问、无限数量摄像机实时预览、单链最多 3 个模块，以及最多 2 路视频源的录像保存功能。阅读更多详情
自 2025 年 10 月起，Xeoma Starter 许可证将改为批量销售（一次性购买 100 个及以上许可证）。如需采购，请联系我们。

Lite版支持最多四个视频源（具体数量取决于您的 Lite 许可证授权数），且每个方案最多可添加六个模块。Xeoma Lite 不支持程序更新，亦不可续费。您可无限期使用激活时的 Xeoma Lite 版本。另请参阅Lite 版介绍视频或阅读更多详情

标准版对远程连接和视频源数量无任何限制。实际使用的视频源/摄像机总数取决于您的许可证。Xeoma 标准版许可证可与 Pro 许可证叠加使用。了解更多关于 Xeoma 标准版的信息 | Xeoma 标准版 PDF 演示文稿 | 标准版介绍视频

Pro 版兼具标准版的所有优势，并新增 ANPR（车牌识别）、人脸识别、烟雾检测等专业模块。Xeoma Pro 与标准版许可证可叠加使用。Pro 许可证可用于构建您的专属云解决方案。点击此处了解更多关于 Xeoma Pro 的信息

您可以通过 主菜单 -> 信息 或 主菜单 -> 信息 -> 关于 来切换模式。

Xeoma 视频监控软件版本对比表:

	试用版	免费版	入门版	轻量版	标准版	专业版
核心功能
最大可用源数量	无限制	实时预览无限制（存档为 2*）	实时预览无限制（存档为 2）	4	无限制（取决于许可证类型）	无限制（取决于许可证类型）
链中最大模块数量	无限制	3	3	6	无限制（取决于许可证类型）	无限制（取决于许可证类型）
实时预览	是	是	是	是	是	是
录像存档	是	是	是	是	是	是
存档覆盖前保留期限	1 小时	5 天	无限制	无限制	无限制	无限制
远程访问	是	否	是	是	是	是
提供多用户配置文件	是	否	否	否	是	是
支持在无界面 (no-GUI) 操作系统中运行	是	否	是	是	是	是
支持使用中继器*	是	是	是	是	是	是
运行时长	启动后运行 8 小时，随后自定义设置将被重置	无限制	无限制	无限制	无限制	无限制
可搭配附加模块使用 （需单独购买）	是 （试用期内）	–	–	–	是	是
无水印	是	–	是	是	是	是
Xeoma 新版本更新	是	是	否	否	是 (购买之日起 1 年) 可享受最高 80% 折扣以延长免费更新期	是 (购买之日起 1 年) 可享受最高 80% 折扣以延长免费更新期
自定义	是	否	是	是	是	是
其他核心功能	免费 每 8 小时或程序退出时，设置将恢复为默认值 所有功能均可测试（设置备份和附加 ANPR 除外）	免费 最多 2 个* 预览与存档模块，最多 2 个* 发送邮件模块 支持在同一台计算机上配置多用户配置文件 无限期使用，并享程序免费更新	付费模式 (需要许可证) 预览摄像头数量无限制 最多 2 个 预览与存档模块，最多 2 个 发送邮件模块 远程访问仅限管理员账户	付费模式（需要许可证） 可用模块数量有限	付费模式（需要许可证） 标准许可证可与 Pro 许可证叠加使用 所有常规模块均可用	付费模式（需要许可证） Pro 许可证与 Standard 许可证可叠加 可使用常规模块 + 专用 PRO 模块
摄像头管理
浏览器查看摄像头（Web 服务器模块）	是，1 个摄像头	否	是	是	是	是
在浏览器中更改设置	是	否	否	是	是	是
PTZ 控制	是	–	–	是	是	是
通过浏览器进行 PTZ 控制	是	–	–	–	–	是
数字变焦	是	–	–	–	是	是
PTZ 追踪	是	–	–	–	是	是
鱼眼矫正	是	–	–	–	是	是
设备列表	是	–	–	–	是	是
eMap 交互式地图	是	–	–	–	–	是
运动可视化 – 预览	是	是	是	是	是	是
多种布局	是	–	–	是	是	是
全屏模式	是	–	–	是	是	是
录像管理
按日期/时间检索录像中的运动事件	是	是	是	是	是	是
在特定区域内检索录像中的运动事件	是	–	–	–	是	是
多个存档同步回放	是	–	–	–	–	是
与摄像头 SD 卡同步	是	否	否	否	否	是
运动可视化 – 存档	是	–	–	–	–	是
支持删除存档片段	是	是	是	是	是	是
支持将存档时间段设为不可删除	是	–	–	–	–	是
模块可用性
摄像头快速开关	是	是	是	是	是	是
切换按钮	是	–	–	–	–	是
HTTP 切换器	是	–	–	–	是	是
访客计数器	是	–	–	–	是	是
徘徊检测	是	–	–	–	–	是
人脸检测	是	–	–	–	–	是
隐私遮蔽	是	–	–	–	–	是
运动检测	是	是	是	是	是	是
声音检测	是	–	–	–	是	是
烟雾检测	是	–	–	–	–	是
遗留物品检测	是	–	–	–	–	是
故障检测	是	–	–	–	是	是
物体检测	是	–	–	–	是	是
摄像头内置检测	是	–	–	–	是	是
GPIO	是	–	–	–	是	是
图像旋转	是	是	是	是	是	是
图像缩放	是	–	–	–	是	是
画中画	是	–	–	是	是	是
Unitor	是	是	是	是	是	是
发送短信	是	–	–	–	是	是
RTSP 推流	是	–	–	–	–	是
推流至 YouTube	是	–	–	–	是	是
FTP 上传	是	–	–	–	是	是
FTP 接收端	是	是	是	是	是	是
ANPR 发送至 FTP	是	–	–	–	–	是
Senstar PTZ 跟踪	是	–	–	–	–	是
移至 PTZ 预设位	是	–	–	–	–	是
Telegram 机器人通知	是	–	–	–	是***	是
保存静态图像（预览、存档）	是	–	–	–	是	是
声音报警 – 客户端	是	–	–	–	–	是
声音报警 – 服务器	是	是	是	是	是	是
HTTP 标记	是	–	–	–	是	是
应用启动器	是	–	–	–	是	是
发送电子邮件	是	是	是	是	是	是
继电器开关	是	–	–	–	是	是
HTTP 接收端	是	–	–	–	是	是
HTTP 上传至其他 Xeoma	是	是	是	是	是	是
HTTP 请求发送端	是	–	–	–	是	是
保存至文件	是	是	是	是	是	是
鸟类检测	–	–	–	–	–	是
激活与界面
客户端组件自动更新	是	–	–	–	–	是
LDAP 同步	是	–	–	–	–	是
支持在虚拟机（含 Docker）上激活	–	–	是，自 20.10.22 版本起。详情请点击 此处	是，自 20.10.13 版本起。详情请点击 此处	是，详情请点击 此处	是，详情见此处

*自 25.3.5 版本起，免费版每台服务器提供 2 个“预览与存档”模块和 2 个“发送邮件”模块。早期版本中，每种模块均为 4 个。
**Repeater 为可选服务，需单独付费购买，兼容所有 Xeoma 版本。
***Telegram 机器人通知模块最初仅在 Xeoma Pro 版本中提供，但自 Xeoma 23.1.25 及更高版本起，Xeoma Standard 版本亦可使用。

---

第二章：快速入门

2.1. 快速上手：Xeoma 使用指南

您还可观看Xeoma 视频教程

假设您需要搭建视频监控系统。您只需准备一台计算机或平板电脑、一台或多台摄像机以及待监控区域。Xeoma 是您的理想之选，它兼容各类摄像机（支持数百种型号），并可在多种操作系统上运行。以下是简易部署步骤。

1. 下载 Xeoma：请访问我们的网站，下载适用于您操作系统的版本。您可选择正式版或 Beta 版（通常更新且同样稳定，但仅经过 Alpha 测试）。针对您当前访问设备推荐的 Xeoma 版本显示在下载选项表上方。若不确定该选哪个版本，请直接在此设备上试用该推荐版本。
Xeoma 由服务器端和客户端两部分组成——下载的可执行文件同时包含这两部分（iOS 和 Linux/ARM 除外）。运行或安装 Xeoma 时，您可以将这两部分分离。

对于具有图形界面的操作系统：

对于控制台（请记得在下载后解压压缩包）：

2. 在将作为服务器（视频监控系统的中心枢纽）的计算机、移动设备或平板电脑上启动 Xeoma。服务器将处理摄像头及其他信源、保存录像等。如果 Xeoma 尚未激活（包括首次启动时），将以试用模式启动。您可以通过主菜单在免费模式、试用模式和商业模式之间切换。启动与安装故障排除

对于具有图形界面的操作系统：直接点击或双击 Xeoma 可执行文件（如果是压缩包，请确保已解压）。

对于控制台：
直接将 Xeoma 可执行文件拖入控制台/命令行/终端，或将 Xeoma 可执行文件的路径复制并粘贴到控制台/命令行/终端，或者手动输入该路径，然后按“Enter”键：

注意：如果后续您仅需要启动服务器部分，请在按“Enter”键前添加 -core 参数。如果您仅需要启动 Xeoma 的客户端部分，请在按“Enter”键前添加 -client 参数。

注意：使用控制台命令 “-programdir [DirPath]”，您可以设置首次启动时解压 Xeoma 文件的目录。

提示： 若需在无图形界面的操作系统上运行，请参阅我们的控制台指南。

3. 首次启动 Xeoma 时，您首先会看到欢迎窗口。其中包含程序初始设置所需的关键操作选项：

• 安装为自启动。 此选项将 Xeoma 设置为开机自启，使程序随操作系统启动而自动运行。若您希望监控软件对其他用户隐藏运行，请在安装菜单中勾选“隐藏模式”。
• 无需安装直接运行：在网络中查找摄像头。 点击即可手动启动本地网络摄像头搜索并开始监控。
• 演示。 启动演示摄像头。用于测试 Xeoma 的功能与性能。
• 连接到远程服务器或云端。 点击即可连接服务器，实现随时随地远程查看摄像头，或接入 Xeoma Cloud 监控服务。

点击右上角的"X"图标即可关闭欢迎窗口，随后进入主菜单执行其他操作。您也可通过“主菜单”>“信息”>“帮助”再次调出欢迎窗口。

4. 首次启动 Xeoma 时，系统会自动扫描网络以搜索摄像头。所有被发现的摄像头都将添加至主窗口；需要授权而暂时无法添加的摄像头将列于下方面板的"+"菜单中，您只需从中选择并输入相应的访问凭据即可添加。搜索过程中您可继续其他操作。若扫描耗时过长或所有摄像头已添加完毕，点击右下角的扫描进度条即可停止搜索。了解更多关于自动搜索的信息。

若通过控制台/cmd/终端运行 Xeoma，可使用 -noscan 命令禁用启动时的自动扫描（而 -noscanptzandaudio 命令仅禁用音频流搜索及 PTZ 摄像头的云台控制指令扫描）。控制台命令完整列表

默认情况下，所有检出的摄像头将按以下默认方案添加：通用摄像头 – 计划程序 – 运动检测器 – 预览与存档 – 故障检测器 – 电子邮件发送模块（采用默认设置）。Lite 和 Free 版本除外，由于单条链中的模块数量有限制，其默认链为：通用摄像头 – 运动检测器 – 预览与存档。您可以根据需求添加、删除或重新配置模块。详细了解模块与链的工作原理

• 通用摄像头：选择图像分辨率和刷新间隔（适用于 USB 摄像头），或选择具有预设参数的流（适用于网络摄像头）。模拟摄像头将根据连接方式被识别为 USB 或 IP 摄像头。更多关于配置摄像头的信息
• 运动检测器：选择一个或多个监测区域以检测运动，并设置录像缓冲时间和传感器灵敏度。
• 计划程序：设置后续模块的工作日期和时间。默认设置为 24/7 全天候工作。
• 预览与存档（或简称“存档”）：您可以指定视频保存位置、存储时长（过期录像将被删除）以及存档允许占用的最大磁盘空间。默认存储时长为一小时。

5. 如需查看存档录像，请点击主窗口中摄像头图像右上角的“播放”按钮，或点击底部面板的大型“播放”按钮。这将打开内置的存档播放器，您可以在其中回顾并导出录像。

6. 自定义模块、摄像头和链设置以实现所需功能。尝试使用智能模块、视频分析和基于人工智能的附加模块。您可以创建用户配置文件以授予员工查看/管理权限，并使用其他多种实用功能。

7. 购买并激活 Xeoma 许可证，以启用具备完整功能的持续运行模式。没有互联网？没问题：Xeoma 可以在无需访问全球网络的情况下激活。离线激活指南

2.2. Xeoma 主窗口界面

2.2.1. Xeoma 主窗口界面

主程序窗口包括操作系统的窗口标题/标题栏 (1) 和程序界面——预览框 (2)（来自摄像头和其他信号源的实时图像）以及预览框下方的状态栏 (3)。窗口标题通常包含所使用的 Xeoma 版本 (4)、运行模式 (5) 以及当前所在屏幕的名称 (6)。连接到远程服务器时，您还可以在窗口标题中看到服务器的 IP 地址；如果客户端版本与服务器不匹配，则还会显示客户端版本。

标题栏包含常规控制按钮：“最小化”、“最大化”、“关闭”。可通过鼠标拖动标题栏来移动窗口位置。可通过拖拽任意边缘或边界来调整窗口大小。

每个预览框的右上角都有小型存档 (7) 和设置 (8) 图标，点击相应图标即可进入存档查看器或对摄像头（信号源）进行详细配置。如果摄像头支持 PTZ 控制，则会与上述两个图标一起显示一个小型的 PTZ 图标。

在右上角的存档和详细设置图标下方，您将看到最后一次存档记录的时间 (9)（若链路中包含运动检测模块，此时间将显示最后一次检测到运动并完成存档记录的时刻）。点击该时间可立即回放事件——直接在时间轴的对应位置打开存档。此外，存档录制期间，预览框边框将变为红色；停止录制时，红框随即消失。若当前正在录制存档，您将看到红色"•Rec"标识；否则该标识不显示。

预览框左上角显示预览名称 (11)，该名称可在“通用摄像机”模块设置中配置；组名则可在“预览和存档”模块中指定。点击此处名称即可打开设置。

点击预览框图像（框内任意位置）(12)，即可快速查看各预览框的设置概览。

主预览窗口下方的弹出栏包含以下按钮：“主菜单”、“加号”、“扳手螺母”、“播放”、“布局”。向下拖动可隐藏该栏，向上拖动或直接点击即可显示。

• “主菜单”为菜单图标。其选项随当前所在屏幕而异。在实时视图界面中，它将打开一个对话框，允许您

– 配置远程访问选项（包括中继器和用户配置文件设置），

– 启用/禁用设备列表（摄像机组），

– 关闭并重新开启所有信号源，

– 安装或卸载程序以实现开机自启（含隐藏模式），

– 在“注册”菜单中激活许可证，

– 查询程序信息与您持有的许可证，打开 Xeoma 视频教程，在试用版/免费版/商业版之间切换，提交反馈或访问开发者官方网站等，

– 切换语言。

• “加号”按钮用于添加新摄像机。若局域网内已检测到摄像机，它们将直接显示在此菜单中供添加；若未检测到，您可选择添加随机全球摄像机、复制上一个方案、重新扫描摄像机，或使用高级搜索（需输入登录名、密码、子网信息或摄像机端口）。

此外，您可在此复制最后查看的摄像机——当需要快速克隆设置几乎相同的复杂方案时，此功能尤为实用。您也可通过"+"菜单手动添加摄像机（指定其 URL）

• “扳手螺母”图标与预览框右上角的设置符号功能相同——此处用于进入最后查看摄像机的“详细设置”，并以可视化方式配置所有功能。

• 底部面板中的“播放”按钮与预览框右上角的存档符号功能类似——此处用于打开对话框，选择您要查看的摄像机存档记录。选定后将启动存档查看器，您可在此查看所有由“预览和存档”模块生成的记录，并导出指定格式的片段。

• “布局”是控制 Xeoma 界面显示的菜单。详见布局菜单。

提示： 另一种便捷控制和分组摄像机的方法是通过 设备列表。

提示： 自 Xeoma 23.12.7 版本起，所有含子菜单的菜单项均标有白色箭头。无箭头的项则将直接打开对话框或执行启用/禁用操作。

---

2.2.2. “快速设置”窗口界面

快速设置界面包含一个侧边弹出面板，列出了该摄像机当前启用的功能，并配有复选框以便快速开启或关闭。点击模块名称即可在该窗口中直接打开并配置其设置。使用箭头可在不同链（摄像机）之间切换。

与主窗口界面相比，快速设置的底栏增加了以下额外图标：“箭头”、“红叉”、“翻转” 和 音量（可选：截屏 图标——如果您已在主菜单中将其设置为按钮）。

点击 “翻转” 即可激活直观的 PTZ（云台-倾斜-变焦）控制，用于旋转及缩放您的 PTZ 摄像机。
只有当 Xeoma 检测到摄像机支持 PTZ 指令时，才会显示该图标和控制面板。

PTZ 控制的内容取决于摄像机类型和您的许可证。
对于不支持 ONVIF 的摄像机，您将看到仅包含缩放图标 (3) 的基础控制面板：

对于符合 ONVIF 标准的摄像机，界面还将额外显示两个用于调整摄像机焦距的缩放按钮 (4)；若服务器持有有效的 Xeoma Pro 许可证，还会显示 PTZ 预设按钮 (1) 和 PTZ 巡航按钮 (2)，以及用于控制红外补光、雨刮器等摄像机设备的附加选项图标 (5)：

深入了解 Xeoma 中的云台-倾斜-变焦 (PTZ) 功能

“箭头” 用于返回上一个窗口，在本例中为预览窗口（主窗口）。

“红叉” 将删除当前摄像机及其连接的所有模块（整个链）。请注意，此操作不可撤销。

点击 “音量” 激活音量控制并调节声音大小。截屏 功能与“截屏”菜单选项一致：即时捕获当前摄像机图像，并保存至您可自定义的默认文件夹。

---

2.2.3. “详细设置”窗口界面

详细设置窗口的底栏与之前屏幕的底栏一致。

模块 是助力 Xeoma 视频监控系统发挥极致效能的功能组件。得益于积木式架构，您可以自由组合。

顶栏 列出可用模块及预设示例链，其下方为 工作流程图。左侧箭头用于返回进入详细设置前的上一界面，“眼睛”图标则可直接跳转至主窗口。

• 要将模块添加至流程图，请将其拖拽到该区域。
• 要连接模块，请将一个模块拖放到另一个模块上，或者从一个模块向另一个模块拖动连线。
• 要删除模块之间的连接，请点击该连线。
• 要调整模块顺序，只需将模块拖至另一连接点即可。

要配置模块，请在工作流程图区域内点击该模块。

注意：仅当所选的所有模块均已通过白线连接时，方案方可生效。若模块间以灰线连接，则表示其中某个模块已关闭，其后的所有模块均无法接收来自该模块的图像。

通常，每个方案的运行至少需要 2 个模块：1 个源模块和 1 个任意类型的目标模块。

例如，默认方案为：通用摄像机 -> 计划任务 -> 移动侦测 -> 预览与归档。不过，您可以根据具体目标构建更复杂的方案。
模块详细设置中的 “打开组设置”选项，可将组设置统一应用于所有同类模块（如所有“移动侦测”或“预览与归档”模块），从而极大简化多摄像机的快速配置流程。

---

2.2.4. 模块设置窗口界面

要打开模块设置，您可点击“快速设置”界面左侧面板中的模块名称，或点击“详细设置”工作区中的模块图标。
不同模块的设置项各不相同，但部分基础元素是通用的。

(1) – 当前设置模块的图标。点击可查看该模块的功能说明。
(2) – 模块状态：启用、禁用（或过滤模块特有的“忽略”状态，20.10.13 之前版本称为“跳过”）。启用：模块正常运行，并将信号通过白线传递至后续模块。禁用：模块已禁用，信号无法传递至后续模块。忽略（20.10.13 之前版本称为“跳过”）：模块被忽略，信号将直接穿过，如同方案中不存在该模块。
(3) – 摄像机图像，并显示“已触发”或“未触发”文本（20.10.13 之前版本为“跳过”或“未跳过”）。
(4) – 部分模块的特定设置隐藏在“高级设置”链接下，通常为无需人人掌握的专业复杂配置。点击即可展开模块的高级设置。
(5) – 回收站。点击即可删除该模块。
(6) – 信息图标。点击即可查看该模块的功能详情。
(7) – 大"X"按钮为“取消”按钮。点击将放弃本次在设置窗口中所做的所有更改。
(8) – 大对勾按钮即“确定”按钮。点击后，Xeoma 将确认并保存本次在设置窗口中所做的更改。
(9) – 组设置（如适用）：此选项位于模块设置窗口顶部，可将更改批量应用于部分或全部同类模块，便于快速配置大量同类型模块。

---

2.3. 模块与链的工作原理

2.3.1. 链的工作原理

另请观看视频：Xeoma 模块及模块系统详解

链路运行基于模块的逻辑顺序连接原则：
信号源（音频、视频或二者兼具）+ 可选过滤模块（检测器）+ 目标模块（通知、录像等）。

通常，一条链路至少需要 2 个模块才能运行：1 个视频源模块和 1 个目标模块。例如：通用摄像机 -> 预览与存档。这将实现持续录像。您也可以根据任务创建更复杂的方案。例如：通用摄像机 -> 时间表 -> 移动检测器 -> 预览与存档。在此示例中，来自摄像机的视频流首先经由时间过滤：若当前处于“允许”时间，视频流将沿链路传输至移动检测器，并检测是否符合预设条件（如是否存在移动、是否满足强度、目标大小等条件）。如果视频流满足所有经过的过滤模块条件，则进入目标模块。

虽然在大多数情况下至少需要一个目标模块（例如使用“预览与存档”模块录制视频流），但也存在无需目标模块的例外情况：例如，您仅需显示信息（如屏幕上的越线检测）并保存报告，而无需保存摄像机录像。即便如此，在此类情况下，仍建议使用能终结链路的模块——即 Preview（预览）模块。

注意：模块之间处于工作状态的连接线（连线）为白色。如果连接线及后续模块显示为灰色，则表示前一模块拦截了图像。

摄像机没有图像？请参阅此处和此处的故障排除指南

2.3.2. 链路分支与模块并行运行
信号沿链路传输时，可能会遇到链路分叉为多个分支的情况。若后续模块已启用并运行，数据流将流经所有此类“分叉”。
一个典型示例是添加新摄像机时创建的默认链路：Universal Camera – Motion Detector – Preview and Archive，同时还有 Universal Camera – Problem Detector – Email Sending。在此链路中，信号将同时通过多个分支——从一台摄像机出发，经过过滤模块，最终进入各分支的目标模块。

链路中包含多个目标模块（如写入存档、发送电子邮件通知、发出声音信号等）也是一种标准情况

闭合分叉。 此外，还可能出现链路分叉为多个分支后，再次汇合至同一个目标模块的情况。此时，进入该目标模块的信号遵循“或 (OR)"逻辑。举例来说：使用 Motion Detector 时，您可能需要设置多个监控区域，且每个区域的设置各不相同（！）。例如，摄像机“视野”的某一部分需要比另一部分具备更高强度和更长时间的运动监控。尽管 Motion Detector 进行了分叉，但您仍希望将所有事件记录到同一个存档中。此时，链路分叉为两个具有独立设置的 Motion Detector，随后汇合至一个存档。只要其中至少 1 个检测器触发了满足其设定条件的运动事件，系统便会保存记录。

注意！将多个分支汇合至同一个模块时请注意：若某一时刻信号同时从多个分支到达，则只有最早启动的那个信号会被写入该模块。如果您后续需根据这些特性搜索存档，这一点至关重要。

---

2.4. 摄像机自动扫描与搜索

注意：本节适用于向独立版 Xeoma 系统添加摄像机。若您想了解如何将摄像机连接至 Xeoma Cloud，请点击此处

2.4.1. 首次启动 Xeoma 时的演示摄像机与摄像机搜索

首次启动 Xeoma 视频监控软件时，您将看到欢迎窗口。该窗口提供两个与摄像机相关的操作选项：

• 免安装运行：在网络中查找摄像机；
• 演示。

关闭欢迎窗口后，后续启动 Xeoma 时将不再显示。更多摄像机添加与配置选项位于主窗口底部面板的"+"菜单中，详见 2.4.2 节及后续内容。

免安装运行：在网络中查找摄像机

这将启动对本地网络的自动扫描以查找可用摄像机（亦称“简单搜索”）。无需指定摄像机型号。

所有无需密码或使用标准凭据的已发现摄像机，都将通过默认模块链添加至主窗口。

Xeoma Pro 试用版（首次启动时自动激活）的默认链包括：通用摄像机 — 调度器（配置为全天候运行）— 运动检测器（限制最少）— 预览与归档（1 小时后覆盖），并并行运行故障检测器和邮件发送（需配置）。

已发现的摄像机将以适用于大多数情况的默认链和默认设置添加。您可以根据需要添加、删除或重新配置模块。

受密码保护的摄像机不会被添加到主窗口，而是列在底栏的“+” 菜单中。您可以选择该摄像机并在弹出的窗口中输入凭据将其添加。“+”菜单还提供“添加下方所有摄像机”选项，可将所有发现的摄像机批量添加到主窗口。对于需要授权的摄像机，您需要在“通用摄像机”模块的设置中输入用户名和密码。

连接至 DVR 的摄像机通常无法通过简单搜索发现。建议通过输入流 URL 手动添加。

注意： 若通过自动搜索添加新摄像机导致 CPU 负载过高，系统将发出高负载警告，且随后发现的摄像机将不再自动添加至主窗口。您可在"+" 菜单中找到这些摄像机，并点击列表项手动添加。

演示

此选项将添加一台演示摄像机，供您测试 Xeoma 的各项功能。选择该选项后，主窗口将打开并加载 Trial/Xeoma Standard/Xeoma Pro 版本的默认模块链：通用摄像机 — 调度器（配置为全天候运行）— 运动检测器（限制最少）— 预览与归档（1 小时后覆盖），并并行运行故障检测器和邮件发送（需配置）。

该模块链采用适用于大多数场景的默认设置。您可根据需要添加、删除或重新配置模块，以更全面地探索 Xeoma 的功能。

欢迎窗口仅提供上述两个与摄像机相关的选项。主窗口底部面板的"+"菜单包含更多摄像机添加与配置选项，详见 2.4.2 及后续章节。

2.4.2. 简单搜索本地摄像机

在"+" 中选择“简单搜索本地摄像机”，将启动对本地网络可用摄像机的自动扫描，无需指定摄像机型号。此功能与 Xeoma 首次启动时欢迎窗口中的 “无需安装即可运行：查找网络中的摄像机” 选项完全一致。

注意： 您可添加的摄像机数量取决于 Xeoma 许可证及模式允许的上限。

所有无需密码或使用标准凭据的已发现摄像机，都将通过默认模块链添加至主窗口。

Xeoma Standard、Xeoma Pro 及其试用版的默认链路：通用摄像机 — 计划任务（配置为全天候运行） — 运动检测（限制最少） — 预览与归档（1 小时后覆盖），同时并行运行故障检测与邮件发送（需配置）。

免费模式和 Xeoma Lite 的默认链：通用摄像机 — 运动检测器 — 预览与归档。

搜索到的摄像机将以适用于大多数场景的默认链和默认设置添加。您可以根据需要添加、删除或重新配置模块。

受密码保护的摄像机不会直接添加到主窗口，而是列在底部面板的“+” 菜单中。您可以选中摄像机并在弹出的窗口中输入凭据将其添加。“+” 菜单还提供“添加下方所有摄像机”选项，可将所有搜索到的摄像机批量添加到主窗口。对于需要授权的摄像机，您需要在“通用摄像机”模块的设置中输入用户名和密码。

通过 DVR 连接的摄像机通常无法通过简易搜索发现。建议通过输入其流 URL 手动添加。

注意： 若自动搜索添加新摄像机导致 CPU 负载过高，系统将发出高负载警告，随后发现的摄像机将不再自动添加至主窗口。您可在"+" 菜单中找到它们，并在列表中点击以手动添加。

2.4.3. 通过 IP / 密码搜索

若摄像机位于 Xeoma 服务器本地网络之外，请使用"IP/密码搜索外部摄像机”功能。从"+"菜单中选择"IP/密码搜索”选项。系统将打开对话框，您需在其中输入摄像机的已知信息（外部 IP 地址、认证凭据、目标流端口）。虽非必填所有字段，但建议尽量完善以提高搜索成功率。点击“确定”后，系统将自动扫描指定地址；若成功，发现的摄像机将添加至主窗口。

支持通过 IP/密码批量搜索摄像机列表。在相应字段中输入多个地址、端口或密码（以逗号、空格等分隔），系统将对所有条目执行搜索。所有符合条件的摄像机均会被添加。

通过 DVR 连接的摄像机通常难以发现。此时，建议通过输入其流连接字符串手动添加。请参阅下文 2.4.4. 手动添加摄像机

2.4.4. 手动添加摄像机

若已知目标摄像机流的准确 URL，可手动添加摄像机。为此，请在"+"菜单中选择“手动添加新摄像机”选项。系统将自动添加标准链，但不会应用通用摄像机设置。通用摄像机设置对话框将立即打开，您可在此输入预览流 URL 和/或直接归档流 URL。

2.4.5. 通过复制添加摄像机

您可以使用“+”菜单将已配置的摄像机复制到其他链中。如果摄像机的 URL 相同，仅在 IP 地址的一两位数字上有所区别，您可以复制链并仅在新链中更改这几个数字，而无需逐个手动添加所有摄像机。所有其他设置将与您复制的源链保持一致。

复制链详解

2.4.6. 通过 POST 请求添加摄像机（仅限 Xeoma Pro）

如果您需要在不启动客户端的情况下向程序添加摄像机，可以通过发送 POST 请求，根据预配置模板添加链：

{
“template”: “FileName”
}

发送到地址 http://IP:Port/api?add=&login=ADMLOG&password=ADMPAS

请将 IP、Port、ADMLOG 和 ADMPAS 替换为服务器的真实 IP 地址、端口号，以及 Xeoma 管理员账户的登录名和密码。

请将模板文件置于"ChainTemplates"文件夹中，该文件夹应位于服务器端 Xeoma 的工作目录内（与 Additional、XeomaArchive 文件夹同处）。

模板文件须包含链描述，格式需与云端用户配置文件一致（参见用户配置文件中的"Default cameras config"）—— 请参阅此处示例（详情点此）。
 

2.4.7. 通过列表批量添加/删除摄像机

自 25.7.9 版本起，Xeoma 支持通过列表批量添加或删除摄像机。

如何批量添加摄像机：
在底部图标面板的"+"菜单中，找到“通过列表批量添加/删除摄像机”选项。点击该选项打开新对话框，输入待添加的摄像机列表。选择执行操作：删除或添加。选定“摄像机添加模式”后，在“以 JSON 格式创建列表”下方的专用字段中输入列表。列表必须为 JSON 格式。如需了解正确语法及必填参数，请点击“添加摄像机示例”，系统将显示 Xeoma 提供的样例至摄像机列表字段。注意：样例将覆盖该字段内的现有内容。

列表编辑完成后，点击确定（勾选）按钮。

操作一旦启动即无法撤销。如需更改，请还原设置备份，或手动删除新增摄像机，亦或使用批量删除功能。

如何批量删除摄像机：
新的“通过列表批量添加/删除摄像机”选项同样可用于批量删除摄像机。
同理，点击底部图标面板中的"+"，选择“通过列表批量添加/删除摄像机”，并选择“摄像机删除模式”。在下方字段中输入需从 Xeoma 删除的摄像机列表。列表必须为 JSON 格式。如需了解正确语法及必填参数，请点击“添加摄像机示例”，系统将显示 Xeoma 提供的样例至摄像机列表字段。注意：样例将覆盖该字段内的现有内容。

列表编辑完成后，点击确定（勾选）按钮。

操作一旦启动即无法撤销。如需更改，请还原设置备份，或手动重新添加已删摄像机，亦或使用批量添加功能。
 

2.4.8. 添加新摄像机的模块链示例

从 Xeoma 21.3.4 版本开始，我们增加了修改 Xeoma 中所有新摄像机默认模块链示例的功能。新方案在 DefaultChain.txt 文件中设置——此处定义了新默认模块链的示例。请将此文件放置在 程序目录 的 ChainTemplates 文件夹中。Xeoma 启动时，服务器将检查该文件是否存在：如果存在，则所有摄像机都将按照该文件中指定的模块链示例进行添加。

DefaultChain.txt 文件内容示例：

chain1.UniversalCamera1=
chain1.MotionDetector2=
chain1.MotionDetector3=
chain1.Preview+Archive4=
chain1.WebconnectorTransmitter5=
chain1.HttpRequestSender6=
chain1.UniversalCamera1.connected=WebconnectorTransmitter5
chain1.UniversalCamera1.connected=MotionDetector2
chain1.MotionDetector2.connected=Preview+Archive4
chain1.UniversalCamera1.connected=MotionDetector3
chain1.MotionDetector3.connected=HttpRequestSender6

根据上述数据，您将为添加新摄像机创建如下模块链示例：

列出所需的模块并根据实际需求将其连接。

请在 此处 查看 Xeoma 模块名称。关于模块间连接及其语法的详细信息，请点击 此处。

如此一来，Xeoma 的模块链配置将变得更简单、更快速！

---

2.5. 布局菜单

底部菜单面板中有一个窗口图标。这就是负责 Xeoma 视觉呈现的“布局”菜单。您可以使用它来配置显示的摄像机数量、摄像机网格、界面透明度，以及交互式地图 (eMap) 和解码设置。

下文详细介绍了该菜单默认提供的所有参数，包括简短说明以及必要时的相关子章节链接。
 

“布局”菜单默认参数

如果您此前未操作过“布局”菜单及其 标签页（详见后文），将直接显示下方列出的菜单选项。若您已操作过，菜单选项将略有不同——我们将在相关章节中探讨（并请记得检查配置 标签页 后出现的额外显示参数）：

返回 (点击此处查看详情)

点击“返回”以回到上级菜单。

拉伸：选择摄像机 (点击此处查看详情)

另请参阅 2.5.2. 消除空白边框
“拉伸”选项提供多种将摄像机图像适配至插槽的方法，以消除侧边黑边。通常情况下，点击摄像机会在单台摄像机预览与全屏所有摄像机预览之间切换。
选择“拉伸”选项将激活拉伸模式。激活后，点击摄像机会改变图像填充指定插槽的方式。多次点击将在 原始模式（带黑边）与另外两种模式之间切换：“拉伸”模式和“适应”模式。拉伸 会确定最大维度（通常为宽度）并使其适配插槽长度，而较小维度（通常为高度）将被拉伸以填满插槽高度。“适应” 方法则确定较小维度（通常为高度）并使其适配插槽高度——图像宽度也将随之增加并填充插槽，从而导致图像部分区域被裁剪。

您可以使用此方法单独拉伸摄像机。如需拉伸所有摄像机，请参考下方的“拉伸：所有摄像机”选项。

拉伸：所有摄像机 (点击此处查看详情)

另请参阅 2.5.2. 消除空白边框
“拉伸”选项包含多种将摄像头图像适配至插槽的方法，以消除侧边黑边。选择“拉伸：所有摄像头”可拉伸屏幕上所有摄像头的图像。
点击此方法后，将显示以下选项：
–返回
–自动
–原始
–拉伸
–适应

原始方法意味着图像不会被拉伸（通常会导致出现侧边黑边）；
拉伸依据最大维度（通常为宽度）进行适配以填满插槽长度，而较小维度（通常为高度）则会被拉伸以填满插槽高度；
适应依据较小维度（通常为高度）进行适配以填满插槽高度——图像宽度也会相应扩大以填充插槽，导致部分图像被裁切而不显示；
自动模式允许 Xeoma 自动从上述列表中选择最理想的拉伸选项。

请注意，此参数将配置屏幕上的所有摄像头。您可以在同一菜单中选择其他选项。如果您只想拉伸特定摄像头，建议使用上述“拉伸：选择摄像头”选项。

大网格模式 （点击此处了解详情）

此选项可为您最关键的摄像头分配更大的插槽。您可以设置显示多少个放大插槽、如何定义“关键”摄像头，以及此类摄像头在消失或被替换前在屏幕上停留的时长。
如需了解此功能及“大网格模式”菜单中的所有选项，请参阅 2.5.4. 大网格模式章节。

存档与录像：操作 （点击此处了解详情）

此选项需要服务器安装 Xeoma Pro 许可证。启用后，可用于指定在预览摄像头图像时点击“播放”（存档）按钮的操作。默认情况下，此操作将为所选摄像头打开独立的存档查看器，但您可以将其更改为在预览插槽中直接打开查看器，而非显示实时流。与常规存档查看器类似，摄像头的预览流将在后台模式下继续正常运行。

“存档与录像：操作”菜单子选项：
–返回
–打开所选摄像头的存档（绿色高亮显示为默认选项）
–在显示其他摄像头实时视图的同时显示所选摄像头的存档

导出页面 （点击此处了解详情）

此选项允许您保存 Xeoma 设置副本。该副本随后可通过“导入页面”选项（详见下文）上传至同一台或另一台 Xeoma 服务器。
有关标签页及其副本的更多信息，请参阅 2.5.1. 标签页

导入页面 （点击此处了解详情）

此选项允许您上传之前通过“导出页面”选项从当前或另一台 Xeoma 服务器（Xeoma Cloud 用户为 Cloud 账户）导出的标签页设置。
有关标签页及其副本的更多信息，请参阅 2.5.1. 标签页

布局：所有摄像头 （点击此处了解详情）

创建所需 标签页并为每个摄像头分配后，“所有摄像头”标签页通常变得不再必要且需要隐藏。“布局：所有摄像头”选项旨在恢复此标签页：它将显示您连接到 Xeoma 的每一个摄像头。
有关标签页的更多信息，请参阅 2.5.1. 标签页

布局：自定义 （点击此处了解详情）

此标签页管理选项用于将特定摄像机单独放置在标签页中，不同于其他自动分配摄像机的类似选项。您可以通过预览（“新建标签页（按摄像机预览选择）”子选项）或通过地址（“新建标签页（从摄像机列表选择）”子选项）来选择要显示的摄像机。

“布局：自定义”菜单子选项完整列表：
–返回
–新建标签页（按摄像机预览选择）
–新建标签页（从摄像机列表选择）
有关标签页的更多详情，请参阅 2.5.1. 标签页

布局：设置自定义网格 (点击此处查看详情)

此标签页管理选项旨在创建自定义网格，而非使用下方列出的默认设置（如“布局 1×1”等）。点击此选项后，将弹出设置对话框，您可以通过点击微型槽位或直接输入所需的横向和纵向槽位数来定义自定义网格。
有关标签页的更多详情，请参阅 2.5.1. 标签页

布局 1×1 (点击此处查看详情)

此标签页管理选项用于选择预设的摄像机网格（例如，“布局：1×1”表示横向显示 1 台且纵向显示 1 台，即每页仅 1 台摄像机；“布局 2×1”表示横向显示 2 台且纵向显示 1 台，即每页 2 台摄像机）。该选项会自动创建包含所有摄像机的标签页并保持其原始顺序，且每个标签页均采用您选择的网格（唯一例外是最后一个标签页，如果摄像机数量不足以填满整个网格，则显示数量较少）。此选项通常与“布局：自定义”和“布局：设置自定义网格”不兼容。网格选项取决于主窗口中显示的摄像机数量。如果仅有一台摄像机，则不显示这些选项。有关标签页的更多详情，请参阅 2.5.1. 标签页。

布局：2×1 (参阅 布局：1×1)
布局：1×2
布局：3×1 以及根据您的摄像机数量而定的其他选项。

在断开连接的摄像机上显示红色叉号 (点击此处查看详情)

此选项用于在摄像机停止工作且无法实时显示视频时提醒您。当屏幕上显示大量摄像机且槽位较小时，图像冻结很难被察觉，此时该功能尤为有用。选择此选项后，一个大的红色叉号将覆盖在静止的预览图上。激活后，菜单中的此选项将变为“不在断开连接的摄像机上显示红色叉号”，以便您可以取消覆盖。另请参阅 2.5.7. 界面增强

隐藏断开连接的摄像机 (点击此处查看详情)

此选项允许您隐藏突然停止工作（即流丢失或冻结）的摄像机。当 Xeoma 用于演示目的且视觉呈现比摄像机状态更重要时，此功能非常有用。我们建议在视频监控系统中不要选择此选项：摄像机故障可能会危及人员安全或阻碍您的监管工作。在视觉上，Xeoma 不会通过任何元素提示已启用“隐藏断开连接的摄像机”模式。
激活后，菜单中的此选项将变为“显示断开连接的摄像机”，用于取消之前的选择。

注意：此选项的功能与“在断开连接的摄像机上显示红色叉号”选项冲突。如果您已隐藏断开连接的摄像机，菜单中将不再出现“在断开连接的摄像机上显示红色叉号”选项！

如果您之前配置了标签页，则“布局”菜单中会出现以下选项：
隐藏页面面板
自动滚动
隐藏“所有摄像机”标签页
显示未分配的摄像机

您可以在2.5.1. 标签页中详细了解标签页及相关的标签页管理选项。

 

b) “窗口设置”选项
此选项包含所有用于管理 Xeoma 视觉效果的工具：透明度、边框、界面缩放、控件自动隐藏等。具体包含以下子选项：

最大 FPS (点击此处查看更多详情)

允许降低 Xeoma 界面（而非摄像机！）的 fps（每秒帧数）。该选项默认状态为“无限制”，意味着界面帧率将与摄像机的最大 fps 一致。最低可调至“1 分钟”，即每分钟 1 帧。

摄像机名称字体大小 (点击此处查看更多详情)

允许更改主窗口和快速设置窗口中显示摄像机名称（在“通用摄像机”、“预览与存档”或“预览”中选择）的字体大小。可用尺寸范围为 10 pt 至 36 pt。默认大小为 12 pt。
有关摄像机名称的更多内容，请参阅 2.10 “在预览中更改摄像机名称”。

界面缩放（原尺寸百分比） (点击此处查看更多详情)

您可以配置此参数来放大或缩小 Xeoma 的元素（如图标、文本、箭头等）。此功能在移动设备上尤为实用：尽管 Xeoma 根据屏幕分辨率拥有自动缩放算法，但控件可能仍然太小，难以准确点击。可用缩放范围从 50%（将标准界面缩小至原尺寸的一半）到 400%（将其放大四倍）。默认大小为 100%。

开启透明度 (点击此处查看更多详情)

切换此开关将激活半透明窗口模式 —— Xeoma 界面将变为半透明，您可以透过 Xeoma 看到其他窗口、桌面等。当您需要同时运行 Xeoma 并执行其他操作（例如观看视频）时，此功能非常有用。
开启开关（显示为蓝色）后，您可以将界面透明度设置为 0%（不启用透明度）至 50%（半透明）。
如果将透明度级别保持为 0，此功能将不会应用于 Xeoma。
如果“开启透明度”开关被禁用，此功能将不会应用于 Xeoma。
该选项默认禁用。

启用控件透明度 (点击此处查看更多详情)

此选项使 Xeoma 设置对话框变为半透明，以便您在配置其他选项时仍能看到摄像机画面。
如果开关关闭（显示为灰色），菜单和对话框将不透明。
此选项默认开启。它可以与下文描述的“启用控件模糊”选项协同工作。

启用控件模糊 (点击此处查看更多详情)

如果启用了前一项“启用控件透明度”选项，您可以为界面添加“磨砂玻璃”效果，使背景画面轻微模糊。
此选项默认启用。如果“启用控件透明度”开关关闭（显示为灰色），则无法激活此项。

置顶显示 (点击此处查看更多详情)

此选项旨在赋予 Xeoma 窗口最高优先级，使其始终置顶显示在设备的所有其他窗口之上。只有手动最小化 Xeoma 窗口才能看到其他窗口，按下 Tab 键或其他操作均无效。当您或操作员需要优先关注 Xeoma 而非其他应用程序，或需要完全禁止与 Xeoma 以外的窗口交互时，此模式非常实用。该选项默认禁用。
为了进一步提升效率，您可以将此选项与“全屏模式”结合使用——在这种情况下，Xeoma 窗口将无法被最小化。

全屏模式 (点击此处查看详情)

将此开关切换至“开启”，Xeoma 将立即扩展至全屏。包括最顶层工具栏在内的所有窗口栏都将消失，且窗口本身无法缩小。此功能适用于 Windows、Linux 和 Mac OSX 等操作系统的 Xeoma 版本，不适用于 Android——建议 Android 用户使用“显示窗口边框”选项。该选项默认禁用。
与“始终置顶”结合使用时，Xeoma 窗口将无法被最小化。

无操作时自动隐藏控件 (点击此处查看详情)

当用户在一段时间内无操作时，此选项将自动隐藏 Xeoma 界面的箭头和面板（隐藏元素包括录像回放控件、主菜单底部面板、模块面板等）。任何用户操作（如移动或点击鼠标）都将使面板和其他元素重新显示。该选项默认启用。

显示窗口边框 (点击此处查看详情)

将开关切换至“开启”（蓝色高亮）以激活此选项，操作系统为 Xeoma 分配的边框将消失。与“全屏模式”不同，此选项不会改变窗口大小，且适用于 Windows 和 Android 版本的 Xeoma。
该选项默认禁用。

—
在对话框的最底部，您可以找到关于如何重新排序摄像头的提示。
 

c) “可视化设置” 选项
此菜单包含与视觉叠加层及 Xeoma 界面显示相关的各项参数：例如，文字标注或移动目标的视觉化显示。此菜单提供以下选项：

返回 (点击此处查看详情)

点击“返回”以回到上级菜单。

显示摄像头信息 (点击此处查看详情)

点击此菜单项以：
–显示摄像头存档流的信息（分辨率、编解码器、比特率以及基于容量和时间的视频存储限制），以及
–让 Xeoma 显示当前连接到服务器的 用户 数据、入站和出站网络流量，以及服务器端 Xeoma 的 RAM 和 CPU 负载。启用此选项后，菜单项将变为“隐藏摄像头信息”，用于隐藏上述所有数据。

隐藏低帧率警告 (点击此处查看详情)

使用此选项关闭 Xeoma 的自动通知，该通知在摄像头出现帧率 (fps) 下降或画面冻结时弹出。选中后，菜单项将变为“显示低 FPS 警告”，以重新开启这些警告。

隐藏界面加速提示 (点击此处查看详情)

此选项将关闭有关提高程序运行速度和效率的提示（例如升级显卡的提示）。这些消息默认启用，仅在 Xeoma 拥有修复已检测到的软件效率降低方案时才会出现。如果您已知晓 Xeoma 的相关问题且决定暂不修复，可通过“隐藏界面加速提示”选项禁用这些通知。选中后，此菜单项将变为“显示界面加速提示”，用于恢复提示功能。

关闭可视化 (点击此处查看更多详情)

选择此选项可关闭由“移动侦测”模块检测到的移动对象可视化（前提是您的模块链中包含该模块）。该功能默认启用，表现为围绕移动对象的绿色边框。请参阅 2.5.8. 移动可视化 了解详细信息。
选中此选项后，该菜单项将变为“开启可视化”，用于重新显示可视化效果。

开启移动轨迹可视化 (点击此处查看更多详情)

此选项扩展了可视化功能，可额外显示移动对象的轨迹（表现为跟随对象的绿色圆点）。此功能仅适用于拥有至少一个 Xeoma Pro 许可证的服务器，且必须与移动可视化同时启用（即菜单中将显示为“关闭可视化”）。
详情请参阅 s. 2.5.8. 移动可视化。
选中此选项后，该菜单项将变为“关闭移动轨迹可视化”，以停止显示移动追踪点。

隐藏过滤消息 (点击此处查看更多详情)

此选项可隐藏相机槽位中出现的所有 Xeoma 消息（包括但不限于来自“问题检测器”的消息、存档录制故障通知等）。此类消息默认启用，仅建议在 Xeoma 用于演示且其提示的问题不涉及严重风险时禁用。选中此选项后，菜单项将变为“显示过滤消息”，使 Xeoma 重新在相机槽位中显示消息。

 

d) eMap 选项
此选项将打开一个专用对话框，您可以在其中添加受控区域的交互式平面图 (eMap)、虚拟布置相机，并在检测器触发时立即收到通知。当您需要快速定位触发事件的相机并无延迟地切换至预览界面时，eMap 将非常高效。该功能还支持添加 Orion Bolid 设备。您可以在 s. 2.5.9. eMap 交互式地图 中了解更多信息
 

e) 客户端解码设置 选项
此选项包含 Xeoma 提供的多种管理相机流解码的设置。您可以使用它来选择由 Xeoma 客户端还是服务器执行解码，启用各种优化方法（仅解码关键帧或缓冲），并在必要时限制主窗口中显示高质量（存档）流的相机数量。
请参阅 s. 2.5.10. 解码设置 详细了解此选项
 

f) “ONVIF 相机时间同步” 选项
此选项旨在让 Xeoma 与所有连接的 ONVIF 摄像机进行通信，使摄像机自动显示与 Xeoma 相同的时间——该时间通常显示在视频流画面上。此选项用于统一程序与摄像机的当前时间数据，特别是当摄像机型号不同且分别配置，导致其显示各自的时间时。它还可以简化新添加摄像机的配置——部分新购摄像机需要手动设置日期和时间。

“ONVIF 摄像机时间同步”子选项：

返回 (点击此处查看更多详情)

点击“返回”以返回上级菜单。

启用自动时间同步 (点击此处查看更多详情)

点击此子选项以启用通过 ONVIF 进行的自动时间同步。启用后，服务器时间将发送至连接到 Xeoma 且支持 ONVIF 的所有摄像机。Xeoma 与摄像机会定期重新同步。
选中此选项后，相应的菜单项将变为“禁用自动时间同步”，用于停止 Xeoma 协调 ONVIF 摄像机的时间。请注意，时间同步一旦启用，无法撤销！若要再次显示“默认”时间，需要手动重新配置摄像机。
我们建议不要将此同步功能与“启用与 NTP 服务器时间同步”选项同时使用，否则可能会导致时间显示不一致并引发设置冲突。

立即同步 (点击此处查看更多详情)

使用此选项可快速执行一次性时间同步。若已启用自动同步，无需等待 Xeoma 与摄像机再次自动同步，即可立即统一摄像机时间。例如，将 Xeoma 服务器时间应用至待添加到系统的一批新 ONVIF 摄像机（欲了解更多时间同步信息，请参阅“启用自动时间同步”选项）。
请注意：此操作无法撤销！同步一旦启用，您需要手动重新配置摄像机才能再次显示其“默认”时间。

启用与 NTP 服务器时间同步 (点击此处查看更多详情)

选中此选项后，Xeoma 将通过 ONVIF 指令使摄像机与预设的专业 NTP 服务器进行同步。请注意：此操作无法撤销！同步启用后，若要再次显示“默认”时间，您需要手动在摄像机设置中关闭 NTP 服务器同步并重新配置。我们建议不要将此同步功能与“启用自动时间同步”选项同时使用，否则可能会导致时间显示不一致并引发设置冲突。

另请参阅：视频监控软件 Xeoma 中的 ONVIF
 

“布局”菜单页签参数

如果您已经配置了页签，则可以使用下方列出的菜单选项：
预览页面
此选项可让您快速切换到所需的页签。如果您选择了“隐藏页面面板”以隐藏顶部页签菜单（“管理布局” $\rightarrow$ “隐藏页面面板”），此方法将尤为便捷。如果面板未隐藏，您也可以直接点击页签名称进行切换。

此菜单的子选项：
–返回
–所有摄像机
–未分配摄像机
–页面 1（或您为第一页定义的任何名称）
–页面 2（或您为第二页定义的任何名称）——以此类推。

欲了解更多关于页签及上述选项的信息，请参阅 2.5.1. 页签
 

2.5.1. 页面（摄像机页签）

点击带有窗口图标的按钮，开始优化您的屏幕。最基础（且最实用）的功能是“管理布局”。如需将一组特定摄像机分配到单个屏幕，请选择“布局：自定义”，点击所需的摄像机图像（选中后将以蓝色高亮显示），然后再次点击窗口按钮。此时，您将在左上角看到两个标签页：“所有摄像机”和“页面 1”。后者即为您刚刚创建的页面，右键点击该标签页即可重命名（例如，将其命名为这些摄像机所监控的区域）。如需更改图像在屏幕上的位置，直接拖动即可。

如需创建另一个页面，请依次进入“布局菜单” → “管理布局” → “布局：自定义” → “添加新标签页”，并选中其他摄像机。在为特定页面选择摄像机时出现错误？在同一菜单中选择“编辑当前标签页”，然后重新选择或取消选择摄像机图像。不再需要该页面？点击“删除当前标签页”（摄像机将保持与服务器的连接，您仍可在“所有摄像机”标签页中看到它们）。最后，如果您希望 Xeoma 根据样本自动排列摄像机，请选择“布局：XxY”（第一个数字为窗口横向的摄像机数量，第二个为纵向数量）。如果您不希望在窗口中显示标签页，请进入“布局菜单” → “管理布局” → “隐藏页面面板”。

为确保用户仅能查看特定的布局和摄像机，您可以限制用户移动摄像机的权限。为此，请以管理员身份登录程序，进入“主菜单” – “远程访问” – “用户”。在弹出的窗口中，找到 “仅允许管理员更改摄像机顺序” 选项并勾选。接着，在 “预览菜单”（四个方块图标）中，选择 “使用用户的摄像机顺序” 并点击目标用户名。如需为特定用户自定义布局，请进入 “预览菜单” – “管理布局” – “布局：自定义”，为该用户创建具有自定义摄像机顺序的布局。

请注意，要使设置生效，您必须关闭客户端程序并重新启动。

重要提示！ 如果取消勾选“仅允许管理员更改摄像机顺序”复选框，所有用户布局设置将被重置。再次激活该选项后，您需要重新创建布局并为用户重新设置摄像机顺序。

2.5.2. 消除黑边

图像两侧的黑色边框可能会影响视觉体验。要消除黑边，请进入“布局菜单” → “管理布局”，选择“拉伸：选择摄像机”（仅针对特定摄像机）或“拉伸：所有摄像机”。随后您可以选择拉伸类型：“原始”、“拉伸”或“适应”。“原始”表示不进行拉伸，图像按原样显示。“拉伸”将通过拉伸图像两侧来消除黑边，这会轻微影响比例。请注意，“适应”将强制图像在保持比例不变的同时适应窗口，必要时会裁剪部分图像。

2.5.3. 自动轮播

如果您在搭建专属安防工作站，可能希望 Xeoma 能以固定间隔自动轮播多个页面。为此，请进入“布局菜单” → “管理布局” → “自动轮播”，并选择间隔时间（5 秒、1 分钟或 5 分钟）。完成！

2.5.4. 放大网格模式

当单个页面上显示多个摄像机画面时，其中一两个可能尤为关键。若您希望它们在屏幕上占据更大空间，请使用“放大网格模式”菜单。在该菜单中选择“放大网格：1×1"（若需 1 个大画面）；若需 2 个，请选择“放大网格：2×1"。如果 Xeoma 放大了错误的视频，请进入“放大网格模式”，选择“点击添加模式”，然后直接点击目标画面即可。

若您的链条中包含检测器（例如 “移动检测器”），您可设置 Xeoma 在检测器触发时立即放大图像。请前往“布局菜单” → “大网格模式” → “按检测器分组”。简便易用！

2.5.5. “仅显示活动摄像机”

从 19.3.7 版本开始，Xeoma 提供了一个特殊的布局选项：一个单独的标签页，其中 仅显示被触发的摄像机（即其过滤模块被触发的摄像机）。
操作说明很简单：创建一个包含所有需启用此功能的摄像机的独立标签页，并在该页面中前往 “布局” $\rightarrow$ “管理布局” $\rightarrow$ “大网格模式” $\rightarrow$ “仅显示活动摄像机”。
您可以为任意数量（且在许可证范围内）的摄像机使用此功能。一旦检测到事件，该摄像机将在该标签页中“打开”，并在事件结束后保持显示 5 秒*（默认值）。您可以在 “布局” $\rightarrow$ “管理布局” $\rightarrow$ “大网格模式” $\rightarrow$ “活动摄像机显示时间” 中设置更长的时间 —— 当前选定值将以绿色字体显示。

2.5.6. 切换至活动页面

自正式版 22.3.16 起，Xeoma 推出名为“切换至活动页面”的全新布局模式。启用后，客户端将自动显示包含已触发（“活动”）摄像机的页面。您可指定触发摄像机进入“活动”状态的事件类型——录像启动（检测器触发）、问题检测器发出消息，或 HTTP 切换器发出消息。
该模式与其它布局模式的区别在于：
1) 包含活动摄像机且界面将切换至的页面，将显示特殊警报图标；
2) 即使当前正在查看其他页面，包含活动摄像机的页面也将被强制打开并显示；
3) 即使页面中仅有一台摄像机被触发，整个页面也会被打开。

如需仅显示被触发的摄像机，请改用 活动摄像机模式。

当然，在配置“切换至活动页面”模式前，您需先完成页面设置。请参阅 上文“页面”部分 了解操作方法。

您可以在任何页面中打开 “布局菜单” $\rightarrow$ “管理布局” $\rightarrow$ “大网格模式”。在弹出的对话框中，您将看到 3 个新选项：

切换至活动页面 —— 勾选此项以启用自动切换至活动摄像机所在页面的模式。启用后，此项名称将变为“禁用‘自动切换至活动页面’模式”，如需退出该模式，请点击此项。

活动页面显示时间 —— 勾选此项以设置页面在切换回原状态前显示的时长。可选值为 5 秒、10 秒、30 秒、1 分钟、2 分钟、5 分钟。
当前选定并使用的值将以绿色字体显示。

“自动切换至活动页面”模式 —— 点击此项以设定触发摄像机（“活动”）的事件类型。可选值包括：正在录像的摄像机、存在故障或警告的摄像机，以及收到 HTTP 切换器消息的摄像机。
当前选定并使用的值将以绿色字体显示。

布局管理是构建高效安防系统的关键要素，旨在全面守护您的私人生活与商业环境。

2.5.7. 界面优化

您可以通过“窗口设置”菜单调整 Xeoma 窗口。若网络流量或 CPU 负载过高，可调节“最大 FPS”滑块，但图像流畅度会随之降低。若屏幕上无法显示摄像机名称，请调高“摄像机名称字体大小”。您还可以通过调节“界面缩放（原尺寸百分比）”滑块来放大界面。此外，您可以勾选“开启透明度”并使用“透明度”滑块进行调整。最后，勾选“始终置顶”可确保 Xeoma 窗口不被其他程序遮挡。

2.5.8. 运动可视化

软件的警觉性有时胜过人工。假如它捕捉到了安保人员忽略的移动，能否精准指出移动位置？当然可以。请前往“布局菜单”→“可视化设置”→“开启运动可视化”。此后，Xeoma 将持续用边框高亮显示“运动检测器”侦测到的所有移动。

您还可在此菜单中选择“开启运动轨迹可视化”来呈现移动对象的轨迹。Xeoma 将在屏幕上沿对象路径标记绿色圆点。

若摄像机断开连接或停止传输信号，您需立即获知，Xeoma 同样可助您实现。请前往“布局菜单”→“可视化设置”→“在断开连接的摄像机上显示红叉”。启用此选项后，一旦任何摄像机画面“冻结”，系统将显示红叉以警示查看者。

2.5.9. eMap 交互式地图

在管理整栋建筑的安全时，您可以使用标记有摄像机的交互式地图以简化控制。请前往“布局菜单” → “eMap”并点击“加载地图”。点击右侧的文件夹按钮选择地图文件（支持 png, jpg, bmp 等任何图像格式）。点击“保存”将地图存入 Xeoma。地图加载后，点击“将摄像机添加到地图”即可开始部署。在下拉菜单中选择摄像机 IP，并在地图上点击其所在位置。摄像机出现后，您可以点击并旋转它以调整朝向。

当摄像机关联链条中的任意检测器被触发时，该摄像机下方对应的检测器图标将显示红色轮廓。

2.5.10. 解码设置

客户端解码设置
若系统使用 H264/H265 流，Xeoma 将接收压缩后的（“编码”）数据。虽然此过程在后台运行，但查看此类流必须先进行解码。若 H264/H265 流用于预览（即“通用摄像机”设置中的“预览 URL”字段），则在到达 Xeoma 时立即解码。若用于存档保存，则在查看存档录像时解码。

解码 H.264/H.265 流（尤其是高分辨率和/或高比特率流）会消耗大量系统资源。在此情况下，高 CPU 负载可能导致视频流出现卡顿，或引发其他系统故障。

为减轻 Xeoma 服务器的 CPU 负载，您可将解码过程部分或全部转移至客户端。如此，服务器将以“原始”（压缩）形式接收并存储流，仅当客户端请求查看视频流时，才在客户端设备上启动解码。

您可在“布局菜单” $\rightarrow$ “客户端解码设置”中启用客户端解码。当服务器与客户端之间的网络带宽较低（例如使用移动网络）时，此选项尤为有益。启用客户端解码后，客户端将接收压缩后的“轻量”流。

在对话框中，您可以灵活选择将哪些解码任务转移至客户端：仅针对“多摄像头视图”模式的预览流；仅针对“单摄像头视图”模式的预览流；存档视图流的解码；或以上所有选项及其任意组合。

实时预览的客户端视频解码具有以下选项：
启用 – 在客户端启用 H264/H265 流的实时预览解码。
在单摄像头视图模式下启用 – 对于在“单摄像头视图”窗口中打开的 H264/H265 流，将由客户端进行解码。
自动检测 – 仅当客户端设备具备足够性能时，预览所用的 H264/H265 流才在客户端解码，否则将由服务器端处理。
禁用 – 预览所用的 H264/H265 流仅在服务器端解码。

综上所述，如果您的首要目标是减轻服务器负载，请为所有或部分视频流强制启用客户端解码。如果减轻负载是首选但非必须，则可以选择“自动检测”选项。

存档视图的客户端视频解码选项如下：
启用 – 为通过内置查看器查看存档录像的 H264/H265 流启用客户端解码。
禁用 – 为通过内置查看器查看存档录像的 H264/H265 流禁用客户端解码。

另一种减轻处理器负载（服务器端或客户端）的方法是使用解码硬件加速。这意味着部分计算将由图形系统资源承担（Windows 和 Linux 支持 NVidia CUDA 和 Intel QuickSync）。要在客户端启用此功能，请使用 客户端视频解码硬件加速 选项。建议在使用前确认客户端设备是否支持上述技术，否则设置将无效。

更多降低 CPU 负载的方法。

---

2.6. 更改摄像头顺序

您可以通过直接将摄像头的预览框拖动至目标位置（即与另一个预览框交换位置），来更改主屏幕上的摄像头布局顺序。

更改摄像头顺序的图文指南

---

2.7. 设备列表（按组排列设备）

在管理大量摄像头时，“设备列表”的快速访问和分组功能将非常实用。请参阅 指南。

---

2.8. PTZ 控制与缩放

在 Xeoma 中，您可以手动控制摄像头的 PTZ（水平旋转、倾斜、缩放）功能；若摄像头硬件不支持，则可使用数字缩放。
此外，系统还支持自动目标跟踪（例如在球场上跟踪运动球体）、预设位操作、警戒/巡逻路线、用于 Senstar 传感器系统的专用模块，以及在云台旋转后触发特定场景。

2.8.1. 手动 PTZ（平移、倾斜和缩放）控制

如果摄像机已正确连接至 Xeoma，且其支持的平移、倾斜、缩放命令已被成功识别，您将在主屏幕/快速设置屏幕的摄像机预览框右上角，或快速设置屏幕的下层面板中看到 PTZ 控制图标。点击该图标即可打开 PTZ 控制界面。点击箭头可使摄像机上下左右转向。点击 + 或 – 可放大或缩小画面。

参阅添加 PTZ 摄像机的指南

以下是 Xeoma 中所有 PTZ 选项的对比表：

	Standard	Pro	附加模块
具备实际物理 PTZ 功能的摄像机：
手动 PTZ 控制（平移和倾斜）	是	是	不适用，请使用 Xeoma Standard 或 Xeoma Pro
手动缩放和摄像机旋转	是	是	不适用，请使用 Xeoma Standard 或 Xeoma Pro
自动缩放和摄像机旋转	参阅 PTZ 跟踪
PTZ 预设和程序巡航	–	是	不适用，请使用 Xeoma Pro
PTZ 跟踪	是	是	不适用，请使用 Xeoma Standard 或 Xeoma Pro
移动至 PTZ 预设	–	是	不适用，请使用 Xeoma Pro
Senstar PTZ 跟踪	–	是	不适用，请使用 Xeoma Pro
数字缩放（无实际 PTZ）：
手动缩放 预览画面	是	是	不适用，请使用 Xeoma Standard 或 Xeoma Pro
手动缩放 存档画面	是	是	不适用，请使用 Xeoma Standard 或 Xeoma Pro
自动缩放 预览画面	参阅 预览中的自动目标跟踪
自动缩放 存档画面	不适用	不适用	不适用
手动平移 - 倾斜 旋转（预览 与 存档）	是	是	不适用，请使用 Xeoma Standard 或 Xeoma Pro
自动 目标跟踪（预览）	不适用	是	不适用，请使用 Xeoma Pro
自动 目标跟踪（存档）	不适用	不适用	不适用

故障排除
如果 PTZ 控制界面已显示，但点击箭头、+ 或 – 无反应，请进入该摄像机的“详细设置”屏幕，打开“通用摄像机”的模块设置，然后向下滚动至 PTZ 选项列表。如果检测到其他选项，请尝试切换。如果您的摄像机使用非标准端口发送平移、倾斜、缩放命令，您可以在提供的输入框中指定正确端口。如果以上方法均无效，请尝试为摄像机使用不同的 URL，或联系 Xeoma 支持团队获取信息。

如果您确定摄像机支持 PTZ 但 Xeoma 中未显示 PTZ 控制：
a) 请确保您填写了摄像机的正确且完整的授权数据。
b) 尝试使用相同或不同的 URL 重新添加该摄像机。
c) 请确保您为摄像机指定了正确的 PTZ 端口。

查看更多

2.8.2. 数字缩放

数字缩放是一种通过数字化增强图像的方法，在不使用镜头的情况下电子化地将主体放大。
如果您的摄像机分辨率较高且需要辨识远处目标，只需在“快速设置”窗口或“存档查看器”窗口的主菜单中启用该选项，然后通过滚动鼠标滚轮即可放大或缩小。
启用数字缩放有多种方式：

1) 摄像机实时数字缩放
要激活数字缩放，请按照以下步骤操作：

-点击您想要缩放的摄像机
-点击左下角的“列表”按钮
-在弹出的窗口中，选择“缩放”
-使用鼠标滚轮缩放，或左键单击要放大的区域。如需进一步放大，请再次单击鼠标左键，直至达到所需尺寸

2) 归档中的数字缩放
要激活归档中的数字缩放功能，请按以下步骤操作：

-进入需要放大的摄像机归档
-单击左下角的“列表”按钮
-在弹出的菜单中，选择“启用缩放模式”
-选择要缩放的视频片段
-使用鼠标滚轮缩放，或左键单击要放大的区域。如需进一步放大，请再次单击鼠标左键，直至达到所需尺寸

* 数字缩放功能适用于 Xeoma Standard 和 Pro 模式。Xeoma 免费版、Starter 版及 Lite 版不支持此功能。

2.8.3. 浏览器中的 PTZ 控制

参阅 Web 服务器

2.8.4. PTZ 跟踪 – 自动目标跟随

借助"PTZ Tracking"模块，Xeoma 可自动检测移动目标并驱动摄像机跟随（即旋转跟踪），助您高效发现并处置突发事件。为便于操作，您可配置最大垂直/水平步长、目标跟踪持续时间（之后自动返回起始位置）、变焦速度等参数。

在 Xeoma 等高级视频监控系统中，自动 PTZ 跟踪可与手动 PTZ 控制相结合。

请注意，若摄像机不支持物理 PTZ，可使用画面的数字缩放来实现自动跟踪。
了解更多

“PTZ Tracking”模块故障排除

有关“PTZ Tracking”模块的故障排除，请参阅此处

2.8.5. 配置 PTZ 预设与 PTZ 巡航

许多 PTZ 摄像机具备记录用户定义关注点（通常称为“预设”）并自动在这些点之间移动的功能。这种基于预设的点对点移动称为 PTZ 巡逻或 PTZ 巡航。

1. 若在查看摄像机的服务器上激活了有效的 Xeoma Pro 许可证，且摄像机支持通过 ONVIF 控制 PTZ 功能，则常规 PTZ 控制 界面将提供管理预置位和巡航（亦称巡逻）的选项。
如需快速跳转至选定预设，请单击“预设”按钮。
若要添加或更改预设点或创建或更改巡航路径，请点击“巡航”图标。进入“PTZ 巡航”窗口后，您可以创建或更改巡逻路径——即摄像头需要“访问”的位置（预设点）清单及其在每个位置的停留时间。

注意：若要添加或更改预设点，请在点击“巡航”按钮之前，先使用方向箭头和缩放按钮将摄像头调整至所需位置。

若要添加预设点，请在“预设点设置”字段中输入新预设点的名称，然后点击该字段下方的“+”号。

若要更改现有预设点，请从列表中选择该预设点并点击“确定”。注意：某些摄像头可能不允许更改或删除其“内置”预设点。所有通过 Xeoma 创建的预设点均可删除。

若要创建巡逻路径，请使用“巡航管理”窗口。

2. 在“巡航管理”字段中输入巡航名称，并点击其下方的"+"按钮。随后将打开"PTZ 巡航设置”对话框，您可利用现有预设点 (1) 制定巡航计划：

从列表中选择一个预设点，并使用滑块 (2) 设置摄像头在该位置的“停留”时间。点击“+”按钮 (3)。所选预设点将显示在巡航时间表字段 (4) 中，您可以使用向上和向下按钮调整预设点的顺序 (5)。

对所有所需预设点重复上述操作。完成巡航计划后，点击“确定”按钮，即可返回“PTZ 巡航”对话框。

3. 设置至少一条巡航路径后，即可在“巡航管理”下拉列表中查看并选择。此外，下方还将显示更多图标：除了用于添加新巡航的"+"按钮 (6) 外，还包括用于编辑当前在“巡航管理”字段中所选巡航的图标 (7)、用于删除当前所选巡航的图标 (8)，以及用于启动当前所选巡航的图标。

点击右侧的“开始”按钮，摄像头将开始移动到指定位置。启动巡航后，该图标外观将发生变化，再次点击即可停止巡航 (9)。

启动巡航后，摄像头预览画面上将显示叠加层，标示摄像头当前所在的预设点名称。

如需为该摄像头设置多条巡航路径，请重复上述步骤。

注意：部分摄像头提供的预设点列表无法更改或删除。例如，Xeoma 通过 ONVIF 从摄像头获取 PTZ 预设点列表时，某些摄像头会提供 Preset1、Preset2…Preset1000。这些 PTZ 预设点无法删除，在极少数情况下也无法更改。这种情况通常见于无品牌的中国产摄像头。在此类情况下，您可以选择（如）"Preset10"并调整该预设点（位置、配置等），但所有这些预设点（即使是不需要的）均无法从 Xeoma 中删除。

更多详情

---

2.9. eMap（场域交互式地图）

E-Map 可在电子地图上显示监控区域，帮助操作员快速定位摄像机。将设施平面图导入程序并标注安防设备位置。拖拽摄像机图标至图纸，为摄像机命名并指定视角。为提升视频监控效能，请使用内置的运动与噪声检测器。一旦任一检测器被触发，Xeoma 将在地图上实时示警。您将看到红色传感器标识，轻松判断哪个房间发生了移动或噪声超标。1 秒内即可跳转至摄像机预览！

Xeoma 的 eMap 支持多层架构，可按需存储任意数量的楼层地图。再次点击 “加载地图” 并选择不同的名称与路径，点击 “保存” 后，您即可拥有两张不同的地图进行作业。通过 “选择地图” 下拉菜单即可在两者间切换。以相同方式向第二张地图添加摄像机。

现在，只需点击摄像机即可查看其图像，操作极其简便。此外，若摄像机链中包含检测器（如 “运动检测器”），eMap 将助您监控其运行状态。每当检测器触发时，摄像机正下方会以红色轮廓高亮显示该检测器符号。

若不再需要某张 eMap，可在 “选择地图” 下拉菜单中选中该地图，然后点击下方的 “删除地图”。若摄像机在地图上的位置有误，可点击 从地图删除摄像机 并直接单击该摄像机即可。

自 Xeoma 21.11.18 版本起，eMap 新增交互式地图全屏查看选项。现在您可让地图自适应屏幕尺寸，确保不遗漏重要细节——尤其在单张地图包含多台摄像机的场景中更为实用。 自 Xeoma 21.11.18 版本起，eMap 新增地图透明度调节功能（含完全不透明模式）。借此调整，您可在警报图标可见度与背景摄像机视频流之间找到最佳平衡点。 自 Xeoma 22.6.3 版本起，eMap（交互式地图）现已支持多服务器模式。

---

2.10. 在预览中更改摄像机名称

如需更改预览窗口左上角的摄像机名称，可采用以下任一方法：

1. 主要通过 通用摄像机 中的 源名称 设置来更改摄像机名称：

2. 您也可在 预览与存档 或 预览 模块的设置中更改摄像机名称：

摄像机名称由 通用摄像机 与 预览与存档（或 存档）中的设置共同决定，因此建议仅在其中一处进行设置。

3. 在主窗口或单摄像机窗口中点击摄像机名称。

随即打开设置对话框：
– 若从未编辑过摄像机名称，将打开“预览与存档”（“预览”）。参见 2，
– 若曾编辑过摄像机名称，将打开“通用摄像机”。参见 1

关于在 Web 浏览器视图中更改摄像机名称的方法，请参阅 Web 服务器

---

2.11. 直接保存至存档，或“双流传输”

“直接保存至存档”功能（亦称“双流传输”）是 Xeoma 优化服务器资源消耗的默认机制之一。其核心在于尽可能利用摄像机输出的多路视频流：
– 一路流通常采用较低参数（分辨率、帧率及比特率），用于画面显示及过滤模块的流处理任务；
— 另一路流采用较高甚至最高参数，原样保存*至存档。

“直接保存至存档”功能的要求（须同时满足所有条件）：
1. 仅适用于以“通用摄像机”模块作为源模块的配置。其他源模块（如“屏幕捕捉”或“HTTP 接收器”）不适用。
2. 如需保存录像，必须使用“预览与存档”模块。其他目标模块（如“保存到文件”或“HTTP 发送器”）不适用。
3. 摄像机应为 IP 网络摄像机，或通过 DVR 或 NVR 连接的模拟摄像机。
4. 摄像机必须支持双流，即具备所需的两路视频流（至少包含一路 H.264/H.265/H.264+/H.265+ 视频流）。关于双流的更多信息
若无需在 Xeoma 中实时预览摄像机画面，可仅使用单路视频流（H.264/H.265/H.264+/H.265+）（此类情况的详情见下文）。

—
“直接保存至存档”模式的优势：
1. 降低 CPU 负载。得益于采用 MJPEG“预览流”（或低性能的 H.264/H.265/H.264+/H.265+ 流），系统无需持续解码高码率主码流，转而解码低参数子码流。仅在访问时（如查看存档或单台摄像机，见下文）才会解码“高码率”主码流。
2. 观看画质无损。在大多数场景中，单屏需显示数十台摄像机，此时屏幕尺寸本就无法同时以最高画质呈现所有画面。与此同时，当查看单台摄像机时，可使用最高画质流（即“存档流”）。此时由于无需渲染其他摄像机，瞬时负载通常更低。
3. “直接保存至存档”将录像保存为压缩的 MKV 格式，与未压缩录像相比，可显著节省磁盘空间。

深入了解 MJPEG 与压缩流的区别及其优势

—
如何启用“直接保存至存档”模式：
若在“通用摄像机”模块设置的“用于直接录制到存档的 IP 摄像机 RTSP 流完整 URL 地址”（即“存档流”）字段中输入了 RTSP 流（H.264/H.265/H.264+/H.265+），该模式将自动生效。

若此字段为空，该模式将无法运行；包括录像在内的所有功能都将改用“用于查看的 IP 摄像机完整 URL（为降低负载，建议使用 MJPEG 流或低参数 H.264 流）”字段（即“预览流”）中的视频流。请注意，若将 H.264/H.265/H.264+/H.265+ 流指定为“预览流”，系统将对其进行实时解码，此时处理器负载和磁盘需求将随“预览流”的参数相应增加。

执行摄像机自动扫描时，Xeoma 会优先选用适用于直接保存的视频流。由于许多摄像机支持双流，它们在添加至 Xeoma 时已自动配置好“直接保存至存档”功能。
若摄像机没有合适的视频流，或在搜索过程中未能找到，Xeoma 将使用摄像机现有的可用流。

关于“通用摄像机”模块设置的更多信息

—
“直接保存至存档”模式的局限性：

1. 图像修饰类过滤器模块无法将其处理效果应用于存档录像。请参阅“直接保存至存档”模式下的录像特性。
2. 由于通常需连接并使用两路视频流，与仅使用单路流（尤其是压缩流）相比，可能会增加网络负载。
3. 需注意多个方面。“直接保存”会影响“通用摄像机”模块的设置、链路中使用的过滤器模块、解码设置、“布局”菜单中的窗口设置，并间接影响用户设置。
4. 实时查看：若需使用过滤器模块，默认情况下它们将利用“预览流”运行。对于智能模块，由于需要更高质量（更精细）的流以确保足够的识别精度，“预览流”的质量可能无法满足需求。在此情况下，您可能需要关闭“直接保存至存档”模式，或为部分乃至全部此类模块勾选“使用存档流”选项。此举实际上将恢复对这些摄像机“高负载”流的持续解码，从而必然导致 CPU 使用率升高，并削弱系统资源的节省效果。
5. 并非所有摄像机都支持双流。尽管大多数网络摄像机支持双流，但部分设备（包括 USB 摄像机，以及通过调谐器或 USB 加密狗连接的模拟摄像机）并不支持此功能。
6. 唯一可用于录像的目标模块是“预览与存档”模块。

—

如果“存档流”字段填写了 URL，而“预览流”字段为空，会发生什么？

在这种情况下，系统将执行直接保存至存档的操作，但不会显示摄像机图像——预览区域将显示黑色背景及相应文字提示，而非预览流画面。

若在这些模块的设置中勾选了“使用存档流（高分辨率）”选项，链路中的过滤器模块即可正常工作（例如，保存报告或关于检测对象的元数据）。
若在没有预览流的链路中，过滤器模块缺少此设置或未勾选该选项，则该模块将被忽略（即模块不工作，处于“已忽略”状态）。

—
如果“存档流”不稳定且时常断开连接，会发生什么？

在 Xeoma 的“通用摄像机”设置中，若两个字段均已填写（“用于查看的 IP 摄像机完整 URL（为减轻负载，建议使用 MJPEG 流或低参数 H264 流）”和“用于直接录制到存档的 IP 摄像机 RTSP 流完整 URL"），则当“存档流”中断时，系统将临时改用“预览流”进行录像。同时，Xeoma 会持续尝试重连“存档流”；一旦连接恢复，将重新将其用于存档保存。

—

Xeoma 的哪些版本支持“直接保存至存档”模式？
所有 6 个 Xeoma 版本、Xeoma Cloud 以及 Xeoma Pro Your Cloud 均支持“直接保存至存档”模式。
此外，该方法不仅应用于 Xeoma Cloud；若涉及 H.264/H.265/H.264+/H.265+ 流，对“预览流”的特性亦存在限制。

—

采用“直接保存至存档”模式录像的特性：
如您所知，启用“直接保存至存档”模式后，“存档”流仅在需要回放记录时才进行解码。这避免了持续解码“高负载”流，仅在必要时（通常是查看摄像机存档时）才进行解码。由于“存档流”并非持续解码，因此在录制过程中无法对其进行任何修改*。若您需要对 Xeoma 录像进行任何图像调整（图像裁剪/旋转/缩放、蒙版），则必须禁用直接保存至存档模式。

“直接保存到存档”模式下，录像仅支持两项调整：1) 依据“运动检测器”的数据过滤运动事件（即不录制无运动事件的存档片段）；2) 添加日期时间标记。由于无法直接修改未解码流，这两项功能实际上采用了变通方案：日期时间标记是以独立字幕形式存储在录像“旁边”；而运动检测器则利用“预览流”侦测运动，并据此发送指令裁剪“存档流”。

—

“直接保存到存档”模式下实时视图的特性（客户端部分）：
重要提示：本段仅讨论摄像机的实时查看。有关存档的信息，请参阅此处

大多数修饰模块（过滤器）基于“预览流”运行。“预览流”的质量会影响视频分析模块（如烟雾与火灾识别）的效果：流质量过低可能导致识别准确率下降。因此，您需在通过双流机制降低处理器负载与保障识别准确率之间做出权衡。若需过滤器模块处理高质量图像，请在其设置中勾选“使用存档流（高分辨率）”选项。此举将启用对“存档流”的解码并用于视频分析：虽会增加处理器负载，但录像仍将以压缩的 MKV 容器保存，从而节省磁盘空间。关于此选项的更多详情
对于其他模块（如“图像裁剪”或“遮蔽”），“预览流”的质量并非关键，唯一需留意的是“预览流”与“存档流”呈现场景不一致的情况（此类差异虽罕见，但在部分摄像机中确实存在）。

对于“隐私遮蔽”、“标记”、“HTTP 标记”、“图像裁剪”、“图像旋转”模块：
当将此列表中的过滤器模块添加到“直接保存到存档”模式的处理链中时，这些模块的效果会自动显示在“单摄像机视图”和“多摄像机视图”窗口中。
Xeoma 22.6.28 版本之前可能不支持此功能。若您使用的 Xeoma 版本较旧且无法看到所列模块的修饰效果，请参阅下文。

对于“鱼眼矫正”、“人脸识别”、“对象识别器”、“ANPR”、“性别识别”、“人群检测”、“对象尺寸过滤”、“年龄识别”、“文本识别”、“FaceID”、“图像缩放”、“人脸检测（情绪）”、“访客计数”、“越线检测”、“Unitor”等模块（即需在图像上叠加可视化效果或进行修饰的模块）：
将此类过滤器模块添加至启用“直接保存到存档”模式的链条中时，其效果可能不会立即显示。若要在实时视图中呈现这些模块的效果，请执行以下步骤（或确认已完成相应设置）：
1. 在用户设置（主菜单 – 远程访问 – 用户）中，为目标用户配置文件取消勾选“强制客户端解码”。此操作仅限管理员配置文件执行。
2. 在“布局” – “解码设置”中，从“实时视图中客户端视频解码”下拉列表中选择“禁用”。如果该选项不可用，请返回步骤 1。
3. 在“布局” – “解码设置”中，将“显示高分辨率流（来自存档）的最大摄像机数量”滑块调低或设置为“0”。

了解更多关于解码设置

这意味着什么？为使模块能够分析来自预览流的图像，该流必须由 Xeoma 服务器端进行解码（例外情况见上文）。

对于“二维码识别”、“颜色检测”、“跌倒检测”、“眼球追踪”、“停车位”、“体育赛事追踪”、“安全装备检测”、“烟雾检测”、“遗留物检测”、“徘徊检测”、“目标检测”（即不对图像覆盖分析信息的模块）：
此类模块使用“预览流”运行，并将接收到的分析信息保存为报告或元数据。元数据（例如关于发现遗留物的所有事件数据）与录像分开存储，并在启动回放查看时同步。此外，可视化数据（例如显示移动对象路径的绿点）同样通过直接保存实现，因为这不需要对主流（“存档流”）进行解码。

请注意，“预览流”的质量可能会影响此类模块的运行效果（例如烟雾和火灾检测的准确率）：低质量码流细节较少，导致识别准确率降低。因此，您需要在通过双码流降低处理器负载与识别准确率之间做出权衡。若希望过滤模块处理高质量图像，请在设置中勾选“使用归档码流（高分辨率）”选项。此举将启用“归档码流”的解码并用于视频分析：虽然处理器负载会增加，但录像仍将保存为压缩的 mkv 格式，以节省磁盘空间。关于此选项的更多信息

适用于“调度器”、“故障检测”、“继电器开关”、“按钮切换”、“条件”、“HTTP 切换”、“摄像头嵌入式检测”、“RIF+”、“智能卡读卡器”、“GPIO”、“移至 PTZ 预置位”、“Senstar PTZ 追踪”、“Modbus 控制器”、“车速检测”、“热成像摄像机集成”模块：
这些模块完全不分析摄像机流，仅接收外部动作信号，因此直接保存到存档不会影响其工作。

---

第 3 章. 模块设置

模块设置

3.1. 资源设置

通用摄像机

此模块允许您选择图像源——摄像机（IP/网络，包括无线、USB 或模拟摄像机）或全球网络摄像机（“随机 IP 摄像机”）。

您可以在“通用摄像机”的“源名称”字段，或在“预览”及“预览与归档”模块的设置中，指定“多摄像机视图”中显示的摄像机名称。
点击此处，了解更多关于该模块、添加摄像机及优化 IP 摄像机操作的信息

另请参阅：摄像机连接故障排除 / 支持的摄像机列表

 

麦克风

该模块允许您选择声音源——麦克风。请从可用音频设备列表中选择麦克风。链路中是否需要此模块取决于摄像机类型：通常 USB 摄像机需搭配麦克风模块才能处理声音，而 IP 摄像机通常已嵌入音频流，无需此模块。

使用此模块监控员工活动。

关于此模块的更多信息，请参阅本文

 

文件读取

该模块（设备）允许您选择 JPEG 或 MJPEG 文件作为图像源。创建模块链，将“文件读取”模块连接至“预览与存档”或“预览”模块。您也可根据目标在链中添加其他模块。
 

指定要用作来源的 JPEG 或 MJPEG 文件的完整路径：

所选图像/视频将在 Xeoma 中作为摄像机显示。摄像机名称可在“预览”模块（或“预览与存档”模块）的设置中指定：

使用此模块播放 JPEG 或 MJPEG 格式的专业广告，尤其适用于经销商推广本软件。

另请参阅 “如何在 Xeoma 中将视频用作摄像头？”

 

屏幕截图

该模块可截取您的屏幕，并将此视频流传输至链路中的后续模块（例如录像单元 “预览与存档” 模块）。屏幕截图模块支持 Windows、Linux 和 Mac OSX。
在该模块的设置中，您可以指定截图频率以及相对于原始图像尺寸的比例。同样，您可以在“预览”、“预览与存档”或“通用摄像头”模块的设置中为该源的预览窗口命名。

与运动检测器配合使用，可在计算机出现活动时立即启动录像。
使用此模块监控子女或员工的计算机操作，录制教学视频或保存培训会议。

 

Another Xeoma

该模块允许您接收通过网络由其他 Xeoma 副本传输的音频/视频流。为此，请在“Another Xeoma”设置中指定音频/视频流的 URL 及访问参数。摄像头名称可在“预览”模块设置（或“预览与存档”模块）中指定。您可以在高级设置中设定图像分辨率和帧率。

关于 Another Xeoma 与 Web 服务器连接的更多信息

 

FTP 接收器

该模块允许您将 FTP 服务器用作源，简单来说，即通过 FTP 将摄像头图像流传输至 Xeoma。当您无法或不希望在摄像头所在地的路由器上进行端口转发，或者摄像头无法分配 IP 地址（例如通过移动互联网连接）导致程序无法将其定位时，此功能非常便捷。请配置您的摄像头，使其通过指定的端口、用户名和密码，将图像 (JPEG) 通过计算机的 IP 地址传输至 FTP 服务器。您可以在“预览”模块设置（或“预览与存档”模块）中为此模块指定预览名称。

有关如何设置此模块的详细图文指南，请参阅此处。

 

HTTP 接收器

该模块允许您从另一个 Xeoma 服务器获取视频和音频。输入端口和路径，以便其他 Xeoma 副本可以访问此 Xeoma。

如需限制对此地址的访问，请输入用户名和密码。相应字段中将显示用于访问视频或图像的地址。详情请参阅本文

 

ANPR 速度接收器

该模块接收来自 ANPR 速度发送器模块的数据，并据此检测超速违规行为。输入“ANPR 速度发送器”模块中第一点和第二点的唯一 ID，以及车辆通过这两点应花费的时间（秒或分钟）。

该模块将计算车辆通过上述两点的时间差，若时间短于您设定的允许值，即触发警报。包含违规车辆、车牌号及事发时间的摄像头静态快照将保存至您指定的文件夹。该模块每 10 分钟向发送器模块请求一次数据，以降低网络负载。

详细信息请参阅 “车牌识别：超速违规”

 

3.2. 目标设置

声音警报

该模块允许服务器在接收到图像时播放指定的声音。在 Xeoma Pro 中，客户端也可以播放该声音。如果您希望在检测到运动时触发信号，请将其连接在运动检测器之后。您可以从列表中选择 wav 声音文件或手动指定文件路径，设置播放间隔（声音将随每帧图像播放，但频率不超过指定间隔）和播放时长。点击“测试”以验证设置。

使用此模块向安保人员发出警报，提示屏幕出现异常状况。

 

应用程序启动器

该模块用于运行指定应用程序。如需在检测到移动时触发程序运行，请将其连接在“移动检测”模块之后。使用宏指定要运行的程序路径并设置时间间隔（程序将在每帧图像输入时运行，但频率不超过指定间隔）。点击“测试”以验证设置。
使用此模块运行第三方应用程序或脚本。

“应用程序运行”模块支持以下宏：

%JPEG% – 向程序发送 JPEG 图像的完整路径（如果点击“测试”按钮，将发送默认的 100×100 图像）
%BMP% – 向程序发送 BMP 图像的完整路径（如果点击“测试”按钮，将发送默认的 100×100 图像）
%FACECOUNT% – 显示来自“人脸识别”模块的人脸数量
%NAMES% – 用于接收来自“人脸识别”模块的人名宏
%FACEID% – 人脸检测时间 + 姓名 + 相似度百分比
%TEXT% – 用于接收来自“文本识别”模块文本的宏
%EYEANGLE% – 来自“眼球追踪”模块的瞳孔方向

有关此模块的更多信息，请参阅 此处

 

弹出窗口（客户端）

该模块允许 Xeoma 在接收到输入帧时从最小化状态自动还原。请将此模块连接到模块链中的必要模块（例如“移动检测” + “弹出窗口”或“人脸识别” + “弹出窗口”等）。这样，当触发事件（如检测到移动、识别到人脸等）发生时，您的 Xeoma 客户端窗口将从最小化状态弹出（最大化）。

此模块还用于在触发时向 Android 端的 Xeoma 发送推送通知。从 Xeoma 20.10.22 版本开始，发送推送通知使用另一个模块 —— “移动通知”。

 

短信发送

该模块用于设置向手机自动发送短信 (SMS)。您可以设置消息发送的时间间隔，并使用宏指定检测到移动的摄像头及其时间。选择一种发送方式：通过 clickatell.com 或 bulksms.com 网站，或使用 GSM 调制解调器。

如果选择 clickatell.com，您需要指定在网站注册后获得的登录名、密码和 API ID（或仅 API ID）。若选择调制解调器，您只需连接设备。随后，输入接收短信的电话号码、消息文本并选择发送频率。

API ID (Api key) – 此密钥可在您使用的网站上获取。

在 clickatell.com 中，您需要进入“Manage my product”选项卡，点击“My Connections”，在“Add connection”下拉框中选择“XML”，然后点击“Submit and Get API ID” —— 您的 API ID 将显示在窗口中。

在 bulksms.com 中，您仅需要注册时获得的登录名和密码。该服务还提供 5 条免费短信用于测试。

发件人号码或名称：您可以使用任何名称，但必须在发送短信的网站上注册。如果在测试后收到发件人错误警告，则说明您指定的名称不正确或与网站管理设置不一致。如果发件人字段留空，将使用您在注册时指定的号码。

收件人号码：可同时向多个号码发送短信，只需用“;”、“,”或空格分隔号码即可。

欲了解更多信息，请访问您注册的网站。

模块设置完成后，点击“测试”以验证其运行情况。

使用此模块发送紧急情况通知。“问题检测”模块配合“短信发送”可就以下情况向您发送通知：
– RAM 内存不足；
– 磁盘空间不足；
– 服务器异常重启；
– 无音频流；
– 画面过暗；
– 画面过亮；
– 摄像头被移动或遮挡；
– 服务器正常重启；
– 无法访问数据库；
– 数据库错误；
– 摄像头图像缺失或无变化；
– 网络资源已不可用。

 

发送电子邮件

此模块支持在检测到事件时自动发送邮件。您可设置邮件发送间隔，并附加视频与图像（包括附件图片最大数量、截图时间间隔、视频帧率与时长，以及邮件最大尺寸）。同时，可利用宏指令联动问题检测器与移动检测器。可附加图片数量上限指根据下方滑块设定的最大邮件尺寸，每封邮件允许附加的图片最大数量。

例如，若限制每封邮件不超过 2 MB，则每封邮件最多可包含 26 张图片（具体数量视摄像头分辨率及图片尺寸而定，这些参数通常可在摄像头的 Web 管理界面中配置）。

请从列表中选择邮件服务器，或手动指定。若列表中未列出您的服务器，可手动输入设置。请输入 SMTP 服务器地址、端口及数据加密方式，并填入邮箱用户名与密码。在“收件人”栏填写收件邮箱地址（多个地址请用空格、逗号或分号分隔），支持发送至多个地址。输入邮件主题及正文（可选）。点击“测试”验证设置。

请注意，若将“发送邮件”模块连接在“移动检测器”之后，将直接影响运行结果。例如：设定邮件发送间隔为 1 分钟，且配置每封邮件附加 2 张图片。此时，程序将每 30 秒检测一次移动状态。若检测到移动，图片将暂存于内存等待发送；若未检测到，则不保存。随后的 30 秒内，程序再次检测，若有移动则抓取另一张图片。随即，程序将发送一封包含该时间间隔内（本例中为 1 分钟）所有暂存图片的邮件。若未抓取到图片，则不发送邮件。

如果您希望在移动设备上查看附件视频，建议选择 MP4 格式，因为大多数移动设备均支持该格式。

“发送电子邮件”模块设置：

使用存档高分辨率流 – 此项表示“发送邮件”模块将调用“通用摄像头”模块设置中的第 2 路流（通常用于存档录像，分辨率更高），从而使您收到的附件具备更高分辨率。

预录制 – 若需捕捉检测器触发前的画面或视频，请在此设置几秒的时长。

将指定时间内发生的多次连续事件计为一次 – 示例说明如下：
- 移动检测器检测到目标持续 5 秒，间隔 10 秒后，再次检测到目标持续 5 秒
- 若邮件发送间隔设为 5 秒，您将收到 2 封邮件（即检测到 2 次独立事件）

若您的场景中检测器触发频繁，且不希望 Xeoma 每隔数秒便向邮箱涌入大量邮件，可通过此滑块将所有触发事件合并至单封邮件中。

添加图片/视频的延迟间隔 – 若邮件包含附件，此设置将强制 Xeoma 在检测器触发后延迟一段时间再抓取附件，而非立即执行。

注意：若启用“预录制”，请将“将指定时间内发生的多次连续事件计为一次”与“添加图片/视频的延迟间隔”滑块均设为 0，如下图所示：

否则，“预录制”将被忽略。

消息间隔时间 – 此设置决定 Xeoma 发送消息的频率；在上述邮箱溢出的场景中，此设置虽有帮助，但间隔期间的所有潜在消息都将被忽略并丢失。（注：此计时器优先级最高；例如，若图像间隔延迟大于此计时器，您仍会收到消息，但不含附件）

在“发送电子邮件”模块的设置中，您可以使用不同的宏作为电子邮件主题和正文，从而接收包含宏所指定特定信息的电子邮件。

您可以使用以下宏：

%TEXT% – 用于从“文本识别”模块获取已识别文本的宏
%OBJECT% – 此宏用于获取由“对象识别器”模块检测到的对象信息
%GENDER% – 此宏用于获取来自“性别识别”模块的性别信息
%NUMBER% – 用于从“ANPR”模块获取纯文本格式车牌号的宏，例如 A110PB77 等
%FACECOUNT% – 在电子邮件中显示来自“人脸识别”模块的人脸数量
%NAMES% – 用于从“人脸识别”模块获取姓名的宏
%TIME% – 检测时间

%AREA% – 来自“停车位”模块的停车位状态
%REPORT% – 用于从“问题检测器”获取问题类型信息的宏
%STATUS% – 触发类型（检测到移动、发现问题或已解决问题）

使用此模块发送紧急情况邮件。“问题检测器”模块配合邮件发送功能可通知您以下情况：
– RAM 内存不足；
– 磁盘空间不足；
– 服务器重启异常；
– 无音频流；
– 画面过暗；
– 画面过亮；
– 摄像头被移动或遮挡；
– 服务器正常重启；
– 无法访问数据库；
– 数据库错误；
– 摄像头图像缺失或无变化；
– 网络资源不可用。

 

保存到文件

此模块可将传入帧保存至指定文件。您可设定视频与图像的存储路径、文件命名规则，并使用宏。

例如，若需将 JPEG 图像保存至 C 盘 Public 文件夹下的 Pictures 子文件夹，文件名以 img 为前缀并附加当前日期和时间，请指定完整文件路径：C:\Users\Public\Pictures\img_%ym-d_h-is%.jpg。您可设定帧保存间隔。

使用此模块将不同的文件保存到不同的磁盘和文件夹中。

请注意，您无法在 Xeoma 内置视频播放器中回放由“保存到文件”模块生成的视频。若需在 Xeoma 内回放视频，请使用“预览和归档”模块。

您可以在此处找到该模块可用宏的相关信息

 

FTP 上传

此模块可将图像或视频文件上传至指定的 FTP (SFTP) 服务器。请指定服务器地址、端口、用户名和密码，并勾选安全连接选项。利用提供的宏设定文件保存路径。您可设定存储数据的间隔与类型。点击“测试”以验证设置。

 

ANPR 发送到 FTP

此模块可将 Xeoma ANPR 模块的数据发送至 FTP 服务器。数据以 tar 归档格式发送，包含识别出的车牌 JPEG 图像及文本报告。文本报告可包含识别出的车牌号、其在图像中的坐标、图像尺寸及时间戳。请在相应字段中输入 FTP 服务器的地址、端口和用户名。利用可用宏设定文件保存路径，以及需发送至服务器的报告文件路径。

 

HTTP 请求发送器

此模块可生成并发送 HTTP 请求。若需发送移动触发请求，请将此模块连接在移动检测器模块之后。勾选“显示所有参数”以设置请求参数。在设置模块唯一标识符参数时，请使用 {ID} 宏。生成的 URL 将显示在“结果 URL”字段中。

使用此模块向第三方设备发送 HTTP 请求，例如开启大门等。

请参阅 3.14. HTTP 请求发送器 (与家庭自动化集成)

 

通过 HTTP 上传至其他 Xeoma

该模块可通过网络将视频和音频传输到其他 Xeoma 实例。输入远程 Xeoma 服务器的端口和路径，以进行音频和视频传输。

如需限制远程服务器的访问权限，请输入用户名和密码。您将在相应字段中看到用于访问视频流或图像的地址。

更多详情请参阅 3.15. 通过 HTTP 上传至其他 Xeoma

 

RTSP 广播

该模块支持通过 RTSP 广播在网络上传输数据。使用 libx264 广播需要安装 ffmpeg 附加软件。您可以从我们的网站下载，或使用您自己的 ffmpeg。从我们的网站下载 ffmpeg 即表示您接受 GNU GPLv2+ 许可协议条款。使用 mjpeg 或 mpeg4 广播无需附加软件，因为可以使用内置的 ffmpeg。您还可以为生成的流选择所需的压缩级别。

使用此模块模拟 RTSP IP 摄像机。

更多详情请参阅 3.16. RTSP 广播

 

预览

该模块支持实时查看摄像机的当前图像：
 
 

与“预览与归档”模块不同，此模块不会将摄像机视频录制到归档中。它适用于仅需在线监控而不需要归档录像的场景。该模块在 Xeoma Starter 模式中非常实用，支持查看无限数量的源。

您可以指定要显示在该“预览”模块图像上的名称：

 

Web 服务器

点击此处了解更多 Web 服务器相关信息

使用此模块将摄像机画面广播到您的网站，或通过浏览器查看摄像机。

 

预览与归档

点击此处了解更多归档相关信息

使用此模块中的特殊选项与 SD 卡同步。

 

ANPR 测速发送器

此目标模块记录车辆经过控制点的时间，并将数据发送至 ANPR 测速发送器，以计算两点间的行驶耗时并判定是否超速。

需在 ANPR 模块后连接一对 ANPR 测速发送器模块（每个控制点各一个），以及一个"ANPR 测速接收器”源模块（三者可位于同一台计算机上）。

请输入控制点的唯一标识符 (ID)（须与其他点位不同）、部署了用于检测超速的 ANPR 测速接收器的 Xeoma 服务器连接数据，以及保存含车牌、日期和检测时刻（UNIX 时间戳）的抓拍图像的文件夹路径。您可选择时间戳同步方式：GPS 模块或计算机时间。

详见"车牌识别：超速违章"

 

移动通知

“移动通知”模块支持在移动设备上接收推送通知（例如在特定模块触发时）。更多详情请参阅本文。

 

YouTube 直播推流

使用"YouTube 直播推流”模块将摄像机画面推送到您的 YouTube 频道进行直播。Xeoma 的 YouTube 直播功能是建立商业信任的绝佳方案，尤其适用于养老护理、宠物酒店，或快餐店及小型 HoReCa 场所等传统上备受疑虑的行业。此外，工作室的实时直播能吸引受众关注，助其深入了解您的工艺流程。同时，在缺乏公网 IP 却需远程查看摄像机视频流时，这也是一种便捷的解决方案。该模块适用于 Xeoma Standard 和 Xeoma Pro 版本。

阅读本文了解更多详情。

 

Telegram 机器人通知

此模块用于向 Telegram 机器人发送消息，内容可包含自定义文本和/或摄像机抓拍图片。

使用此模块需具备 Telegram 机器人的访问令牌。
获取令牌的操作步骤：
1. 打开 Telegram，在搜索栏中搜索“BotFather”
2. 运行 (/start) 并创建新机器人 (/newbot)
3. 复制创建新机器人后获取的 Token。

此模块适用于 Xeoma Standard、Xeoma Pro 及试用版。在此查看更多模块详情

 

3.3. 过滤器

白天检测器

该模块可自动过滤低光照（光线不足）下的画面帧。适用于日间录像场景，例如在无需使用“计划”模块的远程站点——如在自然保护区观察遵循地球生物节律而非固定时间表的动物。

如需禁用该模块，请取消勾选右上角的复选框。此时，后续所有模块将无法接收图像。若要在不禁用整个处理链的情况下停用该过滤器，请勾选“隐藏”——此时过滤器链路图标将显示为不同颜色。如需重新启用模块，请再次勾选该复选框。

 

移动检测器

在此查看更多关于移动检测器的信息
使用此模块检测移动、静止状态，或忽略云层及阴影的移动。将此模块与 PTZ 跟踪功能结合，以监控移动物体。这些功能助您有效监管员工。

 

逗留检测器

当有物体在指定区域内停留达到设定时长时，此模块将被触发。请将此模块串联在“物体检测器”模块之后，并在前者中配置检测区域、物体尺寸等必要参数。在“逗留检测器”的设置中设定触发时长。有关该模块的更多信息，请参阅本文

 

物体检测器

这是“移动检测器”的增强版本，即使物体静止也能持续跟踪，并能区分不同的独立物体。

参阅 3.12. 物体检测器

 

遗留物检测器

该模块用于判断摄像机视野中的物体是否在超出允许时限内无人看管，并触发预设响应。为避免误报，请设置触发警报的物体最小和最大尺寸。例如，这将使模块仅对无人看管的行李做出响应，而忽略火车站内走动的人员。

设置任意形状和尺寸的检测区域。使用画笔将需监控的区域涂红，无需监控的区域保持透明。您可调整画笔尺寸以填充或清除监控区域。在“自动”模式下，系统会根据画笔下方的区域自动选择填充或清除效果。

您可以设置判定物体为遗留物的时间。例如，如果您设置为 10 秒，则只有无人看管超过 10 秒的物品才会触发响应。

若勾选“持续工作以启用存档中的移动搜索”选项，检测器将切换至“忽略”状态（20.10.13 之前的版本为“跳过”）（当存档模块连接在检测器之后时，将进行持续录像）。此选项适用于既需持续录像又需在存档中搜索物体的场景。如此，Xeoma 安防摄像机软件中的检测器将仅收集关于无人看管（遗留）物体的数据。

在此阅读更多关于该模块的信息。

 

计划程序

该模块用于设定所连接调度器模块的工作日期与时段。您可指定具体工作日及时段，例如工作日 17:00 至 23:59（因分钟记录至该分结束，实际截止时间为 23:59:59）。您还可为工作日设定专属时段，并将周末设为全天候运行。此外，您可配置定时器，使模块在特定时长后自动启停。如需禁用该模块，请取消勾选右上角的复选框；此时，后续所有模块将无法接收图像。若需在不禁用整条链路的情况下停用过滤器，请勾选“隐藏”——此时过滤器电路图标将变为不同颜色。如需重新启用模块，请再次勾选该复选框。

使用此模块进行定时检测。有关此模块的详细信息，请参阅本文。

 

标记

此模块用于在摄像机或其他视频源的图像中嵌入时间日期、GPS 坐标、自定义文本或图像叠加层水印。您可选择标记位置、日期/时间格式，并设置所需的字体大小。

若需在存档中录制带标记的视频，请在“通用摄像机”模块设置中取消勾选“无需转换直接将 H.264/H.265/H.265 录制到存档”复选框。此时，存档将以 .xem 格式录制。

若需在存档中记录日期/时间标记，同时以无需转换的方式存储 H.264 存档流，则 Xeoma 存档将以 .mkv 格式录制，标记将作为字幕添加。因此，若使用第三方播放器播放存档录像，请务必开启字幕功能。

了解更多关于标记的信息，请点击此处

 

烟雾检测器

此模块用于检测监控区域内的烟雾。通过灵敏度阈值刻度确定触发响应的烟雾浓度。0 级表示图像中任何程度的雾状物都将被视为烟雾；100 级为高灵敏度，仅当图像中出现浓雾时才会触发报警或您指定的其他操作。

设置任意形状和大小的检测区域。使用红色定义需监控烟雾的区域，保留无需监控的透明区域。您可调整画笔大小以填充或清除监控区域。在“自动”模式下，画笔效果（填充或清除）将根据画笔下方区域自动判定。

为避免误报，请使用“忽略短于以下时间的运动”选项，设定特定的秒数阈值；仅当雾状物持续时间超过该值时，才将其视为烟雾并触发预设响应。

“连续工作以启用存档搜索”：勾选此项后，烟雾检测器将切换至“忽略”状态（20.10.13 之前版本为“跳过”）（例如，若运动检测器后连接了存档模块，系统将进行连续录像）。此选项适用于既需连续录像，又需保留所有“烟雾”事件数据的场景。开启此选项后，Xeoma 安防摄像机软件中的烟雾检测器将仅负责收集“烟雾事件”数据。

Xeoma 同样提供： 火灾检测

参见 3.11. 烟雾检测器

 

声音检测器

此模块用于分析音频流，并对超过特定阈值的声音做出响应。若您的摄像机内置麦克风，可直接将检测器连接至“通用摄像机”；若麦克风为独立安装，请务必添加“麦克风”模块并将其连接至检测器。
该模块的设置包括：
连续录像（可通过归档菜单检索） – 勾选此项，使检测器全天候 24/7 录像，随后可在归档中查阅结果；通过 归档菜单 → 显示声音检测器音频数据，Xeoma 将在时间轴上以橙色标记检测到的声音。

录像后延 – 设定检测器触发后需在归档中保留的录像时长。

声音阈值, % – 设置检测器的灵敏度，使其仅对特定声音（如窗户破碎声或枪声）触发，并忽略无关噪音（如汽车喇叭声）。注意：数值越高，被忽略的声音越多。

当前音量, % – 实时监测检测器捕捉到的音量；这在需要调整阈值的初始设置阶段非常有用。

 

人脸检测器

该模块用于检测摄像机视野中的人脸。可用其检测禁区内人员聚集，或相反地，检测人员配置是否不足。

人脸识别功能可协助在实时视图和归档中查找特定人员。启用人脸识别前需先进行训练，录入待识别的人脸。您可通过两种方式添加人脸：利用摄像机实时图像或在归档回放时添加。详细信息请参阅人脸检测器设置中的“人脸识别帮助”。

结合“隐私遮蔽”模块，可动态模糊摄像机视野中的人脸。

全新创新功能： 口罩检测器 – 自动检测人员是否佩戴医疗防护口罩。

了解更多关于人脸检测器的信息

 

问题检测器

用于系统自检的内置工具。该过滤模块会在出现紧急情况时发出通知：如摄像机无图像、无声音、失焦、图像质量下降、摄像机被移动、图像过暗或过亮、磁盘空间不足、内存耗尽或服务器重启。归档时间轴将标记检测到问题或因摄像机故障（如摄像机“冻结”等）导致未录像的时间段。

凭借 Xeoma 灵活的配置与模块化结构，您可确保在恰当的时间针对正确的摄像机接收精准通知。例如，若某台摄像机信号丢失，可向系统管理员发送通知；若另一台摄像机断电，则可触发声音报警。您还可为同一台摄像机同时配置多种通知类型。

问题消息将同步显示在视口中。通过选择合适的字体，您将不会遗漏任何问题提示：

您可以使用此选项检查网络资源（例如调制解调器）的连通性。为此，请指定需验证的网络资源地址并设置可用性检查间隔。此外，“问题检测器”可将发现的问题记录至日志文件：

日志将写入 Xeoma 设置文件夹下 Logs 目录中的 ProblemsDetector.log 文件。日志包含多种不同类型的消息，列表如下：

问题检测器模块结合短信/邮件发送功能，可通知您以下情况：

• 内存不足
• 内存问题已解决
• 服务器正常重启
• 磁盘空间不足
• 磁盘空间问题已解决
• 磁盘空间已满
• 画面过暗
• 画面不再过暗
• 画面过亮
• 画面不再过亮
• 摄像机失焦
• 摄像机被移动或遮挡
• 摄像机未被移动
• 数据库更新错误
• 数据库读取错误
• 数据库写入错误
• 已接收音频流
• 已接收视频流
• 摄像机图像丢失或无变化
• 网络资源不可用
• 网络资源可用
• CPU 负载过高
• CPU 负载已降低

您可以在此处查看关于如何使用“问题检测器”模块的详细说明。

 


图像缩放



图像缩放模块可减小输入图像的尺寸。

在模块设置中，以原图尺寸的百分比调整结果图像的大小。

更多信息请参阅本文

 


图像旋转



图像旋转模块可用于旋转和镜像翻转摄像机图像。

使用滑块设置旋转角度。取消勾选“90度步进（向下取整）”选项以使用任意旋转角度。否则，勾选后数值将向下取整为 0、90 或 180。

更多信息请参阅本文

 


图像裁剪



图像裁剪模块可动态裁剪摄像机图像。在模块设置对话框中，将需要保留的区域涂成红色，未标记的部分将被裁剪。

更多信息请参阅本文

 


PTZ 追踪



该模块可使 PTZ 摄像机自动向移动对象方向移动。若要启用 PTZ 追踪，摄像机必须支持 PTZ 功能，且该模块在处理链中必须连接在“运动检测器”模块之后。您可以在“运动检测器”模块的设置中配置灵敏度、检测方法等，从而使“PTZ 追踪”相应地发挥作用。

您可以设置对移动对象的反应速度（仅在运动持续时间超过所选长度时摄像机才会移动）、返回初始位置的时间及等待下次追踪的间隔、摄像机的移动和缩放限制，以及摄像机移动和缩放的步长（影响速度/旋转角度）。

更多关于该模块的信息请参阅本文

 


自动车牌识别 (ANPR)



该模块可识别不同国家的车辆车牌、创建白名单和黑名单、存储日志文件等。此模块不支持 Android。

Xeoma 还提供：车速检测（时间差法）与雷达测速法。

更多关于 ANPR 的信息请点击此处

 


鱼眼矫正



该模块可用于矫正鱼眼摄像机的图像，将其转换为常规格式。

更多关于该模块的信息请参阅本文

 


访客计数器



访客计数器模块可统计摄像机视野内检测到的访客数量，并在预览画面中显示。例如，在“运动检测器”的监控区域设置中绘制一条线，并将“访客计数器”模块连接在该检测器之后。任何跨越该线的人员都将被计为一名访客。您可采用两种计数模式：单向计数适用于访客仅沿单一方向（进入或离开）移动的场景，每跨越一次线，计数器加 1；双向计数适用于访客既有进入又有离开的场景，每两次跨越线计为一名访客。“重置计数器间隔”定义了计数复位的频率（例如每日或每班次开始时）。您还可将报告保存为 CSV 文件。

使用此模块监督您的员工。

查看更多关于访客计数器的信息

 



越线检测器



该模块允许您绘制一条虚拟线，并在该线被跨越时触发。该模块能够检测移动方向，并统计特定方向的越线次数。

将此模块串接在“对象检测器”模块之后，并在该模块中设置检测区域、对象大小等必要参数。在“越线检测器”的设置中，在摄像头预览框内拖动绘制一条线。线的两端设有绿点，点击其中一点并拖动即可更改位置。线上还设有红色三角形，表示触发报警时移动对象应当运行的方向。点击“切换方向”可更改此方向。若设有多条线，可通过“选择线”下拉列表选择目标线条。勾选“显示访客数量”，可由 Xeoma 统计在选定方向上跨越线条的次数。自 Xeoma 24.7.9 版本起，“越线检测器”新增了一种工作模式：统计楼层人数。

更多关于此模块的信息，请参阅本文

 


隐私遮蔽



隐私遮蔽模块支持动态模糊摄像头视野中禁止记录的区域。我们致力于保护私有财产的隐私，尤其是在大城市中，CCTV 摄像头的镜头很容易拍到邻居的窗户。

部署此模块以遮蔽录像中的私密区域。该模块可与检测器类型过滤器配合使用，从而动态模糊检测到的人脸、车牌等对象。

“隐私遮蔽”模块可连接至“运动检测器”模块（建议将其设置为“与累积背景比较”模式）或“对象检测器”模块，并在“隐私遮蔽”模块中勾选“使用检测器选择遮蔽区域”。

此外，该模块也可在不使用检测器的情况下，直接利用内置画笔工具标记需遮蔽的区域。若要将模块处理后的数据写入存档，必须在"Universal Camera"模块中取消勾选"Use recording of H.264 stream to Archive without recoding"选项。

此模块仅在 Xeoma Pro 版本中提供。由于 Xeoma Pro 与 Xeoma Standard 许可证可叠加使用，您可购买1 路摄像头的 Xeoma Pro 许可证，并将其添加至 Standard 许可证中，从而为 1 路摄像头启用"Privacy Masking"及其他智能 Pro 模块（Pro 许可证支持按需购买任意数量的摄像头授权）。

 


按钮切换器



此模块支持通过底部面板的按钮或主菜单选项，快速开启/关闭串接在该模块之后的后续模块。将“按钮切换器”模块添加到链路中，即可在需要时（例如快速启动或停止录像）点击底部面板按钮或主菜单选项。您可以设置模块名称 (ID)，所有具有相同 ID 的模块将同步执行操作（开启或关闭）。

使用此模块快速启动/停止录像。

 


合并器



"Unitor"模块可将两个视频源的输出合并为一路。将两路摄像头或其他视频源接入"Unitor"，即可生成合并后的图像。此外，还支持接入 1 路音频源。

您可设定摄像头的相对布局（水平或垂直组合），并调整其排列顺序。

请注意，"Unitor"最终仅输出 1 路音频流。

使用此模块将两路视频流合并为一路。

有关此模块的详细信息，请阅读Unitor 专题文章或观看Unitor 演示视频。

 


继电器开关



此模块为流切换器。当接收到管理模块发出的信号时，它将闭合电路，允许受管（次级）链路的视频流通过。

有关此模块及其设置的更多信息，请参阅3.9. 继电器开关。

 


条件



此模块是一种基于所选预设逻辑条件工作的继电器开关。该模块另称为"Denial"，因为与 Xeoma 中的其他过滤器不同，其核心功能是检查前置模块（过滤器）是否未触发。

将 Condition 模块连接在检测器之后且在目标模块之前。
选择工作类型：
逻辑与 – 仅当所有前置模块当前均未被触发时，该模块才会将视频推送至后续模块。
逻辑或 – 只要至少有一个前置模块当前未被触发，该模块就会将视频推送至后续模块。
若您希望撤销某模块的此反向逻辑（即让 Condition 在模块“被触发”而非“未被触发”时生效），请在列表中勾选该模块名称（列表仅显示已连接至 Condition 的模块）。请注意，其工作机制与不经过 Condition 直接连接模块时截然相反。

 


HTTP 标记



该模块集成了"HTTP 切换器”与“标记”功能。收到 HTTP 请求时，它可开启或关闭所有后续模块（即 HTTP 标记后的整条链路），并保存元数据。其作用类似电路断路器/闭合器：可接收断路命令（通过关闭 URL）或闭路命令（通过开启 URL）。模块会保存命令及相关标识符 (ID) 的元数据；凭借此 ID，您可在 Web 存档中检索并查看对应条目（此时方案中需包含 Web 服务器模块）。收到继续命令后，模块将保持电路闭合；若长时间未收到继续或关闭命令，电路将自动断开。

例如，您可将 HTTP 标记模块接入存档模块之前的链路，并发送带标识符的关闭 URL（示例："id=123"）。若要继续录像，请发送继续命令；若要恢复录像，请发送开启 URL 请求。

请求可通过家庭自动化系统或直接通过 Web 浏览器发送。

 


HTTP 切换器



该模块可在收到 HTTP 请求时，开启或关闭所有后续模块（即 HTTP 切换器后的整条链路）。其作用类似电路断路器/闭合器：可接收断路命令（通过关闭 URL）或闭路命令（通过开启 URL）。

关闭 URL 路径：发送此 HTTP 请求，可使 HTTP 切换器在设定时段内（或永久，直至发送开启 URL）拦截视频流。

开启 URL 路径：发送此 URL 可使 HTTP 切换器停止拦截视频流（闭合电路）。若已设超时时间，待时间耗尽后，模块将恢复拦截视频流。

例如，您可以将此模块连接在存档模块之前的链条中，并在需要停止录像时发送关闭 URL。若要恢复录像，请发送开启 URL 请求。请求可通过家庭自动化系统或直接通过 Web 浏览器发送。

使用 {ID} 宏 可为此模块指定唯一名称。若未使用该宏，且所有 HTTP 发送端的路径相同，则一旦收到请求，所有同类模块将同时被开启或关闭。

使用 “timeout_seconds” 参数设置或更改工作时间（例如：http://10.1.10.10:10090/http_sender_on?module=HttpSwitcher.7&timeout_seconds=5）。

使用 “show_status” 参数获取模块的当前状态信息（例如：http://10.1.10.10:10090/http_sender_on?module=HttpSwitcher.7&show_status）。

 


摄像头内置检测器



该模块可调用支持 ONVIF 协议的 IP 摄像头内置检测器与传感器，并向摄像头发送命令。启用此模块后，您可直接在摄像头中配置分析规则，无需再使用 Xeoma 检测器，从而将部分服务器负载转移至摄像头端。
了解详情

 


人脸检测器（情绪）



该模块可自动识别摄像机画面中人脸的情绪（快乐、恐惧、中立、悲伤等），并在屏幕上显示，保存至电子表格报告或发送至第三方程序进行处理。它也可以作为当前人脸检测器的替代方案用于人脸检测（非识别），或与之结合使用，例如仅确定已知或未知人员的情绪。此模块需单独购买，并在 Xeoma Standard 或 Xeoma Pro 许可基础上激活。提供 1 小时试用模式，随后需要重新配置。

有关此模块及其设置的更多信息，请参阅 此设置指南。

 


FaceID



该模块可在摄像机图像中识别人脸，并将其与数据库（远程 LDAP 数据库或本地数据库）中的人脸进行比对。此模块仅在连接二维码识别或智能卡阅读器模块后才能工作。二维码阅读器或智能卡阅读器获取人员 ID 信息并将此元数据发送至 FaceID，由 FaceID 在数据库中搜索匹配的人脸。该模块可用于受限区域企业的复杂访问控制系统、大学校园、私人住宅等需要高安全性及持卡人身份验证的场景。此模块需单独购买，并在 Xeoma Standard 或 Xeoma Pro 许可基础上激活。提供 1 小时试用模式，随后需要重新配置。欲了解更多关于该模块的信息，请参阅 这篇文章。

 


物体类型识别



该模块可自动对摄像机视野中的物体（人员、汽车、动物、鸟类、摩托车、飞机、无人机等）进行分类，并针对选定类型的物体做出响应或将其忽略。“物体识别器”非常适用于视野中预期有物体移动，且需要系统仅对特定类型物体做出响应（或不响应）的环境。此模块需单独购买，并在 Xeoma Standard 或 Xeoma Pro 许可基础上激活。提供 1 小时试用模式，随后需要重新配置。

!全新创新功能：海鸟/鸟类检测。借助 Xeoma 的人工智能技术，为农场和渔业设施提供作物保护。
!全新创新功能：无人机检测。机场和私人区域的理想之选。利用 Xeoma 的 AI 功能保护您的隐私并防范危险事故。
如需更多信息和演示许可，请联系我们。

有关此模块及其设置的更多信息，请参阅 此设置指南。
 


SmartHome – RIF+



该模块适用于 RIF+ 自动化设备。各种传感器可连接至设备，由该模块接收其报警信号。此模块需单独购买，并在 Xeoma Standard 或 Xeoma Pro 许可基础上激活。提供 1 小时试用模式，随后需要重新配置。阅读更多

 


二维码识别



QR Code Recognition 模块是一款过滤模块，可扫描摄像机图像中的二维码，并在检测到二维码后将视频信号继续传至后续方案。该模块通常置于 FaceID 模块之前，用于将摄像机视野中的人脸与该二维码所识别的人员进行比对。此外，该模块可与“Application Runner”模块协同工作，通过 %TEXT% 宏发送二维码信息。适用于禁区企业、大学校园、私人住宅等需要高安全性及持证人员身份验证的复杂门禁系统。本模块需单独购买，并在 Xeoma Standard 或 Xeoma Pro 许可上激活。提供 1 小时试用，之后需重新配置。
了解更多模块信息，请点击此处。

 


智能卡读卡器



该模块从 Omnikey 门禁卡读卡器接收持卡人信息，并将其传递至 FaceID 模块，从而将数据库中的照片与摄像机前的人脸进行比对。适用于禁区企业、大学校园、私人住宅等需要高安全性及持证人员身份验证的复杂门禁系统。该模块还可与“Application Runner”模块协同工作，通过 %TEXT% 宏发送门禁卡信息。本模块需单独购买，并在 Xeoma Standard 或 Xeoma Pro 许可上激活。提供 1 小时试用，之后需重新配置。

了解更多模块信息，请参阅这篇文章。

 


GPIO 模块



该模块支持连接至 GPIO 接口的设备。模块既能响应外部传感器的触发（使用输入引脚），也能发送信号触发外部设备（使用输出引脚）。

当输入引脚被触发时，模块将切换至"Ignored"状态（20.10.13 之前的版本为"Skipping"），以便将视频信号继续传至后续环节。
当链条中位于此模块之前的模块被触发时，信号将发送至输出引脚。

了解更多信息，请点击此处。

 


转至 PTZ 预设位



当本模块接收到链条中前置模块的告警时，可将选定摄像机移动至预设位置。摄像机必须通过 ONVIF 协议支持 PTZ 控制。

了解更多。

 


性别识别



该模块基于人工智能，可自动识别人物性别。非常适合零售场所，可根据访客性别调整促销广告或通知，从而提升销售转化率。

本模块需单独购买，并在 Xeoma Standard 或 Xeoma Pro 许可上激活。提供 1 小时试用，之后需重新配置。

详见“Xeoma 中的性别识别”

 


体育赛事追踪



Sports Tracking 模块自 Xeoma 19.11.26 版本起可用。该模块基于人工智能数据集，旨在自动检测摄像机视野中的运动球类或运动员，并实现自动追踪（即旋转摄像机以始终跟随目标）。该功能在团体体育赛事的视频直播中需求极高。目前该模块适用于各种足球场地条件，也可按需支持美式足球、篮球及其他团体运动。

"Sports Tracking"模块在跟随球类时可自动变焦。若场上出现两个球，该模块将利用其人工智能和计算机视觉，持续追踪最初检测到的那个球。

该模块需单独购买，并在 Xeoma Standard 或 Xeoma Pro 许可证基础上激活。提供 1 小时试用模式，随后需要重新配置。

详见“体育球类检测与追踪”

 


人群检测器



该模块基于人工智能神经网络，可统计人头数量并检测人数是否超出或低于设定阈值（检测人群拥挤），从而触发预设响应。该模块还适用于地铁车厢、巴士、有轨电车、火车等公共交通封闭空间的乘客计数。您可以设置触发该模块的摄像机视野内人数阈值。新增：社交距离追踪。

该模块需单独购买，并在 Xeoma Standard 或 Xeoma Pro 许可证基础上激活。提供 1 小时试用模式，随后需要重新配置。

详见“人群检测器”

 


颜色识别



当该模块在指定区域实时检测到所选颜色时将被触发。该模块可独立工作以通过颜色拦截目标，也可与其他模块（如车牌识别器）协同工作，用于检测交通违章（例如检测闯红灯行为）。

从建议的基础颜色中选择检测颜色，或通过 RGB 或 HSV 色彩模式输入颜色。使用“灵敏度”阈值滑块以检测所选色系的细微色调。使用画笔将需要监测颜色的区域涂成红色。未标记为红色的区域将在颜色搜索时被忽略。勾选“仅分析变化区域”以忽略摄像机图像中的静态对象（此时模块仅搜索移动对象）。若要使用此功能，您需要在该模块之前的链条中添加“运动检测器”模块。

该模块需单独购买，并在 Xeoma Standard 或 Xeoma Pro 许可证基础上激活。提供 1 小时试用模式，随后需要重新配置。

查看模块推广页
 


Senstar PTZ 追踪

重要提示：自 2024 年 10 月起，Senstar PTZ 追踪不再作为独立模块提供，现已集成至 PTZ 追踪 模块中（可在 Xeoma Standard 和 Xeoma Pro 版本中使用）。

该模块可将您的视频监控系统与配备 Senstar 传感器的安保系统集成，并自动将摄像机转向报警区域。

为实现完整功能，该模块必须在链条中连接至 ONVIF PTZ 摄像机。
要接收来自传感器的报警，您需要在模块设置中输入安装有“Senstar Network Manager”软件的计算机的网络地址，且该软件必须已启用与视频安保系统的连接。

使用模块的高级设置来确定处理哪些设备的报警信号，以及报警时摄像机应移动到哪个位置：
选择设备编号，输入报警编号及摄像机位置的必要坐标（使用“应用当前坐标”按钮可自动输入摄像机的当前位置）。然后点击“添加”以新增待处理报警，“更新”以编辑当前选定的报警，或“删除”以删除当前选定的报警。

当收到待处理报警列表中的报警时，摄像机将自动转向所选区域，并启动向存档或其他指定目标的录制（录制时长由“录后时间”设置决定）。

支持大多数 Senstar 传感器，例如 FlexZone、OmniTrax、UltraWave 等。

了解更多模块详情

 


目标尺寸过滤



Xeoma 新推出的“目标尺寸过滤”模块可根据模块设置中配置的参数（宽度、高度）过滤目标。因此，该模块可用于检测具有特定参数/尺寸的目标。欲了解更多关于此模块的信息，请参阅本文

 


车辆速度检测器



该模块需与 ANPR 模块及 ISKRA DA/40 测速仪配合使用。ANPR 模块必须串联在本模块之后，且其识别方法应设置为“与测速检测器模块配合”。建议在此链路中将"ANPR Sender to FTP"模块作为目标模块。

更多详情请参阅本文

 


年龄识别器



Xeoma 的“年龄识别器”附加模块基于人工智能和神经网络。该模块可利用计算机视觉实时识别人员年龄。有关年龄识别器模块的更多信息，请参阅本文。

 


我的检测器



“我的检测器”允许用户添加神经检测器并在 Xeoma 中调用。
借助此模块，用户可基于第三方工具在 Xeoma 中创建自定义模块。该模块适用于集成各类工具与插件，并创建独立的“我的检测器”神经检测器。有关该模块的更多信息，请参阅本文。

 


声音事件检测器



该模块基于人工智能，可检测哭喊、尖叫、枪声、玻璃破碎声和汽车报警声等声音事件。

有关该模块的更多信息，请参阅本文

 


建筑工地安全检测器



该模块基于人工智能，可检测摄像机图像中人员的安全装备：安全帽和/或工作服。

点击此处了解更多模块详情

 


文本识别



该模块用于识别摄像机实时视频流指定区域内的文本。当在识别文本中检测到特定词汇，或检测到等于、大于或小于给定数值的数字时，该模块可触发相应响应。

点击此处了解更多模块详情

 


Modbus 控制器



该模块用于接收通过 Modbus 协议通信的控制器指令，并在 Xeoma 中触发相应动作。此类控制器广泛应用于自动化系统、智能家居、交通信号灯等设备中。
此类控制器具备输入端口（共 6 个，编号 0 至 5），可向 Xeoma 发送触发信号。请勾选复选框，指定 Xeoma 需响应的输入端口。具体端口与触发信号的对应关系，请参阅控制器文档。当收到特定端口的触发信号时，若本模块后串联了多个模块，您可指定将视频流推送至哪一个模块，从而实现系统对不同端口触发信号做出差异化响应。
添加模块时，请输入控制器的 IP 地址和端口号（通常为 502）。勾选所需端口的“响应此输入端口状态”复选框，并选择在触发时接收视频流的后续模块。若需反向响应（即：无触发信号时推送视频，有信号时停止），请勾选“反转端口状态”复选框。

点击“测试”以检查与控制器的连接情况。

有关此模块的更多信息，请参阅本文。

 

车位检测



Xeoma 视频监控软件的“停车位”附加模块用于自动确定并更新停车场的车位状态（空闲/占用）。该模块通过在选定区域内检测特定类型的目标来实现。
点击此处了解更多模块详情

 

滑倒跌倒检测器



“滑倒跌倒检测器”附加模块基于神经网络，能够检测监控视野内人员是否发生滑倒或跌倒。该功能适用于医疗及养老护理机构（尤其是老年护理场景），也可用于城市监控，以便对各类意外事故（包括从座椅或床上跌落）做出即时响应。
点击此处了解更多模块详情

 

眼球追踪



Xeoma 的“眼球追踪”附加模块是一款基于神经网络的扩展组件，使您的视频监控系统能够检测人员的视线方向。该模块无需特殊设备或传感器。利用获取的数据，您可以针对神经营销、科学研究及其他应用场景创建统计分析。

在此文章中查看更多信息。

 

热成像摄像机数据



Xeoma 的“热成像摄像机数据”是一款功能强大且极具性价比的全新工具，专用于解决物体温度测定相关任务。该模块可接收来自 HikVision 热成像摄像机的温度信息，并在最低、最高或平均温度等于、高于、低于设定值或处于指定范围时触发。

在这篇文章中详细了解该模块。

 

鸟类检测器



鸟类检测器是一款基于人工智能的模块，可检测摄像机视野中的鸟类并协助您进行追踪。该模块专为热成像 PTZ 摄像机设计，同样适用于固定热成像摄像机。

该模块最远可在 350 米距离识别鸟类，即便其在屏幕上仅呈现为一个点。基于预测鸟类飞行方向的人工智能技术，该模块可驱动 PTZ 摄像机朝鸟类飞行方向移动，实现尽可能平滑的跟随追踪。

在这篇文章中详细了解该模块。

 

心率监测仪

（即将推出）心率监测仪是 Xeoma 视频监控软件中的一款附加模块。这是一款独特的工具，利用摄像机视觉技术检测视野内人员的心率，无需额外传感器！

基于人工智能矩阵，此 Xeoma 模块可检测视野中的人员，定位其面部中心，随后读取仅计算机视觉可见的微小变化，从而估算人员心率。

在这篇文章中详细了解该模块。

 

货物卸载计数器



“货物卸载计数器”是 Xeoma 中基于人工智能和深度机器学习的模块，可检测摄像机视野内的货运车辆并统计已完成卸货的车辆数量。此模块仅在 Xeoma Pro 版本中提供。

“货物卸载计数器”兼容 IP 或 USB 等各类摄像机。卸货统计数据存储于 .csv 日志文件中，可导出至 Excel。此外，货运车辆卸货统计数据还可通过“标记”模块叠加显示在预览画面上。

详细了解 Xeoma 中的货物卸载计数器

 

餐厅顾客计数器



“餐厅顾客计数器”模块基于人工智能，专为统计餐厅、咖啡馆及其他公共场所餐桌就座的顾客而设计。

请在餐厅顾客计数器文章中查看该模块的详细信息。

 

360° 全景视图



"360° 全景视图”模块可将 4 台覆盖目标周边全区域的广角摄像机图像进行拼接，从而在单个窗口中生成展示 360° 视野的鸟瞰图。

请在"360° 全景视图”：Xeoma 基于人工智能的模块文章中阅读更多内容。

 

语音转文本

Xeoma 视频监控软件中由人工智能驱动的“语音转文本”模块可“监听”来自摄像机或独立麦克风的音频流，识别语音内容，并将转录文本保存至 CSV 报告或作为字幕叠加在预览画面上。此外，您可将其设置为对特定词汇或短语做出响应。该模块同样支持处理外部 .mp3 音频文件。目前，“语音转文本”处于 Beta 测试阶段，可能会出现循环或漏词现象。

请在语音转文本：Xeoma 的智能语音识别模块文章中阅读更多内容。

定时器

“定时器”过滤模块可设置链中后续模块的运行持续时间，以及工作周期之间的间隔。与“计划任务”模块不同，“定时器”模块仅处理时间，支持设置无限重复的循环操作间隔，可指定模块的工作时长和暂停时长。不同摄像机可配置不同的工作周期和间隔。此外，为节省带宽，该模块可在间隔期间停止接收摄像机的视频流。该模块适用于 Xeoma Standard 和 Xeoma Pro 版本。

欲了解更多详情，请参阅“Xeoma 中的定时器模块”一文。

持续时间检测器

“持续时间检测器”过滤模块在之前检测器的事件持续时间超过指定时长时触发。该模块也可基于相反原则工作，即在指定时长内未收到触发信号时做出响应。利用“持续时间检测器”，您可以对持续时间过长的事件做出响应，或者在画面中目标对象或事件缺失时间超过预期时触发操作。该模块适用于 Xeoma Standard 和 Xeoma Pro 版本。

欲了解更多详情，请参阅“Xeoma 中的持续时间检测器”一文。

反相器

“反相器”过滤模块可自动反转链条中前一个模块（或并行连接到“反相器”的多个模块）的状态。也就是说，如果前一个模块被触发并传递信号，“反相器”将将其拦截；反之，如果前一个模块未被触发，“反相器”则会将触发信号传递给链条中的下一个模块。该模块适用于 Xeoma Standard 和 Xeoma Pro 版本。

欲了解更多详情，请参阅“Xeoma 中的反相器模块”一文。

---

3.4.1. 通用摄像机



该模块允许您选择图像源：摄像机（IP、USB，含无线或模拟摄像机）或全球网络摄像机（“随机 IP 摄像机”）。

主窗口（多摄像机视图窗口）中显示的摄像机名称可在“预览”或“预览与存档”模块设置中指定，也可在“通用摄像机”模块设置的“源名称”字段中指定。此处可使用 %IP% 宏来显示摄像机的 IP 地址。

Xeoma 首次启动时将进入试用模式，并启动摄像机自动搜索。搜索到的摄像机将添加到主窗口中，或放入底部图标面板的“+”菜单中。
关于自动搜索的通用信息，请点击此处查看

针对 IP 摄像机：

您可通过底部图标面板的"+"菜单以任意方式添加 IP（网络）摄像机（有关自动搜索的更多信息，请参阅2.4. 自动搜索章节）。

您可在“通用摄像机”设置中配置以下参数（详见截图下方）：







源名称：在此输入主窗口（多摄像机视图窗口）中显示的摄像机名称。此处可使用 %IP% 宏，系统将自动将其替换为摄像机的 IP 地址。

设备类型：支持在 IP 摄像机、USB 摄像机和随机全球网络摄像机之间切换。对话界面将随选择动态调整，仅显示所选类型特有的设置。

“空闲时允许自动停止”复选框：勾选后，若后续模块未调用该模块（例如，后续连接的“调度器”设定当前为非工作时间），该模块将停止接收摄像机视频流。取消勾选则禁用自动停止——摄像机将持续发送视频流，即使在空闲时也不中断（若摄像机从空闲状态恢复时启动延迟较高，此设置尤为有利）。请注意，若后续过滤器要求全程接收视频流，即使勾选此选项，自动停止也不会生效。

点击“支持品牌列表”文本链接将跳转至我司网站（将在设备的默认浏览器中打开相应网页）。使用此功能需连接互联网。
“未找到？”/“优化技巧”文本链接将打开提示弹窗，提供搜索或优化建议。

自 Xeoma 22.10.12 版本起，“通用摄像机”模块的设置对话框新增了一项功能，可在默认浏览器中打开摄像机的 Web 管理页面。



使用此按钮，可通过摄像机的 Web 管理面板（在 Xeoma 外部）快速应用设置变更。

用户名和密码字段：在此输入访问摄像机流所需的凭据。通常这些凭据与访问摄像机 Web 管理页面的凭据相同，但部分摄像机可能为特定流或 ONVIF 用户设有独立凭据。

摄像机预览流的完整 URL 地址（次要、低分辨率流（推荐 mjpeg））部分用于配置预览流。
预览流参数：此字段用于输入摄像机流 URL，该流将显示在“多摄像机视图窗口”（亦称“预览流”）中，并供检测器使用（除非在检测器设置中另有指定）。该字段通常自动填充为 Xeoma 搜索到的 URL，但您也可手动输入已知 URL。自动搜索期间，Xeoma 通常会发现多个可用于“预览”的流选项；此时您可在此下拉菜单中查看可用选项。流信息将以方括号形式标注在实际 URL 之前，例如 [640×360 25 fps h264 1024 kb]。编辑此信息无效，其仅供参考。Xeoma 将直接获取摄像机 Web 管理界面中设定的流参数（分辨率、帧率、格式、比特率）。
为获得最佳性能，建议在条件允许时利用摄像机的多流功能（在 Xeoma 中称为“无需转换直接保存至归档”）（详见下文）。

仅当“摄像机预览流的完整 URL 地址（次要、低分辨率流（推荐 mjpeg））”字段中使用 H264/H264+ 流时，才会显示仅解码关键帧选项（不适用于 MJPEG 或 H265 流）。
勾选此项可通过仅解码流的关键帧，降低解码压缩 H264 流带来的处理器负载。用于“预览”的流分辨率越高，此选项在降低处理器负载方面的效果越显著。根据摄像机设定的关键帧间隔，这可能导致视频流观感不够流畅（出现“跳帧”现象）。

传输协议类型：可选择 Auto、TCP、UDP、UDP Multicast 等帧传输方式。若遇到流失真（灰色或绿色花屏），请尝试在此下拉菜单中选择其他选项。更多关于解决失真的建议，请点击此处

“缓冲视频流读取”复选框用于启用视频流预缓冲，以实现更流畅的显示。这可能会导致 1–5 秒的延迟并增加内存占用。

“对搜索结果不满意”文本链接将打开提示弹窗，提供搜索建议。
点击“按 IP 地址自动搜索摄像机”文本链接，将弹出对话框以启动摄像机搜索。要使用此功能，您需在“摄像机预览流完整 URL 地址”字段中输入摄像机的 IP 地址。

用于无需重新编码即可保存至存档的 H.264/H.264+/H.265/H.265+ 视频流完整 URL（无预览）部分旨在利用摄像机的多码流功能。必须勾选下方的“启用无需转换的 H.264/H.265/H.265+ 录像存档”复选框方可生效。
在存档流参数字段中输入摄像机主码流的 URL，即可将其录制到存档中（亦称为“用于存档”）。该字段通常由 Xeoma 自动填充已发现的 URL，但您也可手动输入已知 URL。在自动搜索期间，Xeoma 通常会找到多个可用于“预览”的流选项；此时，您可在下拉菜单中查看这些可用选项。流信息将显示在实际 URL 之前的方括号内，例如 [1280×720 25 fps h264 2 Mb]。编辑此信息不会生效，仅供参阅。Xeoma 直接从摄像机的 Web 管理界面获取流参数（分辨率、帧率、格式、比特率）。

若勾选相应选项（见下文），此 URL 可用于在单摄像机视图窗口中显示。

启用无需转换的 H.264/H.265/H.265+ 录像存档：勾选此框以启用存档流参数字段中的 URL。若未勾选此选项，系统将忽略存档流参数字段中的 URL，转而使用
预览流参数字段中的 URL 进行录制。

在单摄像机视图模式下使用 H.264/H.265/H.265+ 流（来自存档）：勾选此框，使“存档流参数”字段中的 URL 在单摄像机视图窗口中显示。

请注意，多码流选项（在 Xeoma 中亦称“直接保存至存档”）仅适用于至少拥有一路 H.264/H.264+/H.265/H.265+ 格式码流的摄像机。 如果您使用“预览与存档”模块（默认模块）保存视频录像，启用此“直接存档保存”选项的摄像机录像将保存为.mkv格式；若未启用此选项，录像将保存为 .xem 格式。 在这两种情况下，录像均可在 Xeoma 内置的存档查看器中查看。 了解更多关于双流传输的信息 查看我们的Xeoma 双流传输分步指南

“低质量存档：将预览流额外记录到存档”选项（适用于 Xeoma 22.3.16 及更高版本）可在保存常规（通常为高质量）存档的同时，并行保存低质量录像。
低质量存档可用于：
* 同时查看多个摄像机录像时降低处理器负载（尤其是在使用倍速播放时）；
* 在网络带宽受限的环境中导出存档片段；
或
* 在长期存储重要视频证据时优化磁盘空间。

低质量存档的存储时长可在"预览与存档"模块设置中配置。

导出时，可在 Xeoma 内置存档查看器的导出对话框中选择低质量存档。

如需在同时查看多个摄像机录像时使用低质量存档（Xeoma Pro 功能），请在布局 (Layouts)菜单 -> 客户端解码设置中，勾选“同时查看多个存档时优先使用低分辨率录像”。

如果可用，使用硬件解码加速：勾选此复选框以启用硬件加速——CUDA（适用于 Nvidia 显卡）或 QuickSync（适用于 Intel 处理器）。详见“4.13 硬件加速”章节”
Linux 设备仅支持 CUDA；Windows 支持 CUDA 和 QuickSync。Mac OS、Android 或 Linux ARM 目前尚不支持硬件加速。

使用摄像头音频流：取消勾选后，系统将忽略摄像头的音频流。
勾选后，将显示 “摄像头音频流完整 URL 地址”（例如 http://IP/audio.cgi） 字段。若音频流独立传输，请在此输入其 URL（可在摄像头的 Web 管理界面、文档或互联网上查找）。通常音频会随摄像头的 RTSP 流一同传输，因此该字段填写的 URL 往往与“存档流参数”字段中的 URL 一致。

摄像头音频流完整 URL 地址”（例如 http://IP/audio.cgi)：详见上文。

音质/采样率：从下拉菜单中选择所需的 kHz 数值。采样率决定了接收到的数字音频流的频率范围。

FPS：此下拉菜单用于选择帧率（仅适用于 JPEG 流）。可选范围：从“最大值”到“每天 1 帧”至“每秒 50 帧”。

启用 PTZ 控制：从下拉菜单中选择适用于该摄像头的 PTZ 命令集。此功能仅适用于具备实际 PTZ 功能的摄像头。选择所需的 PTZ 命令集后，点击"Test PTZ"链接进行测试。配置正确后，您将在 Xeoma 的单摄像头视图窗口中看到 PTZ 控制面板，并可手动或自动旋转摄像头。在此了解更多关于 Xeoma PTZ 的信息

PTZ 控制 HTTP 端口（如果摄像头支持 PTZ）：如果摄像头使用非标准端口，请在此输入用于 PTZ 控制的端口。请访问摄像头的 Web 管理页面（在浏览器地址栏输入其 IP 地址）以获取端口信息。

摄像头旋转 PTZ 反转设置：若摄像头安装方向与常规使用方向相反（如倒装），您可能需要反转 PTZ 命令的响应（例如按下“左”键时摄像头向右旋转）。通过此选项，您可以启用水平反转、垂直反转或同时启用两者。

可用配置文件令牌列表（仅适用于 ONVIF 摄像头）：若 使用 PTZ 控制 设置（见上文）中的 PTZ 配置文件无效，可尝试此下拉菜单中的其他选项。在极少数情况下，PTZ 命令与摄像头流紧密绑定；若您无法通过更改 URL 来启用所需的 PTZ 配置文件，可在此选择流配置文件——此设置仅影响 PTZ 命令的可用性，不会改变用于“预览”的流 URL。

ONVIF 摄像头设置：（仅适用于支持 ONVIF 的摄像头）此选项将打开一个弹出窗口，包含锐度、FPS、快门速度等基础设置。Xeoma 仅显示摄像头通过 ONVIF 提供的选项。若某项设置未在此显示，则表明该摄像头不支持通过 ONVIF 对其进行控制。

注意：摄像头聚焦设置以及雨刷/清洗等辅助功能需在别处查找：PTZ 控制对话框（位于 快速设置 / 单摄像头视图 窗口中）。

针对USB摄像头：从列表中选择您的摄像头。选择所需的图像刷新率 (fps) 和图像分辨率组合（由摄像头驱动程序设定）。下方是亮度、对比度、锐度等图像设置的常规选项，您可以通过滑块进行调整。“恢复默认值”将设置还原为摄像头的初始配置。

针对网络摄像头：您可以在高级设置菜单中指定图像刷新率。

针对模拟摄像头：

Xeoma 支持使用 DirectShow/WDM 驱动且每通道配备 1 个芯片的视频采集卡。此类采集卡在 Windows 中被识别为多个独立设备（设备 #1、设备 #2 等），Xeoma 将其识别为多个 USB 网络摄像头。Xeoma 采用默认设置运行，因此如果运行效果不符合预期，您需要修改采集卡或模拟摄像头的默认配置。

Xeoma 同样支持具有各通道 JPEG、MJPEG、WEBM (VP8 和 VP9) 或 MPEG-4 流直接 URL，并可通过 http 或 rtsp 协议传输视频的DVR (数字视频录像机)。Xeoma 将此类 DVR 识别为多个独立的 IP 摄像头。有时可通过简单的搜索或通过 IP/密码搜索（均在下方面板的“+”菜单中启动）自动发现这些摄像头。但在某些情况下，若要将 DVR 连接至 Xeoma，您需要获知该 DVR 视频流的精确 URL (MJPEG/H264 的 http/rtsp)。您可以在设备文档、Web 管理界面中查找，或直接联系 DVR 制造商咨询。

 

---

3.4.2. 移动侦测

该模块在安防摄像头软件中至关重要，它支持在指定区域设置移动侦测、移动停止、禁区侵入、区域驻留侦测、人员活动监控，并能区分移动对象与背景。

该模块基于计算机视觉技术，侦测视频流中的像素变化，并将事件记录在可搜索的日志中。支持根据元数据和所有系统信息进行综合搜索。



使用灵敏度滑块指定归档数据。0 级表示系统对任何速度或尺寸的对象都极度灵敏；100 级表示高灵敏度阈值，仅当大型对象产生明确移动时，才会触发警报或您指定的其他操作。当前灵敏度滑块可让您了解触发系统响应所需的移动速度和频率。

遮罩：设置任意形状和尺寸的侦测区域。用红色标记需监控移动的区域，透明区域则忽略移动。您可调整画笔大小以填充或清除监控区域。在“自动”模式下，系统会根据画笔下方的区域自动选择填充或清除效果。仅当对象尺寸大于您设定的“对象尺寸”时才会触发警报，请仔细设置。

移动轨迹可视化功能可追踪移动对象的路径。即使您未实时捕捉到移动，也能随时查看移动对象的来源。

在 Xeoma 安防摄像头软件中，您可以在两种侦测方法之间进行选择：比较相邻帧（即 帧差法）或比较累积背景（即 背景减除法）。

此外，您可设置侦测延迟——持续时间短于指定值（秒）的移动将被忽略。预录功能可将直接侦测到移动之前的事件存储至归档。后录选项则可在移动结束后将后续帧保存至归档。

设置项的颜色会发生变化。如果某项设置阻断了视频流，它将显示为黄色。如果该设置开始将视频流传递至后续模块，则变为绿色。

通过“仅检测特定时段内的静止状态”选项，您可以反转运动检测器的工作逻辑，使其仅在摄像头前的运动停止时触发，例如用于监控计数器或设备运动部件的场景。请使用滑块设定时间阈值——若静止状态持续时间超过该值，将触发后续模块。

“持续工作以启用存档中的动作搜索”：勾选此项后，动作检测器将切换至“忽略”状态（20.10.13 之前的版本为“跳过”）（当存档位于动作检测器之后时，将执行持续录像）。此选项适用于需要持续录像且同时需要在存档中进行动作搜索的场景。这样，Xeoma 安防摄像头软件中的动作检测器将仅收集动作事件的数据。

自 Xeoma 20.10.13 版本起，在 Xeoma Peo 许可下，“运动检测器”模块设置中新增了“车辆识别”和“人员识别”选项，旨在仅在需检测车辆或人员运动时避免误报。勾选相应选项可将误报率降至最低（但可能会增加 CPU 负载）。此外，自 Xeoma 23.6.14 版本起，您可设置人员或车辆识别的准确度级别，以便根据实际环境精细调优，消除因识别精度不足引发的误报。

“运动检测器”模块中还内置了一项硬件级选项，可有效避免摄像头切换至红外模式时产生的误报。

如需排查误报问题，请参阅：监控软件 Xeoma 中的误报问题
另请参阅文章：视频监控软件 Xeoma 中运动检测器的高级选项。

自 Xeoma 23.3.22 版本起，我们优化了当高低分辨率流的宽高比不一致时，模块设置中的区域选择逻辑。当前，在此类及其他需在设置中配置检测区域的模块中，系统将采用选定用于运行的特定视频流（默认为预览流；若勾选“使用存档中的高分辨率流”选项，则采用用于存档录制的视频流）。

---

3.5. 存档

“预览与存档”模块不仅可将传入图像存入存档以供日后查看，还能在屏幕上实时显示图像。与“预览”模块类似，它支持实时查看当前画面，并允许根据指定参数在存档中进行交互式搜索。当光标悬停在相应的预览框上时，该框周围将显示蓝色边框。

存档设置与保存

在设置中，您可以为摄像头命名，该名称将显示在主窗口的预览框中（同时应用于设备列表、电子地图及用户权限分配）；并可指定该摄像头所属的一个或多个组，以便在设备列表中进行后续管理。此外，在该模块设置中，您可配置录像存储时长（即录像在被新数据覆盖前的保留时间）、最大存档容量（该摄像头在硬盘上占用的存档空间）以及帧保存频率。



从 Xeoma 21.4.2 版本起，您可以利用“智能”自动分布功能，将录像均匀分配至多个磁盘。只需在“预览与归档”模块设置中指定多个文件夹、磁盘或 RAID 阵列路径，Xeoma 即可自动平衡归档负载，将新录像保存至剩余空间最大的磁盘。该功能适用于 Xeoma Standard、Xeoma Pro 版本以及 Xeoma Pro Your Cloud 服务。 自官方版本 22.3.16 起，Xeoma 新增选项，允许禁用基于路径自动创建缺失文件夹的功能。 此功能在 Unix 系统中尤为实用，特别是在用户将磁盘挂载至指定文件夹时。

值得注意的是，“始终预留 HDD 空间”选项会根据摄像头数量自动调整。
自 Xeoma 23.3.22 起，若该设置值已被手动修改，系统将采用新设定的值；否则，将沿用程序推荐的自动设定值。

在高级设置（点击展开）中，您可以按原始图像的百分比降低存储帧的分辨率和质量（默认与原图一致）；指定归档文件的存储路径；或设置全局限制（应用于所有归档），规定 Xeoma 必须始终预留的可用空间。

自 22.3.16 版本起，Xeoma 支持高低画质录像并行保存。 低画质归档适用于多路录像的低资源同步查看、导出，或重要视频证据的长期存储。查看详情

注意： 得益于循环录制功能，一旦超出容量限制，Xeoma 归档将自动覆盖最早的素材。您绝无需担心磁盘写满或因预留空间耗尽而导致录像停止。但若全局磁盘限制设置导致 Xeoma 无可用存储空间，系统将停止录制。路径框下方显示的 Preview.Archive.{Number} 名称，便于您直接在磁盘上定位该摄像头的 Xeoma 录像文件。

注： 若归档总容量超过 3 TB，建议确保归档数据库（位于 …/Xeoma/XeomaArchive/Database）与归档文件本身存储于不同的驱动器上。

自 Xeoma beta 23.12.7 起，“预览与归档”模块设置中新增“启用降噪”选项。该选项兼容 Xeoma 中的所有音频类型，即使采用直接保存至归档的模式，也能提供纯净音质。降噪仅作用于归档录像。只要激活了至少 1 路摄像头的 Xeoma Pro 许可证，所有摄像头均可使用此功能，Xeoma Pro Trial 版本同样支持。

3.5.2. 归档回放

除非您另行指定路径，否则所有摄像头的录像将默认存储于用户目录，并按日期自动分类至相应文件夹。归档录像支持在线与离线两种查看模式。您可以在浏览归档的同时，让 Xeoma 继续执行监控与录制任务。

Xeoma 存档配备了便捷的内置媒体播放器，采用多线程快速播放机制。存档时间刻度可调（从秒到天），方便您快速定位所需时间段并开始播放。向左或向右拖动时间轴滑块，或滚动鼠标滚轮即可更改时间刻度。此外，您可以通过日历选择日期和时间以快速跳转。使用箭头进行导航并选择具体的日期和时间。您可以调节录像的播放速度，例如以快进模式播放无关紧要的片段，而将重点放在关键部分——向左或向右拖动速度滑块即可减速或加速播放（默认设置为正常速度）。点击时间轴两端的白色箭头，滑块将跳转至前一分钟或后一分钟（若正在查看搜索结果，则跳转至上一个或下一个事件）。

以下为您详细介绍此处的所有元素。



以下是您在存档播放器界面中会遇到的元素和控件。

1 – 摄像头名称。该名称取自该摄像头的“通用摄像头”或“预览与存档”模块。如果两者均有名称，则显示其组合。

2 – 跳转至上一个/下一个摄像头。这两个双箭头用于切换到上一个（左箭头）或下一个（右箭头）存档。从技术上讲，这可能不是上一个/下一个摄像头，而是同一摄像头的上一个/下一个存档（如果该摄像头的链条中具有多个“预览与存档”模块，或者该摄像头被多次重复添加）。
仅在有可切换的摄像头/存档时才显示箭头：例如，如果您正在查看最后一个摄像头，则不会显示右箭头，因为没有下一个存档。

3 – “暂停”。如果播放已暂停（见“9”），此处将显示红色暂停标志。

接下来是 Xeoma 存档查看器“底部面板”的元素概览。底部面板在闲置超过 3 秒后会自动隐藏，以免遮挡视野。任何操作（例如移动鼠标）均可将其唤回。此外，在 Xeoma Beta 24.7.9 及更高版本中，您可以点击面板标签并稍向下拉，将其切换至最小尺寸，或完全拉到底部以隐藏面板（仅保留标签用于唤回）。同时，若在面板任意位置长按，可将面板完全向上拖动——当您需要查看屏幕下方内容但仍需保留面板时，此功能尤为实用。

4 – 跳转至上一个/下一个录像。位于时间轴末端的这些箭头，点击一次可跳转至录像的前一分钟（左箭头）或后一分钟（右箭头）（若执行了存档搜索，则跳转至上一个/下一个事件）；长按则可加速跳转。

5 – 退出存档。点击此按钮退出存档查看器并返回实时视图。

6 – 存档菜单。点击此按钮可打开包含搜索、导出、缩放等更多选项的菜单。有关该菜单及其选项的详细信息，请参阅下方内容

7 – 存档播放器的时间轴。根据所选时间尺度（参见 12）及录像数量，轴上会显示分钟、小时、天或年等刻度。包含录像的时段显示为浅蓝色 (7)，无录像的时段则为空白 (8)。部分时段可能显示为灰色，表示该时间段内视频流出现异常。

请注意，使用 Xeoma Pro 的多存档同步视图时，录像颜色可能会有所不同。

若执行了录像搜索，包含目标对象的时段将显示为亮绿色。详见下文存档菜单选项

9 – 暂停/恢复播放。该按钮有两种状态：默认情况下，存档播放时显示“暂停”图标，点击可暂停播放；暂停后，按钮变为“播放”图标，点击即可恢复播放（此时 (4) 处还会显示红色暂停标志）。

10 – 时间轴滑块。滑块上方会显示一个蓝色区域，标示当前播放录像的时间/日期。随着播放进行，滑块沿时间轴移动；您也可用鼠标将滑块拖至任意位置，从该时刻开始播放。

11 – 播放速度滑块用于调节录像回放速度。默认设置为 1x（正常速度）。按住并拖动滑块即可更改速度：向右（朝"+"号）加速（最高可达 900 倍），或向左（朝"-"号）减速。
0.05x 速度将启用逐帧播放。

当播放速度为负值时，将启用反向播放——即从“现在”向“过去”倒序回放录像。例如，-2.0x 速度表示以两倍速倒序播放。详见下文反向播放章节。

12 – 时间尺度滑块用于调节 Xeoma 存档播放器的时间轴比例。按住并拖动滑块即可更改比例：向右（朝"+"号）增大比例，在时间轴上显示更详细的分钟和小时刻度；向左（朝"-"号）减小比例，以显示天、月或年级别的录像（如有）。在最小比例下，您可预览时间轴上的所有录像，选择所需日期/时间的录像后，再增大比例查看该录像的详细时间轴。最大比例为 1 分钟，此时时间轴还会显示秒数。

13 – 日历按钮可打开一个弹出窗口，供您选择特定的日期和时间以播放录像。日历窗口左侧显示当前月份的日历。有录像的日期显示为白色，无录像的日期显示为灰色。下方设有箭头，可快速跳转至前/后一天，或直接定位到存档中第一条/最后一条记录所在的日期。
日历窗口右侧设有小时和分钟滚轮，用于为左侧选中的录像指定更精确的时间。滚轮中以白色高亮显示存在录像的小时或分钟时段。分钟按 5 分钟一组向下取整，因此若您想查看上午 10:03 的录像，请在小时滚轮中选择 10，在分钟滚轮中选择 00——这将涵盖上午 10:00 至 10:05 期间的所有录像。

14 – 跳转至存档末尾将时间轴滑块 (10) 移动到该存档中最新条目的起始位置。

请注意，执行存档搜索后，此按钮将被一个具有两种形式的按钮取代。一种形式为绿色播放按钮，表示仅回放包含所搜对象的片段；另一种形式为下方带有绿线的白色播放按钮，表示回放所有录像，无论是否包含所搜对象类型。

 

存档时间轴中的运动强度

自 Xeoma Beta 24.7.9 版本起，若摄像机处理链中配置了 “运动检测器”模块，Xeoma 将在存档时间轴上呈现 运动强度可视化效果。颜色越深表示运动越少，颜色越亮则表明运动越频繁。此功能是对 运动轨迹可视化（有助于追踪移动对象的行进路径）和 热力图（同样基于 运动检测器 数据，但使用不同颜色标识画面中运动强度各异的区域）功能的有力补充。此外，全新的 存档时间轴运动强度 功能在打开播放器时即自动就绪，无需任何额外操作，助力操作员仅需扫视时间轴即可快速把握运动态势。

以下是颜色含义的详细说明：



 

倒序回放
从 Xeoma 23.3.22 版本开始，Xeoma Pro 版本新增了 倒序回放 功能（即从时间轴某一点向后回溯至先前事件的逆向回放）。倒序回放适用于常规录像、双存档（低质量并行录像）以及多路摄像机录像的同步查看。

您可以使用键盘快捷键操作全新的倒序回放功能。按下键盘上的 “+” 键执行常规正向回放，或按下 “–” 键启用倒序回放。
 

存档菜单选项



让我们查看 Xeoma 存档播放器窗口的“存档”菜单中包含哪些选项。

首先，“存档”菜单中设有 起始位置 选项，用于设置下次进入存档时的打开位置 —— 可选择在最开始的条目、距离存档末尾 5 分钟处或上次离开的位置（后者为默认设置）。

接下来是 Xeoma Pro 的“可视化设置”选项，用于在录像回放中启用或禁用运动可视化，效果类似于实时视图运动可视化。您可以在此处了解更多 Xeoma Pro 独有功能

下一个选项是 存档搜索，支持在录像中搜索各种对象。大多数选项要求摄像机处理链中运行相应的模块以采集数据。例如，按运动搜索需要“运动检测器”，按情绪搜索需要额外的“人脸检测器（情绪）”，依此类推。此子菜单还包含“车牌日志”和“识别人脸日志”选项，用于查看这些对象类型的事件日志。

导出选项可将归档中的特定片段保存为您选择的格式。若您通常以 MJPEG (.xem) 格式存储，却需向有关部门提交片段，且要求该片段能在大多数播放器中正常播放，或者您仅需保存归档中的截图，此功能将极为实用。所有操作均通过“导出”选项完成：点击一次，时间轴上即会显示白色小三角形；移动它们以框选所需片段；再次进入菜单并点击“导出”。随后将弹出提示，让您选择保存路径及转换格式。

导出对话框提供多种音视频格式，以及一种纯音频格式（.wav，自 Xeoma 23.3.22 版本起可用）。
若需导出包含单路视频流和多条音轨的片段，请选择 .mkv 格式。.mkv 也是唯一支持“标记”模块字幕的容器格式（适用于启用“直接保存至归档”功能时）。

若需导出多音轨片段，请选择 .mkv 格式。

借助新增的“除常规归档外保存低质量归档”选项（Xeoma 22.3.16 及以上版本可用），低质量录像也可用于导出——尤其适用于网络环境受限时的快速远程下载。
通过此功能，您可选择从摄像机的高质量归档或低质量归档中导出录像。

您可在"通用摄像机"模块设置中，启用保存摄像机视频流低质量副本的功能。
低质量归档的存储时长可在"预览与归档"模块设置中进行配置。

通过“删除区间”选项，您可永久删除归档中的片段。其操作方式与导出类似：使用白色标记选定片段，然后再次点击该选项。请务必谨慎，此操作不可撤销。
对于持有 Xeoma Pro 许可证的系统，此菜单还提供以下选项：将部分归档设置为禁止删除、查看此类受保护部分，或撤销其禁止删除状态。

重新索引归档：若您希望利用非 Xeoma 录制的素材扩展归档，需让归档“识别”这些文件。为此，请在归档菜单中选择重新索引归档。自 Xeoma 23.6.14 版本起，您无需等待完整重新索引完成即可查看录像——每段录像一经重新索引完毕，即刻可用。

开启缩放模式：若素材的某部分过小难以辨认，可使用数字缩放仔细查看。请在归档菜单中选择“开启缩放模式”。随后，您可滚动鼠标滚轮，以当前光标位置为中心进行放大或缩小；也可直接点击需要放大的区域；还可按住鼠标左键并拖动框选特定区域以实现放大。


截图功能可在查看归档时进行截屏。点击归档菜单中的“截图”，在新窗口中选择截图存储位置：可选择“同时保存在客户端和服务器端”或“仅保存在客户端”。若要快速访问所有已创建的截图，请选择“打开截图目录”。此外，您还可打印截图，或使用“通过电子邮件发送”选项将其发送至指定地址。


选择要回放的摄像机是另一项 Xeoma Pro 专属功能——它允许您在 Xeoma 归档播放器中选择多台摄像机，并同步查看其归档记录。


选择人脸并添加到数据库是 Xeoma “人脸识别”训练的一项功能，可将录像中出现的人脸添加至识别数据库的白名单或黑名单中。点击此处查看更多关于人脸识别训练选项的信息


创建热力图同样是 Xeoma Pro 授权系统中提供的功能。该功能可将摄像机视野内活动最频繁的“热门”区域以色彩形式呈现。运动数据源自 Xeoma 的“运动检测”模块，因此，若需为某摄像机创建热力图，其处理链中必须包含此模块。了解更多关于热力图的信息


接下来是 “播放 ONVIF 存档”选项，同样适用于 Xeoma Pro 版本。使用该选项，可在 Xeoma 的存档播放器中查看存储在符合 ONVIF 标准的摄像机或 DVR 端的录像。查看此功能的详细信息


时间轴上的微缩预览
从 Xeoma 23.12.7 版本开始，在 Xeoma 存档播放器的时间轴上将光标悬停，将显示该片段中关键帧的小缩略图（微缩预览图），类似于在 YouTube 上观看视频。光标悬停位置将显示时间轴滑块的“虚影”版本，而“主”滑块（见 3.5.2 存档播放部分的第 10 点）保持不变。



 

3.5.3 存档专业功能（需要 Pro 授权）

同时查看多个存档
如果您想同时查看来自多个不同摄像机的存档录像，可以在存档菜单中选择要播放的摄像机。随后点击需要高亮显示的摄像机，并按下“存档”按钮。所有选中的摄像机将同时显示在屏幕上，其录像在底部将以不同颜色的线条标记。

借助在常规存档之外保存低质量存档的新选项（适用于 Xeoma 22.3.16 及更高版本），在同时查看多个摄像机录像（尤其是使用倍速播放时），可利用低质量录像以降低处理器负载。为此，请在 布局 菜单 -> 客户端解码设置中勾选“多存档同时查看时优先使用低分辨率录像”。

您可以在“通用摄像机”模块设置中启用保存摄像机视频流的低质量副本。
低质量存档的存储时间可在“预览与存档”模块设置中进行配置。

运动可视化

“运动可视化”功能不仅能检测移动对象，还能追踪其轨迹。



将存档片段标记为不可删除

在存档中选择特定时间段并将其标记为不可删除（存档 -> 主菜单 -> 删除时间段 -> 将所选时间段保存为不可删除）。此功能可确保重要录像片段不丢失，并将操作员误删的风险降至最低。



按运动搜索

“按运动搜索”功能让存档导航更加便捷高效。选择此选项后，直接在摄像机视图上框选一个矩形区域以搜索其中的运动事件。搜索到的运动事件将在时间轴上以绿色高亮显示。您可以同时选择多个搜索区域；点击区域内部可取消选择该区域，通过存档播放器菜单中的选项可取消选择所有区域。



搜索已识别的车牌
如果您正在使用“ANPR”模块，可通过“存档”功能查看其识别结果。在“存档”菜单中选择“按车牌号搜索”，即可检索摄像头检测到的任何车牌号。Xeoma 将立即跳转到存档的相应时段，显示该特定车辆。此外，您还可以选择“车牌日志”，按日期访问检测到的完整车牌列表（您可以使用日历在不同日期之间切换）。

添加人脸以进行识别（训练）
如果您正在使用“人脸检测”模块，可以训练 Xeoma 从存档中识别特定面孔。为此，请在“存档”菜单中选择“选择人脸并添加到数据库”。您需要输入人员姓名，然后在该人员面部周围拖动一个选框。

NVR 或 DVR 存储
Xeoma 支持视频采集卡。这使得您能够在 IP 网络中利用现有的模拟摄像头，并对模拟和 IP 摄像头进行统一的中心化管理。

Xeoma 同时兼容 NVR 和 DVR 存储。视频压缩（编码格式）、分辨率和移动侦测录像等因素会影响 DVR/NVR 的存储容量，Xeoma 助您高效利用存储空间。

使用 Xeoma，您可优化几乎任意 DVR 或 NVR 的存储效率。

降低硬盘占用的替代方案
另一种方案是使用“保存到文件”模块，采用其他编码格式（例如高压缩率的 H.264）保存视频——这样视频占用的空间更少，但无法使用 Xeoma 的内置播放器播放。

或者，如果您的摄像头支持 RTSP (H.264)，可以使用无需重新编码直接保存至存档。


高低质量录像并行保存

从 22.3.16 版本开始，Xeoma 在常规（通常为高质量）存档的基础上，增加了低质量录像的并行保存功能。

低质量存档可用于：
* 同时查看多路摄像头录像时降低处理器负载（尤其是在使用倍速播放时）；
* 在带宽受限的网络环境中导出存档片段；
或
* 长期存储重要视频证据时优化磁盘空间。

您可以在"通用摄像头"模块设置中启用“低质量存档：将预览流额外录制到存档”选项，以保存较低质量的视频流副本。系统将利用“摄像头的预览流完整 URL 地址..."字段中的预览流进行录制，同时保留高质量常规录像。磁盘空间需求将根据预览流参数相应增加。参阅此说明，了解如何计算低质量存档的空间需求。

默认情况下，低质量存档的存储时长与主高质量存档一致。如需自定义存储时长，请在"预览与存档"模块设置中勾选“低分辨率录像的最大总存储时间”复选框，并使用下方滑块设定所需时长。

请注意，由于技术原因，您无法为低质量存档选择自定义名称或自定义保存路径。低质量存档将与摄像头的主存档保存在同一目录且名称相同，但扩展名为 .lq。

在导出时，可以在 Xeoma 内置存档查看器的导出对话框中选择低质量存档。

如需在同时查看多路摄像头录像时使用低质量存档（Xeoma Pro 功能），请进入布局菜单 $\rightarrow$ “客户端解码”设置，勾选“同时查看多个存档时优先使用低分辨率录像”。

您可以使用我们的最低系统要求计算器来估算存档存储所需的磁盘空间。

高级设置：虽然查看存档必须通过图形界面完成，但您仍可通过部分高级选项控制存档记录的特定参数： 可使用“-noarchivedb”命令选择不创建存档数据库。该数据库用于记录运动事件的元数据并支持存档搜索。若使用此选项，上述两项功能将不可用。 “-reindexingArchive”命令用于启动存档重新索引（例如在手动从磁盘导入或删除记录后）。 “-compressdb”命令用于在存档数据库体积过大时对其进行压缩。 “-archivecache [DirPath]”命令用于指定新的缓存目录路径（位于内存盘或高速 HDD），以加速存档写入 “-uselocaltime”命令用于在创建存档时使用本地时间而非 UTC 时间。 请参阅此处关于控制台命令的更多详情

---

3.6. 人脸检测与人脸识别

除了其他功能外，Xeoma 还支持摄像头检测人脸并识别特定面孔。系统还可以存储其覆盖范围内的人员完整名单。这在监控员工活动或构建防止非法入侵的自动安保系统时尤为有用。您可以将其设置为忽略少量人员，或在人数超过特定阈值时停止录像。不想让摄像头检测路过的人员？想确保 Xeoma 不会将一个人误认为另一个人？

高识别与鉴定精度源于对多个人脸视角的比对分析。系统支持识别运动中的人脸。

运行流程：在线模式下，当人员出现在画面中时，实时捕捉、识别并保存面部生物特征向量。系统结合使用了自有算法与第三方算法。

您可通过“人脸检测器”模块实现此功能。将其加入处理链并点击以进入设置。若需检测进入摄像头视野的所有人脸，请在“反应类型”区域选择“对任何人脸做出反应”。您还可通过滑块设置触发所需的最少人脸数量（若需确保某区域绝不拥挤，请调高该数值）。在详细设置中，您可指定摄像头视野内需检测人脸的区域（类似于“运动检测器”）。此外，还可调整人脸识别范围；例如，若摄像头安装于狭窄空间且人脸始终贴近镜头，建议将范围设为“短”或“中”。

人脸识别
若需摄像头识别特定人脸组合，可对 Xeoma 进行训练。具体有两种方式：

1) 在“人脸检测器”设置中输入人员姓名（或其他 ID），当待保存人脸处于摄像头视野内时，点击“训练人员识别”。Xeoma 会将该人脸录入数据库并绑定相应姓名（或 ID）。

2) 如果要添加的人员已被录像，您可以进入存档并从中选取合适的人脸。点击相应摄像头的“存档”按钮，找到包含所需面孔的帧（画面越大效果越好），然后选择“存档菜单” -> “选择面孔并添加到数据库”。现在只需输入姓名并在面孔周围绘制方框即可完成

建立包含多个人脸的数据库后，您可将“人脸检测器”设置为仅对选定人脸做出反应，或仅对未知/未选定人脸做出反应。后者适用于监控未经授权人员。选择任一选项后，下方将显示完整数据库的姓名（或 ID）列表，您可根据需要勾选或取消勾选。借此，您可让 Xeoma 仅识别特定人员而忽略其他，或仅关注未知人员。

请勿忽略"最低识别准确率"滑块。它用于调节检测人脸与原始图像的相似度。若发现摄像头偶尔将陌生人误判为名单人员，请调高该滑块。

与自动化系统集成

当检测到人脸时，Xeoma 可以通过 “HTTP 请求发送器” 模块将此信息发送至自动化系统。在“人脸检测器”后连接 “PTZ 跟踪” 可使 PTZ 摄像头跟随人员，而“声音报警”则会触发警报。

---

3.7. 访客计数器

“访客计数器” 是一项独特功能，可有效分析商店、展厅的客流量或办公室的出勤情况。该模块支持在计算数据中剔除员工（需与“人脸识别”模块配合使用）。

首先，在链条中的 “运动检测器” 之后插入 “访客计数器” 模块。



使用画笔工具绘制一条线来标记入口，访客必须跨越该线才会被计数。



*在 Xeoma 20.10.13 及更高版本中，绿色的"Skipping"/黄色的"Not Skipping"标识已替换为绿色的"Triggered"/黄色的"Not triggered"。

您可以调整 “访客计数器” 模块以优化数据采集。您可以选择计数方式（单向或双向）以及计数器重置的时间间隔。单向计数法会记录每次跨线行为（适用于人员始终向同一方向移动的场景）。而双向计数法仅将每两次跨线行为计为 1 名访客（适用于跟踪人员通过同一扇门出入的情况）。

您还可将采集的数据保存为 CSV 报告，查看访客出入时间。这对于留存统计数据并将其发送至外部软件进行深度分析尤为实用。



为实现最高的访客计数效率，建议将摄像头垂直于地面安装，正对人员出入口上方。这有助于避免因图像投影导致计数器误触发。

---

3.8. 标记模块

若单台服务器连接多个摄像头，导致单屏显示多路视频流，则实时掌握每个摄像头的位置、日期和时间至关重要。作为安保人员，当摄像头检测到异常且时间紧迫时，您需准确知晓事发位置。

Xeoma 正为此而设计。“标记” 模块可实现所有这些功能。您只需将其添加到链条中（位置不限），然后点击该模块即可进入设置。

首先，您需要在窗口顶部选择 “标记类型”。

a) 如果选择 “日期和时间”，您可以在下方的下拉菜单中调整首选的 “日期/时间格式”。此外，“字体大小” 滑块也值得关注。新用户常遇到的问题是主屏幕上的标记太小而无法看见。不过，部分摄像头会自动显示日期和时间。



b) 如果选择 “自定义文本”，您可以在下方的文本字段中输入任何想要显示的内容。最佳实践之一是标明摄像头的监控地点及其在视频流中的位置。



c) 如果选择 “GPS 坐标”，请确保您的摄像头和计算机均连接了专业的 GPS 设备。正确连接后，视频流将显示摄像头的经纬度、高度和速度（如有）。



d) 画中画：选择 “图像叠加” 后，您可以在 “叠加图像路径” 字段中输入图像文件的完整路径，或点击右侧按钮通过资源管理器选择文件。请记得调整 “缩放（侧边）” 和 “透明度” 滑块，以免图像遮挡视野。例如，您可以使用此功能在屏幕上放置一张标注了摄像机位置的地图以方便导航，或在摄像机视频流中嵌入您的 Logo。



对于以上所有选项，您都可以在屏幕上选择 “位置”（四个角落中的任意一个）。

您需要在同一台摄像机的视频流中设置多个标记吗？没问题！只需在链条中放置多个 “标记” 模块，并将其设置为在屏幕的不同角落显示所需内容即可。



正如您所见，即使部署了所有摄像机检测器，依然能轻而易举地将所有必要信息放置在最便捷的位置。

归档中的标记

“我在归档中也能看到标记吗？” 如果您使用 直接保存至归档（勾选了 “启用无需转换的 H.264 归档录像” 复选框），则时间和日期将以字幕形式显示在 “归档查看器” 中（系统将使用标准位置和字体替换您选择的设置）。此类时间日期标记的字幕也将保存在从归档查看器导出的片段（.mkv 格式）中。

另一种标记类型 “自定义文本” 仅适用于开启直接保存至归档设置的摄像机实时视图，不会出现在录像回放或导出的片段中。

否则，对于未使用直接保存至归档的 .xem 录像，所有类型的标记均适用于归档录像及摄像机实时视图。

---

3.9. 继电器开关

该模块用作流切换器。收到管理模块的信号时，它将闭合电路，使受管（次级）链条的流得以通过。

例如，将两台通用摄像机连接至继电器开关模块。在第一台通用摄像机之后、继电器开关之前放置一个运动检测器。如此，一旦检测到运动，第二台摄像机即被激活，并开始将其视频流传输至继电器后端的模块。

根据选择的操作模式，继电器开关在第一台摄像机运动结束后的行为方式各不相同。

“信号存在期间开启” – 只要管理模块持续发送信号，次级链条即保持开启并运行；信号停止则关闭。

“首次信号开启，二次信号关闭” – 次级链条在收到首个信号时开启，收到下一个信号时关闭。

“仅开启一次，持续时间如下方选择：” – 次级链条在收到信号时仅开启一次，并在下方滑块指定的时间过后自动关闭。

继电器运行演示

若需仅用少量摄像机保护广阔区域（如仓库），可采用以下方案：配置一台窄视角摄像机和一台宽视角摄像机。前者专责监控设施入口，后者覆盖大部分内部区域。入口固然需 24/7 全天候监控，而内部区域无需持续监视，除非第一台摄像机检测到目标。



在此示例中，第一台摄像机连接到“移动侦测”并使用“预览与归档”模块记录所有移动。同时，“移动侦测”也连接到“继电器开关”。该模块确保第二台摄像机在平时不会自行录像。



现在将“继电器开关”的设置修改如下：



*在 Xeoma 20.10.13 及更高版本中，绿色的“Skipping”/黄色的“Not Skipping”字样已替换为绿色的“Triggered”/黄色的“Not triggered”。

这样一来，一旦第一台摄像机侦测到门口有移动，第二台摄像机便立即开始对室内进行连续录像，以便您监视进入人员。当第一台摄像机再次侦测到移动（人员离开）时，第二台摄像机停止录像。这是在不降低安全性的情况下，节省磁盘空间和带宽的绝佳方案。

如果第二台摄像机具备 PTZ 功能，您可以使其“跟随”访客。所有您希望添加到第二台摄像机的过滤器都可以放置在“继电器开关”之后。逻辑链条应如下所示：



这将以极低的成本为建筑提供可靠的安全保障。

---

3.10.遮蔽

隐私遮蔽模块支持动态模糊禁止记录的区域。如果您的摄像机视野覆盖了他人私有财产（例如邻居的房屋），该功能将尤为实用。

结合过滤器模块，它可以动态模糊侦测到的对象（例如面部或车牌）。

该模块也可独立用于对静态对象（例如邻居的窗户）进行持续模糊。在这种情况下，您需要在模块设置中取消勾选侦测框，并选择需要模糊的区域。



*在 Xeoma 20.10.13 及更高版本中，绿色的“Skipping”/黄色的“Not Skipping”字样已替换为绿色的“Triggered”/黄色的“Not triggered”。



或者，您可以将隐私遮蔽连接在侦测器之后——根据需要选择移动侦测、ANPR 或面部侦测（在相应侦测器的设置中勾选侦测框并选择侦测区域）。

遮蔽将实时应用于摄像机图像、录像以及浏览器界面（但若使用直接保存至归档模式，则包括隐私遮蔽在内的任何修改流的过滤器均不生效）。

---

3.11.烟雾侦测

Xeoma 的新功能之一是 “烟雾探测器”。通过此功能，您可以确保在发生火灾时第一时间获得通知。让我们详细了解该模块的功能。

 



若启用 连续运行，该模块不会阻止视频流被记录到归档中，以便日后在归档中检索侦测到的烟雾。工作模式允许您在 烟雾侦测、火灾侦测以及 基于 CUDA 的烟雾和火灾侦测（Xeoma 23.12.7 起支持）模式之间切换。灵敏度阈值有助于确保侦测器在正常情况下（例如有人点燃火柴或香烟时）不会被误触发。然而，若摄像机监控的区域要求完全无烟，您可以将阈值设得很低。有时可能会出现瞬时的烟雾或水蒸气，若您也不希望侦测到这些情况，可使用 忽略短于以下时间的移动滑块进行过滤，将其设置为几秒钟即可。

以下是您在仓库中可以使用的逻辑链条：



“运动检测器”会将检测到的所有动态画面保存至“预览与存档”，包括所有访客及烟雾。同时，“烟雾检测器”会通过“发送短信”通知业主，并触发警报（“声音警报”）。

此类烟雾检测摄像头能尽早发现火情，从而最大限度保障您及财产的安全。

---

3.12. 物体检测器



 
*在 Xeoma 20.10.13 及更高版本中，绿色的“Skipping”/黄色的“Not Skipping”字样已替换为绿色的“Triggered”/黄色的“Not triggered”。

该模块的核心原理非常简单：只要检测到物体，就会将视频跳过并传至链中的下一个模块；若屏幕上无物体，检测器则不执行跳过操作。关键在于细节。为确保“物体检测器”仅关注您指定的物体，需要进行精细调优。首先，确定物体的尺寸范围。通过调整物体最小尺寸和物体最大尺寸滑块即可完成设置。接着，用画笔标出包含物体的区域。为简化流程，只需将目标物体放置在视频系统可见的位置，并调整这两个滑块，直到模块右上角持续显示Triggered（20.10.13 之前的版本显示为“Skipping”）。然后，让人从摄像头与物体之间走过。此时，Triggered状态是否变为Not triggered？若是，则设置正确；若否，请尝试增大物体最大尺寸。

那么，如何应用此功能？如前所述，这一功能名称虽泛，却涵盖了极广的应用场景。以下是几个示例。

商店。如何衡量商店中某件商品的受欢迎程度？直观的答案是“看顾客的购买频率”。但这只是肤浅且片面的分析。更全面的答案是“看它吸引顾客目光的频率”。这正是“物体检测器”发挥作用的地方。将摄像头对准目标商品，构建一个简单的链条：“通用摄像头” – “物体检测器” – “预览与存档”。几天后，查看存档并检查录像中的间断点——这些时段即为顾客拿起商品近距离查看的时刻。间断点越多，说明商品越受欢迎。

仓库。检测物品被盗。假设您有一件不希望被移动或触碰的库存物品，自然需要确保仓库工作人员遵守此规定。将摄像头对准该物品，构建一个简单的链条：“通用摄像头” – “物体检测器” – “预览与存档”。若存档记录出现缺失，您便能准确知晓物品被移动的时间。

配合高性能视频系统和灵活的应用思维，物体检测可实现诸多功能，以上仅为其中几例。视频内容分析 (VCA) 发展迅速，Xeoma 始终紧跟前沿。

---

3.13. HTTP 标记与 POS 集成：

您可以通过 Xeoma 的HTTP 标记模块，将来自 POS（销售点）设备的动态文本叠加层添加到录制文件中：

支持 POS 终端、收银系统、自动售货机（或任何其他数据源，如 ATM、电子秤、条码阅读器等）。该现金管理系统专为贸易企业设计，可接收文本数据、生成事件，并将其与视频录像关联存储在存档中。

支持按标题或查询条件（基于收据、收据中的商品数量、退款、折扣金额等）在存档中进行文本搜索，有助于识别员工或顾客的盗窃及其他经济违规行为，并能发现操作失误和违反现金纪律的情况。该模块支持在摄像机叠加层中显示数据。

您的收银机需要发送以下信息：
Xeoma 服务器的 IP 地址和端口
“id” = 操作 ID 或单据编号
“start” = 开始结算并启动录像
“stop” = 完成结算并停止录像
“continue” = 如果您的收银机设置为在（例如）5 秒后自动停止录像，但本次结账耗时更长，您可以发送此命令以暂不结束结账。

在 Xeoma 中，您需要执行以下操作：

1. 将“HTTP Marking”模块接入链路中所需模块之后，通常位于摄像机之后、存档之前。例如：



2. 无需特殊设置。请根据“HTTP Marking”设置中的信息配置您的收银机。该字段（不可编辑）主要提供如何使用此模块的说明：



*在 Xeoma 20.10.13 及更高版本中，绿色的“Skipping”/黄色的“Not Skipping”标识已替换为绿色的“Triggered”/黄色的“Not triggered”。

3. 当事件开始（例如，开始结账）时，您的收银机会发送类似如下的命令：
http://192.168.0.10:10090/http_marking?id=4&module=HttpMarking.60&cmd=stop

其中：
192.168.0.10 将替换为您 Xeoma 服务器的 IP 地址
10090 – 将替换为您使用的端口
id=4 将替换为您的收银机发送的实际 ID
HttpMarking.60 将替换为您在 Xeoma 中的“HTTP Marking”编号（若您拥有多个此类模块，可通过此编号加以区分）
cmd=stop – 命令
start – 启动录像
continue – 继续录像（如果启用了自动停止）
stop – 停止录像

您无需连接收银机，只需在浏览器地址栏中发送 HTTP 命令（start 和 stop）即可进行测试，例如：

http://192.168.0.10:10090/http_marking?id=4&module=HttpMarking.60&cmd=start
然后
http://192.168.0.10:10090/http_marking?id=4&module=HttpMarking.60&cmd=stop

4. 在存档中通过 ID 搜索所需片段。

通过以下链接进入 Web 界面：
http://localhost:10090/
（其中 localhost 可替换为您的 Xeoma 服务器 IP 地址）

点击“Archive”链接（仅在已有至少一段视频录像时显示）



点击对应图像，选择您想要查看存档的摄像机：



右侧将出现搜索框。在其中输入任意已使用的 ID，然后点击搜索按钮或按 Enter 键



您将看到包含该 ID 的事件列表。点击所需事件即可查看。



若要启动事件，请在浏览器地址栏输入以下 URL：

http://localhost:10090/http_marking?module=HttpMarking.1&params=param1=value1|param2=value2

请将 localhost 替换为您的 IP 地址（例如 192.168.0.1）。现在您可以输入实际参数（替换 param1、param2 等）及其对应的值（替换 value1、value2 等）。分隔符为“|”，您可以使用任意字符，例如 Work Day Start、WORK DAY START、work day start 或 Work_day_start。您可以像这样向多个标记发送命令：HttpMarking.1|HttpMarking.2。命令格式应类似于如下所示（所有空格将自动转换为 %20）：



若要结束事件，请向对应的"HTTP Marker"（或多个）发送此命令：



借此，您可以访问存档并启动通过 HTTP 标记搜索。对话窗口将提示您输入参数值（或可同时搜索所有值）以及执行搜索的时间范围。时间轴应显示如下：



绿色部分表示搜索发现的事件，而名为当前显示的计数器则显示找到了多少个此类事件，以及您当前正在查看其中的哪些事件。

如果存在多个参数，Xeoma 将将其依次排列，您可以根据需要添加任意数量的参数：



---

3.14. HTTP 请求发送器（与家庭自动化集成）

该模块支持生成并发送 HTTP 请求。通过开放的 REST HTTP API 和 SDK，可与第三方解决方案（从“智能家居”到银行领域）以及任何能运行可执行文件的外部系统集成。

它也能完美适配智能家居系统，或增强您的家庭安防系统。若要发送由移动触发的请求，请将该模块连接在移动检测器之后。当模块接收到图像时，将向指定地址发送带有可配置参数的 HTTP 请求。例如，当检测到移动时，该模块会向“HTTP 切换器”模块发送 HTTP 请求，从而启用其他模块，例如：



在此处可以看到，“HTTP 请求发送器”在检测到移动时发送请求以启用声音报警和存档录像，并在移动结束时将其禁用。请注意移动检测器的灵敏度等级和目标尺寸设置。

让我们详细查看“HTTP 请求发送器”的设置：



在红色标记的框中输入 HTTP 服务器的 URL 和端口。

设置后将显示如下：



输入 HTTP 服务器的 URL 和端口后，它们会出现在“结果 URL”中。

在详细设置中，配置请求的发送间隔和发送时间。



正确配置 HTTP 请求发送器模块并点击“确定”以保存更改。该模块配置便捷、操作简单，因为所有设置均集成在 Xeoma IP 安防摄像机软件的统一菜单中。

从 Xeoma 20.11.30 版本开始，“HTTP 请求发送器”模块现在支持 %REPORT% 宏以获取来自“问题检测器”模块的信息，其他宏包括：

%FACECOUNT% – 显示来自“人脸识别”模块的人脸数量
%CROWD% – 显示来自“人群检测器”模块的人数
%NAME% – 用于从“人脸识别”模块获取姓名的宏
%TEXT% – 用于从“文本识别”模块获取文本的宏
%REPORT% – 用于从“问题检测器”获取问题类型信息的宏
%EYEANGLE% – 来自“眼球追踪”模块的瞳孔方向
%AREASTATUS% – 来自“停车位”模块的停车位状态
%STATUS% – 用于从“ANPR”模块接收纯文本形式车牌号的宏，例如 A110PB77 等。

---

3.15. HTTP 上传至其他 Xeoma 及 HTTP 接收器模块

“HTTP 上传至其他 Xeoma”模块的功能很简单：通过 HTTP 协议将通过模块链接收到的图像发送到位于任何位置的“HTTP 接收器”模块。这两个模块协同工作，因此其设置相互关联：



配置方法如下：

第一步。建议首先在接收端的 Xeoma 中添加“HTTP 接收器”模块，因为它会生成大部分所需的设置。

在接收流的计算机中将“HTTP 接收器”添加到模块链并打开其设置后，您首先会看到一个不可编辑的“完整路径”字段，其内容由 Xeoma 根据“localhost”、端口和唯一的模块名称组成。您可以将该名称填入下方的“URI 路径”中，以区分多个此类模块。

端口可设为任何未被其他进程占用的数值，默认为 10090。

最终生成的完整路径可能类似于 http://localhost:10090/myreceiver 或 http://localhost:10090/officecamera。

由于"localhost"地址仅在同一台机器上有效（不符合本示例需求），因此需将其替换为计算机的内网地址。为此，请将完整路径复制到记事本或其他文本编辑器中，把"localhost"替换为该机的私有 IP 地址，最终得到类似 http://192.168.0.54/myreceiver 或 http://192.168.1.12/officecamera 的路径。

您可以设置用户名和密码，以防止他人查看该流。不过，若不使用 Xeoma 且不知晓 IP 地址及模块唯一名称，他人根本无法访问，因此这些设置为可选。

配置好"HTTP Receiver"后，请复制生成的路径和凭据（如有），然后进入步骤 2，该步骤需在发送端执行。

步骤 2. 在用于发送流的计算机上（本例中为连接 USB 摄像头的机器），请在该摄像头的模块链末端添加"HTTP upload to other Xeoma"模块。

其设置大致与"HTTP Receiver"的设置相对应：



将在"HTTP Receiver"中获取的完整路径（已将"localhost"替换为接收端机器的私有 IP 地址，如本例中的 http://192.168.0.53/mycamera）填入地址字段。若在步骤 1 中使用了非 10090 的端口，请在“端口”字段中输入新端口。凭据设置同理：若在步骤 1 中设置了登录名和密码，请在此处重复输入。

这对模块的独特之处在于不仅能转发图像，还能同步传输音频。"HTTP upload to other Xeoma"会查找指定 IP 的机器，验证其是否具有相同的唯一名称（以及用户名/密码，如有），随后将流发送至该机器，从而实现两台机器间视音频的安全传输。

在 Xeoma 新版本 (17.3.30) 中，该功能用于启用一键云端模式："HTTP upload to other Xeoma"模块连接所有本地摄像头，而 Xeoma Cloud 则创建已预置所有必要信息的"HTTP Receivers"。
 

您也可通过其他方法在 Xeoma 服务器间传输流，例如 FTP。将"FTP Upload"连接至摄像头，并在第二台机器上创建包含"FTP Receiver"的模块链。然而，此方案不适用于当前场景，因为它仅能传输视频而无法传输音频。FTP 仅在流格式为 H.264（仅 IP 摄像头原生支持）时才能传输音频。 另一种选择是通过 Web 传输：将"Web Server"连接至摄像头，同时在第二台机器上使用"Another Xeoma"。出于同样原因（有视频无音频），此方案也不符合我们的具体需求。

 

然而，上述示例仅适用于同一局域网内。若两台计算机位于不同街区甚至不同城市怎么办？此时，第一台计算机需要一个外部静态 IP 地址。若选择第一种方案，您需在"HTTP upload to other Xeoma"中填入第二台计算机的公网 IP 地址或其替代地址。

综上所述，解决方案如下：

1. 在第一台计算机（即接收摄像头流的机器）上启动 Xeoma，并创建包含"HTTP Receiver"的模块链。

   

2. 进入其设置并指定唯一名称以及用户名/密码。然后从“Full path”字段复制生成的路径行，并将“localhost”替换为该设备的外部静态（“公网”）IP地址。

   

3. 该计算机上的配置已完成，可以关闭此处的 Xeoma 窗口。现在在第二台计算机（即发送摄像头流的设备）上启动 Xeoma，并在 USB 摄像头的链条中添加 “HTTP upload to other Xeoma”。

   

4. 进入其设置，指定第一台计算机的“full path”，以及模块名称和用户名/密码（如需要）。

   

配置完成！现在通过远程软件，该计算机可以随时查看 USB 摄像头的实时画面或历史存档。

 

从 Xeoma 23.6.13 版本起，P2P 连接已应用于"HTTP upload to other Xeoma"和"HTTP Receiver"模块，作为公网 IP 地址的免费替代方案。该方案免费、安全且连接便捷。了解更多关于 Xeoma P2P 连接的信息

使用 P2P 连接时，配置指南将略有不同：

1. 第一步是在 接收端设备（即装有 HTTP Receiver 模块的设备）上启用 P2P 连接。如需启用，请进入 Xeoma 主菜单 — Remote Access — P2P connection configuration。在随即打开的"P2P connection configuration"窗口中，您可查看有关此免费服务的详细信息，勾选复选框以启用 P2P 连接并获取服务器的唯一地址。

勾选"Enable the P2P connection option"并等待数秒。"P2P address of this server"将显示格式为"AAA-BBB-CCC"的唯一地址，以此替代公网 IP 地址。请复制该地址。

2. 接下来，您可参照上述通用指南，但需使用刚才复制的 P2P 地址代替 IP 地址。因此，当您从"HTTP Receiver"复制"Full path"并编辑后粘贴至"HTTP upload to other Xeoma"时，路径将呈现为 ABC-abc-AbC/mycamera。指南中的其余建议保持不变。例如，您可以使用凭据以增强安全性。

---

3.16. RTSP 广播

进入 Xeoma 的 "RTSP Broadcasting"模块——它支持将 任意流（包括 H.264）转换为 RTSP 格式，无论来源是模拟、USB 还是 IP 摄像头。首先，将其添加至链条中：



广播即将就绪，现在配置该模块：



若使用 mpeg4 或 mjpeg，配置即告完成——将路径（有时包含端口：rtsp://localhost:30001/RtspTranslator.10）复制并粘贴到另一台 Xeoma 的 "Universal camera"中，并将"localhost"替换为第一台设备的 IP 地址，即可开始广播：



若第二台设备位于不同网络中，第一台设备需具备静态（固定）IP（或其 替代方案），并正确转发相应端口（若路径中未指定端口，请转发 554——此为默认 RTSP 端口）。

然而，mpeg4 和 mjpeg 对网络负载较高。若您希望以 H.264 进行流传输并降低网络负载，请将 Encoder 类型选为 libx264。为此，您需要安装特定版本的 ffmpeg 以确保正常运行，下载地址如下：
Windows：https://felenasoft.com/xeoma/downloads/ffmpeg/win/ffmpeg_win.exe
Linux：https://felenasoft.com/xeoma/downloads/ffmpeg/linux/ffmpeg_linux

自 Xeoma 20.10.13 版本起，Xeoma Pro 增加了对 ARMv8 架构下 RTSP Broadcasting 模块的支持。

自 Xeoma 22.10.12 版本起，RTSP Broadcasting 模块已可在 Xeoma Standard版本中使用。

请注意，此选项不适用于 Mac OS，因为目前没有对应的 ffmpeg 版本。请指定该文件在您设备上的路径：



若要降低比特率，请选择“高压缩率”。这样您将获得一个比特率显著降低且不损失画质的压缩流。

此方法存在弊端：流的压缩与编码由 CPU 承担，且必须持续执行。因此，压缩率越高，服务器的 CPU 负载就越高。
这体现了视频监控管理员必须面对的核心权衡：CPU 负载还是网络负载？本质上即：强大的服务器还是强大的网络？在摄像头数量较少时无需过多考虑，即便陈旧的技术也能应对；但随着规模扩大（每台服务器 50-80 个摄像头），硬件需求将大幅增加。最常见的解决方案自然是折中方案：预览使用 MJPEG 流，存档使用 H.264 流——这样服务器无需实时解码图像，同时网络每路摄像头仅承载 1 个未编码流。

---

第 4 章. 高级监控的更多功能


4.1. Xeoma 客户端-服务器架构

Xeoma 基于客户端-服务器架构。这意味着 Xeoma 由两部分组成：Xeoma Server 和 Xeoma Client。服务器负责处理摄像头及其他信源并执行所有自动化任务，而客户端则用于查看画面并与服务器交互。客户端可部署在同一台设备或远程设备上，包括手机。

初次下载 Xeoma 时，您获得的是一个可执行文件。通过该启动程序运行 Xeoma IP 摄像机软件时，将同时运行服务器端和客户端。服务器在后台运行，而客户端则是您看到的 Xeoma 主窗口。



随后在使用远程访问时，您可借助该客户端 - 服务器架构，将一台电脑上的客户端连接至另一台电脑上的服务器（支持多个客户端连接同一台服务器）。操作路径为：主菜单 -> 远程访问 -> 连接，在弹出的对话框中，需将“本地”IP 地址（运行 Xeoma 的电脑地址）替换为“远程”IP 地址或中继器位置，详见远程访问信息。

另请参阅：服务器与客户端设置的区别 以及 设置 Xeoma 客户端



无论您以何种模式使用 Xeoma，它都支持安装或免安装运行。区别在于，如果您需要 Xeoma 在电脑每次重启时自动启动，则需要将其设置为自启动（仅服务器或含客户端）。为此，只需在安装菜单中勾选相应选项即可。

许可证仅针对服务器端。这对计划使用远程访问功能的用户而言是一大利好：无论多少客户端连接至服务器，您只需购买服务器许可证。请在我们的购买页面查看 Xeoma 许可证的最优优惠方案。

---

Xeoma 移动应用已支持 Android 和 iOS：



4.2. 程序安装

Xeoma 无需安装即可在下载后立即运行。您也可以安装 Xeoma，使其随操作系统自动启动。



请注意： Xeoma 不会在未经用户同意的情况下安装任何内容。安装过程由用户自定义。



进入 主菜单 -> 安装 -> 安装。系统将弹出提示，询问您偏好的安装类型以及软件安装路径。

服务器自启动：Xeoma Server 将在操作系统每次启动时自动运行。如果您需要服务器持续处理摄像头数据，而仅偶尔通过 Xeoma Client 连接，此设置非常适用。如需启用，请运行桌面上的 Xeoma 快捷方式。

客户端自启动：Xeoma Client（可视化界面）将在操作系统每次启动时自动运行。例如，当您的服务器部署在远程位置且需要自动连接时，此选项非常有用。

注意：“隐藏模式”与“客户端自启动”互斥。若需隐蔽监控，您显然不希望客户端随每次开机自动弹出，从而暴露您的隐蔽部署。请按需选择：仅启用客户端自启动、仅启用隐藏模式，或两者均不启用（例如，当本机无需操作摄像头或回放录像，仅需将视频流持续推送到网站或 FTP 服务器时）。若同时选择服务器自启动和隐藏模式，Xeoma 将以隐身模式运行。桌面不会创建 Xeoma 启动图标（若已存在则将被删除）。Xeoma Server 将随系统启动自动运行，且不会出现在运行进程列表中。

Android 安装：在 Google Play 或华为应用市场（若设备不支持 Google 服务）中搜索 Xeoma 并点击“安装”。详情请参阅此处。
您也可以从我们的官网下载功能更全的 Android 版本。运行并安装下载的文件（为此，请在设备设置中允许安装未知来源应用）。

iOS 安装：在 App Store 中搜索 Xeoma 并点击“下载”。请注意，iOS 仅提供客户端版本，用于远程查看摄像头。详情请参阅此处。

由于操作系统的限制，Xeoma Android 和 iOS 应用不支持“隐藏模式”安装选项。

勾选所需的安装选项并点击“确定”后，所选组件将安装在本地 PC 上并重启。请注意：若使用试用模式，您的设置将无法保存（有关 Xeoma 模式及其限制的详情，请参阅此处）。

重要：安装的服务器以服务形式运行。您可以在任务管理器的“服务”文件夹中停止该服务，或通过客户端将其卸载（从而停止运行）。

重要：若您连接 Xeoma 时收到“忽略并强制连接到服务器”的提示，说明您使用的客户端与服务器（已安装）版本不一致。
这可能会导致 Xeoma 运行异常、存档回放故障等问题。建议客户端与服务器使用相同版本。
连接服务器后（请选择“忽略并强制连接到服务器”），可在程序标题栏查看 Xeoma 版本。旧版本可在此下载。

软件安装选项下方的文本框中显示了用于远程访问的密码（不可编辑）。勾选复选框可将此密码同时应用于本地访问（即任何人在本机“本地”访问 Xeoma 时也需输入密码）。该密码可在用户权限对话框中修改，或通过控制台使用 -setpassword 命令进行修改。

在控制台中，使用'-install [-argument]'命令来管理 Xeoma 的安装。 使用 -install -allauto 安装服务器端和客户端，并设置为随操作系统启动（详见上文“图形界面安装”部分）； 使用 -install -coreauto 仅安装服务器端并设置为自动启动，客户端需手动启动； 使用 -install -hiddenmode 启用隐藏模式； 使用 -install -allmanual 为服务器端和客户端创建快捷方式，以便在需要时手动启动其中任意一个或全部。 此外，您还可以使用 “-installdir [DirPath]” 命令更改 Xeoma 的安装目录。 查看更多关于控制台命令的信息

---

4.3. 许可证：条款与购买

视频监控软件 Xeoma 提供 4 种商业许可证：Xeoma Starter、Xeoma Lite、Xeoma Standard 和 Xeoma Pro，以及其他几款商业产品：适用于 Xeoma Standard 和 Xeoma Pro 的 附加模块、适用于 Xeoma Standard 的 升级至 Pro、Xeoma Cloud，以及通过 Repeater 进行的连接。

部分产品仅支持永久许可证，部分仅限按月订阅，部分则两种均提供。

更多购买选项见下表：

Xeoma 产品	授权类型
Xeoma Starter	永久许可证（一次性购买）
Xeoma Lite	永久许可证（一次性购买）
Xeoma Standard	永久许可证*（一次性购买） 或 按月订阅
Xeoma Pro	永久许可证*（一次性购买） 或 按月订阅
附加模块**	永久许可证*（一次性购买） 或 按月订阅
升级至 Xeoma Pro	永久许可证（一次性购买）
许可证更新期续费	永久许可证（一次性购买）
Xeoma Cloud	按月订阅
Xeoma Repeater	按年或按月订阅
Xeoma Pro Your Cloud	查看 Xeoma Pro
* 以下产品的永久许可证（Xeoma Standard、Xeoma Pro、附加模块、升级至 Xeoma Pro 以及许可证更新期续费）可购买为软件密钥，也可支付额外费用购买硬件密钥。 ** 附加模块的许可证需单独购买，与 Xeoma Standard 或 Xeoma Pro 的许可证分开。

您可以在我们的 购买页面 或经销商网站购买 Xeoma 许可证和订阅，也可以 联系 Xeoma 支持团队 进行购买。

在此链接页面查看 Xeoma 使用的完整条款与条件

 

购买永久许可证：
Xeoma 永久许可证为一次性购买。默认情况下，许可证由序列号（由 25 位数字和字母组成）标识，该序列号将发送至您指定的电子邮箱地址。

您可以支付额外费用申请硬件密钥，密钥将通过快递寄送至您的地址。在此页面了解更多关于软件密钥与硬件密钥的区别。

除 Xeoma Starter 外，所有永久许可证均按每台服务器所需的摄像头数量购买。这意味着，您需要根据计划连接的摄像头（或其他视频源）数量，为每台服务器单独购买密钥。“视频源”通常指视频信号源（如“通用摄像头”、“另一台 Xeoma”、“屏幕采集”），或 此处所述 的“麦克风”模块。相比之下，Xeoma Starter 仅支持固定数量的摄像头，按服务器购买，与视频源数量无关。

在大多数情况下，您在付款后即可收到许可证。银行转账和 PayPal 支付需在几个工作日内处理，但只要我们收到款项，许可证密钥将立即发送给您。许可证激活本身仅需几秒钟即可完成。永久许可证为通用型，可在 Windows、Linux、Linux ARM、Mac OS 或 Android 上激活（硬件密钥除外）。

激活特定 Xeoma 版本的许可证后，Xeoma 将切换至该版本的商业版。该版本支持的所有功能将开放给许可证涵盖的摄像机数量使用（请参阅不同许可证的购买条件）。
由于 Xeoma 许可证为永久授权，您可无限期使用。

Xeoma Standard、Pro 及附加模块的许可证支持自购买之日起 1 年、3 年或 10 年的免费更新（若未手动选择，默认自动选定 1 年）。对于 Xeoma Starter，免费更新期较短，仅为自购买之日起 1 个月。至于 Xeoma Lite，则不提供更新服务，您仅能使用购买时或此前发布的版本。

默认情况下，永久许可证需联网激活（注册），但也提供离线激活选项。了解详情

已激活的许可证将绑定至激活所在服务器的唯一 ID；若在同一台服务器上重装操作系统，则可重新激活。若在激活过程中遇到问题，请访问“激活相关问题解决方案”页面。
有效许可证信息可在 Xeoma → 主菜单 → 信息 → 有效许可证中查看。

除 Xeoma Starter 外，所有永久许可证均可随时间累积：您可将新许可证叠加至现有许可证，从而合并使用所有已购许可证涵盖的视频源（Xeoma Standard、Xeoma Pro、附加模块、续费及升级至 Pro 的新许可证数量不限；Xeoma Lite 最多支持 4 个）。

客户端与持有已激活许可证的服务器建立远程连接，无论连接的源数量多少，均免费。

 

租赁 Xeoma Standard、Xeoma Pro 及附加模块：

您可以通过按月或按年续订订阅，租赁 Xeoma Standard、Xeoma Pro 及附加模块的许可证。默认情况下，租赁许可证由序列号（25 位数字与字母组合）标识，该序列号将发送至您指定的邮箱，并通过 Xeoma 程序或 App 激活。若按时付款，租赁将自动顺延，无需每日或每月重复激活许可证密钥。同时也支持按天或按月租赁许可证。要激活并使用租赁许可证，激活该许可证的服务器，或主服务器可访问的代理机器（即许可证服务器），必须保持持续的互联网连接。

其他 Xeoma 产品暂不支持许可证租赁。

Xeoma Standard、Xeoma Pro 及附加模块按每台服务器所需的摄像机数量进行租赁。这意味着您需根据计划连接的摄像机（或其他视频源）数量，为每台服务器单独购买许可证。“视频源”通常指视频信号源（“通用摄像机”、“另一台 Xeoma"、“屏幕截取”），或此处所述情况中的“麦克风”模块。

在大多数情况下，您将在付款后立即收到租赁许可证。银行转账和 PayPal 支付的处理时间为几个工作日，但只要我们确认收到款项，许可证密钥将立即发送给您。许可证激活过程仅需几秒钟即可完成。租赁许可证具有通用性，可在 Windows、Linux、Linux ARM、Mac OS 或 Android 上激活，且需保持互联网连接（直接连接或通过代理）。

租赁许可证无法以硬件锁的形式提供，但对于没有独立互联网连接的设备，可以使用许可证服务器。

当特定 Xeoma 版本的许可证激活后，Xeoma 将切换到该版本的商业版。该版本支持的所有功能将适用于许可证包含的摄像机数量及所选的租赁期限（详细阅读不同许可证的购买条件）。

租赁期结束后，过期许可证将失效，Xeoma 将显示错误消息。如果您在此期间续费，许可证将自动重新激活。如果您选择切换回试用版，则在支付许可证租金后，需再次以相同方式激活序列号密钥。

在租赁许可证期间，您可以将 Xeoma Standard、Xeoma Pro 及附加模块更新至所有新版本。

已激活的许可证与激活该许可证的服务器唯一 ID 绑定；但如果重新安装操作系统，可以在同一台服务器上重新激活。如果您在激活过程中遇到问题，请访问“激活问题排查”页面。

有关活动许可证的信息可在 Xeoma → 主菜单 → 信息 → 活动许可证中查看。

租赁许可证可随时间累加：您可以将新许可证添加到原有许可证中，从而合并使用所有已购许可证的视频源。

无论客户端数量多少，连接到拥有激活许可证的服务器均为免费。

 

关于 Xeoma Cloud 订阅：

Xeoma Cloud 订阅是针对独立Xeoma 云服务的按月订阅。
资费由摄像机数量、摄像机参数以及（若需将录像存储在 Xeoma Cloud 中）存储空间决定。

如需购买 Xeoma Cloud 订阅，请使用购买页面的 Xeoma Cloud 资费计算器，并为订阅期选择摄像机相关参数。建议充分考虑摄像机的性能限制，以确保计算出的资费涵盖您的所有需求。

您的订阅无需激活。购买后，您将在指定的电子邮件中收到访问账户所需的凭据。

在大多数情况下，您将在购买后立即收到访问凭据。银行转账和 PayPal 支付的处理时间为几个工作日，但只要我们确认收到款项，凭据密钥将立即发送给您。

在此阅读如何登录您的 Xeoma Cloud 账户

在此阅读如何将摄像机连接到 Xeoma Cloud

若按时付款，订阅将自动续订。无需再次注册或激活您的许可证密钥。
当您的订阅即将到期时，系统将向您的电子邮件发送续订提醒。

如果您的订阅未按时续订，您的账户将被暂停，并为您提供宽限期以购买续订，从而避免丢失设置和录像。如果账户在支付订阅费用前被暂停超过一周，您将只能恢复设置，而录像将永久丢失。

如需购买数月订阅，或增加摄像头、人工智能功能及附加模块，请联系我们。

Xeoma Cloud 主要作为独立服务运行，与 Xeoma 桌面版分离。但两者也可同时使用。此时，您需要订阅 Xeoma Cloud 并选用一款 Xeoma 桌面版（若所选为商业版，则需另行付费）。请注意，Xeoma Cloud 订阅不包含在任何 Xeoma 版本中，须单独购买。 以下是该场景的示例。

订阅信息可在 Xeoma（Android 应用或 PC 客户端）→ 主菜单 → 信息 → 激活的许可证中查看。您需登录账户方可查看。

 

关于中继器（Repeater）订阅：

中继器（Repeater）订阅是针对独立中继器服务的月度（或年度）订阅。它始终独立于 Xeoma 许可证购买，且不包含在任何许可证中。

中继器（Repeater）订阅按服务器计费，与摄像头数量无关。
使用中继器（Repeater）需保持持续的互联网连接。

中继器（Repeater）订阅由序列号（25 位字母数字组合）标识。该序列号将发送至您指定的邮箱，您需通过 PC 版 Xeoma 或移动端应用激活账户。

多数情况下，购买后您将立即收到序列号。银行转账及 PayPal 支付需数个工作日处理，但我方一旦确认收款，系统将即刻向您发送密钥。

中继器（Repeater）订阅具有通用性，可在 Windows、Linux、Linux ARM、Mac OS 或 Android 上激活（需联网）。

激活订阅仅需数秒。请注意，激活是在独立于 Xeoma 版本的对话框中完成的。

激活后的许可证将绑定至激活服务器的唯一 ID，此后您无法更改中继器（Repeater）地址。

若按时付款，订阅将自动续费，无需再次注册或激活许可证密钥。

订阅到期后，经中继器（Repeater）建立的 Xeoma 远程连接将中断，但这不会影响 Xeoma 的其他功能。订阅续费后，中继器（Repeater）即刻恢复运行。

远程连接 Xeoma Cloud 无需中继器（Repeater），因为我们的服务已为您配备“公共”（外部静态）IP 地址。

中继器（Repeater）订阅不影响您获取 Xeoma 新版本的能力——这完全取决于激活中继器（Repeater）的 Xeoma 版本。

 

Xeoma 许可证不绑定特定摄像头。您可以直接更换摄像头，无需干预系统或联系技术支持。

务必综合考量目标监控系统的功能支持，包括软件总成本及所选版本。许可授权、设备性能及诸多其他因素均会影响整套系统的最终成本。

若您在许可证选型、激活过程或付款后未收到许可证时需要协助，请随时联系我们！

---

4.4. 软件激活

购买许可证后，您将获得一串字母数字序列号。请使用以下任一方法激活许可证：将 Xeoma 升级至所选商业版本，或为本机已激活的许可证续费。

如需激活 Xeoma Pro Cloud 许可证，请参阅指南。

Xeoma 激活选项概览：

Xeoma 许可证类型	以下情况需要激活： 专用物理机		以下情况需要激活： 虚拟机
	设备已连接互联网	设备未连接互联网	设备已连接互联网	设备未连接互联网
Xeoma 免费版	此版本无需激活。详情请参阅此处
Xeoma 常规永久许可 一次性付费 (例如：Starter、Lite、Standard、Pro、附加模块、续费、从 Standard 升级至 Pro)	在线激活 (推荐) – 一次性激活，之后可在无互联网环境下运行 许可服务器 – 如需在同一网络内轻松转移许可 硬件锁 – 如需在任何网络中轻松转移许可	离线激活 (推荐) – 若网络中另有设备可访问互联网，可进行一次性激活 许可服务器 – 若网络中另有设备可访问互联网，且需在同一网络内轻松转移许可 硬件锁 – 如需在任何网络中轻松转移许可	在线激活 (推荐) – 需持续连接互联网 许可服务器 – 若网络中另有设备可访问互联网，且需在同一网络内轻松转移许可 硬件锁 – 如需在任何网络中轻松转移许可	许可服务器 – 若网络中另有设备可访问互联网，且需在同一网络内轻松转移许可 硬件锁 – 如需在任何网络中轻松转移许可
Xeoma 许可按月租赁 (租赁 Standard、Pro、附加模块) 或演示/试用许可	在线激活 (推荐) – 需持续连接互联网	许可服务器 – 若网络中另有设备可访问互联网，且需在同一网络内轻松转移许可	在线激活 (推荐) – 需持续连接互联网	许可服务器 – 若网络中另有设备可访问互联网，且需在同一网络内轻松转移许可
Xeoma Pro Your Cloud (您专属的 VSaaS)	通过 Web 浏览器或配置文件进行独立激活。点击查看
Xeoma Cloud	该产品无需激活。详情请参阅此处
中继器	仅支持在线激活，需在另一个窗口中完成。详情请参阅此处

更多激活选项请参阅此表格

 

4.4.1. 在线激活

Xeoma 默认采用的激活方式，简单便捷，但需连接互联网。可通过 Xeoma Client 或在控制台/终端/命令行中完成。
也支持在 代理 环境下使用。

通过 Xeoma Client：

直接将许可（序列号）粘贴到“在线激活”字段中 (主菜单 –> 注册 –> 激活)，勾选同意条款和条件，然后点击 确定 按钮。



激活成功后，系统将弹出提示，显示当前可使用的视频源数量。



通过控制台/cmd/终端 (适用于无图形界面/GUI 的服务器)：

将 Xeoma 可执行文件 (xeoma.exe, xeoma.app) 拖入控制台，按空格键并输入命令 -activateOnline XXXXX-XXXXX-XXXXX-XXXXX-XXXXX (您的许可代码)，然后按 Enter 键。



 



若操作正确，您将收到激活成功的提示。

若需在设备上激活多个序列号（许可证），请遵循相同步骤，但请一次性输入多个序列号，用逗号或分号分隔（不含空格），并在整个序列号组合的首尾各加一个引号。例如：“XXXXX-XXXXX-XXXXX-XXXXX-XXXXX,YYYYY-YYYYY-YYYYY-YYYYY-YYYYY,ZZZZZ-ZZZZZ-ZZZZZ-ZZZZZ-ZZZZZ”

提示：Xeoma 许可证并非专为频繁更换设备而设计。若您尚未确定 Xeoma 的部署设备，请使用试用许可证。 如需频繁更换设备，建议考虑使用硬件加密狗或许可证服务器。

或根据需要，点击“离线激活”。

 

4.4.2. 离线激活

若您的 PC 未连接互联网，或不希望使用互联网连接，可使用 Xeoma 的离线激活功能。
离线激活适用于永久许可证和专用设备，也可用于向硬件加密狗添加更多许可证（在此查看所有激活选项）。

通过 Xeoma Client：

操作步骤：请前往“主菜单” –> “注册” –> “激活” –> 勾选确认“条款和条件” –> 点击“离线激活”链接。



接下来输入您的许可证，点击“复制到剪贴板”以复制链接，然后在另一台可访问互联网的 PC（设备）浏览器中打开该链接。访问后，您将收到一段由数字和字母组成的响应文本，请将其复制并返回 Xeoma，填入响应字段中：





若激活成功，Xeoma 将切换至商业版模式（可在软件标题栏查看），您将收到“激活成功”的消息，且许可证将显示在主菜单 – 信息 – 激活的许可证中。



通过控制台/cmd/Terminal（适用于无图形界面/GUI 的服务器）：

将 Xeoma 可执行文件 (xeoma.exe, xeoma.app) 拖入控制台，按空格键，输入以下命令：-activateRequest XXXXX-XXXXX-XXXXX-XXXXX-XXXXX（您的许可证代码），然后按回车键。



随后您将获得一个链接，请在任意其他可上网的 PC（计算机、平板电脑、智能手机等）浏览器中打开。您将收到一段由数字和字母组成的响应文本，请将其复制并返回到需要激活 Xeoma 许可证的离线 PC 控制台中。在控制台中，再次拖入 Xeoma 可执行文件或手动输入其路径，后跟一个空格及命令 –activateResponse 从浏览器收到的响应（其中“从浏览器收到的响应”即为您在联网设备浏览器中获取的文本），然后按 Enter 键：



若需在设备中激活多个序列号（许可证），请遵循相同步骤，但在输入序列号时，请使用逗号进行分隔（不含空格）。示例：XXXXX-XXXXX-XXXXX-XXXXX-XXXXX,YYYYY-YYYYY-YYYYY-YYYYY-YYYYY,ZZZZZ-ZZZZZ-ZZZZZ-ZZZZZ-ZZZZZ

若您的服务器上已激活许可证且需增加，只需按原方式激活新序列号即可。许可证将累加（注意：Lite 许可证每台服务器仅限累加至 4 路摄像机，且仅支持同类许可证之间累加）。

若您拥有从 Standard 到 Pro 的升级版，可通过输入原许可证序列号、分号及升级版序列号（不含空格）进行激活。例如：XXXXX-XXXXX-XXXXX-XXXXX-XXXXX;YYYYY-YYYYY-YYYYY-YYYYY-YYYYY。激活后，相应数量的摄像机将获得 Pro 功能权限。若 Standard 许可证包含的摄像机数量多于升级版，则仅部分摄像机受影响。

无论您选择哪种激活方式，Xeoma 商业版都将为您提供无限可能和激活权益。

有关使用代理服务器激活 Xeoma 的信息，请参阅本节。

 

4.4.3. 在虚拟机上激活

Xeoma (Xeoma Standard)、Xeoma Pro、Xeoma Lite（20.10.13 版本起）和 Xeoma Starter 永久许可，以及升级至 Xeoma Pro、Xeoma Standard 的许可、Xeoma Pro 续费许可，以及租用或试用版 Xeoma Standard 或 Xeoma Pro 许可，均可在任何类型的虚拟机上激活。

若要在虚拟机上激活其中一个或多个许可，请使用 Xeoma 的在线激活——可通过 Xeoma Client 或控制台进行。
请注意，虚拟机需要保持持续的互联网连接。若互联网连接中断，许可可能会被停用，但在短时间内恢复连接后将自动恢复。如果连续数日无法访问互联网，您需要重新激活许可以恢复系统运行。

此外，如果您要在无法访问互联网的虚拟机上激活 Xeoma，可以使用硬件锁或许可服务器。使用许可服务器意味着您需要在网络中另一台可访问互联网的计算机上部署许可服务器，并在激活时选择该服务器。有关许可服务器的更多信息，请参阅4.4.4.。

从 20.10.13 版本起，允许在虚拟机上激活 Lite 许可（同样需要持续的互联网连接）。

提示：若需在无互联网连接的虚拟机上使用 Xeoma，我们建议使用许可服务器或购买硬件锁

如果您尝试在没有互联网连接的虚拟机上以常规方式激活 Xeoma，系统将发出警告：



此类情况下的可选方案请见下文。

旧版本 – Xeoma 16.12.26 及以下版本：
可在以下虚拟机上激活：
1) Hyper-V
2) KVM
3) LXC
4) VMWare
5) Virtual Box
如果您使用的是其他类型的虚拟机，请改用列表中的类型或使用物理机。

 

4.4.4. 使用许可服务器激活

如果您的虚拟机无法访问互联网，可以通过许可服务器使许可生效。许可服务器充当激活中介，是您网络中一台拥有持续互联网连接，且与无网虚拟机保持永久“内部”网络连接的专用机器。

许可服务器与离线激活方式类似，因为两者都涉及使用中介进行激活，但许可服务器更加自动化且必须实时运行，而离线激活是一次性操作。

此外，对于没有持续互联网连接的虚拟机，可以使用硬件锁激活Xeoma 永久许可。但对于需要激活租用或试用许可且无法联网的虚拟机，仅支持许可服务器方案，因为硬件锁不适用于此类许可。

虽然许可服务器主要用于在虚拟机上激活 Xeoma，但它们同样适用于实体机：例如，当实体机没有持续互联网连接，但需要运行要求持续联网的租用或试用许可时，即可通过许可服务器实现。此外，对于虚拟机和实体机，如果许可需要在多台机器之间定期迁移，可以使用许可服务器激活方式——其作用类似于硬件锁。

延伸阅读：Xeoma 许可的网络激活：简单、快速且经济实惠

设置许可服务器

设置许可证服务器分为两个步骤：首先部署许可证服务器，然后在需要激活的“主”机上选择该服务器。

一台许可证服务器可为多台需要激活中转的机器提供服务。

在具备互联网访问权限并将作为专用许可证服务器的机器上，打开 Xeoma，进入 主菜单 -> 安装 -> 安装许可证服务器。请确保该机器与需要 Xeoma 许可证的机器之间存在“本地”连接。



如需确保本地网络连接的安全，请勾选“对 localhost 访问使用密码”选项：



请稍候，Xeoma 正在安装许可证服务器。



完成后，您将看到相应消息，提示该机器现已作为许可证服务器运行。

在控制台/cmd/Terminal 中，您可以使用 -licenseServer [LicenseServer] 命令将该机器上的 Xeoma 设为许可证服务器。 此外，您可以使用 '-connectioninfoport [PortNumber]' 为许可证服务器设置非默认的 4200 端口。 点击此处了解更多关于控制台命令的信息

选择许可证服务器并激活

接下来是第二部分。在需要激活 Xeoma 许可证的机器上（通常是不具备互联网访问权限的虚拟机），打开 Xeoma 并进入 主菜单 -> 注册 -> 激活。在激活窗口中，将许可证粘贴到相应字段，但请选择许可证服务器，而非常规的 felenasoft.com 激活服务器：



同意条款与条件，然后点击“确定”按钮。该机器将向您的许可证服务器发送请求，服务器随后将为您的虚拟机申请激活权限，并向您的 Xeoma 返回响应以完成许可证激活。请勿关闭许可证服务器：系统会不定期在后台执行许可证检查。



在控制台/cmd/Terminal 中，您可以使用 -licenseServer [LicenseServer] 命令在本地网络中查找 Xeoma 许可证服务器并用于激活。 点击此处了解更多关于控制台命令的信息

请注意，在许可证生效期间，许可证服务器机器必须保持运行状态并具备互联网访问权限。
当互联网连接中断时，许可证可能会被停用，但若在短时间内恢复连接，许可证将重新激活。

 

4.4.5. 硬件锁 (USB 闪存盘)

Xeoma 许可证可作为绑定至 USB 闪存盘的硬件锁使用。您可以选择所需的 Xeoma 许可证，在我们的网站购买，并联系我们。

带有 Xeoma 许可证的硬件锁属于即插即用设备，即您只需将 USB 设备插入 USB 端口，即可在商业模式下使用 Xeoma。通过这种方式，您可以在任何带有 USB 端口的设备（包括无互联网连接的虚拟机）上使用已激活的 Xeoma 版本。

您还可以购买额外的带有 Xeoma 许可证的硬件锁，并将其插入其他 USB 端口，以扩展您的视频监控系统。
请注意，旧版许可证无法用作硬件锁。硬件锁仅适用于分配给 USB 设备的全新许可证。若硬件锁丢失或损坏，则无法更换（在此情况下，您需要重新购买带有新 Xeoma 许可证的硬件锁）。

若在同一台服务器上使用多个硬件锁，您可以将两个 USB 设备上的许可证合并到一个设备中。

此外，您可以使用离线激活向当前的 USB 锁中添加更多 Xeoma（Standard 和 Pro）许可证。也就是说，您可以先购买一个带有 Xeoma 许可证的硬件锁，日后如需扩展系统，再购买更多 Xeoma 许可证。同样，您也可以购买续费许可证，并通过离线激活将其添加到 USB 锁中。

软锁与硬件锁的对比可在此查看。

关于硬件锁的更多信息，请参阅本文。



---

4.5. 更新 Xeoma

4.5.1. 更新至新版本

更新流程取决于您所使用的 Xeoma 摄像头软件版本，以及您是否已通过主菜单 –> 安装 –> 安装完成安装。

在所有当前版本的 Xeoma 中，您均可使用自动更新检查、通知以及便捷的一键更新功能：



您可通过“主菜单”->“信息”->“检查更新”查看是否有可用更新。如果您启用了自动检查更新，程序启动时将收到可用更新的通知！

如果您的 Xeoma 版本为 13.3.7 或更低：

a) 如果未安装 Xeoma，操作非常简单 – 直接运行从 我们的网站 或其他资源下载的新版本文件即可。

b) 若已安装 Xeoma，请先启动旧版本，进入“安装选项”并点击“卸载除存档和设置外的所有内容”（请务必谨慎操作，此举对于保留当前设置并迁移至新版本至关重要）。随后，运行新版 Xeoma 并按需进行安装。

此外，您亦可在离线状态下更新 Xeoma（若服务器无法访问互联网）：

1. 请使用任意可联网设备，通过此链接下载所需的 Xeoma 版本；
2. 将所需的 Xeoma 版本传输至您的服务器
3. 停止旧版 Xeoma 运行：主菜单 –> 安装 –> 卸载 –> 删除（除存档和设置外），或通过控制台/终端执行 (-install -removeexe)
4. 启动新版 Xeoma：主菜单 –> 安装 –> 安装，或通过控制台/终端执行 (-install -coreauto)

至此，Xeoma 更新完成。

Xeoma 的 Beta 版和正式发布版均支持自动更新。

同时，请留意您的许可购买日期。免费更新仅涵盖购买之日起的前 12 个月。期满后，您可以选择：继续使用免费更新期届满时的最新可用版本；将 Xeoma 更新至最新版本（此时将失去原许可的使用权）；或购买新许可以获得另外 12 个月的免费更新。
如需查看已激活许可详情，请前往“主菜单” –> “注册” –> “激活许可”。如需查询所有注册许可信息，请访问felenasoft.com 网站填写在线表单。

注意：如需更新至 Beta 版本，请在检查更新窗口中勾选相应选项。

关于使用代理服务器进行更新的信息，请参阅此章节。

如需禁用新版本可用通知，请取消勾选主菜单 -> 信息 -> 检查更新中的所有选项，或使用控制台命令‘-noautoupdate‘（使用‘-disableDownloads‘命令可从主菜单中移除“检查更新”子菜单）。


4.5.2. 回退至之前版本（桌面版）

回退或降级是与更新相反的过程，即从新版本切换回旧版本。此操作适用于多种场景，最常见的情况包括：a) 您的许可版本过旧，无法支持新版本；b) 因故不希望使用最新版本。

如果您在更新至新版本后决定更改，可以回退到之前使用的版本，或任何比当前版本更旧的版本。

操作步骤简便，具体取决于您的 Xeoma 当前是否已设置为开机自启。

若您的 Xeoma 已设置为开机自启（此为常见情况），请执行以下操作：
第 1 步。移除当前版本：
* (通过图形界面) 前往“主菜单” –> “安装” –> “卸载”，并选择“卸载除存档和设置外的所有内容”



或
* (通过控制台) 将 Xeoma 可执行文件拖入控制台，随后输入 -install -removeexe

第 2 步。获取您想要切换的版本：
a) (GUI/控制台) 进入 Xeoma 文件夹，找到其中的"Old versions"子文件夹，更新前使用的 Xeoma 副本可能保存于此。



若该文件夹不存在，或其中版本并非您希望回滚的目标版本，可从我们的 变更历史记录 页面下载任意旧版本。

第 3 步。获取所需版本的 Xeoma 后，无论是否安装均可启动
(GUI) 双击可执行文件即可启动。前往 主菜单 -> 安装 -> 安装 进行安装
(控制台) 将可执行文件拖入控制台并按 Enter 键，即可同时启动服务端和客户端（若支持 GUI）。在可执行文件后附加 -core 仅启动服务端，附加 -client 仅启动客户端。附加 -install -coreauto 可将服务端安装为开机自启。

若您的 Xeoma 未设置为开机自启（较少见），则需执行以下操作：
1. 关闭当前版本
(GUI) 通过 主菜单 – 退出 或点击窗口标题栏的 X 按钮关闭当前版本的 Xeoma。
或
(控制台) 在控制台中按 CTRL+C 或直接关闭控制台窗口。

2. 找到并启动您想要使用的另一个版本。
a) (GUI/控制台) 进入 Xeoma 文件夹，找到其中的"Old versions"子文件夹，更新前使用的 Xeoma 副本可能保存于此。
若该文件夹不存在，或其中版本并非您希望回滚的目标版本，可从我们的 变更历史记录 页面下载任意旧版本。

第 3 步。获取所需版本的 Xeoma 后，无论是否安装均可启动
(GUI) 双击可执行文件即可启动。前往 主菜单 -> 安装 -> 安装 进行安装
(控制台) 将可执行文件拖入控制台并按 Enter 键，即可同时启动服务端和客户端（若支持 GUI）。在可执行文件后附加 -core 仅启动服务端，附加 -client 仅启动客户端。附加 -install -coreauto 可将服务端安装为开机自启。

请注意： 注意：iOS 应用不支持版本回退。 Google Play 中的 Android 应用不支持版本回退。若您的 Android 设备允许安装非 Google Play 来源的应用，可通过卸载设备上的最新版 Xeoma 应用，然后从我们的网站下载并安装所需版本的 Android 应用来实现回退。

---

4.6. 操作员与用户访问权限

4.6.1. 用户访问权限（用户权限）



在“编辑用户权限”对话框（主菜单 -> 远程访问 -> 用户）中，您可以创建具有多层访问权限和授权的用户配置文件。

在此对话框中，您可针对所有或特定摄像机，限制或允许查看画面（实时与存档）、删除存档、PTZ 控制、修改设置以及开启/关闭摄像机声音。

请注意，“编辑用户权限”对话框仅对 Xeoma 管理员开放。

选中管理员用户配置文件时的可用选项

首先，请注意“用户”和“密码”字段。默认情况下，这些字段已填入拥有系统完全权限的管理员凭据。
请注意，系统仅能存在 1 个管理员配置文件，且该配置文件始终允许多次访问。



“用户” 字段列出了您 Xeoma 中的所有用户。点击该字段右侧的箭头图标即可查看完整列表。

当“用户”字段中选中管理员配置文件时，您可更改由程序初始生成的本地及远程访问密码。只需在字段中输入新密码以替换当前密码即可。
默认情况下，密码以星号掩码显示。如需查看密码，请点击输入框右侧的“闭眼”图标，该图标随即变为“睁眼”状态；再次点击即可重新隐藏密码。

在 Xeoma 的连接对话框中，请使用该用户档案的密码及服务器 IP 地址进行登录。请注意，用户档案名称仅供参考，不在连接对话框中使用。

点击“删除”以清除当前在“用户”字段中选中的用户档案。请注意，管理员档案无法删除。

点击“添加”以添加新用户。在随后弹出的窗口中输入新操作员的用户名和密码，然后点击“确定”。所有已添加的用户档案均会显示在“用户”字段右侧的下拉列表中。

如需编辑档案的密码或权限，请在“用户”字段中选择该档案并修改相应设置，然后点击“确定”按钮。

“复制”选项可为另一用户创建用户档案副本。当您需要创建多个具有相同权限的用户档案时，请使用此功能。不过，新用户档案必须拥有唯一的名称和密码。

点击“导出”可保存电子表格文件，其中列出了所有或选定用户档案及其摄像机权限。

勾选“允许用户多点访问”选项，以允许该档案在多台设备上同时使用。若未勾选，同一时间仅接受一个使用该凭据的连接。例外：管理员档案始终启用多点连接。

勾选“允许通过 LDAP 条目登录”选项，以将目录服务中的用户与 Xeoma 同步。点击"LDAP 属性”可打开 LDAP 同步设置弹窗。

注意：LDAP 选项现已支持用户组及子组管理。查看更多

此外，还提供“预览中摄像机的独立排序（针对每台设备）”选项，允许使用此管理员档案的用户在不同连接设备上拥有不同的摄像机排序。若不启用此选项，当多个设备共用同一用户档案时，摄像机排序将始终被最后一次使用的排序覆盖。

使用‘-individualsettings‘命令为每个客户端单独存储个人设置。 使用'-clientIndex [ClientID]'命令创建多个具有不同设置的快捷方式。详见此处 详见控制台命令

勾选“自动更新客户端组件”（全局）选项，可使所有 Xeoma 用户档案的客户端组件在新版本发布后自动更新。勾选后，该选项将显示可供开启自动更新的操作系统列表。

自 25.1.16 版本起，Xeoma 管理员还可启用双因素认证。这意味着采用两步验证流程：除输入账户密码外，还需提供发送至邮箱的验证码方可完成连接；若无验证码，连接将失败。更多详情请参阅下方4.6.3. “连接的双因素认证”章节。

自 25.1.16 版本起，Xeoma 管理员还可暂时封禁用户，即在不删除账户的情况下临时停用。若配置文件当前无需使用但预计将来会再次启用（例如等待用户付款，或在组织架构调整期间需将账户重新分配给尚未确定的人员），此功能尤为便捷。有关该功能所有特性的详细信息，请参阅下文 4.6.4. “用户封禁设置” 部分。
此外，本节还介绍了如何将用户连接限制在特定的 IP 地址。

如果您以权限受限（无法更改设置、查看存档等）的特定用户身份登录，Xeoma 中的某些图标和菜单选项可能不可用。您可以通过“主菜单”–“远程访问”–“连接至”切换至所需用户（或管理员）。您可以通过“主菜单”–“远程访问”–“用户”配置用户。

“用户”和“密码”字段下方是时区校准下拉列表。此处设定的时区适用于服务器端（而非用户端），旨在确保 Xeoma 中与时间相关的功能正常运行：包括标记的“日期和时间”选项、计划程序，以及至关重要的存档录像功能。默认情况下，Xeoma 服务器端会显示服务器主机的时区；若检测有误或您因故需要更改，可在此处进行调整。
注意：如果用户（包括管理员）从不同时区连接，存档查看器的时间轴将重新计算并以用户本地时间显示，而其他“时间”相关功能仍将使用服务器时间。

通过“仅允许管理员更改摄像机顺序”功能，您可以禁止用户自行更改 Xeoma 中的摄像机顺序。
要激活此功能，请勾选“仅允许管理员更改摄像机顺序”选项。该设置将自动应用于所有用户。

此外，在管理员身份下，您可以允许或限制对布局和主菜单的访问。为此，请在“密码”栏中输入密码并勾选所需选项——“限制布局菜单访问”或“限制主菜单访问”，或两者同时勾选（如果密码框为空，则该功能无效）。如果勾选了这些选项，所有用户在访问其中一个或两个菜单时都需要输入密码

管理员可强制系统将视频解码负载转移至客户端（用户）侧，适用于所有以用户配置文件登录的用户（参见选项 “强制客户端视频解码（针对所有用户）”）。不过，针对包括管理员在内的特定用户，您可通过“允许服务器视频解码（针对当前用户）”选项设置例外。

勾选“使用 csv 文件记录用户操作”，系统将把操作员操作的总体信息以电子表格日志的形式保存至服务器端的 Xeoma“Logs”文件夹中。每当检测到被追踪的操作时，文件就会更新。

如果尚未连接“WebServer”模块，“启用 webAPI” 选项将开启对 外部命令 的支持。要启用此功能，必须在此服务器上激活至少一个 Xeoma Pro 许可证（支持 1 台或更多摄像机）。

勾选“打开站点交互式地图 (eMap)” 选项，即可在 Xeoma 底部图标面板中为管理员显示 eMap 按钮。
注意：这不影响主菜单中的 eMap 选项。

选择其他用户配置文件（非管理员）时可用的选项

如果“用户”字段中选择的不是管理员配置文件，对话框将显示其他选项。最重要的是，系统将列出该服务器中的所有摄像头，用于设置该用户的访问权限。除了查看摄像头的权限外，还可以在此处设置 PTZ 功能控制、存档导出等权限。详见下文。



当选择非管理员用户配置文件时，对话框的上半部分与管理员配置文件基本相同，但此处的复选框选项仅适用于所选用户。
您还可以在此处设置该用户的客户端部分在发布新版本后自动更新（选项 “自动更新客户端部分”）；允许或限制该用户配置文件下的多端同时访问（选项 “允许用户多重访问”）；通过 “允许通过 LDAP 条目登录” 配置 LDAP 同步，以及通过“用户”和“密码”字段更改或添加新的用户配置文件。

其下方是服务器的时区选择。解释请参阅 “选择管理员用户配置文件时的可用选项”。

此外，该配置文件的用户可在不同的连接设备上设置独立的摄像头顺序。为此，请启用 “预览中摄像头的独立排序（针对每台设备）”。若不启用此项，当同一用户配置文件在多台设备上使用时（例如，分店经理工作时间用 Mac 电脑监控收银台摄像头，夜间则用智能手机快速查看门口摄像头），摄像头顺序将始终被 最后一次 使用的顺序覆盖。

或者，您可禁止该用户 更改屏幕上的摄像头顺序（启用 “仅允许管理员更改摄像头顺序” 选项）。
此功能允许管理员为每个用户设置单独的摄像头顺序，并可由管理员本人在查看时使用。
要为用户设置摄像头顺序，请前往“视图窗口”>“使用用户的摄像头顺序”，在弹出的窗口中选择目标用户，您的摄像头视图将切换至该用户的视图。在此，管理员可通过鼠标拖拽调整摄像头顺序。当前显示的视图所属用户将显示在顶部窗格中，位于程序版本信息之后。

通过 “允许导出（如果您拥有存档访问权限）” 选项，您可允许（勾选）或禁止（不勾选）该用户从其有权查看的摄像头存档中 导出 录像（此选项仅适用于该用户有权访问的摄像头存档）。

“允许访问 Emap” 复选框用于授权该配置文件的用户访问名为 eMap 的交互式站点地图。在此了解更多关于 eMap 的信息

勾选 “允许在服务器上进行视频解码（针对当前用户）”，可使该用户配置文件无需像往常一样将解码负载转移至客户端，而是由服务器承担此负载。

“允许用户在网页中更改密码” 设置旨在授予该用户配置文件通过 Xeoma Web 界面（由 Web 服务器 页面打开）更改其指定密码的权限。

下方提供了 “PTZ 控制优先级” 选项，我们将在 下文进行详细说明

最后，我们来到用户配置文件中最核心的部分——“摄像头访问权限” 区域，用于设置访问摄像头、存档、设置等各项权限。

如需快速搜索摄像机，请输入其在预览窗格左上角显示的名称，然后点击“搜索”。

搜索框下方左列将显示该服务器中所有摄像机的列表（如果已设置并可用，还将显示页面和/或摄像机组列表）。摄像机右侧的列包含复选框，勾选即可为此用户配置文件启用该摄像机/页面/组的相应功能（功能图标位于复选框上方的一行）。

以下是复选框上方显示的图标及其代表的功能列表：

当摄像机被纳入多个具有不同访问权限设置的组或页面时，若需为该摄像机设置例外并赋予其独立的访问权限，请使用“固定”图标。换言之，这将忽略组级别的访问权限，优先采用该摄像机作为独立个体时所设定的权限。
“眼睛”图标控制摄像机的查看权限。若未勾选某台摄像机的此项，则其所有其他复选框均不可用。
“回放”图标用于设定访问摄像机归档录像的权限。若未对某台摄像机/组/页面勾选此项，则随后的删除录像选项也将不可用。
“垃圾桶”用于设置手动删除部分归档录像的权限。
“PTZ”开启用户控制摄像机 PTZ 功能的权限。
“齿轮”图标允许该用户配置文件持有者打开并修改摄像机及其链路的设置。
“扬声器”图标允许该用户配置文件持有者访问此摄像机/摄像机组/页面的音频流。

请注意：即使摄像机不具备此类功能（PTZ、音频、归档录像），系统仍会显示这些图标，因为本对话框并不校验具体硬件功能。

下方将显示此服务器中添加的所有页面、摄像机组和所有摄像机。首行用于设定所有“新”摄像机的权限：即尚未添加但未来可能会添加的摄像机。

此外，还有一个可点击的“全部”文本。点击它将为该功能垂直列中所有 (!) 摄像机的复选框打上勾选标记。再次点击“全部”将取消所有摄像机的勾选，并禁止该用户配置文件使用此功能

请勾选该操作员需要访问的所有摄像机及相关功能的复选框。

虽然摄像机访问权限是“编辑用户权限”对话框的核心部分，但还有几项实用设置可针对所有摄像机统一配置，而无需逐台设置：

勾选“查看、查看与归档模块的可用性”，以选择该用户配置文件可访问哪些由“预览”和“预览与归档”模块创建的预览窗格（若某条摄像机链路中单个摄像机使用了多个“预览”或“预览与归档”模块）。

其下方是访问底部面板图标的选项列表，该列表范围比管理员的更广：

• 添加新摄像机（“加号”图标）
• 在查看模式下选择摄像机（“窗口”图标）
• 打开站点交互式地图 (eMap)（“地图”图标）
• 打开录像归档（“播放”图标）
• 打开设置（“齿轮”图标）
• 删除方案（“叉号”图标）
• 打开 PTZ 控制（“PTZ”图标）
• 截屏（“照相机”图标）
• 快速开关（按钮切换器）（“继电器”图标）

---

4.6.2. PTZ 锁定

您可以为操作员锁定 PTZ 功能。为此，请前往主菜单 -> 远程访问 -> 用户

如需完全禁用任何摄像头的 PTZ 功能，请取消勾选相应摄像头旁的复选框。这样即可为指定用户完全禁用所选摄像头的 PTZ 操作。



如需允许操作员使用摄像头的 PTZ 功能但需设置限制，请使用优先级等级。

这意味着什么？

设想一座部署了大量摄像头的大型工厂，其监控管理通常涵盖从安保人员到首席执行官的多个层级。优先级机制允许高优先级用户阻断低优先级用户的操作。例如，优先级为 10 的管理员可阻断优先级为 1 至 9 的下级用户；而优先级在 11 至 15 之间的用户则可同时阻断管理员及下级用户，依此类推。



自 Xeoma 22.6.3 版本起，Starter 和 Lite 版支持通过“主菜单 – 远程访问 – 用户”对话框修改管理员密码、配置时区及其他界面设置（这两个版本不支持创建用户配置文件）。

4.6.3. 连接的双因子身份验证

连接的双因子身份验证是 Xeoma 25.1.30 版本起推出的一项新功能。

该功能在尝试连接时引入两步验证：不仅验证密码，每次连接还要求输入发送至账户注册邮箱的专用验证码。若验证码输入错误或未输入，连接将失败。此功能目前仍在开发中，后续将持续优化。

仅 Xeoma 管理员可配置并启用此功能，但可将其应用于 除管理员以外 的任何账户。该功能仅适用于客户端到服务器的连接类型，不支持 Web 界面登录。

设置双因子身份验证分为三个步骤：

1. 点击“双因子验证 SMTP 服务器设置”文本按钮。系统将打开一个对话框，用于配置发送邮件的邮箱地址。在此处，您需要输入用于发送邮件的账户登录名、密码及 SMTP 服务器地址。填入所需信息后，保存更改并进入下一步。

2. 点击“双因子验证设置”文本按钮。系统将打开一个对话框，用于配置账户持有者在尝试连接时接收的消息内容。您可根据需要编辑消息模板或保留默认设置。选择接收者语言，保存更改后进入步骤 3。注意：此阶段无需指定接收者地址（即账户持有者的邮箱），该操作将在下一步完成。

3. 在“用户”下拉列表中，选择需要启用双因子身份验证的账户。在可编辑的“服务器名称”字段下方，找到“启用双因子身份验证”开关并将其切换至启用状态（蓝色）。随后将出现以下字段：
- 若需选择与步骤 2 模板中指定语言不同的语言，可使用下拉菜单；
- 提供一个可编辑字段，用于输入接收者（即用户配置文件持有者）的邮箱地址。每个账户仅能绑定一个邮箱地址，但可根据需要随时更换。  
 

4.6.4. 用户屏蔽设置

从 25.1.30 版本起，Xeoma 的 用户 菜单中现已提供“用户屏蔽设置”对话框。该对话框包含以下实用功能：

临时禁用用户 – 无需删除账户即可暂时停用其访问权限。被临时禁用的账户将无法使用密码连接，效果等同于配置文件已被删除。不过，您只需单击一下即可解除禁用，恢复其连接 Xeoma 服务器的权限。当后续可能需要再次使用该配置文件时，此功能尤为实用。

2. IP 地址限制，用于指定允许连接的地址（即"IP 白名单"）。此安全措施将连接至 Xeoma 服务器的请求限定在特定 IP 地址范围内。例如，若您预期安保人员仅从公司办公室连接，此功能可确保仅允许这些地址访问。它还能防范因密码泄露带来的风险，并在无法避免某配置文件被多方访问时，减少过度连接的情况。

3. 特定用户的 Xeoma 服务器历史与当前连接信息。此部分列出了该用户连接时使用的所有 IP 地址及详细的连接详情。
其中包括：
-当前或此前用于连接的 IP 地址；
-当前或此前用于连接的设备操作系统；
-连接方式：若通过 Xeoma 客户端连接，App 标签将以白色高亮显示；若通过 Web 界面连接，则 Web 标签高亮显示；
-连接状态：当前活动连接标记为 Online，历史连接标记为 Offline；
-连接的时间和日期（活动连接显示当前时间和日期）；
-连接持续时间。

如果同一个 IP 地址发起了多次连接，则仅显示最近的一次。

以上所有功能仅对 Xeoma 管理员开放。功能 1 和 2 可应用于除管理员以外的任何账户。
 

配置临时禁用用户
在“用户”对话框中，点击“用户禁用设置”文本按钮。在随后打开的“用户禁用设置”对话框中，您可以使用搜索字段查找特定账户。开始输入用户名，程序将自动筛选匹配的配置文件。此字段为可选：如果您用户较少，也可以直接在窗口中滚动查找所需账户，因为用户是按字母顺序排列的。

每个账户显示：1) 用户名称（即配置文件、账户或操作员）以及 2) 临时禁用开关，所有用户默认状态均为"Active"（蓝色）。关闭开关后颜色将变为灰色，表示该账户已被禁用。

使用开关 (2) 即可轻松启用或禁用任何用户的临时禁用状态。此功能不设定时器：配置文件将保持停用状态，直到手动将开关切换回“Active”以解除禁用。
 

配置连接地址限制
连接地址限制同样在“用户禁用设置”对话框中配置，您可通过点击“用户”对话框中的“用户禁用设置”文本按钮打开该对话框。

除前述功能外，每个用户配置块还包含一个可编辑字段，标签为 “允许该用户连接的 IP 地址/子网白名单”。该字段用于创建连接地址白名单。

在此字段中为用户输入至少一个 IP 地址或子网，然后点击 “添加” 按钮以激活连接过滤。若用户尝试从名单之外的地址连接，连接将被拒绝。

您可以重复上述步骤添加多个地址或子网。若要删除错误或过时的地址，请在地址列表中选中该地址，然后点击字段下方的 “删除” 按钮。

如需对所有账户启用地址过滤，可一次性为所有用户添加 IP 地址。操作方法：在任意用户的“允许该用户连接的 IP 地址/子网列表”字段中输入通用地址，点击“全部添加”而非“添加”。该地址随即会出现在所有账户的列表中。如有需要，您可针对无需此地址的特定用户将其移除（参见上文）。
 

4.6.5. 显示预览水印

自 25.1.30 版本起，Xeoma 支持在整个客户端窗口自动应用水印。 

请勿将此功能与 “标记”模块的“画中画”功能（可在摄像机画面内嵌入类水印效果）或 Xeoma 免费版 自动添加的水印混淆。相关详情请参阅对应章节。

客户端水印叠加功能可在 “用户” 对话框中启用 (主菜单 -> 远程访问 -> 用户)。进入用户设置对话框，确保在“用户”下拉列表中已选中 Administrator。 

以 Administrator 身份登录时，“显示预览水印”选项将显示在可编辑的“服务器名称”字段下方的选项列表中。
将开关切换至“启用”状态（蓝色），所有客户端的所有摄像机画面上均会显示水印，内容包括： 
1. （必填）当前登录用户的名称（账户/配置/操作员）， 
2. （必填）当前日期和时间， 
以及 
3. （可选）“服务器名称”字段中设定的自定义服务器名称（如已指定）。 

水印将显示于所有 Xeoma 窗口：主窗口、单路摄像机视图窗口、录像回放器及设置界面。 

使用 Xeoma 内置“截图”功能拍摄的截图，以及存档或导出的录像中，不会保存水印。该叠加效果仅作用于客户端。 

您可在同一位置将开关切换至“禁用”状态（灰色），从而关闭水印叠加。 
 

---

4.7. 设置恢复（设置与存档备份）

在 Xeoma 中，您可以通过“主菜单”–“安装”–“恢复”–“导入/导出设置”创建配置副本（备份）（Xeoma 试用版不可用）。

您可以通过以下两种方式创建备份副本并恢复 Xeoma 设置：1. 通过 Xeoma Client 自动完成；2. 使用设置文件夹中的 Xeoma 设置文件手动完成。

1. 通过 Xeoma Client 自动创建备份副本并恢复配置：

我们建议定期备份 Xeoma 设置，尤其是当我们的技术专家通过远程连接对 Xeoma 进行配置之后。请将备份文件保存在安全的位置（例如另一台 PC 或 USB 驱动器）

如何创建备份：

1. 运行 Xeoma Client，前往“主菜单”–“安装”–“恢复”–“导出设置”



2. 指定所需路径（或保留默认路径）和文件名，然后点击“确定”
3. 之后，您将在文件夹中看到两个 .dat 和 .cache 格式的文件（例如 settings.dat 和 settings.cache）
其中 settings.dat 是主配置文件（摄像头设置、模块链等），settings.cache 是“客户端”配置文件（窗口大小、解码设置等）
4. 备份文件应保存在安全的位置，例如另一台 PC 或 USB 闪存盘中。
如需恢复设置，可通过“主菜单”–“安装”–“恢复”–“导入设置”完成：指定备份文件路径并点击“确定”



2. 使用设置文件手动创建备份副本并恢复配置：

您可以从服务器上的 Xeoma 设置文件夹 中复制 settings.dat 文件。该文件包含可恢复的配置信息。

如需手动还原 Xeoma 设置，请停止 Xeoma（通过控制台 (Terminal)，或在 Xeoma Client 中依次点击“主菜单”>“安装”>“卸载”以取消自启动（存档和设置除外）），进入 Xeoma 的设置文件夹，将 setting.dat 文件替换为您需要的文件。启动 Xeoma，您将看到设置已生效。

此外，Xeoma 服务器上的设置文件夹内的 SettingsBackupDir 文件夹中，按最后保存日期存储了设置备份。若您丢失了设置备份副本或希望还原至之前的配置，可利用这些备份进行手动还原。操作步骤如下：

1. 请确保 Xeoma 未运行且未设置为自启动（您可通过“主菜单”>“安装”>“卸载”>“卸载（存档和设置除外）”来卸载 Xeoma）。停止/启动 Xeoma 的控制台命令请查看此处。
2. 进入 SettingsBackupDir 文件夹
3. 选择所需的设置文件（根据目标日期，例如 settings_2020-12-29 12.07.04）
4. 将备份文件重命名为 settings.dat，复制并移至Xeoma 的设置文件夹，覆盖当前的 settings.dat 文件
5. 启动 Xeoma，设置将自动加载

SettingsBackupDir 文件夹中的设置备份按以下策略存储：
– 当天：每次更改设置后均会存储备份副本。
– 前一日：每小时保留一份设置备份副本。
– 2 至 10 天前：仅保留首尾两份副本。

超过此期限的设置备份副本将被自动删除。

“主菜单”>“安装”>“还原”中各选项简述：



• 重置设置：此选项将重置 Xeoma 的所有设置。许可证保持激活，存档予以保留。该操作将清除所有已配置的摄像头，Xeoma 将如同首次启动般重新搜索本地摄像头。
• 保存设置：此选项可将当前配置保存至备份文件夹“SettingsBackupDir”。
• 还原设置：此选项可从近期备份（位于“SettingsBackupDir”文件夹）中还原设置。在 Xeoma 中，每次更改软件配置时均会自动创建设置备份，您也可手动将备份保存至“SettingsBackupDir”文件夹（即上述“保存设置”选项）。使用“还原设置”选项，即可从备份（例如最新备份）中还原配置。
• 导出设置：此功能可创建程序设置的备份副本并存储于 Xeoma 之外。建议定期创建 Xeoma 配置备份，并将其保存在安全位置（例如独立的硬盘或 USB 闪存盘）。
• 导入设置：通过此选项，您可还原此前通过“导出设置”功能保存为备份的设置。

 

若需手动更改设置文件的 Xeoma 服务器端已设置为自启动，可使用'-stopservice'命令暂时停止服务器端。 更改完成后，可使用'-startservice'命令重新启动服务器端。 在此处查看有关控制台命令的更多信息

若需将 Xeoma 及其所有设置从一台服务器迁移至另一台，请参阅此指南。

4.8. 运动可视化（运动追踪）

Xeoma 支持运动可视化与运动追踪。启用此选项后，所有移动对象将被框选，您将看到移动对象在运动过程中留下的“轨迹”（绿色圆点）。

要开启或关闭运动可视化，请进入“布局”并选择“开启运动可视化”或“关闭运动可视化”。



---

4.9. 热力图

热力图是视频监控中最高效的工具之一。通过它，您可以快速掌握摄像机视野内的运动动态。

Xeoma 热力图的工作原理与热成像摄像机有所不同。后者基于物体的温度：“温暖”或“灼热”的物体显示为暖色调区域（红色系），而物体越冷，在摄像机图像中的蓝色就越深。

Xeoma 采用类似的“冷暖”颜色梯度，但其依据的是特定区域的运动频率而非温度。

从理论到实践
由于热力图基于运动检测器提供的信息，因此该方案必须包含 运动检测器 模块。请确保您的方案中已配置该模块，以及通用摄像机、“预览”和“存档”。按照需求设置运动检测器，并确保其将图像向下传递至方案中的后续模块。



进入存档查看器（点击下方面板或摄像机窗口角落的 播放 按钮）。在存档查看器菜单中选择“创建热力图”。



在弹出的提示框中选择需要生成热力图的时间范围。例如：一周、24 小时或 15 分钟。默认情况下，系统将选择所有已有记录的时间段。注意！特定存档中必须至少包含 5 分钟的记录，Xeoma 才能为您选择的任何时间段创建热力图。



您可以使用存档查看器菜单中的相应选项保存生成的热力图。

---

4.10. 安全 TLS 连接

Xeoma 支持服务器与客户端之间的安全 TLS 连接。TLS 即传输层安全性协议 (Transport Layer Security)，是 SSL (Secure Sockets Layer) 的升级替代方案。
其核心原理如下：客户端和服务器在每次连接时都需要一种唯一的方式来加密数据。这样即使会话被拦截，也无法被解密，从而保障信息安全。这就是 TLS 连接的高度安全性所在。这一切都基于数字证书（或安全证书）的概念。安全证书通常由服务器创建，并在首次交互期间发送给客户端。客户端对此进行确认或拒绝——此过程称为“握手”。随后，双方使用密钥对数据进行加密和解密，无需担心第三方篡改。

因此，TLS 连接需要有效的安全证书。相应地，每个安全证书都需要签名，否则无法使用。理想情况下，证书应由服务器和客户端共同信任的第三方签名。服务器可以通过两种方式签名证书：向正式的证书颁发机构 (CA) 申请，或自行签名以创建自签名证书。Xeoma 采用的是后者。

首先，我们需要在服务器上生成安全证书。最佳软件是 OpenSSL：https://www.openssl.org/source/。不过，该软件似乎仅在基于 Linux 的系统上运行稳定。但生成的证书在任何系统上均有效，因此如果您运行的是 Windows 或 Mac OS，可以寻求使用 Linux 的朋友帮助，或通过虚拟机访问 Linux。您可以在终端中使用多种命令来生成证书，但请务必将结果文件命名为 PublicCertificate.pem 和 PrivateKey.pem，或者 PublicCertificate.der 和 PrivateKey.der。最快捷的方法是复制并粘贴此命令：

openssl req -x509 -sha256 -new -days 3650 -newkey rsa:2048 -nodes -out PublicCertificate.pem -keyout PrivateKey.pem -subj “/C=Co/S=SN/L=Lo/O=Or/OU=OU/CN=CN”



现在，您的 OpenSSL 目录下已生成这两个文件：



最后一步是将它们移动到 Xeoma 的主目录，路径为 Xeoma → Security → Certificate：



将 PublicCertificate.pem 和 PrivateKey.pem 均放入 Server 文件夹（它们将替换现有文件）。请注意，PrivateKey.pem 至关重要，除您之外任何人不得访问，否则您的安全性可能会受损。现在，所有客户端都需要将 PublicCertificate.pem 放入 Client 文件夹，即可保障安全连接。如果您需要单个客户端通过不同的证书连接到多个不同的服务器，可以将它们全部放入 Client 文件夹（命名为 PublicCertificate1.pem、PublicCertificate2.pem 等，但请确保名称与服务器上的名称一致）。

Xeoma 支持多种受保护的客户端-服务器连接选项：请使用 “-sslconnection [0/1/2]” 参数，其中 0 表示忽略证书连接到服务器（在客户端配置）；1 表示仅接受来自客户端的安全连接（在服务器配置）；2 表示自动检测证书（可在服务器或客户端配置）。 了解更多关于控制台命令的信息

---

4.11. 录像自动化备份（通过 FTP）

保存数据最高效的方式之一是创建备份，且建议将备份存储在远离主服务器的位置。此时，FTP 上传功能可提供理想的解决方案。

用于存放备份存档的服务器需要安装 FTP 工具。FileZilla 是最受欢迎的选择之一，且完全免费，您可以轻松下载并安装。

如何在 Xeoma 中实现此功能？为此专门设计了一个模块 —— “FTP Upload”。您只需对其进行正确配置即可。



首先，输入 FTP 服务器的地址和端口（默认端口为 21，但您可以在 FTP 服务器上指定其他端口）。如果您希望传输过程经过加密，请勾选 SFTP (SSH File Transfer Protocol) 复选框。不要忘记点击 测试 按钮！如果配置有误，顶部消息将准确显示错误原因。如果一切正常，消息将显示 测试成功。

备份存档无需像主存档那样严格整理。但为了便于日后检索，仍需以清晰的结构进行排列。目前最简单的方法是在每个文件名中插入日期和时间。为此，我们设计了 宏。您只需将相关符号置于两个 %（百分号）之间即可。输入框下方的提示行将实时显示文件名的最终格式。例如，%y-m-d h-i% 将转换为 2016-12-06 13-47。这样一来，检索备份存档将变得非常简单。

为确保不遗漏任何内容，您可以将 预录 设置为几秒钟，并定义 保存图像/视频的间隔。最后，选择 保存的数据类型：JPEG, MJPEG, WEBM, AVI 或 WMV。

大功告成！安装有 FTP 工具的服务器备份存档现已准备就绪。

---

4.12. 故障转移

Xeoma 是新一代视频监控软件。顺应现代视频监控技术的最新需求，Xeoma 现已支持故障转移功能。

若其中一台主服务器宕机，指定的备份服务器将自动接管。当故障主服务器恢复运行后，业务将自动切回该服务器。



此功能适用于 Xeoma Standard 和 Xeoma Pro 版本。

在备份服务器上，前往 主菜单 → 安装 → 备份服务器模式 并指定主服务器列表。此时，该备份服务器将监控所有指定的主服务器，并在其中一台发生故障时接管其工作。



注意！备份服务器所需的许可证类型必须与其作为故障转移目标的主服务器完全一致。

---

4.13. 硬件加速

4.13.1. 服务器

若单台服务器需处理大量摄像机（如 50 台），通常需高性能 CPU 来处理实时流。然而，显卡 (GPU) 可通过硬件加速解码分担部分负载。具体而言，现代 Nvidia 显卡支持 CUDA（Compute Unified Device Architecture，适用于 Windows 和 Linux），而 Intel 集成 GPU 支持 Quick Sync（仅限 Windows）。Xeoma 支持利用这两种技术。

要启用此选项，请进入 “通用摄像机” 设置并勾选相应复选框：



硬件加速生效需满足两个条件：

1. 预览流（模块中的首个 URL）分辨率须至少达到 HD 级别（720p 或 1280×720）；否则，硬件加速不仅无效，反而会产生负面影响，因此无法启用；
2. GPU 本身须同时兼容操作系统类型与摄像机流类型

第二个条件的具体要求如下：

操作系统	流	最低架构
Windows	H.264	Fermi
	H.265	Pascal
Linux	H.264	Maxwell
	H.265	Pascal
MacOS	H.264	Maxwell
	H.265	Pascal

GPU 性能需与待处理的摄像机数量相匹配。例如，GeForce GT 730 可处理 4-6 台摄像机，而 GTX 1060 则可处理数十台。

有关 CUDA 运行的更多详情，请参阅 本文。

4.13.2. 客户端

若客户端设备具备足够的解码能力，可显著降低服务器负载。在此场景下同样可启用硬件加速——可将 服务器 配置为将解码任务卸载至客户端（远程工作站）。请前往 布局菜单 → 客户端解码设置，并在下拉菜单中选择相应选项：



自 Xeoma 23.12.7 版本起，依据图形驱动程序的不同，针对各类客户端操作系统提供了更多选项。明细如下：
Windows:

• Intel Quick Sync
• NVIDIA CUDA
• DXVA2
• D3D11VA
• Vulkan

Linux:

• Intel Quick Sync
• NVIDIA CUDA
• VAAPI
• VDPAU
• Vulkan

Linux ARM:

• V4L2M2M

有关此主题的更多内容，请参阅 接下来的文章。

4.13.3. 模块

自 Xeoma 22.3.16 版本起，部分模块亦可利用 CUDA 加速；所有操作系统类型下的最低架构要求均为 Pascal。涉及模块包括：

• 对象识别器
• 体育追踪
• 跨线检测器
• 烟雾检测器

Xeoma 会自动检测您的显卡与这些模块的兼容性；若显卡符合要求，模块设置中将显示“使用 CUDA 识别”复选框。勾选后，该模块运行的部分负载将由 GPU 与 CPU 共同分担。

---

4.14. 与外部设备集成

Xeoma 视频监控软件支持与各类外部设备广泛集成，主要通过发送和接收 HTTP 命令或经由 ONVIF 协议实现。

4.14.1. 与外部设备集成：HTTP 请求发送器（例如道闸）

借助“HTTP 请求发送器”模块，可轻松实现与自动化系统的集成；该模块可在触发时向外部设备及传感器发送指令。详情请参阅 “HTTP 请求发送器” 章节

4.14.2. 与外部设备集成：接收命令（例如通过信号启用录像）

借助“HTTP 切换器”模块，可轻松实现与自动化系统的集成。该模块不仅能在接收外部传感器信号时启用或禁用录像，还可向授权人员发送报警消息。详情请参阅 “HTTP 切换器” 章节

4.14.3. 外部设备集成：叠加标题（例如，用于自助现金机）

借助“HTTP 标记”模块，您可轻松将外部系统信息叠加至视频流及/或归档记录中，实现与自动化系统的无缝集成。例如，该功能可用于监控自助现金机的交易情况。点击 此处 了解更多关于 HTTP 标记的信息

4.14.4. 通过外部数据库集成外部设备

当前，智能 PRO 模块（自动车牌识别、FaceID、人脸识别）可能需要接入外部数据库。有关外部数据库集成的详细信息，请参阅各模块的相关章节。

4.14.5. 通过 GPIO 模块集成外部设备

该模块适用于连接至 GPIO 接口的设备，既能响应外部传感器触发（使用输入引脚），也能发送信号以触发外部设备（使用输出引脚）。请在 本文 中查看更多信息。

4.14.6. 通过 RIF+ 模块集成外部设备

该模块适用于 RIF+ 自动化设备，可连接各类传感器并接收其报警信号。请在 本文 中查看更多关于 RIF+ 系统的信息。

4.14.7. 通过 Modbus 控制器模块集成外部设备

该模块专为接收基于 Modbus 协议的控制器指令并在 Xeoma 中触发响应而设计。此类控制器广泛应用于自动化系统、智能家居及交通信号灯设备等场景。请在 本文 中查看更多信息。

4.14.8. 通过 Senstar PTZ 跟踪模块集成外部设备

该模块可将您的视频监控系统与配备 Senstar 传感器的安防系统联动，使摄像机自动转向报警区域。请在 本文 中查看更多关于该模块的信息。

4.14.9. Xeoma API

Xeoma API 可实现本程序与第三方软件及系统的集成。

4.14.10. 将外部传感器绑定至摄像机信号输入端

通过 摄像机内置检测器，您可向 ONVIF 摄像机发送信号以传输至报警输入/输出端。传感器需连接至摄像机并进行配置（可通过 ONVIF 完成）。此功能仅在 Xeoma PRO 中可用。

---

新功能：通知

自 Xeoma 23.12.7 版本起，Xeoma 推出了一项名为“通知”的新功能，区别于“常规”通知。
您可以通过主菜单（主菜单 – 远程访问 – 通知）或“问题检测器”模块设置（位于“告知停电情况”复选框下方的“通知设置”）访问此功能。

此选项与 “问题检测器” 模块（该模块也可在检测到 RAM 或 CPU 资源不足等系统健康问题时发出通知）的区别在于：它专为在最关键时刻发出警报而设计，例如当 Xeoma 服务器本身因停电而停止响应时。这使得“通知”功能独具优势，因为当承载设备的运行中断时，其他任何功能均无法生效。此前，一种变通方案是让多台 Xeoma 服务器通过“问题检测器”中的“检查网络资源访问”复选框和“要检查的网络资源地址”字段相互监控；但若所有服务器均位于同一栋遭遇停电或断网的建筑内，该方案便失效。使用“通知”功能则非常简单——只需勾选“如果服务器停止工作则显示通知”复选框即可。

“Notifications”模块与Xeoma其他模块的独特之处在于，它无需依赖目标通知模块！它能像“Mobile Notifications”模块一样，向安装了Xeoma应用的移动设备发送推送通知，却无需在Xeoma的任何链条中配置该模块。唯一的要求是：您需授予Xeoma应用显示通知的权限，并确保该应用至少连接过一次启用了“Notifications”功能的Xeoma Server。此外，应用无需始终运行，通知仍可正常送达。

除推送通知外，“Notifications”还能将服务器停止/恢复运行的数据保存到专属日志列表中，您可以通过对话框底部的“History”标签页打开。通过“Automatic deletion of old notifications”选项（可选范围 1 天至 100 天），可自动清除过旧条目，防止日志过大。

您可以自定义服务器“丢失”时的通知文本（“Message when the server is down”）以及恢复时的文本（“Message when the server is active again”），并通过“Interval of inspections of the server activity”选项指定服务器检查频率（可选范围 3 至 100 分钟）。

此外，“Notifications”还能检查其他网络设备的可用性。勾选“Inform about power outages”并在“List of IP or MAC addresses to check availability”中输入设备地址即可实现。通过此功能，您的 Xeoma 可额外监控其他 Xeoma 服务器、路由器、摄像头等的在线状态。

---

第 5 章. 远程访问


5.1. 代理服务器设置

您可配置Xeoma通过特定代理服务器运行。在通过命令行或终端启动Xeoma时，请使用-proxy命令并紧随代理服务器地址。例如：



若不再需要使用代理服务器，可通过-proxyclear命令禁用此选项。

---

5.2. 远程访问选项

视频监控系统通常需支持远程查看摄像头、访问归档记录、导出录像或管理模块/链条设置，而不仅限于运行Xeoma server part的计算机或设备。此功能称为远程访问；即便“远程”设备与服务器端仅相距数英寸，物理距离亦非关键，真正重要的是下文将探讨的其他因素。

Xeoma提供多种选项，可建立不同类型和用途的远程连接：
a) 客户端-服务器连接
b) 多服务器连接
c) “Web server”+“Another Xeoma”模块组合
d) 通过 Web 浏览器远程查看

下图将助您判断何种场景下适用特定连接方式：



接下来，我们将深入解析这些方法的用途及操作方式。

请勿混淆客户端远程连接至服务器（用于查看摄像头、归档及管理Xeoma设置）与远程摄像头连接至Xeoma服务器。本节介绍前者；关于后者的说明请点击此处。

1) 客户端-服务器连接



正如“4.1. Client-server architecture”章节所述，Xeoma由负责处理摄像头、保存录像及运行过滤模块等任务的服务器端，以及用于与服务器端交互（如修改设置、查看摄像头及录像、导出片段等）的可视化客户端组成

“客户端-服务器”远程连接方法的核心是将可视化部分（Xeoma 移动应用或 Xeoma 桌面程序）连接至服务器端。

用于：查看所有摄像机，访问（查看并修改）摄像机及其他模块的设置，以及查看实时视频和录像。

移动端应用或桌面软件连接至 Xeoma Cloud 账户部分基于此方法。详见Xeoma Cloud 章节。

支持多种操作员账户，以限制对摄像机或 Xeoma 功能的访问权限。参阅4.6 操作员与用户访问权限章节

此连接方法的指南：参阅5.2.1. 客户端-服务器远程连接

2) 多服务器（及多客户端）连接。



这是客户端-服务器连接的一种变体，客户端可视化界面可同时连接到多个 Xeoma 服务器。

用于：同时实时查看来自多个 Xeoma 系统的摄像机画面及检索录像。

详细指南请参阅多服务器章节。

客户端-服务器连接的另一种变体是多客户端连接，即多个客户端（移动应用或桌面软件）同时连接到同一服务器。此模式常用于构建视频墙、多显示器系统，或为具有不同访问权限的多名操作员提供连接。有关创建不同权限账户的信息，请参阅用户章节。

如果仅有少数客户端需要查看摄像机，请阅读下方关于配置客户端-服务器连接的详细指南。

3) 浏览器查看



在无法或不愿在远程设备上安装并运行 Xeoma 客户端应用程序时，您可以使用 Web 浏览器页面查看摄像机和录像，并使用部分受限的配置选项。

用于：在浏览器中实时查看连接至 Xeoma 的摄像机（及其录像），例如在不支持的移动设备上查看。点击此处了解支持的设备

此连接方法的指南：参阅5.4.1. Xeoma Web 服务器：第一部分。通过浏览器远程查看摄像机

4) “Web 服务器”-“另一台 Xeoma”。





严格来说，此方法本身并非远程访问，而是一种将摄像机流传输至远程设备的方法（该组合中的两台设备均为服务器端，即它们都会处理摄像机流、应用过滤器或执行相关操作等）。此处提及该功能旨在帮助您全面了解系统能力。

用途：在 1 号机器上查看特定摄像机的图像，同时在接收机器（2 号机器）上利用该摄像机构建其他链路，例如将录像存储在接收机器而非 1 号机器上。

示例：您需要采集计算机实验室中多台计算机的屏幕画面，并在管理员计算机上录制视频。示例 2：Web 摄像机 (USB) 在 PC 或笔记本电脑上运行，但您希望使用过滤器模块对其进行处理，并将录像存储在另一台设备上（出于安全考虑，或将负载转移至另一台性能更强或优先级较低的 PC）。

此方法的指南请参阅5.4.3. Xeoma Web 服务器：第二部分。在另一台 PC 上记录存档

5.2.1. 客户端-服务器远程连接

您可以使用适用于计算机或移动设备的 Xeoma 客户端连接到运行 Xeoma 服务器的计算机。

这里的关键在于，您是从安装有 Xeoma 服务器端计算机所在的同一局域网（“内部”网络）进行连接（例如，从另一个房间或同一楼层的办公室等），还是从外部连接（例如，从城市的另一端、另一个城市或国家等）。

为方便起见，我们将执行所有摄像机操作且我们将连接至的服务器端设备称为1 号机。我们将发起连接的远程设备称为2 号机（由此连接）。此外，多个远程设备可同时连接至同一台服务器，一台远程设备也可同时连接至多台 Xeoma 服务器。

1. 同一网络内连接

 


方案 1. 手动连接（适用于任何设备）

按需配置好 Xeoma 服务器端（如连接摄像机、配置模块和链条等）后，您可能需要从另一台设备连接至服务器，以查看摄像机画面、调阅归档录像或修改设置等。建议操作步骤如下：

请勿关闭或停止您要连接的服务器端：服务器端必须处于运行状态，才能处理摄像机数据并接收传入连接。

Xeoma 服务器端（1 号机）必须处于试用版或任一商业版本。免费版不支持远程连接！

步骤 1. 获取连接数据
首先获取连接数据。在 1 号机上，进入主菜单（最左侧的“列表”图标）– “远程访问”，然后选择“连接至”。

在弹出的对话框中，复制指定的密码以及其中列出的内网（“私有”）IP 地址。远程设备（2 号机）连接时需要这些数据，请将其发送至 2 号机。建议使用复制粘贴而非手动输入密码，以避免出错。



控制台：如果服务器无图形界面，您可以使用系统命令获取 1 号机的 IP 地址，例如 ipconfig（Windows）、ifconfig（适用于 Linux、Mac OS X 及其他 Unix 系统的旧版命令）或 ip（适用于 Linux、Mac OS X 及其他 Unix 系统的现代命令）。更多说明请自行搜索。 然后，使用 -showpassword 命令获取 Xeoma 密码，并将该数据发送至 2 号机。

步骤 2. 在 2 号机下载 Xeoma 程序或 Xeoma App
在 2 号机上从我们的官网下载 Xeoma 程序，或从 App Store（iPhone / iPad）或 Google Play（Android 设备）下载 Xeoma 手机 App。启动该程序或 App。

控制台：由于远程访问意味着 2 号机将具备图形界面，请参阅 GUI 指南。所有操作均通过图形界面完成。

客户端版本不限。任何版本的客户端均可用于连接至服务器端（而服务器端则必须为试用版或商业版本之一）。

步骤 3. 从 2 号机发起连接

在 2 号机上进入“连接”对话框（Android 设备和计算机可在“主菜单” $\rightarrow$ “远程访问” $\rightarrow$ “连接至”中找到；iOS 设备在启动 Xeoma App 后将直接进入该对话框）。

在“连接”对话框中输入 1 号机的 IP 地址和 Xeoma 密码。

2 号机必须与 1 号机连接至同一网络，例如通过 WiFi。

方案 2. 通过扫描 QR 码连接（仅适用于 Android 版 Xeoma App）

自 Beta 版 23.12.7 起，Xeoma 支持通过Android 版 Xeoma App生成专用 QR 码来远程连接服务器。该 QR 码可包含管理员或任意单个用户的登录凭据，以及P2P 连接数据。

如何设置（仅管理员可用）

服务器端操作：
1. 进入“主菜单” – “远程访问” – “用户”；
2. 在打开的用户权限编辑对话框右上角，点击“通过 QR 码连接”；
3. 在弹出的窗口中，您可以选择：
— 为哪个用户生成 QR 码（本例中选择的是管理员）
— 选择是否生成一次性 QR 码（勾选“一次性 QR 码”复选框）
— 选择此 QR 码是否用于 P2P 连接（勾选"P2P 连接”复选框）
— 生成的 QR 码有效期，即扫描后可连接至服务器的时间段（拖动"QR 码有效期”下方的滑块进行设置，范围从 2 分钟至无限期）；
4. 完成上述配置后，点击 QR 码有效期滑块右侧的“创建”按钮；
5. 生成的 QR 码可通过 Android 设备上的 Xeoma 进行扫描（详见下文），也可在弹出的对话框中点击相应按钮将其删除、保存或更新（即重新生成）。



在 Android 设备的 Xeoma 应用中：
1. 打开 主菜单 – 远程访问 – QR 码扫描器；
2. 使用启动的摄像头扫描您在服务器端生成的 QR 码；
3. 在随后弹出的连接数据窗口中，输入生成 QR 码时所选用户的密码，即可访问摄像头。

 

2. 跨网络连接。

若需从 1 号机所属局域网之外的远程位置进行连接，1 号机必须具备外部静态 IP 地址（即“公网/固定/外部 IP 地址”），或具备相应的替代方案。

我们将分别介绍这两种情况：拥有公网 IP 地址，以及没有且无法获取公网 IP 地址。

 


情况 1：服务器端拥有静态固定（“公网”）IP 地址：

步骤 1：获取连接数据
在 1 号机中进入 主菜单（左侧的“列表”图标），选择“远程访问”，然后进入“连接至”。

在弹出的新对话框中，仅复制 Xeoma 密码(!)。

此时您应已知晓您的外部静态（固定）IP 地址。连接需要这两项信息，请将其发送至远程设备或计算机（以下称为 2 号机）。建议使用剪贴板复制粘贴密码，以避免手动输入出错。

控制台：若服务器无图形界面，可使用系统命令获取 2 号机的 IP 地址，例如 ipconfig（Windows）、ifconfig（适用于 Linux、Mac OS X 及其他 Unix 系统的旧版命令）或 ip（适用于 Linux、Mac OS X 及其他 Unix 系统的较新命令）。更多说明请自行搜索。 然后，使用 -showpassword 命令获取 Xeoma 密码，并将此数据发送至 2 号机。

步骤 2：转发 8090 端口
在 1 号机的路由器设置中，针对 Xeoma 用于客户端 - 服务器连接的 8090 端口执行"端口转发"。

请根据您的路由器型号搜索端口转发说明。例如，Portforward.com 网站提供了丰富的指南合集。

8090 是 Xeoma 客户端 - 服务器连接的默认端口。如果您之前使用 -serverport 命令将其更改为其他端口，则需转发该新端口。

控制台：请搜索关于通过控制台/终端转发 8090 端口的说明。

步骤 3：在 2 号机下载 Xeoma 程序或 Xeoma 应用
在 2 号机中从我们的网站下载 Xeoma 程序，或从 App Store（iPhone / iPad）或 Google Play（Android 设备）下载 Xeoma 智能手机应用。启动应用或程序。

控制台：由于远程访问的前提是 2 号机具备图形界面，请参阅 GUI 相关说明。所有操作均通过图形界面完成。

客户端版本不限。任何版本均可作为客户端连接至服务器端（服务器端必须为试用版或任一商业版）。

步骤 4：从 2 号机连接

在 2 号机器上打开“连接对话框”（Android 设备和计算机可在“主菜单” -> “远程访问” -> “连接至”中找到；iOS 设备在启动 Xeoma 应用后将直接进入该界面）。

在 2 号机器的连接对话框中，输入 1 号机器的公网 IP 地址、Xeoma 密码和 Xeoma 端口（默认为 8090，若已修改则输入自定义端口）。

点击“确定/连接”即可完成连接。

 

查看所有远程访问选项

自 Beta 版本 23.12.7 起，Android 端新增简化方案，支持通过扫描二维码连接至静态 IP 服务器，无需再手动输入 IP 地址。请参阅此处说明。

情况 2：服务器端没有静态固定（“公网”）IP 地址（且无法获取）：

方案 1：P2P 连接
一种突破性的免费方案，可实现不同网络环境下 Xeoma 远程客户端与服务器端的互联 —— P2P 连接。

P2P 客户端-服务器连接是无需服务器公网 IP 的全新免费替代方案。其工作机制很简单：利用中间 STUN 服务器为 Xeoma 服务器端分配唯一地址，从而将一个或多个客户端连接至服务器。此云端 P2P 服务器仅用于初始路由。连接建立后，服务器端与客户端将直接通信。P2P 服务器不接收也不传输 Xeoma 的设置、视频或流媒体等数据。

P2P 连接自 Xeoma 22.11.25 版本起在所有支持的操作系统和版本中提供（免费版除外），同时支持多客户端和/或多服务器连接。

唯一缺陷是，在极少数情况下（例如受网络基础设施限制），P2P 连接可能无法使用。若 P2P 连接在您的环境下失效，请尝试下文提到的其他方法，例如付费的 Repeater 服务。

您可在此查阅 P2P 快速配置指南，以下是启用该连接类型的详细步骤：
步骤 1：在 1 号机器（服务器端）开启并获取唯一地址
在 1 号机器上，进入 Xeoma 的主菜单 – 远程访问 – P2P 连接配置。在弹出的“P2P 连接配置”窗口中，您可查看该免费服务的详情，并勾选复选框以启用 P2P 连接，从而为服务器获取唯一地址。
勾选“启用 P2P 连接”选项，稍候数秒。
“此服务器的 P2P 地址”将显示格式为"AAA-BBB-CCC"的唯一地址，作为 Xeoma 客户端 - 服务器连接中公网 IP 的替代方案。请复制该地址并发送至 2 号机器（客户端）。此地址由 Xeoma 自动生成，无法编辑。



若当前 P2P 地址存在泄露风险，此窗口还支持更改自动生成的地址。如需获取新地址，请点击“此服务器的 P2P 地址”字段下方的“为该服务器获取新 P2P 地址”，数秒后地址栏将更新为新地址。

步骤 2：获取 1 号机器的 Xeoma 密码
要从客户端连接至 1 号机器，您需要步骤 1 中的唯一地址，以及 Administrator 或用户账户的 Xeoma 密码（如果在主菜单 – 远程访问 – 用户中创建了用户账户）。
Xeoma Administrator 密码仅可由服务器端管理员查看（通过 Xeoma GUI：主菜单 – 远程访问 – 连接至；或通过控制台命令 -showpassword）。

步骤 3：从 2 号机器发起连接
在 2 号设备上，从我们的网站下载 Xeoma 软件，或从 App Store (iPhone / iPad) 或 Google Play (Android 设备) 下载 Xeoma 移动应用。启动该应用或软件。

随后在 2 号设备上打开连接对话框 (Android 设备和电脑请前往 主菜单 -> 远程访问 -> 连接至；iOS 设备在启动 Xeoma 应用后将直接进入)。
输入步骤 1 中获取的 P2P 地址以及步骤 2 中 1 号设备的 Xeoma 密码 (管理员或用户密码)。点击 “确定/连接” 按钮。
客户端将向中间 P2P 服务器发送请求，获取服务端位置并与之建立连接，之后 P2P 服务器将不再参与两者之间的通信。

即将推出：用于 P2P 连接的控制台命令。

P2P 连接仅适用于 Xeoma 的客户端-服务端连接。不支持通过浏览器页面查看，也不适用于 Xeoma 以外的任何用途。

从 beta 版本 23.12.7 开始，Android 端提供了一种通过扫描 QR 码连接至服务端的简化选项。您无需再手动输入 P2P 地址！请在此处阅读说明。

选项 2。使用 Xeoma Repeater 服务
Repeater 是一项单独按月/年购买的服务，并在您服务器的 Xeoma 许可证基础上激活。

它可替代 Xeoma 服务端所需的唯一公网 IP 地址（仅适用于 Xeoma 客户端与服务端的连接；不同于真实的固定静态 IP 地址，它无法用于整台计算机）。在服务器上激活 Repeater 订阅后，您将获得一个唯一地址，使一个 Xeoma 实例能够找到另一个实例。

步骤 1。在此购买 Repeater 订阅。
在 1 号设备上激活：进入主菜单（左侧“列表”图标），选择“远程访问”，然后点击"Repeater 设置”。进入“激活”选项，在新对话框中输入 Repeater 订阅序列号，然后点击“确定”。

在新对话框中，您将看到 Xeoma Repeater 为该设备分配的唯一地址和密码。连接时需要这些数据，因此请将其发送至 2 号设备。为避免错误，建议使用复制粘贴而非手动输入密码。

控制台：可使用控制台命令 -activateRetranslator 激活 Repeater，但您仍需通过图形界面复制 Repeater 地址和密码，以便发送至 2 号设备。

步骤 2。在 2 号设备上下载 Xeoma 软件或 Xeoma 应用
在 2 号设备上，从我们的网站下载 Xeoma 软件，或从 App Store (iPhone / iPad) 或 Google Play (Android 设备) 下载 Xeoma 移动应用。启动该应用或软件。

控制台：由于远程访问的前提是 2 号设备必须具备图形界面，请参阅图形界面操作指南。所有操作均需通过图形界面完成。

客户端版本不限。任何版本均可作为客户端连接至服务端 (服务端必须为试用版或商业版)。

步骤 3。从 2 号设备连接

在 2 号设备上进入连接对话框 (Android 设备和电脑请前往 主菜单 -> 远程访问 -> 连接至；iOS 设备在启动 Xeoma 应用后将直接进入)。

输入服务端设备的Repeater 地址和密码。点击“确定/连接”即可建立连接。

Repeater 不支持权限受限的用户配置文件。它仅支持一个用户 —— 管理员。

Repeater 仅适用于 Xeoma 的客户端-服务端连接。不支持通过浏览器页面查看。


选项 3。使用第三方 dynDNS 服务模拟公网 IP 地址
在互联网上寻找免费或付费的 dynDNS 服务，将您的私有 IP 地址（也称为“动态内网 IP 地址”）转换为公网 IP 地址。通过此类服务，可为 1 号机器模拟公网 IP 地址。

第 1 步：获取连接数据
使用 dynDNS 服务获取模拟的公网 IP 地址，随后获取 Xeoma 连接数据。操作方法如下：在 1 号机器上，进入主菜单（点击最左侧的“列表”图标）→“远程访问”，然后选择“连接至”。

在弹出的对话框中，复制 Xeoma 密码。从远程设备（2 号机器）连接时需要此数据，因此请将该密码以及从 dynDNS 服务获取的“IP 地址”发送至 2 号机器。建议使用复制粘贴而非手动输入密码，以避免出错。

控制台：请在互联网上查阅有关如何通过控制台操作所选 dynDNS 服务的指南。 然后，使用 -showpassword 命令获取 Xeoma 密码，并将此数据发送至 2 号机器。

第 2 步：转发 8090 端口
在 1 号机器的路由器设置中，为 Xeoma 用于客户端与服务器连接的 8090 端口配置端口转发。

请在互联网上搜索适用于您路由器型号的端口转发指南。例如，Portforward.com 网站便收录了丰富的教程资源。

8090 是 Xeoma 客户端-服务器连接的默认端口。如果您此前通过 -serverport 命令将其更改为其他端口，则需要转发该新端口。

控制台：请在互联网上搜索如何通过控制台/终端转发 8090 端口的指南。

步骤 3：在 2 号机下载 Xeoma 程序或 Xeoma 应用
在 2 号机中从我们的网站下载 Xeoma 程序，或从 App Store（iPhone / iPad）或 Google Play（Android 设备）下载 Xeoma 智能手机应用。启动应用或程序。

控制台：由于远程访问的前提是 2 号机具备图形界面，请参阅 GUI 相关说明。所有操作均通过图形界面完成。

客户端版本不限。任意版本均可用作客户端连接至服务器端（服务器端须为试用版或任一商业版）。

第 4 步：从 2 号设备连接

在 2 号设备中进入“连接”对话框（Android 设备和计算机可通过“主菜单” -> “远程访问” -> “连接到”找到；iOS 设备在启动 Xeoma 应用时将直接进入）。

在“连接”对话框中，输入从 dynDNS 获取的 1 号设备公网IP 地址、Xeoma 密码及 Xeoma 端口（默认为 8090，若已更改则填入自定义端口）。

点击“确定”或“连接”即可建立连接。


方案 4：VPN 隧道
如今，VPN 更为人熟知的用途是在网页浏览器中隐藏用户的地理位置。然而，视频监控系统对其另有妙用：VPN 隧道可作为直接访问远程设备的通道——这正是 2 号设备远程访问不具备静态固定（公网）IP 地址的 1 号设备时所需的方案。其弊端在于，为此目的配置 VPN 隧道比常规的“浏览器”用途更为复杂。

请参阅 5.8. 通过 VPN 连接 Xeoma 章节中的 VPN 设置指南。

---

5.3. Repeater 服务 – 即使没有公网 IP 地址，也可随时随地访问您的计算机

另请参阅 Repeater 视频

Repeater 是一项类似于动态 DNS 但功能更强大的服务。它让您能够在计算机无法从 Internet 直接访问的情况下（例如处于防火墙内、私有 IP 地址空间、移动网络或某些无法分配公网 IP 地址的亚洲国家/地区）访问运行 Xeoma 程序的计算机。

在 Xeoma 中启用 Repeater 服务后，即使您的计算机无法从互联网直接访问，您仍可访问摄像头、录像存档或设置。

您只需在 Xeoma 中通过“主菜单” -> “远程访问” -> “Repeater 设置”启用此服务。您将获得 Repeater 连接数据，随后可将其用于从客户端连接到该服务器（在 连接对话框 中输入此数据）。



若您的服务器拥有静态固定 IP 地址或已使用 Xeoma Cloud，则无需 Repeater。

故障排除：
若激活 Repeater 时遇到困难，请尝试暂时关闭或卸载杀毒软件。激活 Repeater 后，再重新开启（或安装）杀毒软件。

若通过 Repeater 连接时帧率较低，请检查网络是否存在瓶颈。请提升服务器端或客户端的带宽容量，或联系运营商提高互联网接入速度。

另请参阅：使用 Repeater 服务进行远程访问的相关指南。

仅当设备具有图形 shell 时，您才能通过控制台激活 Repeater（Xeoma 客户端部分将自动启动）。此外，如果 Repeater 将在没有图形 shell 的服务器上运行，您可以使用同一网络中另一台设备上的 Xeoma 客户端连接至该服务器，然后通过“主菜单” -> “远程访问” -> “Repeater 设置” -> “订阅”来激活 Repeater。

---

5.4. Xeoma Web Server 模块

您还可以观看Xeoma Web Server 视频

Xeoma Web Server 模块因其多功能性而不同于大多数其他模块。例如，Scheduler 模块的用途单一（仅用于开启或关闭系统），而 Web Server 模块则可通过多种方式实现不同的目标。

第 1 部分：通过浏览器远程查看摄像机画面

Xeoma Web Server 最常见的用途是让您能够在几乎任何可接入互联网且支持网络摄像头串流的设备上查看摄像机实时画面，即使该设备运行的操作系统不受支持。将此模块连接至摄像机后，您即可通过浏览器远程查看画面（若要从局域网外部访问，服务器需具备固定静态 IP 地址）。

只需在链路中将Web Server模块连接至摄像机即可。



模块连接规则在此同样适用：若将 Web Server 接在 Motion Detector 等过滤模块之后，仅当模块放行时，图像才会在浏览器中显示。鉴于浏览器视图通常需要持续访问，建议将 Web Server 直接连接至摄像机。

提示：若需在浏览器中查看存档录像，请确保已连接 Preview and Archive 模块，且该模块存有录像。

进入设置，您可以找到用于访问各种流的链接 (URL) —— JPEG 图像、MJPEG 视频、带声音的 Flash 视频，以及用于查看本计算机上所有已连接 Web server 模块摄像机的 Web 服务器主页。

如果浏览器访问需要身份验证，请在此设置用户名和密码。

请注意，默认链接仅供同一网络内访问，故包含 localhost 字样。若需从网络外部远程访问，请将"localhost"替换为计算机的实际静态固定 IP 地址。这些链接可在 Xeoma 外部编辑。复制链接并粘贴至浏览器即可。



提示：请注意 Path to access… 框中的名称。浏览器页面中的摄像机图像将依此名称按字母顺序排列。例如，若一台摄像机名为"image1"，另一台为"image 99"，则浏览器页面将优先显示"image1"。

注意！若在 Universal camera 模块中启用了直接保存到存档，请注意 Web Server 仅获取并显示预览流。

注意！并非所有浏览器均支持 MJPEG 流的实时查看。

若您的浏览器不支持 MJPEG，可改用其他浏览器，或使用动态更新的 JPEG 图片替代真实的 MJPEG 视频。


通过 Web 浏览器进行远程访问时，一个关键问题是：您是从 Xeoma 服务器所在的同一个本地（“家庭”）网络进行连接（例如，从同一个楼层的另一个房间或办公室），还是从外部网络连接（例如，从城市的另一端，或从另一个城市或国家）。

为了方便起见，我们将运行服务器端（执行所有摄像机处理工作且我们需要连接至其的设备）称为1 号机。
我们将通过 Web 浏览器连接的远程设备称为2 号机。

请勿关闭或停止您要连接的服务器端：服务器端必须保持运行，才能处理摄像机数据并接收传入连接。

Xeoma 服务器端（在 1 号机上）必须处于试用版或商业模式。免费版本不支持远程连接！

1. 同一网络内的连接。
在完成 Xeoma 的初步设置（连接摄像机、添加模块、配置模块和链等）后，您需要将“Web Server”模块连接到所有希望通过 Web 浏览器查看的链中。请遵循模块连接的标准规则（详见上文）。
连接足够的 Web Server 模块后，请按照以下步骤启用远程访问：

步骤 1. 获取连接数据
进入 WebServer 模块的设置，复制用于访问 Xeoma Web 界面的链接。您会发现，该计算机上所有 WebServer 模块的通用链接（http://localhost:10090/）均相同。
您也可以在此通过设置登录名和密码，来限制对该 Web 界面的访问。

示例链接中使用的是 “localhost” 而非实际的私有（内部）IP 地址，您需要将其替换为计算机的真实私有 IP 地址。查看方法如下：

您可以在 Xeoma 的“连接”对话框中检查计算机的私有 IP 地址。在 1 号机上，前往主菜单（最左侧的“列表”图标）— “远程访问”，然后选择“连接至”。

在打开的对话框中，复制其中指定的内部（“私有”）IP 地址。
将该地址输入到您从 WebServer 设置中复制的网页链接中。
将该链接发送至 2 号机，如果已经在 WebServer 设置中配置了登录名和密码，请一并发送。为避免错误，建议使用复制粘贴而非手动输入。

控制台：您需要在希望远程查看的链中添加 WebServer 模块。为此，您需要相应的可视化界面，因此必须使用带图形界面的计算机上的客户端连接至服务器端。请参阅5.2.1. 客户端到服务器的远程访问指南。

步骤 2. 从 2 号机连接
在 2 号机上打开首选 Web 浏览器，输入来自 1 号机 Web Server 的链接（如果手动设置了密码和登录名，请输入凭据）。按下键盘上的 Enter 键、浏览器的“前往”按钮或箭头按钮，即可打开 Xeoma 的 Web 界面。

有关网页界面的更多信息，请参阅此处。

2 号机必须与 1 号机连接在同一网络中，例如通过 WiFi 连接。

 

2. 从其他网络连接。

若要从 1 号机家庭网络之外的地点进行远程连接，1 号机需要拥有一个外部静态固定 IP 地址（即“公网 IP 地址”），或具备替代方案。

我们将为您介绍两种情况：拥有公网 IP 地址的情况，以及没有且无法获取公网 IP 地址的情况。

情况 1. 服务器端拥有静态固定（“公网”）IP 地址：

步骤 1. 获取连接数据
进入 WebServer 模块设置，复制用于访问 Xeoma Web 界面的链接。您会发现，此计算机上所有 WebServer 模块的通用链接 (http://localhost:10090/) 均相同。
您还可以在此处通过设置用户名和密码，对该 Web 界面实施访问限制。

示例链接中使用的是“localhost”而非真实的私有（内部）IP 地址，您需要将其替换为计算机真实的公网（静态、外部、固定）IP 地址。此时您应当已经获知该地址。如需了解更多关于公网 IP 地址的信息，请联系您的互联网服务提供商。

将其输入到您从 WebServer 设置中复制的网页链接中。
将该链接发送至 2 号机器，如果您在 WebServer 设置中配置了登录信息，请一并发送用户名和密码。在这种情况下，我们建议使用复制粘贴而非手动输入，以避免出错。

控制台：您需要将 WebServer 模块添加到希望远程查看的链中。为此，您需要配置其可视化部分——即使用具有图形界面的机器上的客户端连接到服务器端。请参阅 5.2.1. 客户端到服务器的远程访问 章节获取指南。

步骤 2. 转发端口 10090 和/或 10091
在 1 号机器的路由器设置中，为 Xeoma 用于浏览器远程访问的 10090 和 10091 端口配置"端口转发"。

自 Xeoma 20.10.13 版本起，支持为同一服务器上的不同"Web Server"模块指定并使用独立端口。

请在网上搜索适用于您路由器型号的端口转发指南。例如，Portforward.com 网站提供了丰富的指南合集。

端口 10090 是远程连接 Xeoma Web 界面的默认端口。如果您之前将其更改为其他端口，则需要转发新端口。

控制台：在网上搜索通过控制台/终端转发 10090 端口的指南。

步骤 3. 从 2 号机器连接
在 2 号机器上打开常用的 Web 浏览器，输入来自 1 号机器 Web Server 的链接（若已手动设置用户名和密码，还需输入访问凭据）。按下键盘上的 Enter 键，或点击浏览器中的“前往”按钮或箭头按钮（具体取决于浏览器界面），即可打开 Xeoma 的 Web 界面。

在此处阅读更多关于网页界面的信息。

 

返回所有远程访问选项

情况 2. 服务器端没有静态固定（“公网”）IP 地址（且无法获取）：

遗憾的是，Repeater 服务不支持通过 Web 浏览器进行远程访问（仅支持通过 Xeoma 客户端软件连接）。

方案 1. 使用第三方 dynDNS 服务模拟公网 IP 地址
在网上查找免费或付费的 dynDNS 服务，将您的私有 IP 地址（也称为“动态内网 IP 地址”）映射为公网 IP 地址。利用此类服务为 1 号机器模拟公网 IP 地址。
按您的需求完成 Xeoma 配置（连接摄像机、模块，设置模块和链等）后，需将 Web Server 模块添加到所有希望在 Web 浏览器中查看的链中。模块连接遵循常规规则（详见上文）。
连接好所需的 Web Server 模块后，请按以下步骤启用远程访问：

步骤 1. 获取连接数据
进入 WebServer 模块设置，复制用于访问 Xeoma Web 界面的链接。您会发现，此计算机上所有 WebServer 模块的通用链接 (http://localhost:10090/) 均相同。
您还可以在此处通过设置用户名和密码，对该 Web 界面实施访问限制。

示例链接中使用的是“localhost”而非真实 IP 地址，您需要将其替换为从 dynDNS 服务获取的计算机真实公网 IP 地址。

将从 WebServer 设置中复制的链接中的公网 IP 地址替换为模拟值。
将该链接发送至 2 号机器；若已在 WebServer 设置中配置了登录名和密码，请一并提供。为避免出错，建议使用复制粘贴而非手动输入。

第 2 步。转发 10090 和/或 10091 端口
在 1 号机器的路由器设置中，针对 Xeoma 用于浏览器远程访问的 10090 和 10091 端口执行“端口转发”。

自 Xeoma 20.10.13 版本起，即使在同一台服务器上，也可为不同的"Web Server"模块指定并使用独立端口。

请在网上搜索适用于您路由器型号的端口转发指南。例如，Portforward.com 网站提供了丰富的指南合集。

端口 10090 是远程连接 Xeoma Web 界面的默认端口。如果您之前将其更改为其他端口，则需要转发新端口。

控制台：在网上搜索通过控制台/终端转发 10090 端口的指南。

第 3 步。从 2 号机器连接
在 2 号机器上打开常用浏览器，输入来自 1 号机器 Web Server 的链接（若已手动设置用户名和密码，请同时输入凭据）。按下键盘上的 Enter 键，或点击浏览器中的“前往”按钮或箭头按钮（视浏览器而定），即可打开 Xeoma 的 Web 界面。

在此处了解更多关于网页界面的信息。

 
方案 2。VPN 隧道
如今，VPN 因在浏览器中掩盖用户地理位置而广为人知。然而，视频监控系统对其另有用途：VPN 隧道可作为访问远程设备的直接通道——这正是从 2 号机器远程访问无静态公网 IP 地址的 1 号机器所需的功能。其缺点在于，为此目的配置 VPN 隧道的复杂度高于普通的“浏览器”用途。

请参阅 5.8. 通过 VPN 连接 Xeoma 章节中的 VPN 设置指南。

配置好 VPN 后，请按照这些说明操作，如同在同一局域网内连接一样（这正是 VPN 的作用）。

请参阅下方关于网页界面的详细信息。

*自 Xeoma 23.3.22 版本起，我们优化了 Edge 浏览器 (Windows) 的 WebRTC 性能

5.4.2 关于浏览器界面的详细说明

多摄像头网页。 通过访问 http://IP_address:10090/（本地机器请使用 http://localhost:10090），您可进入 Web Server 主页，查看 Xeoma 模块链中已连接 Web Server 模块的所有摄像头。

注意：如果摄像头不可用或因某种原因停止工作，浏览器中将显示黑色方块而非摄像头图像。



在浏览器中，您可实时查看摄像头画面、回放归档录像，并控制 PTZ 功能（前提是摄像头支持 PTZ 且已被 Xeoma 检测到）。PTZ 控制菜单将显示在 Web 界面的单摄像头视图模式中（请注意，在浏览器中启用 PTZ 至少需要 1 路摄像头的 Pro 许可证）。

网页中将显示以下标签页：摄像头视图（默认首页）、归档、首选项、帧率。
摄像头视图是用于查看 Xeoma 中已连接 Web Server 模块的多个摄像头（默认首页，亦称多摄像头视图页面），或查看单个选定摄像头画面（亦称单摄像头视图页面）的界面。
归档是用于查看摄像头归档录像的页面。若从多摄像头视图进入此页，您需先选择要查看归档的摄像头。
首选项是一个包含多个选项的下拉列表：包括多种添加摄像头的方式（详见此处），以及 Mjpeg/WebRTC 视频模式的激活与预览。
帧率是一个下拉滑块，用于降低网页中所有摄像头图像的最大刷新速度 (FPS)。此选项仅作用于浏览器视图，不影响 Xeoma 服务器端的帧率。帧率不得超过摄像头流本身的帧率。

单摄像头视图。在多摄像头视图页面，点击选中的摄像头图像，即可进入该摄像头的单摄像头视图页面。如果您仅有一个摄像头，点击即可以单摄像头视图模式打开，以获得更大视野。



在单摄像头视图页面的顶部面板中，您将看到以下选项卡：摄像头视图、存档、偏好设置、全屏视图和 MJPEG/WebRTC菜单。MJPEG/WebRTC 菜单允许您为摄像头选择视频模式（“WebRTC”选项支持带音频的流传输并可节省网络流量）。

帧率和图像质量可在图像下方选择（这两个参数仅应用于浏览器视图，不影响 Xeoma 服务器端的帧率）。

“偏好设置”选项卡还包含配置摄像头“运动检测”模块的设置（前提是该模块已连接至模块链）。几乎所有客户端版本的功能均可在此使用：



存档。要查看摄像头的录像，请前往存档选项卡。



在此处，您将看到所选摄像头的存档以及时间轴。您可以通过滑块或日期时间列表选择特定的存档片段。

您可以在偏好设置（底部面板的“齿轮”图标）中更改播放速度并降低视频质量，以减轻网络带宽负载。同样，此参数仅应用于浏览器视图，不影响 Xeoma 服务器端的帧率。



导出。在网页端，您还可以将部分存档录像下载至本地设备。为此，请点击下载按钮（底部面板的“箭头”图标），然后选择所需视频片段的开始和结束日期时间。




手动添加摄像头。您也可以通过 Web 界面查找并添加 IP 摄像头。为此，请点击 Web 门户顶部面板的“偏好设置”按钮 $\rightarrow$ “添加源”。在打开的界面中输入摄像头信息（URL、凭据）。若要添加多个摄像头，请逐一添加。



自动搜索摄像头。或者，您可以使用 Web 界面的自动搜索功能：通过“偏好设置”菜单 $\rightarrow$ “搜索摄像头”。输入摄像头信息（IP 地址、端口、凭据）并点击“开始扫描”。您还可以输入多个 IP 地址或 IP 地址范围（IP_address – IP_address）。



浏览器中带音频的摄像头流视图。

选项 1：WebRTC（主流技术，仅限 Xeoma Pro）



WebRTC 是一种专为流媒体优化的现代技术，支持带音频的实时视图，甚至在某些情况下能利用浏览器的处理能力来分担流处理负载。

为实现此功能，请在 Web 服务器模块设置对话框中启用“带声音的 WebRTC 广播（服务器端转码）”（由服务器承担实时视图处理负载）或“Xeoma 端 WebRTC 广播转码”选项（在支持时将负载转移至浏览器）。（这些选项仅在 Xeoma Pro 中可用）。

之后，登录 Web 界面时，您可以选择以 MJPEG（默认）或 WebRTC 查看视频流。
该选项在多摄像头视图页面和单摄像头视图页面均可用。





首次启动时，您可能会看到警告，提示浏览器设置禁止带声音的实时播放。此时，您需将音量滑块调至非零值，或在浏览器设置中启用声音，例如：



“带声音的 WebRTC 广播（服务器端转码）”选项仅适用于 H264 流。如果使用 H265/H265+ 流，建议在 Web 服务器模块设置对话框中切换至“Xeoma 端 WebRTC 广播转码”选项。







选项 2：Flash（已过时）

Adobe 已于 2020 年 12 月 31 日停止对 Flash Player 的支持，这意味着现代版本的浏览器可能不再支持 Flash。不过，在上述停止支持日期之前发布的浏览器版本中，Flash 可能仍然可以运行。

如需通过网络浏览器观看带声音的 Flash 视频，请勾选此选框并使用相应的链接（或直接从 Web 服务器主页进入 Flash 视频广播）：

+ 与客户端到服务器连接不同，通过浏览器查看摄像机可在任何可访问互联网的设备上进行，包括平板电脑、手机，甚至是操作系统不受支持的设备。
– 但同样，与客户端到服务器连接不同，如果运行 Xeoma 和连接摄像机的计算机没有静态固定 IP 地址，则无法使用浏览器查看功能。

如何在浏览器中整合多台服务器？

通过浏览器查看时，您可按照以下说明整合来自多台服务器的摄像机：

打开主服务器上的Xeoma 设置文件夹，进入 WebSourcesConfig 文件夹，您将在其中找到 WebSourcesConfig.txt 文件

可使用任何文本编辑器（如 Notepad 或 Notepad++）编辑 WebSourcesConfig.txt 文件。打开该文件后，您将看到具体的操作指南。

在浏览器的多服务器模块中，指定您想要整合的其他服务器的 IP 地址并保存 .txt 文件。此后，每当您打开Web 界面时，即可看到 WebSourcesConfig.txt 文件中指定的所有服务器上的全部摄像机。

第 2 部分：将录像保存至另一台计算机

若需将视频监控录像保存至另一台计算机（例如在中央监控站创建备份录像），Web 服务器模块也将派上用场。

此时，您需要将 Web 服务器连接至摄像机。在需要存储录像的另一台计算机上（本例中为中央监控站），需使用"Another Xeoma"模块而非摄像机模块：

+ 两台计算机均可存储录像并操作摄像机。
– 您可能需要额外的许可证（如果任一计算机上使用的模块总数超过 3 个）。

提示：您可以结合使用HTTP 上传至另一台 Xeoma和HTTP 接收器，不仅传输视频，还能传输音频及所有元数据。详见HTTP 上传至另一台 Xeoma文章。

第 3 部分：IP 摄像机仿真

如果您想将 Web 摄像机（USB 摄像机）转换为可供其他计算机和 Xeoma Cloud 访问的 IP 摄像机，则需要将 Web 服务器连接至该摄像机。其他计算机将其识别为 IP 摄像机。

有关模拟摄像机的其他方法，请参阅"如何在 Xeoma 中将视频用作摄像机"文章

第 4 部分：在您的网站上进行实时直播

您可以将摄像机画面直播到您的网站或博客。只需将 Web 服务器设置中的链接嵌入页面代码，即可在无需安装 Xeoma 客户端的情况下，在网站或博客上展示天气雷达或交通状况。直播动态更新的图像或视频流（如天气雷达仿真、实用交通信息的高质量实时快照和视频），将显著提升网站对访客的吸引力和实用价值。

您可以通过以下方式之一嵌入 Xeoma 摄像机流：

a) 更简便：
在“Web 服务器”模块的设置对话框中，您可以看到该摄像机 JPEG 和 MJPEG 流的直接链接：



复制所需的链接，将“localhost”替换为 Xeoma 服务器主机的 IP 地址，然后使用兼容的播放器（如 iFrame）将结果链接嵌入到您的网站中。

另请参阅：Xeoma webAPI

 

b) 更先进：webRTC 流传输（仅限 Xeoma Pro）
该方法的优势在于采用了 webRTC——一种专为流媒体优化的现代技术，可利用浏览器的处理能力分担部分负载。

如需实现，请在“Web Server”模块设置对话框中启用“带声音的 WebRTC 广播（服务端转码）”（仅在 Xeoma Pro 中可用）或“WebRTC 广播的 Xeoma 端转码”选项。



然后使用 webRTC API（仅限 Xeoma Pro）将所需的摄像机流嵌入您的网站。

 

c) 已过时：Flash 广播。
若在"Web Server"模块设置中开启了"flv 广播（带声音）”选项，您将看到一个用于查看 Flash 流的链接。点击该链接，然后点击您希望在 Flash 中查看（带声音）的摄像机图像。



在 Flash 查看窗口中，您可以使用以下按钮：



A – 选择不同的流分辨率；
B – 开始/暂停播放；
C – 调节音量；
D – 以全屏模式打开流。

注意！Mozilla 浏览器可能会要求安装 Flash Player 以播放 Flash 流。

 

浏览器连接安全性

目前，有两种方式可为浏览器查看启用安全连接。

1. 手动，通过 Apache 实现。在此查看指南

2. 内置 – 23.3.22 版本起可用。
从 23.3.22 版本开始，“Web Server”模块新增了“启用安全 HTTPS 连接”选项，以支持浏览器连接加密。现在可以直接在模块设置中选择安全连接，无需像以前那样通过 Apache 进行配置。

操作步骤：将“Web Server”模块添加到您的链中，打开模块设置（点击链中的模块），点击打开窗口底部的“显示详细设置”，勾选“启用安全 https 连接”复选框。

 

WebServer API
您也可以使用 http 命令控制 Web 服务器。所有命令如下：

http://IP:10090/video0.mjpg?resolution=1027×768&oneframe=0&waitTimeoutMs=1000&login=USERNAME&password=PASSWORD 返回 MJPEG 格式的实时视频或单帧图像
video0.mjpg 是“Web Server”模块中的“访问视频流的路径”
resolution 是帧的分辨率（可选）
oneframe 指定需要视频 (0) 还是单帧 JPEG 图像 (1)
waitTimeoutMs 是服务器响应的等待时间（通常在 100 到 1000 之间）
login 是用户名（可选）
password 是密码（可选）

http://IP:10090/image0.jpg?resolution=1024×768&login=USERNAME&password=PASSWORD 返回单帧 JPEG 图像
image0.jpg 是“Web Server”模块中的“访问图像的路径”
resolution 是帧的分辨率（可选）
login 是用户名（可选）
password 是密码（可选）

http://IP:10090/?archive_minutes=&archive_date=2015-11-26&archive=Preview%2BArchive.9 返回指定日期的时间码列表，格式为 hh:mm:ss，每项占一行
archive_date 是日期，格式为 year-month-day
archive 是“预览与归档”模块的 ID（“+”转换为“%2B”）

http://IP:10090/?archive_frame=&archive=Preview%2BArchive.9&archive_date=2015-11-26&archive_minute=13:19:18&archive_millis=2500&maxResolution=&scaleFactor=100 以 JSON (base64) 格式返回指定日期和时间的单帧图像
archive 是“预览与归档”模块的 ID（“+”转换为“%2B”）
archive_date 是日期，格式为 year-month-day
archive_minute 是时间，格式为 hh:mm:ss
archive_millis 是添加到前一个参数秒数之上的毫秒数（范围为 0 到 59999）
maxResolution 是帧分辨率，格式为 宽x高
scaleFactor 是压缩比例（范围为 0 到 100，100 为最高质量，不建议低于 80）

http://IP:10090/?archive_start_export=&archive_id=Preview%2BArchive.24&start_date=2017-03-09&start_hour_minute=13:00:08&end_date=2017-03-09&end_hour_minute=13:02:18 从存档中导出指定时间段
archive_id 是该存档在“预览与存档”模块中的名称
start_date 是时间段的开始日期（格式 年-月-日）
start_hour_minute 是时间段的开始时间（格式 时:分:秒）
end_date 是时间段的结束日期（格式 年-月-日）
end_hour_minute 是时间段的结束时间（格式 时:分:秒）

http://IP:10090/?archive_get_export_file= 下载由前一条命令导出的文件

http://IP:10090/?login=LOGIN&password=PASSWORD&getsessionkey= 快速授权
login 是用户名
password 是密码

http://IP:10090/?addchain=&cameraSettings=&cameraLogin=LOGIN&cameraPassword=PASSWORD&previewUrl=PREVIEWURL&archiveUrl=ARCHIVEURL&enableH264ArchiveId=false 添加摄像机
cameraLogin 是摄像机的用户名
cameraPassword 是摄像机的密码
previewUrl 是预览流的 URL
archiveUrl 是存档流的 URL
enableH264ArchiveId 指无需转换直接进行 H.264 录制（true 为启用，false 为禁用）

http://IP:10090/?addchain=&ftpReceiverSettings=&ftpReceiverServerAddress=ADDRESS&ftpReceiverServerPort=FTPPORT&ftpReceiverLogin=LOGIN&ftpReceiverPassword=PASSWORD 添加“FTP 接收器”
ftpReceiverServerAddress 是服务器地址
ftpReceiverServerPort 是 FTP 端口
ftpReceiverServerLogin 是用户名
ftpReceiverServerPassword 是密码

现在您可以自定义 Web 服务器页面了！具体操作请参阅下文的Web 服务器自定义！

---

5.5. Xeoma 摄像机在线查看的 Web 服务器自定义

除其他品牌重塑方案外，Xeoma 还提供免费的 Web 服务器页面自定义功能，让您随心打造专属外观。

自 17.8.31 版本起，您可借助我们免费的品牌重塑工具自定义 Xeoma 的 Web 服务器页面。无需具备 HTML 知识，即可轻松更改页面颜色、徽标及服务名称。



了解更多关于免费品牌重塑工具的详情

已过时：适用于 Xeoma 13.9.30 至 17.8.31 版本，网页自定义需通过编辑 HTML 代码实现，步骤如下：

将 Web 服务器模块连接至您希望在 Web 服务器中查看的摄像机。进入 Web 服务器模块设置，并在浏览器中访问需自定义的页面。此时 Xeoma 目录下将生成一个 XeomaWeb 文件夹，其中包含所需的 HTML 页面。请将所有待用资源（图标、图片及其他页面）存放于此。

访问图形文件时，请使用类似 img src="?obj=PictureName.png"的路径。打开并编辑所需 HTML 页面（使用记事本即可），您也可访问该目录下的其他页面。

有关 Web 服务器自定义的完整图文教程，请参阅我们的“文章”栏目。

---

5.6. 使用 Xeoma Android 应用进行移动视频监控

远程视频监控的核心价值在于，让您能够同时管理数个乃至数百个地理位置分散的站点，无需实地奔波即可轻松巡检，极大降低了时间成本。



Xeoma Android 应用与桌面版有所不同：受 Android 系统规范限制，应用必须先安装才能启动。除此之外，该应用几乎完整复刻了桌面版 Xeoma 的功能，默认启动客户端模式。Android 应用会自动检测并连接您的摄像机（包括内置摄像机，如有）。您可以使用 Xeoma 的常规版本——免费版、试用版和商业版，享受自动更新、连接摄像机等功能。

Xeoma 可作为客户端或 CCTV 查看器，连接到另一台设备（桌面或移动端）上的 Xeoma 服务器。在“连接”对话框（主菜单 -> 远程访问 -> 连接至）中填写相关字段即可连接至目标机器，实时查看摄像机画面、浏览录像存档并修改设置。

此外，借助该应用，您的 Android 设备本身即可变身为独立的监控系统。您可以为这套全新的移动视频安防系统连接摄像机、配置事件与联动反应、分配用户权限等。



推送通知

通过“窗口弹出（客户端）”模块（位于 Xeoma 模块栏顶部的“目标”选项卡），您可以在 Android 设备上接收推送通知，例如当摄像机视野内检测到移动（或识别到人脸/车牌等）时。与桌面版 Xeoma 仅将最小化的客户端窗口还原不同，Android 端的“窗口弹出”模块在触发时会发出提示音、闪烁 LED 指示灯，并在设备通知栏显示 Xeoma 图标。
您可以查看通知详情以获知移动检测的发生时间。点击该通知将直接跳转至 Xeoma，以便查看移动事件或采取其他必要措施。图标将持续显示在通知栏，直到您打开 Xeoma；因此，即使检测发生时您不在现场，也绝不会错过提醒。

该模块还用于在触发时向 Android 版 Xeoma 发送推送通知。自 Xeoma 20.10.22 版本起，改用另一个模块发送推送通知——“移动通知”。

与标准版 Xeoma 的区别： Android 应用不支持全屏模式，因为移动设备通常无需此功能。此外，基于人工智能和深度机器学习的附加模块暂不适用于 Android 版本。
Android 应用无需手动安装（由于应用直接从 Google Play 或我们的官网下载，您可直接启动并使用）。若 Android 设备未进行刷机且不具备相关功能，则无法更改存档存储路径。

---

5.7. iPhone/iPad 应用







全新适用于 iPhone 和 iPad 的 Xeoma 是远程查看摄像机的理想之选。它可作为 CCTV 查看器，连接至 Xeoma Cloud 或您桌面/平板设备上的 Xeoma 服务器，即使处于防火墙后方也能实现连接（借助 Repeater 服务）。

使用此 iOS 客户端，无论您身在何处，都能连接至您的 Xeoma，查看摄像机的 实时画面和录像存档（含音频），并支持画面的数字缩放！

无论是度假、出差还是办公，它都能随行随用。您可随时查看保姆或长辈的状况，或确认在医院治疗的亲人安然无恙。

连接指南

1. 前往 App Store 并下载 Xeoma。

2. 下载完成后，启动应用并按提示进行安装。

3. 安装完成后，系统将弹出提示要求输入连接数据。您可从 您的 Xeoma 服务器 或 Xeoma Cloud 订阅中获取这些信息：



4. 若数据正确且服务器端可用，您将成功连接，并可查看摄像机及其存档。

5. 您可以返回连接对话框窗口以连接到另一个服务器。点击下方的连接按钮。

大功告成！现在您可以随时随地远程访问您的 Xeoma！

自 Xeoma 20.10.22 版本起，新增了一个支持向 iOS 发送推送通知的模块 – “移动通知”

---

5.8. 通过 VPN 连接 Xeoma

首先，您需要确定您的设备需要安装 服务器 还是 客户端。如果您希望计算机作为枢纽，供其他设备连接以查看摄像机，则需安装 服务器。如果您仅需连接到存储摄像机信息的其他设备，则需安装 客户端。


服务器

要通过 VPN 部署功能完备的服务器，您需要进行正确配置。请按照以下步骤操作：

1. 从 https://openvpn.net/index.php/open-source/downloads.html 下载与您的操作系统相对应的免费 OpenVPN 软件
2. 将其安装在 C:\OpenVPN（勾选所有组件）
3. 为您的服务器创建有效的证书颁发机构 (CA) 文件。操作步骤如下：
1) 输入以下命令进入文件夹：cd C:\OpenVPN\easy-rsa
2) 输入以下命令运行配置文件：init-config.bat



3) 转到 C:\OpenVPN\easy-rsa 并编辑 vars.bat（使用记事本即可）。您将看到以下内容：
set KEY_COUNTRY=US
set KEY_PROVINCE=CA
set KEY_CITY=SanFrancisco
set KEY_ORG=OpenVPN
set KEY_EMAIL=mail@host.domain
分别编辑这些值，使其与您的国家、省份、城市、组织和电子邮件相匹配。



4) 在控制台中输入 vars.bat 来运行 vars.bat
5) 现在输入以下命令运行另外两个文件：
clean-all.bat
build-ca.bat
6) 除“Common Name”外，所有值均直接按 ENTER 键确认。在“Common Name”处输入：
OpenVPN-CA



7) 大功告成！您现在已生成名为 ca.crt 的有效证书颁发机构文件，该文件位于 C:\OpenVPN\easy-rsa\keys。



4. 为服务器创建实际的证书和密钥：
1) 输入：build-key-server.bat server
2) 除 Common Name 外，所有值均直接按 ENTER 键确认。在此处输入：server
3) 控制台将询问：“Sign the certificate?” 输入：y
4) 控制台将询问：“1 out of 1 certificate requests certified, commit?” 输入：y



5) 大功告成！您已生成 server.crt 和 server.key 文件，该文件位于 C:\OpenVPN\easy-rsa\keys。



5. 设置 Diffie-Hellman 参数（用于增强密钥安全性）。输入：build-dh.bat
您现在已生成文件 dh1024.pem，该文件位于 C:\OpenVPN\easy-rsa\keys。



6. 现在将 C:\OpenVPN\easy-rsa\keys 中的 ca.crt, server.crt, server.key 和 dh1024.pem 文件复制并粘贴到 C:\OpenVPN\config。您还需要在该文件夹中创建 server.ovpn 文件。使用记事本创建并输入以下信息：
port 1194
proto tcp
dev tun

ca ca.crt
cert server.crt
key server.key
dh dh1024.pem

topology subnet

server 10.8.0.0 255.255.0.0

keepalive 10 120

cipher AES-128-CBC

persist-key
persist-tun

comp-lzo

verb 3



7. 您现在可以为服务器设置用户：
1) 用户需要登录名和密码才能访问您的服务器。使用记事本将此信息添加到 server.ovpn 文件中：
# Path to the folder with config files
client-config-dir C:\\OpenVPN\\ccd
# Verification of the authentication data via verify.bat
auth-user-pass-verify C:\\OpenVPN\\verify.bat via-file
# 验证用户名和密码时，无需请求证书
client-cert-not-required
# 用于进一步认证的用户名
username-as-common-name
# 允许外部脚本
script-security 2
2) 在 C:\OpenVPN 中创建 ccd 文件夹，用于存放用户配置文件。
3) 每个用户在该文件夹中都需要一个独立文件。文件名应为 ‹User_Login›.config（即文件名包含用户登录名）。在文件中按以下格式输入您要分配给该用户的 IP 地址：
ifconfig-push ‹IP_address› ‹Mask›（其中 ‹IP_address› 根据 server.ovpn 文件范围在 10.8.0.0 到 255.255.0.0 之间，‹Mask› 为 255.255.0.0）



4) 在 C:\OpenVPN 文件夹中创建 verify.bat 文件（使用记事本）。服务器将使用此文件验证用户的登录名和密码。在文件中直接输入用户的登录名和密码，并用空格分隔。



8. 最后，即可启动服务器。点击 OpenVPN GUI 图标。此时系统托盘（屏幕右下角）会出现 OpenVPN GUI 图标，右键点击并选择 连接。等待几秒钟，图标将变为绿色并显示服务器的 IP 地址。



一切就绪！


Windows 客户端

请按照以下步骤正确配置客户端连接：

1. 执行服务器指南中的步骤 1 和 2。
2. 访问此链接：https://felenasoft.com/xeoma/downloads/cloud/cloud.ca.crt 下载有效证书。
3. 访问此链接：https://felenasoft.com/xeoma/downloads/cloud/client.ovpn 下载配置文件。
4. 将 cloud.ca.crt 和 client.ovpn 两个文件复制到 C:\OpenVPN\config。



5. 在同一文件夹中创建 authentication.txt。该文件应包含登录名和密码，每组占用一行。



6. 启动 OpenVPN GUI 并等待其图标出现在系统托盘中。右键点击图标并选择 连接。等待几秒钟，图标将变为绿色并显示分配的 IP 地址。

全部完成！

为确保您可以远程查看摄像头，还需要完成最后一步：转发摄像头的 IP 地址。为此，请打开控制台（确保使用管理员权限）：

1. 输入：netsh
2. 输入：interface
3. 输入：portproxy
4. 您需要为摄像头选择一个端口。本文以端口 12345 和摄像头 IP 192.168.0.1 为例。请注意，不同的摄像头需要使用不同的端口。此外，您还需要知道摄像头的当前端口。
5. 输入：add v4tov4 listenport=12345 connectaddress=192.168.0.1 connectport=22 listenaddress=0.0.0.0（全部写在同一行）
这将把 12345 端口转发至 192.168.0.1:22。
设置完毕！


Linux 客户端

请按照以下步骤正确配置客户端连接：

1. 使用以下命令安装 OpenVPN：sudo apt-get install openvpn
2. 访问此链接：https://felenasoft.com/xeoma/downloads/cloud/cloud.ca.crt 下载有效证书。
3. 访问此链接：https://felenasoft.com/xeoma/downloads/cloud/client.conf 下载配置文件。
4. 将 cloud.ca.crt 和 client.conf 两个文件复制到 /etc/openvpn/



5. 在同一文件夹中创建 authentication.txt。该文件应包含登录名和密码，每组占用一行。



6. 直接通过输入以下命令启动 OpenVPN：sudo openvpn /etc/openvpn/client.conf



全部完成！

最后一步是确保您可以远程查看摄像头：需要对摄像头的 IP 地址进行端口转发。

1. 输入：iptables -t nat -A PREROUTING -p tcp -d 10.8.109.142 –dport 554 -j DNAT –to-destination 192.168.0.177:554（此处 10.8.109.142:554 为摄像头 IP 及端口，将被转发至 192.168.0.177:554）
2. 输入：iptables -t nat -A POSTROUTING -p tcp –dst 192.168.0.177 –dport 554 -j SNAT –to-source 10.8.109.142（此处 192.168.0.177:554 将被还原为 10.8.109.142）
设置完成！

---

第 6 章 其他产品


6.1. Xeoma Pro Your Cloud – 打造您专属的云服务与专业监控系统！



另请参阅 Xeoma Pro 视频

Xeoma 视频监控软件已被证实是一款高效、易用且灵活的解决方案，深受亟需专业监控系统的企业与个人青睐。

Xeoma Pro 不仅突破了软件本身的灵活极限，更为您提供绝佳契机，助您构建专属的云视频监控服务器并面向客户提供服务。

运作方式：

– 根据您的操作系统下载 Xeoma，运行并配置 Xeoma Pro Cloud。
– 按需购买对应摄像头数量的 Xeoma Pro 许可证。
– 激活方式与 Xeoma 标准许可证一致。您可根据 Pro 许可证授权额度，向云服务中添加相应数量的摄像头。

此刻，云服务已由您掌控，您可自主制定面向客户的服务条款——无论是“按月”、“按年”还是“终身”订阅模式，均可自行定价，并设定每个摄像头的磁盘空间配额等。

借助我们的免费品牌定制工具，您甚至可以使用自定义品牌名称提供此项服务！

---

6.2. Xeoma Cloud 服务

XEOMA CLOUD 是一款视频监控即服务 (VSaaS) 产品。这意味着 Xeoma 运行于我们的云端服务器，您只需将摄像头接入即可。

为什么选择它？

服务器将承担所有负载、维护与更新工作；您可随时连接，查看摄像头实时画面与存档、下载目标录像，并在云端畅享 Xeoma 的所有核心功能！

您无需购买或维护昂贵的视频监控设备，仅需一台摄像头和网络连接。

观看关于 Xeoma Cloud 的视频

 

Xeoma Cloud 为何优于其他云服务？

在如今众多的云服务中，选择 Xeoma Cloud 的理由如下：

快速启动

启动 Xeoma Cloud 的门槛极低——仅需一台摄像头和网络连接，无需专业知识。借助分步指南和视频教程，即可轻松完成接入。

高性价比，无后顾之忧

无需购置高端计算机，无需承担维护成本及服务器 24/7 全天候运行产生的巨额电费。Xeoma Cloud 服务器由我们的专家团队部署，整体成本与便捷性均优于传统本地视频监控方案！

运行稳定且安全

您的视频数据在 Xeoma Cloud 视频监控系统中安全无忧——仅授权用户可访问实时画面与存档。即使摄像头遭到破坏，视频数据也绝不会泄露。

高级功能

与其他仅提供移动侦测和录像（甚至仅此而已）的云监控服务不同，Xeoma Cloud 几乎涵盖所有常规功能，包括 PRO 级特性：电子地图 (emap)、目标跟踪与可视化、收银系统及智能家居系统集成、隐私遮蔽、多路存档同步查看，以及更多功能！

灵活定价，无隐藏费用

多样化且灵活的订阅方案，配合透明直观的定价条件，助您轻松找到最适合的选择。

无广告，无 Logo 水印

即使在免费版本中也是如此！

 



每项订阅均包含：
摄像机实时画面或存档中 无广告或徽标水印
实时查看与录像回放均无限制。
视频下载无限制。
支持任意图像分辨率。
帧率（fps）无限制。

 

如何使用 Xeoma Cloud

4 个简单步骤：

1. 购买订阅

2. 订阅购买成功后，系统将向您发送一封包含连接数据和密码的邮件。您需要将这些信息输入 Xeoma Client。

3. 从下载页面下载 Xeoma Client

4. 运行程序，在“连接”对话框中输入邮件提供的连接数据。







 

为何基于云端的视频监控优于传统的本地 PC 部署？

• 省时、省力、更省钱
• 适用于无法或不宜 24/7 全天候运行服务器的场所
• 节省电力成本
• 除摄像机外无需额外设备
• 完美适配多地分散部署的摄像机
• 录像存储于我们的云服务器，安全无忧，杜绝被盗风险

若需在自有服务器上部署云端 CCTV 系统，请使用 Xeoma Pro Your Cloud

 

 
Xeoma、Xeoma Pro、Xeoma Pro Your Cloud 和 Xeoma Cloud 对比表

深入了解 Xeoma Cloud 如何赋能您的业务！

立即免费试用 Xeoma Cloud！只需联系我们，即可申请 1 天免费体验权限！
 

条件与订阅

Xeoma Cloud 订阅	平均存储时长*（1 台摄像机，仅移动侦测）	平均存储时长*（最大摄像机数量，连续录像）	并发观看人数（客户端 / Web 浏览器）
1 台摄像机 (最高 1 GB)	5 天	12 小时	1
最多 2 台摄像机 (最高 5 GB)	24 天	2 天	2
最多 4 台摄像机 (最高 50 GB)	8 个月	6 天	4
最多 8 台摄像机 (最高 100 GB)	16 个月	6 天	8
最多 16 台摄像机 (最高 200 GB)	32 个月	6 天	16
最多 32 台摄像机 (最高 400 GB)	64 个月	6 天	32
最多 64 台摄像机 (最高 800 GB)	128 个月	6 天	64

购买 Xeoma Cloud

*存储时长无上限，具体取决于摄像机规格及订阅包含的存储空间。
表中的平均存储时长仅为估算值，基于摄像机分辨率 0.3 Mpix (640 x 480 px)、刷新率 2 秒/帧的条件，计算在开始覆盖前可保留的视频时长。
您可据此自行估算平均存储时长，或直接联系我们。
覆盖录制会用最新录像替换最旧的录像。


 

XEOMA CLOUD 与其他云服务的对比

您或许认为已找到经济便捷的云服务，但在体验 Xeoma 之前切勿下定论。其他云服务往往通过隐藏费用（如去水印功能）诱导您购买看似廉价的订阅。此外，它们对可接入的摄像机型号限制严苛，而 Xeoma Cloud 支持任意分辨率和帧率的摄像机。

功能特性	Xeoma Cloud	传统云服务
无广告
无水印
查看时长无限制 (实时及存档)
无限制视频下载
支持任意分辨率的摄像机
支持任意帧率（fps） (每秒传输帧数)
提供高级功能
订阅方案灵活
条款透明，无额外费用
支持连续录像或移动侦测触发录像

 

要求与条件

本方案是单点或多点摄像机部署的理想之选，广泛适用于商店、停车场、学校等场景！

• 轻松上手 – 三步即可连接！
• 无需自建 IT 基础设施；
• 当达到订阅存储上限时，循环录像将自动用新视频覆盖旧视频；
• 可随时查看订阅剩余天数；
• 可使用 Xeoma 标准版的所有模块——侦测器、短信或邮件通知、FTP 上传等；
• 仅不支持无法在云端运行的模块（如屏幕捕获、本地 USB 摄像机、本地麦克风、文件读取等）
• 摄像机要求：支持 JPEG、MJPEG、H264、H264+、H265+、H265 或 MPEG-4 流，且具备可从外网访问的静态固定 IP 地址（若地址为动态，可使用任意免费 DDNS 服务），并在路由器上完成摄像机 80 端口的端口转发（操作指南请参考：http://portforward.com/english/routers/port_forwarding/routerindex.htm）。
• 网络要求：取决于摄像机的图像分辨率和帧率 (fps)（例如，每台 2 fps 的 Full-HD 摄像机需 2.2 Mbit 带宽，或每台分辨率 800×450、帧率 0.5 fps 的摄像机需 128 Kbit，此外还需计入网络中其他用户的负载）。请注意，由于摄像机持续推流，建议使用不限流量的互联网连接；
• 您可随业务增长扩展订阅——购买更多存储空间或接入更多摄像机。

 

特别优惠！联系我们即可申请 Xeoma Cloud 免费试用！

三步轻松连接摄像机

若摄像机具有外部静态固定 IP 地址：
1. 使用收到的连接数据连接至 Xeoma Cloud。
2. 在下方面板的“+”菜单中，通过 IP/密码执行高级搜索。
3. 系统将自动发现并添加您的摄像机。

若摄像机没有外部静态公网 IP 地址：
为摄像机配置 dynDNS 或其他静态公网 IP 替代方案。请在互联网上搜索相关指南及免费或付费的 dynDNS 服务。

若无法为摄像机获取静态公网 IP 地址或 dynDNS 地址
请参阅本文，了解针对无静态固定 IP 地址摄像机的解决方案。

1. 使用收到的连接数据连接至 Xeoma Cloud。
2. 添加新链（在下方面板的“+”菜单中选择“添加新摄像机”），但请连接“FTP 接收器*”模块而非摄像机模块。
3. 按照本文所述，设置摄像机的 FTP 上传功能以将数据上传至 Xeoma。请注意，在摄像机设置的“服务器地址”中，您需指定 cloud.xeoma.com.*

*注意！如需使用此方法，请在购买 Xeoma Cloud 订阅前确认您的摄像机支持图片 FTP 上传。联系我们申请免费试用进行体验。

若上述方案均不适用，建议在摄像机部署现场安装一台 Raspberry Pi 或其他简易微型计算机（约 50 美元），在其上安装标准版 Xeoma，并利用 FTP 上传选项将录像上传至 Xeoma Cloud。详见Raspberry Pi与FTP 上传。



 

Xeoma Cloud 演示视频
购买订阅
连接至 Xeoma Cloud

---

6.3. 定制 Xeoma 视频监控软件

这是专为安装商和代理商提供的独家特惠！

如果您代理或计划代理 Xeoma 视频监控软件，为何不在其中加入您的公司信息？

使用我们的免费工具即可轻松定制 Xeoma。该工具支持 Xeoma 品牌重塑，包括更改软件名称、自定义公司名称、地址、技术支持时间、网站链接，以及添加启动画面、更换 Xeoma 图标等。

抓住机会，完全免费地重塑 Xeoma 品牌！通过定制，Xeoma 不仅能精准满足客户需求，还能持续提升您的公司品牌曝光度！

您可在此处下载品牌重塑工具以定制 Xeoma。

这是一个 Windows .exe 文件，可用于定制适用于 Windows、Linux、Android 和 Mac OS 的 Xeoma。您可自由选择使用部分或全部选项。

遇到问题？请查看我们“图片指南”部分中最新的免费品牌重塑工具分步指南。

---

第 7 章 结语


7.1. 卸载与重新安装程序

建议使用程序内置工具卸载 Xeoma，具体操作如下。此方法可确保在重新安装时保留文件，或根据需要完整删除 Xeoma 文件。

本节介绍 Xeoma 桌面版本的卸载方法。Xeoma Pro Your Cloud 管理员请参阅 Xeoma Pro Your Cloud 设置指南。

关于 Xeoma 移动端应用程序，请参阅 7.1.4. 删除 Xeoma 移动端应用程序。

 

7.1.1. 停止程序运行

有时需要 停止 Xeoma 才能执行特定操作（例如将录像复制到 Xeoma 存档文件夹）。具体操作取决于 Xeoma 的运行方式，特别是服务器端是否 安装为自启动服务。


如果程序已 安装为自启动，您可以通过以下方法停止运行：

– 通过控制台（推荐）：
将 Xeoma 可执行文件拖入控制台，或在控制台中手动输入该文件路径，添加空格并输入以下命令：
-stopservice
然后按 OK。控制台将显示相应消息。

完整命令示例：C:\Users\a\Desktop\xeoma.exe -stopservice

您可以使用以下命令启动 Xeoma 服务器端：-startservice


– 通过程序界面：
我们建议使用控制台命令停止 Xeoma。如果无法操作，您也可以使用 程序卸载方法 来实现，但该操作较为复杂。
如需通过界面停止 Xeoma，请进入“主菜单”并选择“安装”。如果此计算机上已安装 Xeoma，该子菜单中应包含“卸载”选项——点击该选项，系统将提示您选择 “卸载但保留存档和设置”。此选项会将 Xeoma 从自启动中移除，防止其随系统启动，同时保留文件和摄像机录像。我们建议选择此选项。选择后，系统将弹出警告——此操作需要输入系统管理员密码。请输入管理员密码并点击 OK。

 

如果程序 未安装为自启动：

– 通过程序界面（推荐）：
关闭 Xeoma，例如点击“主菜单”中的“退出”。Xeoma 关闭后，您可以在计算机中找到并 删除 Xeoma 可执行文件。


– 通过 Linux 终端：
在 top（或 htop）中查找 Xeoma 进程的 PID（进程 ID）。
然后执行 kill 命令：输入 kill {Xeoma PID} 并按 Enter。


– 通过 Windows 任务管理器：
在“进程”选项卡中找到 Xeoma，右键点击相应条目，并从上下文菜单中选择“结束任务”。

 

7.1.2. 重新安装程序

如需重新安装程序（例如回滚至 Xeoma 旧版本或安装 Xeoma 团队提供的临时版本），请参阅 4.5.2. 降级至旧版本（桌面版本） 中的说明。

 

7.1.3. 完整卸载程序

如需从 PC 中彻底移除 Xeoma，可通过程序界面或终端/控制台/命令提示符完成。关键在于确认您的 Xeoma 是否 安装 为自启动。

如果 Xeoma 已 安装为自启动（较常见的情况）：

– 通过程序界面：
进入 Xeoma“主菜单”并选择“安装”。如果此计算机上已安装 Xeoma，该子菜单中应包含“卸载”选项——点击该选项，系统将提示您选择以下两个选项：

“卸载（保留存档和设置）” — 将 Xeoma 从自动启动项中移除，防止其随系统启动，同时保留配置文件和摄像机录像（通常在重新安装或回滚到之前的 Xeoma 版本时需要 — 请参阅 4.5.2. 降级到之前的版本（桌面版） 部分）

“完全卸载” — 将 Xeoma 从自动启动项中移除，并删除所有录像和程序设置。
选择此选项以卸载 Xeoma 并删除其所有数据。

系统将弹出警告 — 此操作需要输入系统管理员密码。请输入管理员密码并点击“确定”。


– 通过控制台：
在 Linux 或 Windows 计算机上：打开命令行/终端，将 Xeoma 可执行文件拖入控制台或手动输入其路径（在 Linux 计算机上，请在路径前输入“sudo”）。然后添加空格并输入以下命令之一：
-install -removeexe（将 Xeoma 从自动启动项中移除，防止其随系统启动，但保留文件和摄像机录像）或
-install -removeall（将 Xeoma 从自动启动项中移除，并删除所有录像和程序设置。选择此选项以卸载 Xeoma 并删除其所有数据）。

Windows 完整命令示例：
C:\Users\a\Desktop\xeoma.exe -install -removeexe
C:\Users\a\Desktop\xeoma.exe -install -removeall

Linux 完整命令示例：
sudo ./xeoma.app -install -removeexe
sudo ./xeoma.app -install -removeall

输入完成后，按 Enter 键。此操作需要输入系统管理员密码。

 

如果 Xeoma 未设为自动启动：

– 通过 Xeoma 界面：
如果您尚未安装 Xeoma，请关闭软件，例如在程序主菜单中选择“退出”。关闭 Xeoma 后，您可以在计算机上找到并删除 Xeoma 可执行文件（通常位于下载文件夹或解压存档的文件夹中）。
利用此技巧，您还可以定位计算机上存储设置和摄像机录像的文件夹。找到 Xeoma 文件夹并手动删除。

为避免搜索 Xeoma 文件夹并手动删除，您可以尝试暂时安装 Xeoma，然后使用 第 7.1.3 节开头所述的自动完整卸载功能。

 

– 通过控制台：
此处的推荐步骤与通过界面卸载的步骤相同：您需要停止 Xeoma 运行并手动删除 Xeoma 文件夹和文件。如需查找 Xeoma 文件的位置，可以使用系统搜索功能或参考 此页面 上的信息。

您可以通过程序界面停止未安装的 Xeoma，也可以通过控制台以稍复杂的方式停止。在 Linux 或 Windows 计算机上：打开命令行/终端，将 Xeoma 可执行文件拖入控制台或手动输入其路径（在 Linux 计算机上，请在路径前输入“sudo”）。然后添加空格，输入
-install -removeexe
并按 Enter 键。此操作需要输入系统管理员密码。

Windows 完整命令示例：
C:\Users\a\Desktop\xeoma.exe -install -removeexe

Linux 完整命令示例：
sudo ./xeoma.app -install -removeexe

为避免搜索 Xeoma 文件夹并手动删除，您可以尝试暂时 安装 Xeoma，然后使用 第 7.1.3 节开头所述的自动完整卸载功能。

 

7.1.4. 删除 Xeoma 移动应用

删除 iOS 或 Android 上的 Xeoma 移动应用与删除设备上的其他应用类似。具体操作可能因操作系统版本而异，以下提供几种从移动设备删除 Xeoma 的示例。

Android 设备：在设备主屏幕上找到 Xeoma 应用程序。长按应用程序图标，直到出现回收站图标。将 Xeoma 应用程序图标拖放到回收站图标上即可删除该程序。
或者，在 Android 设备主屏幕上找到 Xeoma 移动应用程序，长按直到出现包含多个选项的对话框。点击该对话框中的“删除”选项，随后将出现删除确认消息。点击相应按钮确认移除，应用程序即被删除。请注意，删除 完整的 Android Xeoma 应用程序（客户端和服务器） 也将同步删除所有应用程序文件（摄像机录像、设置等）。

iOS 设备：在设备主屏幕上找到 Xeoma iOS 移动应用程序。长按应用程序图标，直到出现包含多个选项的对话框。点击该对话框中的“删除”选项，随后将出现删除确认消息。点击相应按钮确认移除，应用程序即被删除。或者，在对话框出现后继续长按应用程序图标，图标上会出现“-”号，点击该符号同样会显示“删除”确认消息。

您可以通过互联网查询如何从设备中删除应用程序的相关信息。

---

7.2. 降低 CPU 占用、内存负载及磁盘空间需求的技巧

如果您使用 MJPEG 流进行预览和存档（或仅预览），CPU 占用率 将显著降低。请参阅本文了解 如何降低 CPU 负载。

若在“预览与存档”中使用预录选项，RAM 占用率 可能会很高。如果设备负载过高，请关闭该选项。

HDD 空间：存储容量取决于诸多现场因素，但请注意，通过设置移动侦测、昼夜侦测或计划录像可减少所需磁盘空间。另一种方案是使用“保存至文件”模块，采用其他编解码器（如高压缩比的 H.264）保存视频——此举虽能节省空间，但视频将无法通过 Xeoma 内置播放器播放。若您使用的是 RTSP (H264) 摄像机，也可选择无需重编码直接保存至存档。

---


第 8 章. 术语表

A B C D E F H I L M O P R S T U V W X

A

激活（有时亦称注册）——指将许可证应用于 Xeoma，以将其切换至任一付费版本的过程。

管理页面 —— 参见 摄像机管理页面

管理员 —— 参见 Xeoma 管理员、系统管理员

API —— 一套供自动化系统控制程序的指令集。Xeoma 提供多种 API，分布于不同版本中，用于管理 Xeoma 的各项功能。查看更多

存档 —— 指 Xeoma 中由“预览与存档”模块生成的所有摄像机视频录像，涵盖近期或过往记录。在此查看更多关于存档的信息

身份验证 – 在访问服务或系统（例如 Xeoma 视频监控系统）时验证用户或设备身份的过程。它通过防止未经授权地访问 视频流 和程序管理来保障安全性。

自动化 – 指无需人工干预即可执行的操作，例如在探测器触发时自动启动录像或发送通知。Xeoma 拥有丰富的 模块与功能，可助力各行业（如 门禁控制）实现业务流程自动化。

B

备份（也称为备用副本） — 创建 Xeoma 设置或完整视频 存档 的副本，以防止数据丢失或损坏。可在系统崩溃或出错后快速恢复。在此查看备份指南

比特率 — 视频流的关键特性之一（与分辨率和帧率并列），定义每秒传输或录制的数据量，单位为 Kbps 或 Mbps。在 Xeoma 中，比特率是 H.264、H.265、H.266 流的核心参数。比特率越高，画质越佳，但网络与存储负载也相应增加。

浏览器 – 请参阅 Web 浏览器

C

摄像头管理页面（亦称摄像头 Web 界面、摄像头管理面板） — 通过浏览器访问的网络摄像头专属网页。通常在浏览器中输入摄像头的IP 地址即可打开此页面，进行设置与视频预览。99% 的网络摄像头均具备此功能。

链（亦称 Scheme） — 在“详细设置”窗口中创建的 Xeoma 模块组合，用于定义应用于摄像头的具体功能。

客户端 – 请参阅 Xeoma 客户端

命令行（也称为控制台、cmd） — 用于执行命令的程序（通常在 Windows 上）。另请参阅：终端。

商业版（亦称商业版本、付费版本） — Xeoma 付费版本（Starter、Lite、Standard、Pro）的统称，需持有许可证方可持续运行。

配置文件（亦称 Config） – 存储 Xeoma 设置的后台文件。通常指 Xeoma Pro Your Cloud 中的设置文件。

连接对话框 – 这是 Xeoma 中的一个弹出窗口，用于指定 Xeoma 服务器 组件的连接详情（IP 地址、端口、Xeoma 管理员 或 用户 密码）。您可以通过“主菜单” -> “远程访问”访问连接对话框。当仅启动 Xeoma 客户端组件 时，该对话框也会自动打开。连接对话框存在于所有 Xeoma 版本（桌面端和移动端）中，但 iOS 移动应用除外，它使用 身份验证 页面代替。

CUDA — Nvidia 开发的硬件加速技术，旨在利用图形处理器 (GPU) 代替 CPU 执行复杂计算。通过 CUDA，GPU 可同时处理多项任务，显著提升软件性能，尤其是在摄像机处理、视频分析和人工智能等涉及海量数据或复杂计算的领域。

D

解码 (也称为视频解码) — 将压缩的视频流 (例如 H.264 格式) 转换为适用于查看和分析的视频格式的过程。另请参阅 直接保存至存档

Demo 许可证 – 一种特殊的 Xeoma 许可证，与常规许可证不同，其有效期受限。Demo 许可证是试用版的替代方案，支持更长时间测试 Xeoma。您可向 Xeoma 支持团队申请，或通过网站在线申请，例如此处。

桌面应用程序 – 安装并运行在个人电脑或笔记本电脑上的软件，与移动端或 Web 应用相对。

目标模块 (也称为目标、响应) — 位于处理链末端并执行响应操作的 Xeoma 模块组统称。示例：通过“预览与存档”进行录像，通过“发送电子邮件”发送邮件，通过“窗口弹出”还原 Xeoma 窗口，或通过“Web 服务器”打开 Web 门户。其他组别：源、过滤器。

定制开发 (也称为定制软件开发、付费开发) – 在 Xeoma 中新增功能或优化现有功能，以满足用户的个性化需求或解决特定任务。查看条件

对话框 – Xeoma 中用于用户配置设置或获取信息的图形用户界面窗口。

直接保存至存档 — Xeoma 的一种优化机制，利用摄像机的双流传输降低 CPU（有时还包括网络和磁盘）负载。另请参阅：解码、双流传输。

版本降级 (也称为回滚) – 将 Xeoma 还原至较早版本，适用于更新受许可证限制，或更新后出现问题的情况。

E

版本 (也称为模式、Xeoma 版本) — 按“方案”分组的功能集与限制。付费版本：Pro、Standard、Lite、Starter（需许可证）。免费版本：Free 和 Trial（无需许可证）。

F

帧率 (也称 FPS、每秒帧数) — 视频流的关键特性之一，定义每秒显示的帧数。FPS 越高，视频流越流畅。对于“实时”视频，通常每秒至少需要 24 帧。

免费版 (也称为免费版本、免费模式) — Xeoma 提供的免费版本之一（与试用版并列），无需许可证。在此查看更多关于 Xeoma 版本的信息

FTP (文件传输协议) — 用于传输文件的网络协议。在 Xeoma 中，FTP 用于将视频录像或备份自动传输至远程 FTP 服务器，确保存档安全存储于主监控服务器之外。

H

硬件加密狗（亦称硬件许可证、USB 许可证）—— Xeoma 许可证的两种类型之一。与软件许可证不同，这是一种需邮寄至买家物理地址的 USB 设备。了解更多关于硬件加密狗的信息。另见：许可证。

H.264（亦称 H.264+、H.265、H.265+、H.266）—— 用于压缩视频流以节省存储空间和带宽的视频编解码器。较新版本（H.265 和 H.266）比旧版本提供更高效的压缩。另见：MJPEG、RTSP。

HTTP — 一种网络数据传输协议。HTTP 通常用于传输来自摄像机的 MJPEG 流（而 H.264 等压缩流则通过 RTSP 传输）。HTTP 也用于 ONVIF 系统和摄像机管理后台。

I

安装（在 Xeoma 中）—— 将 Xeoma 添加至系统自启动项的过程，以便系统重启后自动运行。这不同于下载后直接启动程序。在 Xeoma 中，安装需手动执行（通过界面或命令）。例外情况：移动应用中，安装是启动前的必要步骤。

集成 — 将 Xeoma 与其他系统或设备（如智能家居系统、门禁控制、收银机）结合以实现协同运作的过程。

界面 — 用户与 Xeoma 软件交互的途径，包括菜单、按钮、窗口及其他图形元素。

IP 地址 — 设备的网络地址，类似于计算机或摄像机的电话号码。它可以是动态的（定期变更）或静态的（固定不变）；公网的（在互联网上唯一）或内网的（仅在本地/家庭网络内可用）。“动态内网”组合通常称为灰色 IP 地址，而“静态公网”则称为白色 IP 地址。将摄像机连接至 Xeoma 需要摄像机 IP 地址，而远程访问则需要 Xeoma 服务器 IP 地址。

IP 摄像机（亦称网络摄像机）— 具备网络连接能力、可通过互联网或本地网络访问的摄像机。例如：海康威视 HikVision DS-2CD2683G0-IZS（Xeoma 支持），Reolink Argus Pro（Xeoma 不支持）。查看 Xeoma 支持及不支持的摄像机列表

L

许可证 — 将 Xeoma 激活为付费（商业）模式的凭证。Xeoma 提供两种许可证：
软件许可证（默认）— 一个 25 位字符的代码，通常在购买后通过电子邮件发送。
硬件许可证 — 一种基于类 USB 设备的智能密钥，通过物理快递寄送。
许可证为永久有效（不同于订阅制），但在更新方面可能受限。

Localhost — IP 地址 127.0.0.1 的特称，用于访问同一系统内的当前计算机或服务器。在 Xeoma 中，进行本地软件设置时，“Localhost”常用于“连接”对话框以替代内网 IP 地址。

循环录像 — 一种存储存档的方式，当存储空间满时会自动覆盖旧录像。此机制确保持续录像不中断。

M

微型计算机（亦称单板计算机）— 如 Raspberry Pi 等超紧凑型计算机，也可搭配 Xeoma 用于视频监控。

MJPEG (Motion JPEG) — 由 JPEG 图像序列组成的视频流。相比现代编解码器，MJPEG 流易于查看和处理，但通常会导致更高的网络负载和更大的存储需求。另请参阅：MJPEG 与 H.264 的比较。查看 MJPEG 与 H.264 的比较

模块 (在 Xeoma 中) — 以块元素形式呈现的功能。通过在“详细设置”窗口中组合模块，您可以创建链并配置应用于摄像机的功能。

多服务器连接 (亦称：多服务器模式) — 一种远程连接类型，Xeoma 客户端可同时连接到多个Xeoma 服务器。在此模式下，并非所有 Xeoma 功能和连接类型均可用。详情

O

ONVIF — 一项通用标准，使不同制造商的摄像机能够与 Xeoma 协同工作。

P

P2P — 一种无需复杂配置的远程连接方式。通常指 Xeoma 内置的从 Xeoma 客户端到服务器端的远程连接方法。有时也指某些摄像机无需 IP 地址即可被发现的内置功能。在此查看详情

付费版本 — 请参阅商业版

端口转发 — 将外部请求定向至特定内部 IP 地址和端口的路由器配置。在 Xeoma 中，使用公网 IP 地址进行远程访问时需要此配置。替代方案是 Xeoma 内置的 P2P 连接。

端口 — 数据传输的数字出入口，用于摄像机与服务器之间的通信。端口设置与 IP 地址一样，对于确保正确连接和远程访问至关重要。另请参阅：端口转发

PTZ (Pan, Tilt, Zoom) — 具备云台、俯仰和变焦功能的摄像机类型。Xeoma 支持多种 PTZ 相关功能，在此查看详情。

R

Raspberry Pi 摄像机模块 — 一种专用于 Raspberry Pi 微型计算机的摄像机，通过排线连接。在 Xeoma 中，它被识别为 USB 摄像机。

响应 (亦称响应模块) — 请参阅目标模块。

品牌重塑 (亦称自定义) — 修改 Xeoma 名称、链接、图标和颜色的功能。提供免费选项，同时也支持付费自定义。另请参阅：开发

注册表 (在 Windows 中) — 一个包含系统和程序设置（包括 Xeoma 参数）的集中式 Windows 数据库。例如，编辑 Xeoma 的注册表项可以添加启动延迟。另请参阅：Xeoma 设置文件夹。

远程访问 (亦称远程连接) — 从另一台设备连接到 Xeoma 的功能（用于查看摄像机、存档或管理设置）。

续费 — 在许可证免费更新期结束后，继续获取并使用 Xeoma 新版本的方式。既指延期操作，也指专门的延期许可证。了解更多关于续费的信息

经销商 (亦称合作伙伴) — 出售 Xeoma 的个人或组织（线上或线下）。Xeoma 可与服务捆绑销售（例如作为视频监控或智能家居系统的一部分）、集成到产品中（例如作为 NVR），或仅作为独立软件销售。查看条件

回滚 – 参阅 降级

RTSP（实时流协议）— 一种用于管理 IP 摄像机实时视频流传输的网络协议（通常采用 H.264、H.265、H.266 编码）。

S

方案 — 请参阅 链。

服务器 — 通常指：运行 Xeoma 服务器端程序的计算机。

Xeoma 服务器部分 — 参阅 Xeoma 服务器部分

智能家居 — 一种集成照明、环境、安防及视频监控控制的家居自动化系统。Xeoma 可集成至智能家居系统中。查看更多

启动窗口 — 参阅 欢迎窗口。

静态 IP 地址 — 参阅 IP 地址。

订阅 – 类似于 许可证，但针对基于时长的服务（例如 Xeoma Cloud、Repeater）。

系统管理员 — 通常指：拥有完全控制权（安装程序、执行命令等）的操作系统主用户。极少数情况下可能指 Xeoma 管理员。

T

TCP/UDP — 数据传输的核心网络协议。TCP 确保可靠交付，而 UDP 提供更快的传输速度，但可能存在数据丢失。Xeoma 根据任务需求同时支持这两种协议。可在“通用摄像机”设置的“传输协议类型”中进行选择

终端（有时也称为控制台）— 用于执行命令的程序，类似于命令行界面，主要适用于 Linux 和 macOS 系统。

试用版（也称为测试版、试用版本）— Xeoma 的免费版本之一，旨在测试各项功能与性能。默认情况下，它模拟功能最全的 Xeoma Pro 版本，但也支持切换至其他版本。测试结束后，建议用户购买许可证并 激活 Xeoma。

触发 — 指 Xeoma 模块（如移动侦测或声音侦测）检测到符合设定条件的事件的那一刻。触发用于启动录像、通知或报警等响应动作。

U

UDP – 参阅 TCP/UDP

更新 – 指 Xeoma 的新版本，广义上也指获取并使用 Xeoma 新版本的能力。此能力可能受 许可证 限制。

用户 — 广义上指：任何使用 Xeoma 或操作系统的个人。

“用户”（亦称：操作员账户、访问权限管理、操作员配置文件、账户）— Xeoma 的一项功能，允许创建具有不同摄像机和功能访问权限的账户。由 Xeoma 管理员在“主菜单” → “远程访问” → “用户”中进行配置。查看更多

V

视频流（也称为流）— 来自监控摄像机的实时视频。另请参阅：RTSP。

可视化（也称为移动可视化）— 应用于视频流之上的图形效果，用于高亮显示由移动侦测模块检测到的目标及其运动轨迹。广义上，也可指代任何其他视频分析模块（例如人脸识别）检测结果的图形化展示。在此查看更多关于移动可视化的信息

W

Web 浏览器（也称为浏览器、互联网浏览器）— 用于访问互联网的程序。例如：Google Chrome、Mozilla Firefox、Microsoft Edge、Internet Explorer。

欢迎窗口（亦称“启动窗口”）——Xeoma 中的弹出式界面，通常在首次启动时显示，提供关键设置选项（激活、安装、远程访问等）。

X

Xeoma 管理员 —— Xeoma 的主用户，拥有更改设置、查看摄像机以及（部分版本中）创建其他用户的完整权限。这是一个逻辑概念：安装或运行 Xeoma 的用户即自动成为管理员。Xeoma 的主密码即为管理员密码。每个 Xeoma 服务器端始终保留一个管理员账户（不可删除），但该账户支持多设备同时登录（即使由不同人员操作，所有登录者均享有完整权限）。

Xeoma 客户端（亦称“客户端部分”）——Xeoma 架构的两大组件之一，用于配置系统与显示视频。另一组件为服务器，负责处理摄像机数据及执行核心功能。深入了解 Xeoma 架构

Xeoma 服务器端（亦称“Xeoma 服务器”）——Xeoma 架构的两大组件之一。服务器在后台运行，负责管理摄像机与数据处理，而配置与监控工作则通过客户端完成。深入了解 Xeoma 架构

---

附录


典型应用场景

面向 CCTV 操作员的 Xeoma	CCTV 操作员视频监控的 目标：克服分心、疲劳以及因监控时长延长和摄像机数量增加而导致的注意力下降等天然挑战，简化监控人员的实时监测工作。 Xeoma 提供的 解决方案： –用户配置文件：可限制或允许访问特定摄像头、录像存档及功能。创建特定的用户配置文件，并将密码告知 CCTV 操作员，以便其连接至 Xeoma 服务器。 管理大量摄像头： -在“布局”菜单中，您可以将摄像头分组并设置自动轮巡，以逐个或按组查看摄像头。观看布局视频 –支持多显示器。在布局菜单中将摄像头分组。运行多个 Xeoma 客户端，使用操作员的用户配置文件密码登录。在每个客户端中分别设置显示不同的摄像头组，并将各客户端窗口拖至不同的显示器。这样，每台显示器将显示特定的摄像头组。 –放大触发摄像头：前往“布局” -> “更大网格” -> “根据检测器生成”，使 Xeoma 自动将检测到运动的摄像头置于更大的窗口槽位中，从而引起 CCTV 操作员的注意。 –布局中的显示红色十字选项将在摄像头画面冻结时在图像上叠加一个大十字。当监控大量摄像头且预览窗口过小，无法立即判断摄像头是否停止工作（可能遭到破坏）时，此功能尤为实用。 –eMap（监控区域交互式地图）和设备列表（分组摄像头列表，可快速跳转至所需摄像头） 让 CCTV 操作员在监控的同时处理其他任务。 –透明度（布局菜单 -> 窗口设置）：将 Xeoma 窗口设为半透明，使操作员在处理其他工作的同时仍能实时掌握监控动态（适用于 Windows）。 –弹出窗口模块将在触发时（例如检测到运动）自动还原 Xeoma 窗口。其他时段，Xeoma 窗口可保持最小化，而您仍不会错过重要信息。 推荐产品 – 按需选用 Xeoma 或 Xeoma Pro。 请记住，客户端软件免费。仅服务器端需要许可证。 另请参阅：安保人员专用的视频墙、紧急按钮和报警监视器
面向安保管理员的 Xeoma	安保管理员部署视频监控系统的目标：构建一套无需人工值守即可无缝运行的视频监控系统。 Xeoma 提供的 解决方案： -支持在各类 Linux 系统上运行，包括控制台模式。 –安装 Xeoma 以实现独立运行及自动重启。 –更改安装文件夹（主菜单 -> 安装 -> 安装）。 -设置 Xeoma 执行的命令 – 例如，磁盘挂载或启动可执行文件（主菜单 -> 安装 -> 自动启动设置）。 –问题检测模块将通过电子邮件或短信通知您摄像头视野内的异常变动或系统健康状况问题。 –日志（控制台命令“-logs”）将保存系统信息（如添加摄像头、客户端连接等）。 –多服务器模式支持同时连接多个 Xeoma 服务器。 -为操作员创建用户配置文件。 推荐产品 – Xeoma Standard 或 Xeoma Pro
家庭闭路电视监控	家庭闭路电视监控的 目标：保护您的住宅及前院免受陌生人入侵。 Xeoma 提供的 解决方案： 移动侦测模块可检测移动物体并启动录像；“徘徊检测”功能可识别是否有人在您区域附近可疑逗留。 “越线检测”可识别快递员、邮递员等是否进入禁区，而不仅仅是到达门口。 发送电子邮件模块将通过邮件通知您紧急情况。 Web 服务器让您能将摄像头画面推送到网站，方便与家人或朋友共享实时影像。 家庭闭路电视监控推荐产品 – Xeoma Starter、Xeoma Lite、Xeoma Standard（如需更高配置可选 Xeoma Pro） 延伸阅读：家庭使用或小型系统的视频监控
借助 Xeoma 提升办公室安全	目标：保障整个区域的安全。 Xeoma 提供的 解决方案： 移动侦测结合计划调度，可在非工作时间检测到移动时向您发出警报。 人脸检测模块可自动定位人脸。ANPR可基于黑白名单识别车辆牌照。 电子地图可在平面图上显示所有摄像头位置。紧急情况下，您可查看摄像头的确切位置并立即派遣救援。 目标：管控员工出勤与工作效率。 Xeoma 提供的 解决方案： 移动侦测的“仅检测无移动”选项可用于监控怠工情况。如果摄像头视野内的人数超过预期，将触发人脸识别或“人群检测”模块。 访客计数模块可统计进出办公室的员工人数。若您的摄像头支持云台变焦，PTZ 跟踪功能将自动跟随移动物体。 推荐产品 – Xeoma Standard 或 Xeoma Pro
借助 Xeoma 视频监控保障零售店安全	零售店安保的 目标：揭露欺诈行为，处理索赔，管控现金短缺。 Xeoma 提供的 解决方案： HTTP 标记让您能将 Xeoma 与收银机同步，从而管控收银单据。 零售店安保的 目标：管控门店客流。 Xeoma 提供的 解决方案： 访客计数模块可统计进出商店的人员数量。所有接收到的数据将发送至 CSV 文件以便您进行分析。 零售店安保 目标：防止通过窗户非法闯入。 Xeoma 解决方案： 声音检测在检测到剧烈声音（如玻璃破碎声或安保警报声）时将启动。 零售店安保 目标：防止在发生抢劫时监控记录被盗。 Xeoma 解决方案： Xeoma Cloud 或 Xeoma Pro Your Cloud 可将您的录像安全存储于云端。您无需在店内部署计算机，仅需一台摄像头即可。即便摄像头被盗，您的录像依然安全，随时可供调阅。 推荐产品 – Xeoma, Xeoma Pro, Xeoma Cloud。 延伸阅读：购物中心安保摄像头安装
使用 Xeoma 实现校园安保	目标：监管计算机教室内的学生活动，保障校园安全。 Xeoma 解决方案： 屏幕捕获模块可让您实时查看计算机屏幕动态。推荐产品 – Xeoma, Xeoma Pro。 教育机构购买 Xeoma 许可证可享 8 折优惠。
使用 Xeoma 实现医院安保	目标：监管医护人员，监测患者状况，保障医院安全。 Xeoma 解决方案： 声音检测可识别医院设备发出的警报声（可能预示患者状况异常）或呼救声。访客计数模块可统计医护人员进入患者房间的频率，协助核实患者是否得到了妥善治疗且未被忽视。 年龄识别附加模块可设定仅针对老年人做出响应，自动过滤年轻工作人员。 推荐产品 – Xeoma Pro。 延伸阅读：辅助生活护理中心的视频监控 同时观看我们的视频：医院视频监控
使用 Xeoma 实现机场安保	目标：管控遗忘及无人看管的物品，保障机场安全。 Xeoma 解决方案： 遗留物检测：可检测被遗留且无人看管达一定时长的物品。 无人机探测附加模块可侦测无人机（UAV），并通过通知模块向授权人员发送警报。 推荐产品 – Xeoma Pro。 同时观看我们的视频：无人机检测 和 机场安保

典型的视频监控目标及 Xeoma 实现方案

摄像头、源、视图

• 使用非摄像头视频源（屏幕捕获、文件读取等）– 通过底部面板的“+”菜单添加默认方案，移除“通用摄像头”模块，并从上部面板替换为所需模块

* 鱼眼矫正 – 鱼眼矫正模块

* 当一台摄像头故障时自动切换至另一台 – 继电器切换模块

• 将摄像头嵌入您的网站 – Web 服务器模块

* 在浏览器中查看摄像头 – Web 服务器模块

• 为预览和存档添加日期时间叠加层 – 标记模块

* 为预览和存档添加自定义文本叠加层 – 标记模块

• 为预览和存档添加 GPS 叠加层 – 标记模块

* 更改 Xeoma 标记叠加层的字体大小 – 在 标记模块的设置中进行配置

• 更改摄像头自带的日期/时间叠加层字体大小 – 请在摄像头的 Web 管理页面中检查设置（Xeoma 外部）

* 更改主屏幕上摄像机名称的字体大小 – 布局中的选项 -> 窗口设置

* 在 Xeoma 界面中控制摄像机的云台（平移、倾斜、变焦）功能 – 通过底部面板或摄像机预览框进行 PTZ 控制。另请参阅

• 在浏览器视图中控制摄像机的云台（平移、倾斜、变焦）功能 – 在单摄像机视图模式下使用 PTZ 控制（需 PRO 许可证）

* 连接摄像机 PTZ – 通用摄像机模块设置

• 快速添加优化设置的预设链 – 使用顶部模块面板中的即用链

• 同时查看来自多个服务器的摄像机（网络集群） – 主菜单 -> 远程访问 -> 多服务器模式

• 模拟 MJPEG IP 摄像机 – Web 服务器

* 模拟 H.264 IP 摄像机 – RTSP 广播模块 (PRO) 或 Web 服务器中的 webRTC 流媒体选项 (PRO)

* 在实时视图中截屏 – 主菜单中的“截屏”选项或底部面板中的“截屏”按钮

• 在存档中截屏 – 存档查看器菜单中的“截屏”选项

* 定期自动截屏 – 截屏模块

* 将 JPEG 图像或 MJPEG 视频用作视频源 – 文件读取模块

• 将其他 Xeoma 实例广播的视频流用作视频源 – 另一台 Xeoma模块

• 将通过 FTP 服务器发送的视频用作视频源 – FTP 接收器模块

* 视频或静态图像出现重影 – 请参阅图像失真故障排除

• 更改摄像机顺序 – 将摄像机预览窗格拖动至目标位置

* 将摄像机置于由较小摄像机槽位环绕的大槽位中 – 底部面板“布局”菜单中的选项

• 触发时弹出 Xeoma 窗口 – 弹出窗口模块，以及适用于 iOS 和 Android 的“移动通知”（自 20.10.22 版本起）

• 摄像机分组 – 主菜单中的设备列表

激活、注册、许可证

• 激活 Xeoma/Xeoma Pro 许可证续期（延长免费更新期限）– 主菜单 -> 注册 -> 激活（需对应续期密钥）

* 激活中继器 – 主菜单 -> 远程访问 -> 中继器设置 -> 订阅（需中继器订阅）

• 激活 Xeoma Lite 续费 – Xeoma Lite 不支持此功能

* 查看已激活许可证信息 – 主菜单 -> 信息 -> 已激活许可证，或主菜单 -> 信息 -> 关于

* 激活 Xeoma/Xeoma Starter/Xeoma Standard/Xeoma Lite/Xeoma Pro 许可证（切换至商业版并注册）– 主菜单 -> 注册 -> 激活（需对应许可证）

• 切换至试用模式 – 主菜单 -> 注册中的选项

* 检查 Xeoma 是否有新版本 – 主菜单 -> 信息 -> 检查更新

• 将 Xeoma 更新至最新正式发布版本 – 主菜单 -> 信息 -> 检查更新

* 将 Xeoma 更新至最新Beta版本 – 主菜单 -> 信息 -> 检查更新中的“更新至 Beta 版本”选项

• 激活 Xeoma Starter 许可证 – 主菜单 – 注册 – 激活（请确保使用 20.10.13 或更高版本）

• 激活 Xeoma Cloud 许可证 – 无需激活，购买订阅后即可访问

归档、移动侦测

* 从摄像机存储卡导入（SD 卡同步）– 预览与归档模块中的“从 SD 卡下载”选项（适用于 ONVIF 摄像机，PRO 版）

* 禁区闯入 – 运动检测器模块、越线检测模块或对象识别模块（若需识别闯入对象类型）

• 多路存档同步查看 – 底部面板中的“播放”按钮（PRO版本）

• 预览界面运动可视化 – 底部面板中“布局”菜单的“可视化设置”菜单

* 存档界面运动可视化 – 底部面板中“布局”菜单的“可视化设置”菜单（PRO版本）

• 运动轨迹可视化 – 底部面板中“布局”菜单的“可视化设置”菜单（PRO版本）

* 运动检测 – 运动检测模块

• 静止检测 – 运动检测模块中的“仅检测无运动”选项或遗留物检测模块

* 消除云影误报 – 运动检测器模块中的“与累积背景对比”检测方法

• 消除误报 – 运动检测器模块中的“灵敏度阈值”、“对象大小”、“忽略短于 X 的运动”选项及检测区域设置

• 远程快速启停录像、过滤器或目标模块（例如由自动化系统自动执行，或通过浏览器手动执行）– HTTP 开关模块

* 通过 Xeoma 界面快速启停录像或其他模块 – 按钮开关模块

• 通过 Xeoma 界面快速启停摄像机 – 主菜单中的“开启/关闭摄像机”选项

* 通过 Xeoma 界面快速启停所有模块 – 在快速设置页面的左侧弹出面板中勾选/取消勾选模块

• 仅白天录像 – 白天检测模块

* 仅在夜间录像 – 计划任务模块

• 在特定时间、日期录像 – 计划任务模块

• 将两路或多路摄像机画面合并录制至 1 个存档 – 合并器模块

* 更改预览及所有后续模块的图像分辨率 – 图像缩放模块

• 仅更改存档图像分辨率 – 预览与存档模块设置中的选项

* 以较低质量或较低帧率保存存档视频以节省空间 – 预览与存档模块设置中的选项

* 存档查看器图像缩放 – 存档查看器菜单中的开启/关闭缩放（PRO版本）

• 从存档查看器下载视频 – 存档查看器菜单中的“导出”选项

• 以指定格式保存视频 – 保存至文件模块

* 查看存档记录 – 摄像机预览框右上角的“播放”按钮（需安装预览与存档模块）

• 在存档查看器中按日期、时间搜索 – 使用存档查看器的时间轴和日历按钮

功能与模块

• 从方案中移除模块 – 模块设置中的回收站；点击连接两个模块的白色连线；将模块拖回顶部模块面板

* 向方案中添加模块 – 将模块从顶部模块面板拖至方案中的所需位置；或点击顶部模块面板中的模块

• 人脸自动检测与识别 – 人脸识别模块，或用于双重认证的 Face ID

* 对象交互式地图 – “布局”菜单中的eMap选项

• 收银机/POS 系统与 IP 摄像机同步 – HTTP 标记模块

* 人群检测 – 人群检测器模块、人脸识别模块或访客计数模块

• 越线检测与报警 – 越线检测模块或访客计数模块结合所需的通知模块

* 模糊（遮蔽）面向私人财产的图像区域 – 隐私遮蔽模块

• 追踪移动目标（跟踪） – PTZ Tracking 模块结合 Motion Detector 使用

* 员工监控 – Motion Detector、Face Recognition、Screen Capture 和 Microphone 模块

• 异常噪音检测（如玻璃破碎、枪声、爆炸） – Sound Detector 结合 Microphone 或 Universal Camera 模块（若特定噪音类型至关重要，请使用 Sound Events Detector (Additional)）

* 区分目标类型并对特定目标做出响应 – Object Recognition (Additional)

• 逆行检测 – Cross-line Detector 模块

* 保存问题、错误及程序事件日志 – Problems Detector 模块中的“将发现的问题记录到日志文件”选项

• 出入人数报告 – Visitor Counter 模块中的“将数据保存为 CSV 报告”

• 创建用户配置文件（操作员） – Main menu 中的“Users”菜单 -> Remote access

* 限制特定操作员访问某些摄像头/功能 – Main menu 中的“Users”菜单 -> Remote access

• 修改管理员密码/远程访问密码 – 主菜单 -> “用户”菜单 -> 远程访问

* 丢失管理员密码或远程访问密码 – 控制台命令 -showpassword

• 远程访问 Xeoma 服务器 – 主菜单 -> 远程访问 -> 连接至

* 连接无公网 IP 地址的远程服务器 – 中继器

• 将 JPEG 图片和视频上传至 FTP 服务器 – FTP 上传 模块

* 向其他设备发送 HTTP 请求 – HTTP 请求发送器

• 家长控制 – 屏幕截图 模块

* 将视频或音频流广播至其他 Xeoma 实例 – HTTP 上传 模块

• 在 Xeoma 中使用 LDAP 认证数据 – LDAP 设置

* 更改语言 – 主菜单中的“语言”选项

• 使用密码保护 Xeoma 服务器访问权限（在同一台电脑上）– 勾选安装对话框中的“使用此密码...”选项，并取消勾选连接对话框中的“记住此密码”

* 缩放界面（例如，针对移动端显示屏）– 布局 -> 窗口设置中的选项

• Xeoma Cloud：连接没有静态固定 IP 地址的摄像机 – FTP Receiver 模块

通知与响应

* 触发时鸣响警报 – Sound Alarm 模块

* 紧急情况邮件通知 – Email Sending 结合移动侦测、声音侦测、故障侦测等模块

• 紧急情况 SMS（短信）通知 – SMS Sending 结合移动侦测、声音侦测、故障侦测等模块

* 摄像机离线或“画面冻结”通知 – Problems Detector + Email/SMS Sending

• 摄像机被篡改或遮挡通知 – Problems Detector + Email/SMS Sending

* 磁盘空间不足通知 – Problems Detector + Email/SMS Sending

• 内存不足通知 – Problems Detector + Email/SMS Sending

* 处理器负载过高通知 – Problems Detector + Email/SMS Sending

• 调制解调器/路由器/互联网断开通知 – Problems Detector + Email/SMS Sending

* Xeoma 异常重启通知 – Problems Detector + Email/SMS Sending

• 数据库问题通知 – Problems Detector + Email/SMS Sending

即使是初学者也能轻松上手的快速入门指南

首次启动 Xeoma 时，您将看到以下界面：



您可以多次点击空白区域以跳过所有消息并开始工作。如果您的摄像机位于同一局域网内-
– 等等！我怎么知道它们是否属于局域网？
局域网是由您的路由器创建的网络。基本上，任何在路由器覆盖范围内的设备都属于该网络。因此，如果摄像头距离路由器不远，您可以安全地假定它们位于局域网内。最简单的检查方法是通过浏览器访问路由器的管理页面：其中应包含所有已连接设备的列表。请记下这些设备的 IP 地址——它们通常类似于 192.168.0.5、192.168.0.3。这些是本地 IP 地址，无法在外部网络中使用。

添加这些摄像头很简单：“+” → 简单搜索本地摄像头：



稍后您就能看到这些摄像头：



系统很简单，对吧？搜索过程中，您可能会看到此消息：



此处所需信息应在摄像头说明书中注明（如果是标准的 admin/admin，您甚至无需手动输入任何内容——Xeoma 将自动使用这些凭据）。

现在，如果摄像头位于不同的网络中，则需要静态固定 IP 地址。您可以向互联网服务提供商申请（他们也会指导您如何使用）。当摄像头拥有静态公网 IP 后，您可以通过 "+" → 按 IP/密码搜索 将其添加到 Xeoma 中。您将看到此窗口：



您需要知道用户名和密码；IP 地址由您的互联网服务提供商提供，端口通常为 80。有时摄像头可能使用非标准端口，您可以检查管理页面以确认。正确的页面应类似于：



摄像头添加完成后，您可以将此机器视为您的服务器。点击齿轮按钮即可查看设置。如您所见，Xeoma 采用简单的链式系统。这是 Xeoma 为每个摄像头创建的标准模块链：



它同时以两种方式运行：

1. 在指定时间（在 “计划程序” 中设置的时间段），“移动侦测” 启动，并将所有运动画面存储到 “预览与存档” 中；
2. 如果摄像头或服务器出现异常，“故障侦测” 会通知 “发送电子邮件” 模块，从而向您发出通知。

您的监控系统已基本就绪，您只需花一点时间配置“移动侦测”和“发送电子邮件”。

如果您想从其他设备（例如 Android 或 iPhone）查看服务器，可以进行远程连接。这些设备将成为您的客户端。这就是简单的“客户端 - 服务器架构”。只需在这些设备上下载 Xeoma App，然后前往 主菜单 → 远程访问 → 连接到。您将看到此窗口：



您需要在第一个输入框中输入服务器的 IP 地址。如果服务器和客户端位于同一网络中，使用服务器的本地 IP (192.168.x.x) 即可。您可以通过在服务器上查看同一个窗口来获取其 IP 地址——它会在 用于连接此计算机的 IP 地址 中显示确切地址。否则，服务器需要静态 IP 或激活 中继器（这是解决该问题的便捷方案）。

还需最后一步即可让您的系统独立运行。若服务器重启，您希望 Xeoma 能自动启动，以免丢失任何录像。这很容易设置：前往 主菜单 → 安装 → 安装 并勾选 将 Xeoma 服务器部分作为服务自动运行。

在无图形界面 Linux 上安装 Xeoma 视频监控软件（例如基于 ARM 的 Raspberry Pi）（通过终端）

如果您的 Linux 是服务器版本，或者您想通过控制台执行相同操作，请运行终端并执行

wget https://felenasoft.com/xeoma/downloads/latest/linux/xeoma_linux64.tgz（适用于 64 位系统）

或

wget https://felenasoft.com/xeoma/downloads/latest/linux/xeoma_linux.tgz（适用于 32 位 Linux）。

使用 tar 命令解压压缩包。



解压完成后，您将获得 xeoma.app 文件。运行该文件即可启动 Xeoma（同时启动 服务端和客户端）。运行该文件时，系统将显示包含可用 命令 的简要帮助信息。



自 Xeoma 22.11.25 版本起，安装 Xeoma 时新增了指定控制台命令的功能，该命令将被添加到安装后的自动启动脚本中。例如，如果您执行 -install -coreauto -serverport 8888，-serverport 8888 命令将自动添加到自动启动脚本中。此前，附加命令无法与安装命令合并，必须在自动启动脚本中手动指定。

仅当您的 Linux 系统具备图形界面时，运行 xeoma.app 才会启动客户端可视化界面：



否则，您可以直接运行服务端，而不启动可视化界面（客户端）：



您可以通过控制台更改语言、安装和卸载程序、运行程序以及激活程序。



要设置其他功能（例如添加和配置摄像头、创建用户配置文件、更改密码并设置本地访问等），您需要 通过客户端连接到该服务端。运行客户端的设备必须具有图形界面。这甚至可以是您的 Android 智能手机。

正如您所见，Linux 版 Xeoma 视频监控软件的操作便捷性与其他操作系统版本无异。此外，在 Ubuntu 或其他 Linux 发行版上部署 Xeoma，不仅能省时省力，更能节约成本。

控制台命令

在终端中运行 Xeoma 时，将显示以下常规命令：

用法：Xeoma.app [-command] [-argument]

命令：

命令	说明
-help	显示此帮助信息
-core	仅运行服务端
-client [password@address:port]	仅运行客户端。可不带参数使用，密码和端口也可为空。例如：-client 192.168.0.1
-lls	运行许可证服务器
-install [-argument]	仅在带参数时有效
-install -allmanual	安装服务端和客户端，并设为手动启动
-install -allauto	安装服务端和客户端，并设为自动启动***
-install -coreauto	安装服务端（自动启动）和客户端（手动启动）***
-install -hiddenmode	以隐藏模式安装服务端（自动启动）***
-install -cloudauto	安装 Cloud 服务并设为自动启动***
-install -removeall	移除所有组件，包括归档文件和配置文件***
-install -removeexe	移除程序，保留归档文件和配置文件***
-install -licauto	安装许可证服务器并设为自动启动
-installdir [DirPath]	设置安装目录。注意！目录路径必须采用 UTF-8 编码！**
-stopservice	停止 Xeoma 服务（如果已安装）***
-startservice	启动 Xeoma 服务（如果已安装）***
-restartservice	重启 Xeoma 服务（如果已安装）***
-activateOnline [Serial]	在线激活（如需激活多个序列号，请用逗号分隔且不加空格，或用单引号将序列号括起来并用“;”分隔。例如：-activateOnline Serial1,Serial2）
-licenseServer [LicenseServer]	在线激活所需的许可证服务器。例如：192.168.0.1:8090
-activateRequest [Serial]	离线激活（如需激活多个序列号，请用逗号分隔且不加空格，或用单引号将序列号括起来并用“;”分隔。）
-activateResponse [Activation]	离线激活
-showpassword	显示当前密码并启用网络访问
-startdelay [seconds]	启动前的延迟时间（秒）
-log	启用服务端事件日志
-lang [Language]	英语：en，俄语：ru 等
-clientIndex [ClientID]	客户端 ID 仅能包含字母和数字（无空格，最多 16 个字符）
-individualsettings	为每个客户端单独存储个人设置
-cloud	启动 Cloud 服务器，并在崩溃时自动重启
-noguard	与 -cloud 配合使用，在不启用重启守护进程的情况下运行 Cloud
-sampleconfig	与 -cloud 配合使用，在 Cloud 模式下生成示例配置
-nohup	忽略 HUP (hangup) 信号
-noscan	禁用摄像机扫描
-noscanptzandaudio	禁用 PTZ 和音频 URL 扫描
-proxy [ProxyServerURL]	设置代理服务器地址*
-proxyclear	移除存储的代理服务器地址*
-pcm	启动 Xeoma 并支持海康威视 (HikVision) IP 摄像机的 PCM 音频格式
-noarchivedb	禁用归档数据库（将无法在归档中进行搜索）
-activateRetranslator [Serial]	在线激活中继器（如需激活多个序列号，请用逗号分隔（无空格），或用单引号将序列号括起并以";"分隔。例如：-activateRetranslator 'Serial1;Serial2'）
-noautoupdate	强制限制服务器端的自动更新
-serverport [PortNumber]	设置服务器端口*
-setpassword [Password]	设置服务器密码
-savepassword [1/0]	允许在客户端保存密码
-reindexingArchive	重新索引归档并退出
-nolog	禁用服务器事件日志
-fullscreen	以全屏模式运行 Xeoma
-sslconnection [0/1/2]	客户端设为 0：连接服务器时忽略证书；服务器设为 1：仅接受来自客户端的安全连接（为此，请生成证书并将其放入 Server 和 Client 文件夹。详情请参阅 Xeoma 文件夹 > Security > Certificate > Readme.txt）；服务器或客户端设为 2：自动检测证书
-arducam	启用 ArduCAM
-compressdb	压缩归档数据库
-uselocaltime	使用本地时间而非 UTC
-webaddr [WebAddr]	将所有地址更改为指定地址
-enableconwithoutpass [UserName]	启用一分钟内无需密码连接
-archivecache [DirPath]	缓存目录路径（位于 RAM-disk 或高速 HDD），用于加速归档写入**
-connectioninfoport [PortNumber]	设置许可证服务器端口（参阅 -lls），默认为 4200
-programdir [DirPath]	设置首次启动时解压 Xeoma 文件的目录**
-disableDownloads	允许从菜单中移除“更新”选项
-nosearchservers	使 Xeoma 停止在网络中搜索任何可连接的 Xeoma 服务器