locator

command
v0.3.0-beta.1 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Sep 20, 2026 License: Apache-2.0 Imports: 4 Imported by: 0

README

Locator

The Home Cloud Locator service handles coordinating peer-to-peer connections between Home Cloud devices over the internet. This negotiation is necessary since Home Cloud devices are typically behind a firewall/NAT and so can not connect to each other directly without some sort of aided traversal.

How it Works

Below is a diagram showing the process Home Cloud devices follow to "locate" each other using a Locator service:

The result of this discovery process is that both devices have each others public IP and ports on their respective NATs. Both devices then can attempt connections to each other on those addresses and negotiate a peer-to-peer WireGuard tunnel to each other.

The Locator is no longer needed once the tunnel is established until the connection is broken and then both devices can follow the same process above to relocate each other.

Running a Locator

Documentation

The Go Gopher

There is no documentation for this package.

Directories

Path Synopsis
mock command

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL