High-performance gaming gateway service framework for the go-pantheon ecosystem
Janus is a high-performance gaming gateway service built on microservice architecture, developed in Go. As a bridge between clients and backend services, it provides a scalable and reliable connection layer with multi-protocol access and intelligent request routing. Janus is the core gateway component of the go-pantheon gaming ecosystem, powered by the fabrica-net network library for enterprise-grade communication capabilities.
go-pantheon is a ready-to-use modern game server framework designed with microservice architecture, providing game developers with high-performance, high-availability complete solutions:
- ๐ฐ Janus - Gaming gateway service for client connection handling and request forwarding
- โ๏ธ Roma - Game core logic service, business logic processing center
- ๐ Lares - User authentication service for account management and identity verification
- ๐ Senate - Backend management service for operational data and system administration
- ๐ High Performance: Multi-protocol network server powered by fabrica-net with worker pool architecture, supporting tens of thousands of connections per service
- ๐ Horizontal Scaling: Stateless design supports cluster deployment with dynamic scaling for traffic peaks
- ๐ Secure Communication: ECDH key exchange with Ed25519 certificate signing + AES-GCM encrypted communication
- โก Smart Routing: Three-tier routing system based on Redis with dynamic load balancing
- ๐ก๏ธ Token Validation: Secure handshake mechanism integrated with Lares authentication service
- ๐ Multi-Protocol Support: TCP, KCP (UDP), and WebSocket protocols with unified API through fabrica-net
- ๐ฆ Protocol Conversion: Seamless protocol conversion between network protocols and gRPC
- ๐ Data Compression: Support for zlib compression to optimize network transmission
- ๐ Monitoring & Tracing: Integrated OpenTelemetry distributed tracing and Prometheus metrics
- ๐ฏ Real-time Push: Support for message push, multicast, and broadcast notifications
graph TB
Client["๐ฎ Game Client"]
Lares["๐ Lares<br/>(Auth Service)"]
Janus["๐ฐ Janus<br/>(Gateway Service)"]
Roma["โ๏ธ Roma<br/>(Game Service)"]
Client -->|"1.HTTPS Token Request"| Lares
Lares -->|"Return Encrypted Token"| Client
Client -->|"2.TCP Connection + Token Handshake"| Janus
Janus -->|"3.Handshake Success + Encryption Params"| Client
Client -->|"4.AES Encrypted Game Protocol"| Janus
Janus -->|"5.gRPC Tunnel Communication"| Roma
Roma -->|"6.Business Response"| Janus
Janus -->|"7.Encrypted Response Data"| Client
- Go 1.24+
- etcd service (service discovery)
- Redis service (routing table)
# 1. Clone the project
git clone https://github.com/go-pantheon/janus.git
cd janus
# 2. Initialize dependencies
make init
# 3. Generate API code
make api
# 4. Build service
make build
# 5. Start service
make run# app/gate/configs/config.yaml
server:
tcp:
addr: ":17001"
timeout: 30s
data:
redis:
addr: "127.0.0.1:6379"
registry:
etcd:
endpoints: ["127.0.0.1:2379"]| Module | Description |
|---|---|
| System | Handshake, heartbeat, error handling |
| Player | Player data sync and management |
| Room | Room creation and management |
| Team | Team system |
| Fight | Combat system |
| Chat | Chat system |
| Guild | Guild system |
sequenceDiagram
participant C as ๐ฎ Client
participant J as ๐ฐ Janus
C->>J: Handshake Request (ECDH Public Key + Ed25519 Signature + Token)
Note right of J: Verify signature and token<br/>Calculate shared key<br/>Generate AES key
J->>C: Handshake Response (Server ECDH Public Key + Signature)
loop Game Session
C->>J: AES Encrypted Message
J->>C: AES Encrypted Response
end
| Technology | Version | Purpose |
|---|---|---|
| Go | 1.24+ | Primary development language |
| Kratos | v2.8.4 | Microservice framework |
| fabrica-net | v0.0.35 | Multi-protocol network library |
| gRPC | v1.73.0 | Service communication |
| etcd | v3.6.1 | Service discovery |
| Redis | v9.10.0 | Routing table cache |
| Prometheus | v1.22.0 | Monitoring system |
| gorilla/websocket | v1.5.3 | WebSocket implementation |
| xtaci/kcp-go | v5.6.22 | KCP protocol support |
Janus leverages the powerful fabrica-net library to support multiple network protocols:
- High Performance: Worker pool architecture with bucket-based connection management
- Secure: AES-GCM encryption with ECDH key exchange
- Scalable: Support for tens of thousands of concurrent connections
- Low Latency: Optimized for unreliable network conditions
- Reliable: Forward Error Correction (FEC) and automatic retransmission
- Multiplexed: Stream multiplexing over single UDP connection
- Web Compatible: Direct browser client support
- Real-time: Bi-directional communication
- Path-based: Configurable endpoint routing
| Protocol | Use Case | Latency | Reliability | Firewall Friendly |
|---|---|---|---|---|
| TCP | General game traffic | Medium | High | โ |
| KCP (UDP) | Real-time action games | Low | Medium | |
| WebSocket | Browser-based games | Medium | High | โ |
# Copy configuration template
cp -r app/gate/configs.tmpl/ app/gate/configs/
# Modify service configuration
vim app/gate/configs/config.yaml
# Modify security configuration
vim app/gate/configs/secret.yaml
# Modify registry configuration
vim app/gate/configs/registry.yamlTest with Roma Game Service for complete integration:
# Start Mercury mock client
git clone https://github.com/go-pantheon/roma.git
cd roma && make mercury# Health check
curl http://localhost:18100/health
# Connection statistics
curl http://localhost:18100/stats/connections
# View logs
make logThis project is licensed under the terms specified in the LICENSE file.
โจ High-performance gaming gateway, built for games โจ
Core component of the go-pantheon ecosystem