在视频监控领域，协议碎片化、设备兼容性差、媒体流处理复杂是三大核心痛点。Voglander 以 生产就绪 的工程质量，提供一站式解决方案：

• 🎯 全协议支持 — GB28181（sip-gateway 1.8.0）、ONVIF、GT1078，兼容海康、大华、宇视、中维等主流厂商
• ⚡ 高并发分片引擎 — 四层异步事件管线（翻译 → 分片 → 协议路由 → 协议处理），16 槽哈希分片，零锁竞争
• 🎬 ZLM 二次封装 — 基于 zlm-spring-boot-starter 封装，实时点播、录像回放、流代理、推流，Hook 驱动状态自动同步
• 🏗️ 企业级分层架构 — Web / Manager / Service / Repository / Integration 五层，Assembler 模式统一数据转换
• 🛡️ 安全可靠 — RBAC 权限体系、XSS 过滤、防重复提交、限流切面、Redis 分布式锁
• 📊 全链路可观测 — SkyWalking 链路追踪、结构化日志、JaCoCo 聚合覆盖率报告
• 🔌 开箱即用 — SQLite 零配置启动，平滑迁移 MySQL，Docker 友好

• JDK 17+
• Maven 3.6+
• MySQL 8.0+（可选，默认 SQLite 零配置）
• Redis 6.0+（可选，多节点部署必须）

# 克隆项目
git clone https://github.com/lunasaw/voglander.git
cd voglander

# 编译
mvn clean compile

# 启动（自动创建 app.db，真正开箱即用）
mvn spring-boot:run -pl voglander-web

启动后访问：

• 应用地址: http://localhost:8081
• API 文档: http://localhost:8081/swagger-ui.html

# 1. 建库
mysql -u root -p -e "CREATE DATABASE voglander;"

# 2. 初始化表结构
mysql -u root -p voglander < sql/voglander.sql

# 3. 修改数据源配置
# 编辑 voglander-web/src/main/resources/application-repo.yml

# application-inte.yml
gateway:
  node-id: node-1                    # 每个节点唯一
  gb28181:
    store:
      type: redis                    # 多节点必须改为 redis（跨节点 INVITE 回包路由）

sip:
  server:
    external-ip: <VIP>               # 多节点必须配置

voglander:
  event:
    shard:
      enabled: true
      count: 16

所有出站命令通过 dispatchEnvelope 统一下发，cmdType 格式为 protocol.Group.Name：

# 运行所有测试
mvn test

# 单个测试类
mvn test -Dtest=DeviceManagerTest

# Redis 集成测试（自动探测，不可用则跳过）
brew services start redis
mvn test -Dtest=MediaNodeCacheIntegrationTest

# 生成 JaCoCo 聚合覆盖率报告
./generate-coverage-report.sh
# 输出: voglander-coverage-report/target/site/jacoco-aggregate/index.html

所有业务表统一包含：id（BIGINT）、create_time / update_time（自动填充）、enabled（开关）、extend（JSON 扩展）。

欢迎任何形式的贡献！

1. Fork 本仓库
2. 创建特性分支：git checkout -b feature/your-feature
3. 提交变更：git commit -m 'feat: add your feature'
4. 推送分支：git push origin feature/your-feature
5. 提交 Pull Request

请确保代码通过 mvn test 且符合项目编码规范。

本项目基于 MIT License 开源发布，欢迎在遵守许可证的前提下自由使用。

Luna — GitHub @lunasaw · iszychen@gmail.com

• sip-proxy — GB28181 SIP 协议通信框架（本项目的 SIP 基础层）
• zlm-spring-boot-starter — ZLMediaKit Spring Boot 封装，本项目媒体流能力的底层依赖
• vue-vben-admin — 配套前端管理界面