mirror of
https://github.com/syncthing/syncthing.git
synced 2026-11-20 17:11:27 -08:00
This implements a new peer-to-peer-based discovery protocol. - The DHT is based on libp2p (of IPFS etc) and constitutes a new, separate Syncthing-specific network. It does not piggyback on any existing non-Syncthing nodes out there. - It uses existing device IDs as the keys, and publishes discovery documents that include the device certificate and are signed by the same. This enables validation that the discovery data is _for_ the right device ID, as well as published _by_ that device. - The DHT runs on the QUIC socket, so it shares UPnP/NAT-PMP whole punches and STUN discovery. (Unless the QUIC listener is disabled, then it runs on an ephemeral socket and can effectively do only queries and not participate as a full DHT node.) - There is a hardcoded default pointing to three bootstrap nodes hosted in the usual manner. - Currently it's strictly additive -- it runs separately and in parallell with the usual global discovery. Once proven and scaled, it will gradually take over the duties of the global discovery. - There is a new command line tool `stdht` which just runs a DHT node to assist with discovery (the bootstrap nodes are this). The diff is large and terrifying, but that's how it is. Signed-off-by: Jakob Borg <[email protected]>
48 lines
1.3 KiB
Go
48 lines
1.3 KiB
Go
// Copyright (C) 2015 The Syncthing Authors.
|
|
//
|
|
// This Source Code Form is subject to the terms of the Mozilla Public
|
|
// License, v. 2.0. If a copy of the MPL was not distributed with this file,
|
|
// You can obtain one at https://mozilla.org/MPL/2.0/.
|
|
|
|
package discover
|
|
|
|
import (
|
|
"context"
|
|
"net/netip"
|
|
"time"
|
|
|
|
"github.com/syncthing/syncthing/lib/protocol"
|
|
"github.com/thejerf/suture/v4"
|
|
)
|
|
|
|
// A Finder provides lookup services of some kind.
|
|
type Finder interface {
|
|
Lookup(ctx context.Context, deviceID protocol.DeviceID) (address []string, err error)
|
|
Error() error
|
|
String() string
|
|
Cache() map[protocol.DeviceID]CacheEntry
|
|
}
|
|
|
|
type CacheEntry struct {
|
|
Addresses []string `json:"addresses"`
|
|
when time.Time // When did we get the result
|
|
found bool // Is it a success (cacheTime applies) or a failure (negCacheTime applies)?
|
|
validUntil time.Time // Validity time, overrides normal calculation
|
|
instanceID int64 // for local discovery, the instance ID (random on each restart)
|
|
}
|
|
|
|
// A FinderService is a Finder that has background activity and must be run as
|
|
// a suture.Service.
|
|
type FinderService interface {
|
|
Finder
|
|
suture.Service
|
|
}
|
|
|
|
// The AddressLister answers questions about what addresses we are listening
|
|
// on.
|
|
type AddressLister interface {
|
|
ExternalIPs() []netip.Addr
|
|
ExternalAddresses() []string
|
|
AllAddresses() []string
|
|
}
|