6 releases (1 stable)
3.0.0 | Oct 3, 2024 |
---|---|
3.0.0-alpha.11 | Sep 18, 2023 |
3.0.0-alpha.3 | Jul 10, 2023 |
3.0.0-alpha.2 | Apr 13, 2023 |
3.0.0-alpha.1 |
|
#212 in Network programming
175 downloads per month
2MB
16K
SLoC
Torrust Tracker
Torrust Tracker is a BitTorrent Tracker that matchmakes peers and collects statistics. Written in Rust Language with the Axum web framework. This tracker aims to be respectful to established standards, (both formal and otherwise).
This is a Torrust project and is in active development. It is community supported as well as sponsored by Nautilus Cyberneering.
Key Features
- High Quality and Modern Rust Codebase.
- Documentation Generated from Code Comments.
- Comprehensive Suit of Unit and Functional Tests.
- Good Performance in Busy Conditions.
- Support for
UDP
,HTTP
, andTLS
Sockets. - Native
IPv4
andIPv6
support. - Private & Whitelisted mode.
- Tracker Management API.
- Support newTrackon checks.
- Persistent
SQLite3
orMySQL
Databases.
Roadmap
Core:
- New option
want_ip_from_query_string
. See https://github.com/torrust/torrust-tracker/discussions/532#issuecomment-1836642956. - Peer and torrents specific statistics. See https://github.com/torrust/torrust-tracker/discussions/139.
Persistence:
- Support other databases like PostgreSQL.
Performance:
- More optimizations. See https://github.com/torrust/torrust-tracker/discussions/774.
Protocols:
- WebTorrent.
Integrations:
- Monitoring (Prometheus).
Utils:
- Tracker client.
- Tracker checker.
Others:
- Support for Windows.
- Docker images for other architectures.
https://github.com/orgs/torrust/projects/10/views/6
Implemented BitTorrent Enhancement Proposals (BEPs)
- BEP 03: The BitTorrent Protocol.
- BEP 07: IPv6 Support.
- BEP 15: UDP Tracker Protocol for BitTorrent.
- BEP 23: Tracker Returns Compact Peer Lists.
- BEP 27: Private Torrents.
- BEP 48: Tracker Protocol Extension: Scrape.
Getting Started
Container Version
The Torrust Tracker is deployed to DockerHub, you can run a demo immediately with the following commands:
Docker
docker run -it torrust/tracker:develop
Please read our container guide for more information.
Podman
podman run -it docker.io/torrust/tracker:develop
Please read our container guide for more information.
Development Version
- Please ensure you have the **latest stable (or nightly) version of rust__.
- Please ensure that your computer has enough RAM. **Recommended 16GB.__
Checkout, Test and Run
# Checkout repository into a new folder:
git clone https://github.com/torrust/torrust-tracker.git
# Change into directory and create a empty database file:
cd torrust-tracker
mkdir -p ./storage/tracker/lib/database/
touch ./storage/tracker/lib/database/sqlite3.db
# Check all tests in application:
cargo test --tests --benches --examples --workspace --all-targets --all-features
# Run the tracker:
cargo run
Customization
# Copy the default configuration into the standard location:
mkdir -p ./storage/tracker/etc/
cp ./share/default/config/tracker.development.sqlite3.toml ./storage/tracker/etc/tracker.toml
# Customize the tracker configuration (for example):
vim ./storage/tracker/etc/tracker.toml
# Run the tracker with the updated configuration:
TORRUST_TRACKER_CONFIG_TOML_PATH="./storage/tracker/etc/tracker.toml" cargo run
Optionally, you may choose to supply the entire configuration as an environmental variable:
# Use a configuration supplied on an environmental variable:
TORRUST_TRACKER_CONFIG_TOML=$(cat "./storage/tracker/etc/tracker.toml") cargo run
For deployment, you should override the api_admin_token
by using an environmental variable:
# Generate a Secret Token:
gpg --armor --gen-random 1 10 | tee ./storage/tracker/lib/tracker_api_admin_token.secret
chmod go-rwx ./storage/tracker/lib/tracker_api_admin_token.secret
# Override secret in configuration using an environmental variable:
TORRUST_TRACKER_CONFIG_TOML=$(cat "./storage/tracker/etc/tracker.toml") \
TORRUST_TRACKER_CONFIG_OVERRIDE_HTTP_API__ACCESS_TOKENS__ADMIN=$(cat "./storage/tracker/lib/tracker_api_admin_token.secret") \
cargo run
Please view our crate documentation for more detailed instructions.
Services
The following services are provided by the default configuration:
- UDP (tracker)
udp://127.0.0.1:6969/announce
.
- HTTP (tracker)
http://127.0.0.1:7070/announce
.
- API (management)
http://127.0.0.1:1212/api/v1/stats?token=MyAccessToken
.
Documentation
You can read the latest documentation from https://docs.rs/.
Some specific sections:
Benchmarking
Contributing
We are happy to support and welcome new people to our project. Please consider our contributor guide.
This is an open-source community-supported project. We welcome contributions from the community!
How can you contribute?
- Bug reports and feature requests.
- Code contributions. You can start by looking at the issues labeled "good first issues".
- Documentation improvements. Check the documentation and API documentation for typos, errors, or missing information.
- Participation in the community. You can help by answering questions in the discussions.
License
Copyright (c) 2023 The Torrust Developers.
This program is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, version 3.
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for more details.
You should have received a copy of the GNU Affero General Public License along with this program. If not, see https://www.gnu.org/licenses/.
Some files include explicit copyright notices and/or license notices.
Legacy Exception
For prosperity, versions of Torrust Tracker that are older than five years are automatically granted the MIT-0 license in addition to the existing AGPL-3.0-only license.
Contributor Agreement
The copyright of the Torrust Tracker is retained by the respective authors.
Contributors agree:
- That all their contributions be granted a license(s) compatible with the Torrust Trackers License.
- That all contributors signal clearly and explicitly any other compilable licenses if they are not: AGPL-3.0-only with the legacy MIT-0 exception.
The Torrust-Tracker project has no copyright assignment agreement.
We kindly ask you to take time and consider The Torrust Project Contributor Agreement in full.
Acknowledgments
This project was a joint effort by Nautilus Cyberneering GmbH and Dutch Bits. Also thanks to Naim A. and greatest-ape for some parts of the code. Further added features and functions thanks to Power2All.
Dependencies
~75MB
~1.5M SLoC