syncthing/cmd/relaysrv
Antony Male e660d683a0 Enable extra logging in pool.go even when -debug not specified
Knowing why a relay server failed to join the pool can be important. This
is typically an issue which must be investigated after it occurred, so
having logs available is useful.

Running with -debug permanently enabled is impractical, due to the amount
of traffic that is generated, particularly when data is being transferred.

Logging is limited to at most one message per minute, although one message
per hour is more likely.
2015-11-06 12:58:44 +00:00
..
etc/linux-systemd Rename relaysrv binary, see #11 2015-10-10 15:24:20 +02:00
testutil Use vendored dependencies, new protocol location 2015-09-22 19:54:20 +02:00
LICENSE Initial commit 2015-06-24 00:34:16 +01:00
listener.go Use vendored dependencies, new protocol location 2015-09-22 19:54:20 +02:00
main.go Allow extAddress to be set from the command line 2015-11-05 21:26:58 +00:00
pool.go Enable extra logging in pool.go even when -debug not specified 2015-11-06 12:58:44 +00:00
README.md Update README.md 2015-09-21 23:07:39 +01:00
session.go Use vendored dependencies, new protocol location 2015-09-22 19:54:20 +02:00
status.go Add CORS headers 2015-10-22 21:44:29 +01:00
utils.go Progress 2015-06-28 19:57:13 +01:00

relaysrv

Latest Build

This is the relay server for the syncthing project.

To get it, run go get github.com/syncthing/relaysrv or download the latest build from the build server.

Warnings - Read or regret

By default, all relay servers will join the default public relay pool, which means that the relay server will be availble for public use, and will consume your bandwidth helping others to connect.

If you wish to disable this behaviour, please specify -pools="" argument.

Please note that relaysrv is only usable by syncthing version v0.12 and onwards.

To run relaysrv you need to have port 22067 available to the internet, which means you might need to allow it through your firewall if you have a public IP, or setup a port-forwarding (22067 to 22067) if you are behind a router.

Running for public use

Make sure you have a public IP with port 22067 open, or make sure you have port-forwarding (22067 to 22067) if you are behind a router.

Run the relaysrv with no arguments (or -debug if you want more output), and that should be enough for the server to join the public relay pool. You should see a message saying:

2015/09/21 22:45:46 pool.go:60: Joined https://relays.syncthing.net rejoining in 48m0s

See relaysrv -help for other options, such as rate limits, timeout intervals, etc.

Running for private use

Once you've started the relaysrv, it will generate a key pair and print an URI:

relay://:22067/?id=EZQOIDM-6DDD4ZI-DJ65NSM-4OQWRAT-EIKSMJO-OZ552BO-WQZEGYY-STS5RQM&pingInterval=1m0s&networkTimeout=2m0s&sessionLimitBps=0&globalLimitBps=0&statusAddr=:22070

This URI contains partial address of the relay server, as well as it's options which in the future may be taken into account when choosing the best suitable relay out of multiple available.

Because -listen option was not used, the relaysrv does not know it's external IP, therefore you should replace the host part of the URI with your public IP address on which the relaysrv will be available:

relay://123.123.123.123:22067/?id=EZQOIDM-6DDD4ZI-DJ65NSM-4OQWRAT-EIKSMJO-OZ552BO-WQZEGYY-STS5RQM&pingInterval=1m0s&networkTimeout=2m0s&sessionLimitBps=0&globalLimitBps=0&statusAddr=:22070

If you do not care about certificate pinning (improved security) or do not care about passing verbose settings to the clients, you can shorten the URL to just the host part:

relay://123.123.123.123:22067

This URI can then be used in syncthing as one of the relay servers.

See relaysrv -help for other options, such as rate limits, timeout intervals, etc.

Other items available in this repo

testutil

A test utility which can be used to test connectivity of a relay server. You need to generate two x509 key pairs (key.pem and cert.pem), one for the client, another one for the server, in separate directories. Afterwards, start the client:

./testutil -relay="relay://uri.of.relay" -keys=certs/client/ -join

This prints out the client ID:

2015/09/21 23:00:52 main.go:42: ID: BG2C5ZA-W7XPFDO-LH222Z6-65F3HJX-ADFTGRT-3SBFIGM-KV26O2Q-E5RMRQ2

In the other terminal run the following:

 ./testutil -relay="relay://uri.of.relay" -keys=certs/server/ -connect=BG2C5ZA-W7XPFDO-LH222Z6-65F3HJX-ADFTGRT-3SBFIGM-KV26O2Q-E5RMRQ2

Which should then give you an interactive prompt, where you can type things in one terminal, and they get relayed to the other terminal.

client

A client library which is used by syncthing

protocol

Go files which define the protocol and it's messages, and a few utility functions which make it easier to consume.