DGate v2 - Rust Edition

A high-performance API Gateway written in Rust, featuring JavaScript module support via QuickJS engine.

Features

• High Performance: Built with Rust and async I/O using Tokio
• Dynamic Routing: Configure routes, services, and domains dynamically via Admin API
• Namespace Isolation: Organize resources into namespaces for multi-tenancy
• Simple KV Storage: Document storage without JSON schema requirements
• TLS Support: HTTPS with dynamic certificate loading per domain
• Reverse Proxy: Forward requests to upstream services with load balancing support

Supported

• HTTP/1.1 ✅
• HTTP/2 ✅
• WebSocket ✅
• gRPC ✅
• QUIC/HTTP3 ❌

Resource Diagram

┌─────────────────────────────────────────────────────────────┐
│ DGate V2 │
├─────────────────────────────────────────────────────────────┤
│ │
│ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ │
│ │ Domains │───▶│ Namespaces │───▶│ Routes │ │
│ └─────────────┘ └─────────────┘ └─────────────┘ │
│ │ │
│ ▼ │
│ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ │
│ │ Modules │◀───│ Handler │───▶│ Services │ │
│ │ (QuickJS) │ └─────────────┘ │ (Upstream) │ │
│ └─────────────┘ └─────────────┘ │
│ │
│ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ │
│ │ Documents │ │ Secrets │ │ Collections │ │
│ │ (KV) │ └─────────────┘ └─────────────┘ │
│ └─────────────┘ │
│ │
└─────────────────────────────────────────────────────────────┘

Installation

From Cargo (crates.io)

cargo install dgate

From Source

git clone https://github.com/dgate-io/dgate.git
cd dgate
cargo build --release

Docker

# Pull from GitHub Container Registry
docker pull ghcr.io/dgate-io/dgate:latest
# Run with a config file
docker run -d \
-p 80:80 -p 443:443 -p 9080:9080 \
-v $(pwd)/config.yaml:/app/config.yaml \
ghcr.io/dgate-io/dgate:latest

Quick Start

Run

# With default config
./target/release/dgate-server
# With custom config
./target/release/dgate-server -c config.dgate.yaml

Configuration

Create a config.dgate.yaml file:

version: v1log_level: infostorage:
type: filedir: .dgate/data/proxy:
port: 80host: 0.0.0.0admin:
port: 9080host: 0.0.0.0

Resources

Namespaces

Namespaces organize resources and provide multi-tenancy:

# Create a namespace
curl -X PUT http://localhost:9080/api/v1/namespace/myapp \
-H "Content-Type: application/json" \
-d '{"tags": ["production"]}'

Services

Services define upstream endpoints:

curl -X PUT http://localhost:9080/api/v1/service/myapp/backend \
-H "Content-Type: application/json" \
-d '{ "urls": ["http://backend-1:8080", "http://backend-2:8080"], "request_timeout_ms": 30000, "retries": 3 }'

Routes

Routes match incoming requests to services:

curl -X PUT http://localhost:9080/api/v1/route/myapp/api-route \
-H "Content-Type: application/json" \
-d '{ "paths": ["/api/**"], "methods": ["GET", "POST", "PUT", "DELETE"], "service": "backend", "strip_path": true }'

Modules

JavaScript modules for request/response processing:

# Create a module
curl -X PUT http://localhost:9080/api/v1/module/myapp/auth-check \
-H "Content-Type: application/json" \
-d '{ "moduleType": "javascript", "payload": "BASE64_ENCODED_JAVASCRIPT" }'

Module Functions:

// Modify request before proxyingfunctionrequestModifier(ctx){ctx.request.headers['X-Custom']='value';}// Handle request without upstream (serverless-style)functionrequestHandler(ctx){ctx.setStatus(200);ctx.json({message: 'Hello from DGate!'});}// Modify response after upstreamfunctionresponseModifier(ctx,res){res.headers['X-Processed']='true';}// Handle errorsfunctionerrorHandler(ctx,error){ctx.setStatus(500);ctx.json({error: error.message});}// Custom upstream URL selectionfunctionfetchUpstreamUrl(ctx){return'http://custom-backend:8080';}

Domains

Control ingress traffic routing:

curl -X PUT http://localhost:9080/api/v1/domain/myapp/main \
-H "Content-Type: application/json" \
-d '{ "patterns": ["*.myapp.com", "myapp.local"], "priority": 10 }'

Collections & Documents

Simple KV storage:

# Create a collection
curl -X PUT http://localhost:9080/api/v1/collection/myapp/users \
-H "Content-Type: application/json" \
-d '{"visibility": "private"}'# Create a document
curl -X PUT http://localhost:9080/api/v1/document/myapp/users/user-123 \
-H "Content-Type: application/json" \
-d '{ "data": { "name": "John Doe", "email": "john@example.com" } }'# Get document
curl http://localhost:9080/api/v1/document/myapp/users/user-123

Secrets

Store sensitive data:

curl -X PUT http://localhost:9080/api/v1/secret/myapp/api-key \
-H "Content-Type: application/json" \
-d '{"data": "sk-secret-key-123"}'

API Reference

Admin Endpoints

Method	Path	Description
GET	/	Root info
GET	/health	Health check
GET	/readyz	Readiness check
GET	/api/v1/namespace	List namespaces
PUT	/api/v1/namespace/:name	Create/update namespace
DELETE	/api/v1/namespace/:name	Delete namespace
GET	/api/v1/route	List routes
PUT	/api/v1/route/:ns/:name	Create/update route
DELETE	/api/v1/route/:ns/:name	Delete route
GET	/api/v1/service	List services
PUT	/api/v1/service/:ns/:name	Create/update service
DELETE	/api/v1/service/:ns/:name	Delete service
GET	/api/v1/module	List modules
PUT	/api/v1/module/:ns/:name	Create/update module
DELETE	/api/v1/module/:ns/:name	Delete module
GET	/api/v1/domain	List domains
PUT	/api/v1/domain/:ns/:name	Create/update domain
DELETE	/api/v1/domain/:ns/:name	Delete domain
GET	/api/v1/collection	List collections
PUT	/api/v1/collection/:ns/:name	Create/update collection
DELETE	/api/v1/collection/:ns/:name	Delete collection
GET	/api/v1/document?namespace=x&collection=y	List documents
PUT	/api/v1/document/:ns/:col/:id	Create/update document
DELETE	/api/v1/document/:ns/:col/:id	Delete document
GET	/api/v1/secret	List secrets
PUT	/api/v1/secret/:ns/:name	Create/update secret
DELETE	/api/v1/secret/:ns/:name	Delete secret
GET	/api/v1/changelog	List change logs

Environment Variables

Variable	Description	Default
LOG_LEVEL	Logging level	info
PORT	Proxy server port	80
PORT_SSL	HTTPS port	443
DG_DISABLE_BANNER	Disable startup banner	-

Performance

DGate v2 is built for high performance:

• Async I/O: Non-blocking operations with Tokio
• Zero-copy: Efficient buffer handling
• Connection Pooling: Reuse upstream connections
• Module Caching: Compiled JS modules are cached

Comparison with v1 (Go)

Feature	v1 (Go)	v2 (Rust)
Runtime	Go 1.21+	Rust 1.75+
JS Engine	goja	QuickJS (rquickjs)
HTTP	chi/stdlib	axum/hyper
Storage	badger/file	redb/memory
Documents	JSON Schema	Simple KV

Development

Running Tests

# Unit tests
cargo test# Functional tests
./functional-tests/run-all-tests.sh
# Performance tests (requires k6)
./perf-tests/run-tests.sh quick

Building for Release

cargo build --release

License

MIT License