BT Tracker // BEP 0007 - IPv6 Tracker Extension

BEP 0007 为 BitTorrent 协议引入了 IPV6 支持。 新增查询参数 ipv4 - 客户端向 Tracker 汇报自己的 IPV4 地址 ipv6 - 客户端向 Tracker 汇报自己的 IPV6 地址 key - 参考标志

BEP 0007 为 BitTorrent 协议引入了 IPV6 支持。

新增查询参数

  • ipv4 - 客户端向 Tracker 汇报自己的 IPV4 地址
  • ipv6 - 客户端向 Tracker 汇报自己的 IPV6 地址
  • key - 参考标志

客户端会生成一个随机的 key,并配合自己的 peer_id 来允许 Tracker 在多次 announce(宣告)期间识别你的客户端。

注1:这个 key 似乎不是很需要的样子,毕竟识别唯一身份 peer_id 可能就够了。

注2:BEP 中说不推荐使用 ipv4/ipv6 参数,可能会允许坏客户端引发拒绝服务攻击(DDoS),但实际上,大部分客户端都这么干了。

当客户端拥有多个 IP 地址时,客户端可能会添加多个 ipv4/ipv6 查询参数到请求中,亦或是通过不同的 IP 地址来发起 GET 请求,以及还有的会上面两种方式一起混合使用来 announce(宣告)自己的全部 IP 地址。具体实现方式取决于各个客户端的实现。

响应

对于 BEP 0003,无需任何修改,保持不变即可。

对于 BEP 0023,新增了一个 peers6 字段,以支持 IPV6 地址。

以下是 Java 示例代码,以生成新的带有 peers6 的 compat 响应:

    @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));
        if (peers.peers6().size() > 0) {
            dict.put("peers6", compactPeers(peers.peers6(), true));
        }
        return dict;
    }

    public static String compactPeers(Collection<Peer> peers, boolean isV6) throws RetryableAnnounceException {
        ByteBuffer buffer = ByteBuffer.allocate((isV6 ? 18 : 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);
    }
String finalResponse = bencode(generatePeersResponseCompat(infoHash, numWant));

示例(使用 JSON 格式以提高可读性)

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

Comment