| .github | ||
| bittorrent | ||
| cmd/chihaya | ||
| dist | ||
| docs | ||
| frontend | ||
| middleware | ||
| pkg | ||
| storage | ||
| .golangci.yaml | ||
| .markdownlint.yaml | ||
| .yamllint | ||
| CONTRIBUTING.md | ||
| Dockerfile | ||
| go.mod | ||
| go.sum | ||
| LICENSE | ||
| MAINTAINERS | ||
| README.md | ||
LBRY Tracker
The LBRY tracker is a server that helps peers find each other. It was forked from Chihaya, an open-source BitTorrent tracker.
Installation and Usage
Building from HEAD
In order to compile the project, the latest stable version of Go and knowledge of a working Go environment are required.
git clone git@github.com:lbryio/tracker.git
cd tracker
go build ./cmd/chihaya
./chihaya --help
Testing
The following will run all tests and benchmarks.
Removing -bench will just run unit tests.
go test -bench $(go list ./...)
The tracker executable contains a command to end-to-end test a BitTorrent tracker. See
tracker --help
Configuration
Configuration of the tracker is done via one YAML configuration file.
The dist/ directory contains an example configuration file.
Files and directories under docs/ contain detailed information about configuring middleware, storage implementations, architecture etc.
This is an example for an UDP server running on 6969 with metrics enabled. Remember to change the private key to some random string.
---
tracker:
announce_interval: "30m"
min_announce_interval: "15m"
metrics_addr: "0.0.0.0:6880"
udp:
addr: "0.0.0.0:6969"
max_clock_skew: "10s"
private_key: ">>>>CHANGE THIS TO SOME RANDOM THING<<<<"
enable_request_timing: false
allow_ip_spoofing: false
max_numwant: 100
default_numwant: 50
max_scrape_infohashes: 50
storage:
name: "memory"
config:
gc_interval: "3m"
peer_lifetime: "31m"
shard_count: 1024
prometheus_reporting_interval: "1s"
Contributing
Contributions to this project are welcome, encouraged, and compensated. For more details, please check this link.
License
LBRY's code changes are MIT licensed, and the upstream Chihaya code is licensed under a BSD 2-Clause license. For the full license, see LICENSE.
Security
We take security seriously. Please contact security@lbry.com regarding any security issues. Our PGP key is here if you need it.
Contact
The primary contact for this project is @shyba.