Skip to content

Public peers in the Yggdrasil network

Notifications You must be signed in to change notification settings

yggdrasil-network/public-peers

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Public Peers

This repository contains peering information for publicly accessible nodes on the Yggdrasil network.

Note that not all peers in this repository are guaranteed to be online - check the Public Peers page instead to find peers that are online now.

In most cases, public peers should be accessible by adding the string provided for each peer to the Peers: [] section of your yggdrasil.conf configuration file.

Example in yggdrasil.conf:

Peers: [
  tcp://a.b.c.d:e
  tls://d.c.b.a:e
  tcp://[a:b:c::d]:e
  tls://[d:c:b::a]:e
]

How do I pick peers?

If you are new to the network then take a look at the Public Peers page to find public peers that are online.

Always try to pick peers that are as close to you geographically as possible, as this will keep the latency of the network down.

If you are using a home connection, then you should avoid peering with any nodes that are far away, as you may end up carrying traffic for the rest of the network.

For normal usage, you probably only need 2 or 3 peers.

Peering reference

URI format: [protocol]://[host]:[port]?[options]

Available protocols:

  • Cleartext TCP: tcp://
  • TLS: tls://
  • TCP over SOCKS5: socks://[proxyhost]:[proxyport]/[host]:[port]
  • UNIX sockets: unix://
  • QUIC (v0.5.0+): quic://
  • TLS over SOCKS5 (v0.5.2+): sockstls://[proxyhost]:[proxyport]/[host]:[port]
  • WebSocket (v0.5.7+): ws://
  • WebSocket over HTTPS (v0.5.7+): wss://

Yggdrasil supports basic authentication for SOCKS5 using credentials in the URI like this:

socks://[username]:[password]@[proxyhost]:[proxyport]/[host]:[port]

Query options:

  • Public-key authentication: ?key=[publickey] (can have multiple values)
  • Custom SNI (for TLS/QUIC): ?sni=[domain] (default is host if it's domain)
  • Same-peer link priority: ?priority=[integer] (default is 0, maximum 254 for lowest priority)
  • Password authentication (v0.5.0+): ?password=[string] (length up to 64 characters)
  • Maximum back-off time (v0.5.5+): ?maxbackoff=[seconds] (supports duration values like 5m, 1h etc)

About

Public peers in the Yggdrasil network

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published