remoteingress/readme.hints.md at 4b06cb1b24b51c0007fda6a30a2487199293ec5d

Files

Juergen Kunz 5321e5f0e0 fix(build): bump dev dependencies, update build script, and refresh README docs

2026-02-17 10:04:54 +00:00

This module is part of the @serve.zone stack
v3.0.0+ uses a Hub/Edge architecture with a Rust core binary (remoteingress-bin)
TypeScript classes RemoteIngressHub and RemoteIngressEdge bridge to Rust via @push.rocks/smartrust RustBridge IPC
Custom multiplexed binary frame protocol over TLS for tunneling TCP connections
PROXY protocol v1 preserves client IP when forwarding to SmartProxy/DcRouter
Edge authenticates to Hub via shared secret over TLS
STUN-based public IP discovery at the edge (Cloudflare STUN server)
Cross-compiled Rust binary for linux/amd64 and linux/arm64
Old ConnectorPublic/ConnectorPrivate classes no longer exist (removed in v2.0.0/v3.0.0)
localPaths in RustBridge config must be full file paths (not directories) — smartrust's RustBinaryLocator checks isExecutable() on each entry directly
Production binaries are named with platform suffixes: remoteingress-bin_linux_amd64, remoteingress-bin_linux_arm64
Rust core uses ring as the rustls CryptoProvider (explicitly installed in main.rs, aws-lc-rs disabled via default-features=false)