toxuin/alarmserver

IP Camera Alarm Server

!docker pulls

一款通用的IP摄像头报警服务器，可集中管理所有IP摄像头的报警！

能与Home Assistant、Node-Red等系统良好集成，在树莓派上运行表现出色！

核心功能与特性

支持的摄像头类型 📸

• Hikvision（Annke/Alarm.com等品牌）
• Dahua（Lorex/Amcrest等品牌）
• Hisilicon（使用XmEye的摄像头）
• 任何可通过FTP上传报警的摄像头

支持的报警交付方式 📬

• MQTT
• Webhooks

使用场景与适用范围

适用于需要集中管理多个IP摄像头报警的用户，尤其适合家庭自动化爱好者，可将摄像头报警事件集成到智能家居系统中，实现报警信息的统一收集与分发。

配置说明

在应用程序二进制文件所在的文件夹中创建config.yaml文件。

也可参考https://github.com/toxuin/alarmserver/blob/master/docs/config.yaml%E3%80%82

当报警服务器启动时，会向/camera-alerts主题发送状态消息。

HiSilicon

包括大多数使用XmEye应用且具有"报警服务器"功能的无品牌中国摄像头。

如果您的摄像头需要Internet Explorer才能访问其Web界面（https://github.com/toxuin/alarmserver/blob/master/docs/hisilicon.jpg%EF%BC%89%EF%BC%8C%E4%B8%94%E5%9C%A8%E5%85%B6%E4%BB%96%E6%B5%8F%E8%A7%88%E5%99%A8%E4%B8%AD%E6%97%A0%E6%B3%95%E5%B7%A5%E4%BD%9C%EF%BC%8C%E9%82%A3%E4%B9%88%E6%AD%A4%E6%9C%8D%E5%8A%A1%E5%99%A8%E6%AD%A3%E6%98%AF%E6%82%A8%E6%89%80%E9%9C%80%E8%A6%81%E7%9A%84%E3%80%82%E8%BF%99%E4%BA%9B%E6%91%84%E5%83%8F%E5%A4%B4%E5%9D%87%E7%94%B1%E6%B5%B7%E6%80%9D%EF%BC%88HiSilicon%EF%BC%89%E5%88%B6%E9%80%A0%EF%BC%8C%E4%BB%A5%E6%95%B0%E7%99%BE%E7%A7%8D%E4%B8%8D%E5%90%8C%E5%93%81%E7%89%8C%E9%94%80%E5%94%AE%E3%80%82

摄像头日志也可作为报警——在摄像头的"发送日志"设置中进行配置。

yaml
hisilicon:
  enabled: true  # 若为false，则不监听来自HiSilicon摄像头的报警  
  port: 15002    # 必须与摄像头设置中的端口一致

Dahua

大华（Dahua）是一家OEM公司，为多个知名品牌生产摄像头。查看大华OEM摄像头制造商列表，确定您的摄像头是否应在报警服务器中配置为Dahua类型。

yaml
dahua:
  enabled: true              # 若未启用，则不会连接任何Dahua摄像头
  cams:
    myCam:                   # 摄像头名称
      address: 192.168.1.69  # IP地址或域名
      username: admin        # 登录摄像头Web面板的用户名 
      password: admin1234    # 登录摄像头Web面板的密码

Hikvision

报警服务器使用HTTP流分别连接每个摄像头并订阅所有事件。

一些低端摄像头，尤其是门铃和对讲机，其HTTP流实现存在问题，无法打开多个连接，会"关闭"HTTP响应但保持TCP连接打开（不发送keep-alive头！）。对于这些摄像头，报警服务器提供了替代的流实现。要使用此功能，在摄像头配置文件中设置rawTcp: true。

海康威视（Hikvision）摄像头也可与FTP服务器配合使用。

yaml
hikvision:
  enabled: true              # 若未启用，则不会连接任何Hikvision摄像头
  cams:
    myCam:                   # 摄像头名称
      address: 192.168.1.69  # IP地址或域名
      https: false           # 若摄像头仅支持https，设为true
      username: admin        # 登录摄像头Web面板的用户名 
      password: admin1234    # 登录摄像头Web面板的密码
      rawTcp: false          # 部分摄像头流实现有问题，若常规HTTP流不工作，设为true

FTP

报警服务器接受任何用户名作为FTP登录用户名，并将其用作摄像头名称。只要密码匹配，就允许连接。

yaml
ftp:
  enabled: true      # 若未启用，则不接受连接
  port: 21           # 必须与摄像头设置中的端口匹配
  password: "root"   # 接受的FTP密码
  allowFiles: true   # 若为false，不存储文件（但传输仍会进行）
  rootPath: "./ftp"  # 保存摄像头上传文件的文件夹

Q: FTP不是很慢吗？
A: 不。报警处理在实际文件上传开始前就已完成，在典型的家庭无线网络中，这不到0.2秒，速度足够快。

Q: 既然有ONVIF，为什么还需要这个？
A: 一些IP摄像头支持ONVIF，有时甚至包括运动报警，但这并不意味着人体检测报警或其他报警（如"SD卡损坏"或"管理员登录失败"）会通过ONVIF公开，而且并非所有摄像头都支持ONVIF。

测试过的摄像头

• 3xLogic VX-2M-2D-RIA（Hikvision服务器）
• Uniden U-Bell DB1（也称为Hikvision DS-KB6003、LaView LV-PDB1630-U和RCA HSDB2A）
• Misecu 5MP Wifi AI Cam（Hisilicon服务器）
• HomeViz OB10、K4W10、OW10（Hisilicon服务器，由https://github.com/acburnett%E6%B5%8B%E8%AF%95%EF%BC%89

如果您的摄像头可与报警服务器配合使用，请创建一个包含相关细节和图片的issue，我们将在此处列出。

Docker部署

有预构建镜像toxuin/alarmserver，为多架构镜像，可在Intel/AMD机器和树莓派上运行。

基本用法

bash
docker run -d -v $PWD/config.yml:/config.yml -v $PWD/ftp:/ftp -p 21:21 -p 15002:15002 toxuin/alarmserver

参数说明

• -d: 后台运行，无需持续查看日志
• -v $PWD/config.yml:/config.yml: 将本地配置文件挂载到容器中，确保文件已存在
• -v $PWD/ftp:/ftp: 将本地ftp文件夹挂载到容器中，不使用FTP时可省略
• -p 21:21: 映射FTP服务器端口21，不使用FTP时可省略
• -p 15002:15002: 映射HiSilicon报警服务器端口***，不使用HiSilicon时可省略

反馈

本项目最初为作者个人使用而创建，虽然它可能也适用于您，但作者并不清楚您的使用方式是否与作者相同。为了更好地适应每个人的使用场景，若您能描述您如何使用报警服务器，将非常有帮助。

无论您是刚开始在网络中使用报警服务器（或已使用很长时间），无论您喜欢它（或讨厌它），都欢迎创建issue分享使用体验和您的摄像头型号。作者很想知道它是否适合您的使用场景（或完全不适合）。

如有功能建议，请创建issue，我们可能会共同解决。

许可证

MIT许可证