发布订阅流协议

独立、轻量的流数据分发

PSSP 是传输不透明数据的发布/订阅协议。Broker 接收字节数据，为每个主题保留有界的内存缓存，并向已授权订阅者分发数据；它不解析音频、视频、图像、文件、控制数据或同步数据。

范围边界

本仓库只包含 Broker 和桌面管理客户端。OX Firmware 与 WebService 将来会作为 PSSP 客户端接入；本项目未嵌入这两个项目的任何代码。

协议

线上的记录格式、登录、主题过滤器、QoS 语义、重放与加密会话行为。

运行、配置、保护并部署独立的 Rust/Tokio 服务。

连接、发布、缓存、扇出、确认和恢复的可视化流程。

连接、认证、订阅、发布 QoS 1 数据，并验证 UDP 心跳。

诊断启动、SQLite、凭据、TLS、仅 AES 固定公钥、ACL、UDP 和重放错误。

应用程序	位置	支持的系统	职责
PSSP Broker	源代码：`broker/` 可执行文件和运行命令	Windows、Linux、macOS	认证、授权、有界主题缓存、QoS 1 扇出/重放以及 QoS 0 UDP 处理。
PSSP 客户端	`client/`	Windows、Linux、macOS	桌面端连接/登录、主题检查、测试发布、心跳验证和诊断。

QoS 1 · TCP

用于音频、视频、图像、文件和所有不能被静默丢失的数据。Broker 的 PUBACK 确认已接收。订阅者在完成持久化交接后发送 MSGACK。主题缓存提供有界重放。

QoS 0 · UDP

通常用于心跳和其他可容忍丢失的信号。它没有回执、重试、订阅者确认或重放。UDP 端点与一个仍有效的已认证 TCP 会话绑定。

模式	配置	用途
TLS + AES	启用 TLS 1.3 + PSSP AES-256-GCM	正常部署。每个已认证连接都会生成新的仅内存 AES 密钥。
仅 AES	关闭 TLS + 启用 PSSP AES + 固定 Broker X25519 公钥	无证书传输层。每个会话通过 X25519 + HKDF 在本地派生 AES；对称密钥不会通过网络发送。
明文 TCP/UDP	关闭 TLS/AES + 显式设置 `allow_insecure_tcp_udp = true`	仅限可信的本地/私有网络。凭据和负载在网络中可被读取。

专有软件