BT Tracker // BEP 0023 - Tracker Returns Compact Peer Lists

BT Tracker // BEP 0023 - Tracker Returns Compact Peer Lists

在 BEP 0003 中,我们介绍了对于 Peers 的响应返回。 但是当对等体过多的时候,peers 字段将会变得相当庞大,而且经过时间证明,其中 peer_id 字段完全可以被省略,没有存在的必要。因此,BitTorrent 对响应做出了改进,以便进一步压缩响应体的大小。 新增查询参数 客户端通

BEP 0003 中,我们介绍了对于 Peers 的响应返回。

但是当对等体过多的时候,peers 字段将会变得相当庞大,而且经过时间证明,其中 peer_id 字段完全可以被省略,没有存在的必要。因此,BitTorrent 对响应做出了改进,以便进一步压缩响应体的大小。

新增查询参数

客户端通过添加 compact 字段指示 Tracker 是否应该返回 compact 样式的响应,以下是一个示例请求:

GET /announce?info_hash=j%25%7c%fe%12%0e%c0%9d%ee6%d5%df%03%bb%fda%cd%7b%97%b5&peer_id=-qB4510-1MTFo0SteXN2&port=22387&uploaded=0&downloaded=0&left=0&corrupt=0&key=332CA113&event=started&numwant=200&compact=1&no_peer_id=1&supportcrypto=1&redundant=0&ipv4=198.18.0.1&ipv6=2408%3a8214%3a2e11%3a8cb1%3a%3a9b8&ipv6=2408%3a8214%3a2e11%3a8cb1%3a7c27%3acac2%3a3b51%3a42fb&ipv6=2408%3a8214%3a2e11%3a8cb1%3ae0e7%3a8eb%3a4677%3a21f0

响应

BEP 0003 基本相同,但 peers 字段内不再是一个 List,而是一个 Bencode 编码的二进制字符串。

对于 BEP 0023 来说,仅支持 IPV4 协议,IPV6 的支持由另一个 BEP 规范引入。

每个 peer 大小为 6 个字节,前 4 为一个 32 为的 IPV4 地址,其余 2 个字节为一个端口号。

地址和端口号使用网络字节序(Big Endian)。

以下是生成一个 peers 的二进制字符串的 Java 示例代码:

    @NotNull
    private Map<String, Object> generatePeersResponseCompat(@NotNull String infoHash, int numWant) throws RetryableAnnounceException {
        PeerResult peers = gatherPeers(infoHash, numWant);
        Map<String, Object> dict = new HashMap<>();
        dict.put("interval", randomInterval());
        dict.put("peers", compactPeers(peers.peers(), false));
        return dict;
    }
     public static String compactPeers(Collection<Peer> peers) throws RetryableAnnounceException {
        ByteBuffer buffer = ByteBuffer.allocate(6 * peers.size());
        for (Peer peer : peers) {
            String ip = peer.getIp();
            try {
                for (byte address : InetAddress.getByName(ip).getAddress()) {
                    buffer.put(address);
                }
                int in = peer.getPort();
                buffer.put((byte) ((in >>> 8) & 0xFF));
                buffer.put((byte) (in & 0xFF));
            } catch (UnknownHostException e) {
                throw new IllegalStateException("incorrect ip format encountered when compact peer ip", 0);
            }
        }
        return convertToString(buffer.array());
    }

     public static String convertToString(byte[] bytes) {
        return new String(bytes,StandardCharsets.ISO_8859_1);
    }

示例响应(使用 JSON 编码以提高可读性):

{
  "interval": 3600,
  "peers": [
       "<binary string>",
       "<binary string>",
       "<binary string>",
       "<binary string>",
       "<binary string>",
       "<binary string>",
       "<binary string>"
  ]
}

Comment