Skip to content

feat: vprox edge adds support for edge connectors - #22

Open
luiscape wants to merge 13 commits into
mainfrom
luis/vprox-edge
Open

feat: vprox edge adds support for edge connectors#22
luiscape wants to merge 13 commits into
mainfrom
luis/vprox-edge

Conversation

@luiscape

@luiscape luiscape commented Apr 4, 2026

Copy link
Copy Markdown
Member

vprox edge deploys an outbound-only connector inside a restricted network that establishes a WireGuard tunnel back to the vprox server. It advertises local CIDR routes (via --routes) so that connect clients can reach private resources (databases, internal APIs, etc.) through the server — without opening any inbound ports in the restricted network.

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR introduces edge connectors to vprox, enabling an outbound-only node inside a restricted/private network to establish a WireGuard tunnel back to the vprox server and advertise reachable CIDR routes so connect clients can access private resources through the server.

Changes:

  • Adds a new vprox edge CLI command and corresponding edge client implementation (WireGuard + forwarding/NAT).
  • Extends the server HTTPS control plane with /edge-connect and /edge-disconnect endpoints and route advertisement conflict handling.
  • Updates documentation to explain the edge connector architecture, setup steps, and requirements.

Reviewed changes

Copilot reviewed 5 out of 5 changed files in this pull request and generated 6 comments.

Show a summary per file
File Description
README.md Documents edge connector concept, architecture diagram, setup steps, and feature list update.
main.go Registers the new edge subcommand with the root CLI.
lib/server.go Adds edge peer tracking, route conflict checking, new edge connect/disconnect handlers, and tightens SNAT rule matching by outbound iface.
lib/edge.go Implements the edge connector client: control-plane calls, WireGuard config, forwarding + iptables NAT rules, and tunnel health checks.
cmd/edge.go Adds the vprox edge CLI wiring: route parsing, lifecycle management, and reconnect/healthcheck loop.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread lib/server.go Outdated
Comment thread lib/server.go Outdated
Comment thread lib/server.go
Comment thread lib/server.go
Comment thread lib/edge.go
Comment thread cmd/edge.go
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants