hdspace-devbridge

Developer tunnel service for HDSPACE-DEV — secure tunneling between local development environments and remote devices.

Overview

hdspace-devbridge provides secure, persistent tunnels that expose local development services to remote devices over the internet. It is inspired by Microsoft Dev Tunnels and cloudflared.

Architecture

┌─────────────┐     ┌─────────────────┐     ┌──────────────┐
│  Local Dev  │────▶│  devbridged     │────▶│  Remote      │
│  Service    │     │  (server)       │     │  Device      │
│  :8080      │     │  tunnel relay   │     │              │
└─────────────┘     └─────────────────┘     └──────────────┘
                          ▲
                          │
                    ┌─────┴─────┐
                    │ dashboard │  Web UI for tunnel management
                    └───────────┘
                          ▲
                          │
                    ┌─────┴─────┐
                    │   cli     │  Command-line client
                    └───────────┘

Components

Component	Language	Binary	Description
server	Go	devbridged	Tunnel relay server (PID 1 daemon)
cli	Go	devbridge	Command-line client for tunnel management
dashboard	TypeScript	—	Web console for tunnel management

Quick Start

Prerequisites

• Go 1.22+
• Node.js 20+ with pnpm
• Docker

Build

# Build a specific component
make build COMPONENT=server
make build COMPONENT=cli

# Build all
make build-all

Run

# Start the tunnel server
./components/server/bin/devbridged --port 13000

# Connect via CLI
./components/cli/bin/devbridge connect --server ws://localhost:13000 --port 8080

Development

See CONTRIBUTING.md for development setup and guidelines.

Project Structure

hdspace-devbridge/
├── components/
│   ├── server/          # Tunnel relay server (Go)
│   ├── cli/             # CLI client (Go)
│   └── dashboard/       # Web console (TypeScript)
├── install/             # Deployment manifests (Helm)
├── docs/                # Architecture, ADR, design docs
├── scripts/             # Repository-level scripts
├── .github/workflows/   # CI pipelines
├── Makefile             # Root orchestration
└── go.work              # Go workspace

License

MIT — see LICENSE.