eduard256/strix

Strix

镜像概述和主要用途

Strix是一款智能IP摄像头流发现系统，专为解决IP摄像头文档缺失、流协议不明确、配置复杂等问题设计。它能够自动检测并识别各类IP摄像头的工作流，支持多种协议（RTSP、HTTP、MJPEG、JPEG、BUBBLE等），并生成适用于Frigate NVR的配置文件，帮助用户快速集成摄像头到家庭自动化或安防系统中。

核心功能和特性

自动流发现

• 并行测试102,787种URL变体，平均30-60秒内完成检测
• 支持ONVIF协议、数据库 lookup（67,288种已知型号）、206种通用URL模式，95%摄像头流发现成功率

多协议支持

• 兼容RTSP、HTTP MJPEG、JPEG快照、HTTP-FLV、BUBBLE（中国 proprietary NVR/DVR协议）、ONVIF等
• 自动将JPEG快照转换为视频流（通过FFmpeg）

Frigate配置生成

• 自动区分主流（HD，用于录制）和子流（低分辨率，用于检测），降低CPU占用5-10倍
• 生成完整go2rtc配置，支持流复用和协议转换
• 智能合并现有配置，添加新摄像头时不破坏原有结构

丰富的摄像头数据库

• 覆盖3,636个品牌，包括海康威视、大华、Axis、Foscam等知名品牌，以及ZOSI、Escam等中国品牌和无品牌OEM型号

高效性能

• 20路并行测试，实时进度更新（通过SSE）
• 轻量级设计，Docker镜像大小仅80-90MB（基于Alpine Linux）

使用场景和适用范围

家庭自动化

• 将廉价摄像头集成到Home Assistant
• 与Frigate NVR配合实现物体检测（人员、车辆、猫、狗等）
• 低CPU占用的 motion 录制

安防系统

• 发现老旧NVR系统中的摄像头流
• 无文档摄像头的快速配置
• 从专有DVR迁移到Frigate
• 降低硬件资源需求

IP摄像头测试

• 部署前验证摄像头流质量
• 查找最佳分辨率和帧率
• 检查编解码器兼容性

使用方法和配置说明

安装方式

Ubuntu / Debian 一键安装

bash
sudo apt update && command -v docker >/dev/null 2>&1 || curl -fsSL https://get.docker.com | sudo sh && docker run -d --name strix --network host --restart unless-stopped eduard256/strix:latest

安装完成后访问：http://YOUR_SERVER_IP:4567

Docker Compose

bash
sudo apt update && command -v docker >/dev/null 2>&1 || curl -fsSL https://get.docker.com | sudo sh && command -v docker-compose >/dev/null 2>&1 || { sudo curl -L "https://github.com/docker/compose/releases/latest/download/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose && sudo chmod +x /usr/local/bin/docker-compose; } && curl -fsSL https://raw.githubusercontent.com/eduard256/Strix/main/docker-compose.yml -o docker-compose.yml && docker-compose up -d

Home Assistant 插件

1. 进入 设置 → 插件 → 插件商店
2. 点击右上角 ⋮ → 仓库
3. 添加仓库：https://github.com/eduard256/hassio-strix
4. 在商店中找到 "Strix"
5. 点击 安装
6. 启用 "开机启动" 和 "在侧边栏显示"
7. 点击 启动

使用步骤

步骤1：打开Web界面

http://YOUR_SERVER_IP:4567

步骤2：输入摄像头信息

• IP地址：192.168.1.100（摄像头局域网IP）
• 用户名：admin（如需要）
• 密码：摄像头密码
• 型号：可选，提高检测准确性

步骤3：发现流

点击 "Discover Streams"，实时查看进度：

• 当前测试的URL
• 已测试数量
• 发现的流会即时显示

等待30-60秒完成检测。

步骤4：选择流

Strix会显示每个流的详细信息：

步骤5：生成Frigate配置

点击 "Use Stream" → "Generate Frigate Config"，获取完整配置：

yaml
go2rtc:
  streams:
    '192_168_1_100_main':
      - http://admin:pass@192.168.1.100:8000/video.mjpg
    '192_168_1_100_sub':
      - http://admin:pass@192.168.1.100:8000/video2.mjpg

cameras:
  camera_192_168_1_100:
    ffmpeg:
      inputs:
        - path: rtsp://127.0.0.1:8554/192_168_1_100_sub
          roles: [detect]      # CPU占用从70%降至8%
        - path: rtsp://127.0.0.1:8554/192_168_1_100_main
          roles: [record]      # 高清录制
    objects:
      track: [person, car, cat, dog]
    record:
      enabled: true

智能合并功能：

• 粘贴现有包含500+摄像头的frigate.yml
• Strix会正确添加第501个摄像头
• 不破坏原有结构，保留所有设置

步骤6：添加到Frigate

复制配置 → 粘贴到frigate.yml → 重启Frigate

高级配置

Docker环境变量

yaml
environment:
  - STRIX_API_LISTEN=:8080        # 自定义端口
  - STRIX_LOG_LEVEL=debug         # 详细日志
  - STRIX_LOG_FORMAT=json         # JSON格式日志

配置文件

创建strix.yaml：

yaml
api:
  listen: ":8080"

示例配置：strix.yaml.example

发现参数（Web界面高级设置）

• 通道：NVR系统使用（通常为0）
• 超时时间：最大发现时间（默认：240秒）
• 最大流数量：找到N个流后停止（默认：10）

API参考

健康检查

bash
GET /api/v1/health

搜索摄像头

bash
POST /api/v1/cameras/search

{
  "query": "hikvision",
  "limit": 10
}

发现流（SSE）

bash
POST /api/v1/streams/discover

{
  "target": "192.168.1.100",
  "username": "admin",
  "password": "12345",
  "model": "DS-2CD2xxx",
  "timeout": 240,
  "max_streams": 10
}

返回实时进度的Server-Sent Events。

完整API文档：DOCKER.md

技术细节

• 开发语言：Go 1.24
• 数据库：3,636个JSON文件
• 镜像大小：80-90MB（Alpine Linux）
• 依赖：FFmpeg/FFprobe（用于流验证）
• 并发处理：工作池（20路并行测试）
• 实时更新：Server-Sent Events（SSE）

支持的Docker平台

• linux/amd64
• linux/arm64

故障排除

未找到流？

• 检查网络：确保摄像头可ping通（ping 192.168.1.100）
• 验证凭据：确认用户名/密码正确，尝试无凭据访问
• 不指定型号：Strix会运行ONVIF检测+206种通用模式

Frigate仍高CPU占用？

• 使用子流：子流（低分辨率）用于检测，主流（高清）用于录制

yaml
inputs:
  - path: rtsp://127.0.0.1:8554/camera_sub   # 640x480用于检测
    roles: [detect]
  - path: rtsp://127.0.0.1:8554/camera_main  # 1920x1080用于录制
    roles: [record]

发现时间过长？

• 缩小搜索范围：指定确切型号、降低"最大流数量"（默认10→5）、减少超时时间（默认240→120秒）

许可

MIT许可 - 允许商业使用、修改和分发。详见LICENSE文件。

支持

• 问题反馈：https://github.com/eduard256/Strix/issues
• 讨论：https://github.com/eduard256/Strix/discussions
• Docker：https://hub.docker.com/r/eduard256/strix

为厌倦无文档摄像头的用户打造
已在各种无品牌中国摄像头上测试通过。