Does aria2 support BitTorrent Web-Seeding?

Yes, aria2 fully supports Web-Seeding (HTTP/FTP seeding) for BitTorrent downloads. It natively implements the BitTorrent Web-Seeding extension, allowing it to fetch file pieces directly from standard HTTP, HTTPS, or FTP servers when traditional BitTorrent peers are unavailable or slow. Beyond merely downloading from web seeds, aria2 features a unique multi-protocol engine that can seamlessly bridge ecosystem gaps by uploading data downloaded via HTTP/FTP directly back into the BitTorrent peer swarm.

How Web-Seeding Works in aria2

When you load a .torrent file or a Magnet link that contains Web-Seed URIs (often defined via the url-list key in the torrent metadata), aria2 treats those web servers as alternative sources.

• Parallel Downloading: aria2 can request specific chunks from the HTTP/FTP server using standard byte-range requests. It pipelines these requests to match the torrent’s piece size, minimizing connection overhead.
• Hybrid Swarm Contribution: If you are downloading a hybrid file, aria2 can pull data down from the HTTP/FTP web seed, verify its integrity against the torrent piece hashes, and then immediately upload those completed pieces to other BitTorrent peers in the swarm.

Usage and Configuration

You do not need to pass any special flags to enable Web-Seeding, as aria2 processes the web-seed list automatically if it is embedded in the torrent. However, you can control and optimize how aria2 interacts with these web sources using several command-line options.

Adjusting Web Connection Settings

Because web seeds rely on standard web protocols, options that dictate HTTP/FTP behavior will alter how aria2 handles Web-Seeding:

aria2c --max-connection-per-server=4 --max-file-not-found=3 sample.torrent

• --max-connection-per-server=<NUM>: Adjusts how many parallel connections aria2 can open to a single HTTP/FTP web seed server.
• --max-file-not-found=<NUM>: Defines how many times aria2 can encounter a “404 Not Found” error from the web seed before giving up on that specific host and relying strictly on P2P peers.