WebSocket Cluster
Clustered connections · sessions · broadcast & unicast
- Netty + MQTT dual engine
- MQTT internal · decoupled services
- Single consumption · duplicate-safe
- Deep integration with Message Center
- Multi-device support · force sign-out
Screenshots
Overview
The WebSocket Cluster plugin solves message routing across multi-node deployments: any message addressed to a user must reach the exact node holding their live socket. The common sticky-session + Redis Pub/Sub approach hits bottlenecks on both session sharing and broadcast throughput.
This plugin uses MQTT as the inter-node protocol — topic subscriptions are natively broadcast, and exactly-once consumption between nodes prevents duplication. Once integrated, WebSocket scales horizontally without node-count limits.
Modules
- 01
Connection (Netty core)
High-performance Netty-based connection mgmt · Session mgmt · Cluster-ready · yml namespace blade.plugin.websocket
- 02
Channels
Subscription / broadcast / unicast channels · Channel permissions · Event-callback notification types for flexible outbound signaling
- 03
Heartbeat & auth
Heartbeat · Auth · Auto cleanup · Multi-device same-user delivery (toggle-controlled)
- 04
MQTT messaging & extensibility
Internal MQTT bus · Topic subscribe / batch unsubscribe · Single-consumption annotation lock with configurable window · Plug-in external topics + handler classes (see module README)
- 05
Runtime & monitoring
Online user list · Multi-device · Force sign-out · P2P push · Dashboard data push · Multi-tenant isolation · Real-time message monitor
Key features
- Netty-powered low-latency core
- MQTT internal routing across nodes
- Session / room / tag — 3-level management
- Heartbeat & auto-reconnect
- Broadcast / unicast / multicast
- Annotation-based single-consumption lock
- External MQTT topic + handler registration
Use cases
- 01
Real-time collaboration (online forms / dashboards)
- 02
Real-time dashboard pushes (multi-tenant P2P)
- 03
Online customer service / IM
- 04
IoT device-status streaming back to dashboards
Specifications
- Tech stack
- WebSocket · MQTT internal messaging · clustered sessions
- License
- Commercial
- Delivery
- Backend JAR
- Support
- Perpetual ticket support · business hours
Invoicing
A 1% VAT regular electronic invoice is issued within 15 business days after payment. Reach out to sales to update the title or tax ID.