e660d683a0
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. |
||
|---|---|---|
| .. | ||
| etc/linux-systemd | ||
| testutil | ||
| LICENSE | ||
| listener.go | ||
| main.go | ||
| pool.go | ||
| README.md | ||
| session.go | ||
| status.go | ||
| utils.go | ||
relaysrv
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.