appleboy/gorush
Gorush
Gorush is a dedicated notification dispatch server used to send real-time alerts to iOS and Android mobile devices. It functions as a centralized infrastructure for hosting a notification API and managing the delivery of push messages through high-throughput queuing.
The system supports both gRPC streams and HTTP endpoints to receive notification triggers and includes a command-line interface for triggering alerts without a running server process. It manages network traffic through proxy routing via HTTP or SOCKS5 and secures server communication using automated TLS certificate management.
Operational capabilities include worker-based queue processing and concurrency-limited dispatch to prevent overloading external push services. The project provides observability through Prometheus-compatible telemetry for tracking delivery performance and utilizes pluggable storage backends for persisting application statistics.
Features
- Push Notification Dispatchers - Provides a dedicated server for dispatching real-time push notifications to iOS and Android devices.
- Push Notification Servers - Provides a dedicated server to manage and dispatch push notifications via a standardized API.
- Message Queue Workers - Processes high-volume notification deliveries using a configurable pool of concurrent background workers.
- Message Queues - Uses a configurable pool of concurrent workers and queues to handle high-volume notification throughput.
- Push Notification Providers - Routes real-time alerts to iOS and Android devices through a centralized dispatch server.
- Notification Routing Services - Implements a centralized system for aggregating and dispatching notification alerts via HTTP.
- High-Throughput Task Processing - Employs an architecture designed to process massive volumes of notification tasks with low latency.
- gRPC Interfaces - Provides a high-performance gRPC server interface for low-latency notification request streaming.
- Message Failure Handlers - Reports failed notification attempts using synchronous API responses or asynchronous webhooks for recovery.
- CLI Triggers - Enables triggering push notifications directly from a command-line interface independently of the server process.
- Multi-Protocol - Supports multiple communication protocols, including gRPC and HTTP, for receiving notification triggers.
- Notification Security - Secures notification traffic using automated TLS certificates and proxy-aware routing.
- Rate Limiting - Limits simultaneous connections to iOS push services to prevent overloading external providers.
- Delivery Monitoring - Monitors the delivery status, success rates, and response times of notification pipelines.
- Infrastructure Monitoring - Tracks notification delivery success rates and system health using infrastructure monitoring tools.
- Prometheus Exporters - Exposes internal delivery metrics and system health data via a standardized Prometheus endpoint.
- Concurrency Limiters - Restricts the number of simultaneous connections to external push providers to ensure system stability.
- Messaging Systems - Push notification server supporting multiple providers.
- Messaging - Listed in the “Messaging” section of the Awesome Go awesome list.
- Messaging Systems - Push notification server.
- More to explore - Push notification service.
