hpfeeds/hpfeeds-broker

hpfeeds-broker 镜像说明

镜像概述

hpfeeds是一款轻量级认证发布订阅协议，具有简洁的有线格式，支持通过频道分离不同消息流，允许传输任意二进制payload（常见为JSON格式）。本镜像提供基于asyncio的现代Python 3兼容broker实现，同时支持Python 3客户端，便于快速集成到各类应用中。

核心功能

1. 轻量级认证机制：确保消息传输的安全性；
2. 频道分离：不同消息流通过频道隔离，便于管理；
3. 灵活payload支持：允许传输任意二进制数据（如JSON事件、日志等）；
4. Python 3兼容：基于asyncio的高效broker实现；
5. 命令行工具：提供订阅/发布消息的命令行接口；
6. 监控支持：暴露Prometheus监控端口（9431）。

使用场景

• 实时数据传输（如系统日志、应用事件通知）；
• 分布式系统间的消息通信；
• 合法的安全事件数据共享场景；
• 需要轻量级消息协议的应用集成。

配置说明

客户端安装

bash
pip install hpfeeds

命令行使用

• 订阅频道：

  bash
  hpfeeds subscribe --host localhost -p 10000 -i myident -s mysecret -c mychannel
  

• 发布消息：

  bash
  hpfeeds publish --host localhost -p 10000 -i myident -s mysecret -c mychannel '{"event": "ping"}'
  

Docker部署

bash
docker run -d \
  -p "0.0.0.0:20000:20000" \
  -p "0.0.0.0:9431:9431" \
  -v /your/local/path/var:/app/var \
  hpfeeds/hpfeeds-broker:latest

说明：

• 端口20000用于客户端连接；
• 端口9431用于Prometheus监控；
• 挂载/app/var目录可持久化存储access keys（基于sqlite数据库）。

更多详细文档请访问：[***]