Skip to content

Commit e092f7a

Browse files
authored
Create README.en.md
1 parent 7cc445d commit e092f7a

File tree

1 file changed

+135
-0
lines changed

1 file changed

+135
-0
lines changed

README.en.md

Lines changed: 135 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,135 @@
1+
[🇨🇳 简体中文](README.md) | [🇺🇸 English](README.en.md)
2+
3+
# BitTorrent Tracker Aggregation Project
4+
5+
[![Update Status](https://github.com/adysec/tracker/workflows/Daily%20Update%20Tracker/badge.svg)](https://github.com/adysec/tracker/actions)
6+
[![License](https://img.shields.io/github/license/adysec/tracker)](LICENSE)
7+
8+
## 📖 Overview
9+
10+
This project automatically collects, tests, and maintains high-quality BitTorrent tracker server lists.
11+
Through a daily automated workflow, it aggregates tracker data from multiple open-source projects, performs connectivity tests, and provides curated lists categorized by protocol.
12+
13+
**We provide a recommended tracker endpoint. By using load-balancing based on the full tracker list from this project, you can effectively join all trackers in this project while significantly reducing concurrent requests to individual tracker servers.**
14+
15+
`https://tracker.adysec.com/announce`
16+
17+
arduino
18+
複製程式碼
19+
Client
20+
21+
22+
Recommended Tracker
23+
24+
┌────┼────┼────┐
25+
▼ ▼ ▼
26+
A B C
27+
28+
markdown
29+
複製程式碼
30+
31+
## 📋 Tracker Lists
32+
33+
This project provides two types of tracker lists: **full** and **best**.
34+
35+
- The **full list** contains all aggregated tracker servers from upstream open-source projects and is suitable when you want maximum coverage.
36+
- The **best list** is strictly filtered by connectivity tests to keep only truly available, high-quality trackers, giving you the best download experience.
37+
38+
To support different use cases, the best list is further categorized by protocol.
39+
You can select the appropriate protocol type based on what your BitTorrent client supports and your network environment.
40+
41+
- `trackers_best.txt` is the **recommended** option.
42+
It includes high-quality trackers of all supported protocols and offers the best compatibility.
43+
- All lists provide both a primary and a backup download source to ensure high availability.
44+
45+
| Type | Protocol | Description | Primary | Backup |
46+
|------|----------|-------------|---------|--------|
47+
| **Full** | All | All aggregated tracker servers (no availability filtering) | [`trackers_all.txt`](https://down.adysec.com/trackers_all.txt) | [`GitHub`](https://raw.githubusercontent.com/adysec/tracker/main/trackers_all.txt) |
48+
| **Best** | All | Connectivity-tested, high-quality trackers (recommended) | [`trackers_best.txt`](https://down.adysec.com/trackers_best.txt) | [`GitHub`](https://raw.githubusercontent.com/adysec/tracker/main/trackers_best.txt) |
49+
| **Best** | HTTP | Only available HTTP trackers | [`trackers_best_http.txt`](https://down.adysec.com/trackers_best_http.txt) | [`GitHub`](https://raw.githubusercontent.com/adysec/tracker/main/trackers_best_http.txt) |
50+
| **Best** | HTTPS | Only available HTTPS trackers | [`trackers_best_https.txt`](https://down.adysec.com/trackers_best_https.txt) | [`GitHub`](https://raw.githubusercontent.com/adysec/tracker/main/trackers_best_https.txt) |
51+
| **Best** | UDP | Only available UDP trackers | [`trackers_best_udp.txt`](https://down.adysec.com/trackers_best_udp.txt) | [`GitHub`](https://raw.githubusercontent.com/adysec/tracker/main/trackers_best_udp.txt) |
52+
| **Best** | WSS | Only available WSS trackers | [`trackers_best_wss.txt`](https://down.adysec.com/trackers_best_wss.txt) | [`GitHub`](https://raw.githubusercontent.com/adysec/tracker/main/trackers_best_wss.txt) |
53+
54+
### ✨ Key Features
55+
56+
- 🛡️ **Secure & Reliable** – Integrates threat intelligence and automatically filters malicious IPs
57+
- 🔄 **Daily Updates** – Tracker lists are refreshed every day to keep them up-to-date
58+
- 📊 **Protocol-Aware** – Supports HTTP, HTTPS, UDP and WSS categorized lists
59+
- 🚀 **High Availability** – Only retains trackers that pass connectivity checks
60+
- 🌐 **Multi-Source Aggregation** – Aggregates tracker resources from 10+ well-known open-source projects
61+
62+
## 🔧 Usage
63+
64+
### Configure in BitTorrent Clients
65+
66+
1. **qBittorrent**
67+
*Tools → Options → BitTorrent → Automatically add these trackers to new downloads → paste the list URL*
68+
69+
2. **Transmission**
70+
*Preferences → Trackers → Add tracker URL*
71+
72+
3. **Other Clients**
73+
Add any of the above URLs in the tracker configuration section.
74+
75+
### Command-Line Usage
76+
77+
```bash
78+
# Get the latest recommended tracker list
79+
curl -s https://down.adysec.com/trackers_best.txt
80+
81+
# Get trackers for a specific protocol (e.g., UDP)
82+
curl -s https://down.adysec.com/trackers_best_udp.txt
83+
🔧 Custom Filtering
84+
Create a blackstr.txt file to filter specific IP addresses or domains:
85+
86+
bash
87+
複製程式碼
88+
# Example: filter malicious IP / domain
89+
echo "192.168.1.100" >> blackstr.txt
90+
echo "malicious-tracker.com" >> blackstr.txt
91+
📊 Data Sources
92+
This project aggregates tracker resources from the following high-quality open-source projects:
93+
94+
ngosang/trackerslist
95+
96+
XIU2/TrackersListCollection
97+
98+
chenjia404/CnTrackersList
99+
100+
hezhijie0327/Trackerslist
101+
102+
DeSireFire/animeTrackerList
103+
104+
NewTrackon
105+
106+
And several other community-maintained projects
107+
108+
💡 Motivation
109+
Many public trackers perform poorly in real-world use and severely degrade download experience.
110+
This project aims to automatically aggregate, test, and filter trackers to provide a truly usable, frequently updated list for both personal use and the community.
111+
112+
By leveraging DHT and various tracker information flows, we can collect more torrent metadata (similar to BTDigg) to search and organize useful content.
113+
However, most public torrents are concentrated in adult content, making it difficult to find valuable resources 🐶.
114+
115+
Any tracker naturally logs clients’ IP and port information, which has threat-intelligence value.
116+
For example, you can observe which countries or regions a torrent is most frequently downloaded from, or quickly estimate the location and impact scope in a data-leak incident based on connection distribution.
117+
118+
⭐ Star History
119+
If this project is helpful to you, please consider giving it a ⭐ on GitHub!
120+
121+
複製程式碼
122+
123+
124+
125+
126+
127+
128+
129+
130+
131+
進階思考
132+
133+
134+
135+
ChatGPT 可能會出錯。請查核重要資訊。

0 commit comments

Comments
 (0)