51 lines
1.1 KiB
Markdown
51 lines
1.1 KiB
Markdown
# Trackers
|
|
|
|
A torrent tracker aggregator that polls multiple sources and serves a unified,
|
|
deduplicated list of tracker URLs via HTTP API.
|
|
|
|
**Educational project written in Go 1.25.5**
|
|
|
|
## Features
|
|
|
|
- Polls tracker sources at configurable intervals
|
|
- Supports HTTP/HTTPS and local file sources
|
|
- Deduplicates and validates tracker URLs
|
|
- Persistent disk caching for resilience
|
|
- HTTP proxy support via environment variables
|
|
- Request logging for monitoring
|
|
- Single binary with minimal dependencies
|
|
|
|
## Usage
|
|
|
|
```shell
|
|
trackers -config config.toml
|
|
```
|
|
|
|
Get the aggregated tracker list:
|
|
|
|
```shell
|
|
curl http://127.0.0.1:8080/list
|
|
```
|
|
|
|
## Configuration
|
|
|
|
See [config.dist.toml](config.dist.toml) for a complete configuration example with comments.
|
|
|
|
Copy the example file and customize:
|
|
|
|
```shell
|
|
cp config.dist.toml config.toml
|
|
# Edit config.toml with your sources
|
|
```
|
|
|
|
## Proxy Support
|
|
|
|
HTTP requests respect standard proxy environment variables:
|
|
|
|
```shell
|
|
export HTTP_PROXY=http://proxy.example.com:8080
|
|
export HTTPS_PROXY=http://proxy.example.com:8080
|
|
trackers -config config.toml
|
|
```
|
|
|
|
See [config.dist.toml](config.dist.toml) for details. |