relay-server

Overview ¶

Command relay-server is a zero-dependency, in-memory relay server for local testing.

It implements the same wire protocol as the production AWS relay (API GW WebSocket + HTTP REST) but runs as a single process with no storage, no token validation, and no TLS — suitable for LAN testing with the CLI agent and the Android app.

Usage:

relay-server [-addr :18080]

# CLI agent (same machine or LAN):
go-openvpn-cli -config tunnel.ovpn -relay testtoken -relay-endpoint ws://192.168.1.12:18080/ws

# Android app: set relay endpoint to http://192.168.1.12:18080/api/v1
#              and org token to  mytoken

Endpoints:

WS  /ws                          Agent connects here
GET /api/v1/agents?token=        List registered agents
POST /api/v1/connect             Reserve an agent, create session
POST /api/v1/session/:id/execute Deliver Phase 2 credentials to agent

Everything is kept in memory. Restart clears all state. Zero-trust mode: any token is accepted, no validation.