BitTorrent+协议规范(翻译)

BitTorrent 是一种分发文件的协议。

它通过URL来识别内容，并且可以无缝的和web进行交互。

它基于HTTP协议，它的优势是：如果有多个下载者并发的下载同一个文 件，那么，每个下载者也同时为其它下载者上传文件，这样，文件源可以支持大量的用户进行下载，而只带来适当的负载的增长。

（译注：因为大量的负载被均衡到 整个系统中，所以提供源文件的机器的负载只有少量增长）一个BT文件分布系统由下列实体组成：一个普通的web服务器一个静态的“元信息”文件一个跟踪（tracker）服务器终端用户的web浏览器终端下载者理想的情况是多个终端用户在下载同一个文件。

要提供文件共享，那么一台主机需要执行以下步骤：?运行一个 tracker服务器（或者，已经有一个tracker服务器在运行了也可以）?运行一个web服务器，例如apache，或者已经有一个web服务器在运行了。

?在web服务器上，将文件扩展名.torrent 和MIME类型 application/x-bittorrent关联起来（或者已经关联了）?根据 tracker服务器的 URL 和要共享的文件来创建一个“元信息”文件（.torrent）。

?将“元信息”文件发布到web服务器上?在某个web页面上，添加一个到“元信息”文件的链接。

?运行一个已经拥有完整文件的下载者（被成为’origin’，或者’seed’，种子）要开始下载文件，那么终端用户执行以下步骤：?安装 BT（或者已经安装）?访问提供 .torrent 文件的web服务器?点击到 .torrent 文件的链接（译注：这时候，bt会弹出一个对话框）?选择要把下载的文件保存到哪里？或者是一次断点续传?等待下载的完成。

?结束bt程序的运行（如果不主动结束，那么bt会一直为其它人提供文件上传）各个部分之间的连通性如下：网站负责提供一个静态的文件，而把BT辅助程序（客户端）放在客户端机器上。

Trackers从所有下载者处接收信息，并返回给它们一个随机的peers的列表。

这种交互是通过HTTP或HTTPS协议来完成的。

下载者周期性的向tracker登记，使得tracker能了解它们的进度；下载者之间通过直接连接进行数据的上传和下载。

这种连接使用的是 BitTorrent 对等协议，它基于T C P。

O rigin只负责上传，从不下载，因为它已经拥有了完整的文件。

O rigin是必须的。

元文件和tracker的响应都采用的是一种简单、有效、可扩展的格式，被称为bencoding，它可以包含字符串和整数。

由于对不需要的字典关键字可以忽略，所以这种格式具有可扩展性，其它选项以后可以方便的加进来。

Bencoding格式如下：对于字符串，首先是一个字符串的长度，然后是冒号，后面跟着实际的字符串，例如：4:spa m，就是“ spa m”整数编码如下，以 ‘i’ 开始，然后10进制的整数值，最后以’e’结尾。

例如，i3e表示3，I-3e 表示-3。

整数没有大小限制。

I-0e是无效的。

除了 i0e外，所以以0起始的整数都无效。

I0e 当然表示0。

列表编码如下，以’l’开始，接下来是列表值的编码（也采用bencoded编码），最后以’e’结束。

例如：l4:spa m4:eggse 表示[‘spa m’,‘eggs’]。

字典编码如下，以’d’开始，接下来是可选的ke y s和它对应的值，最户以’e’结束。

例如：d3:cow3:m oo4:spa m4:eggse，表示{‘cow’:’m oo’,’spa m’:’eggs’}，而d4:spa m l1:al:bee 表示{‘spa m’:[‘a’,’b’]}。

键值必须是字符串，而且已经排序（并非是按照字母顺序排序，而是根据原始的字符串进行排序）。

元文件是采用bencoded编码的字典，包括以下关键字：anno u nce tracker的服务器in f o 它实际上是一个字典，包括以下关键字：N a m e：一个字符串，在保存文件的时候，作为一个建议值。

仅仅是个建议而已，你可以用别的名字保存文件。

Piece length：为了更好的传输，文件被分隔成等长的片断，除了最后一个片断以外，这个值就是片断的大小。

片断大小几乎一直都是2的幂，最常用的是 256k（BT的前一个版本3.2，用的是1M作为默认大小）Pieces：一个长度为20的整数倍的字符串。

它将再被分隔为20字节长的字符串，每个子串都是相应片断的hash值。

此外，还有一个length或f iles的关键字，这两个关键字只能出现一个。

如果是length，那么表示要下载的仅仅是单个文件，如果是f iles那么要下载的是一个目录中的多个文件。

如果是单个文件，那么length是该文件的长度。

为了能支持其它关键字，对于多个文件的情况，也把它当作一个文件来看，也就是按照文件出现的顺序，把每个文件的信息连接起来，形成一个字符串。

每个文件的信息实际上也是一个字典，包括以下关键字：Length：文件长度Path：子目录名称的列表，列表最后一项是文件的实际名称。

（不允许出现列表为空的情况）。

N a m e：在单文件情况下，na m e是文件的名称，而在多文件情况下，na m e是目录的名称。

Tracker 查询。

Trakcer通过HTTP的G ET命令的参数来接收信息，而响应给对方（也就是下载者）的是经过bencoded编码的消息。

注意，尽管当前的 tracker的实现需要一个web服务器，它实际上可以运行的更轻便一些，例如，作为apache的一个模块。

Tracker G ET re qu ests ha v e the f ollowing ke y s:发送给Tracker的G ET请求，包含以下关键字：In f o_hash：元文件中in f o部分的sha hash，20字节长。

这个字符创几乎肯定需要被转义（译注：在URL中，有些字符不能出现，必须通过u nicode进行编码）Peer_id：下载者的id，一个20字节长的字符串。

每个下载者在开始一次新的下载之前，需要随机创建这个id。

这个字符串通常也需要被转义。

Ip：一个可选的参数，给出了peer的ip地址（或者dns名称？）。

通常用在origin身上，如果它和tracker在同一个机器上。

Port：peer所监听的端口。

下载者通常在在 6881 端口上监听，如果该端口被占用，那么会一直尝试到 6889，如果都被占用，那么就放弃监听。

Uploaded：已经上载的数据大小，十进制表示。

D ownloaded：已经下载的数据大小，十进制表示Le f t：该peer还有多少数据没有下载完，十进制表示。

注意，这个值不能根据文件长度和已下载数据大小计算出来，因为很可能是断点续传，如果因为检查文件完整性失败而必须重新下载的时候，这也提供了一个机会。

E v ent：一 个可选的关键字，值是started、co m pted或者stopped之一（也可以为空，不做处理）。

如果不出现该关键字，。

在一次下载刚开始的时候， 该值被设置为started，在下载完成之后，设置为co m pleted。

如果下载者停止了下载，那么该值设置为stopped。

Tracker 的响应是用bencoded编码的字典。

如果tracker的响应中有一个关键字f ail u re reason，那么它对应的是一个字符串，用来解释查询失败的原因，其它关键字都不再需要了。

否则，它必须有两个关键字：Inter v al：下载者在两次 发送请求之间的时间间隔。

Peers:一个字典的列表，每个字典包括以下关键字：Peer id，Ip，Port，分别对应peer所选择的id、ip地址或者dns名称、端口号。

注意，如果某些事件发生，或者需要更多的peers，那么下载者 可能不定期的发送请求，（downloader 通过 HTTP 的G ET 命令来向 tracker 发送查询请求，tracker 响应一个peers的列表）如果你想对元信息文件或者tracker查询进行扩展，那么需要同Bra m C ohen协调，以确保所有的扩展都是兼容的。

BT对等协议基于T C P，它很有效率，并不需要设置任何socket选项。

（译注：BT对等协议指的是peer与peer之间交换信息的协议）对等的两个连接是对称的，消息在两个方向上同样的传递，数据也可以在任何一个方向上流动。

一旦某个peer下载完了一个片断，并且也检查了它的完整性，那么它就向它所有的peers宣布它拥有了这个片断。

连接的任何一端都包含两比特的状态信息：是否choked，是否感兴趣。

C hoking是通知对方，没有数据可以发送，除非u nchoking发生。

C hoking的原因以及技术后文解释。

一 旦一端状态变为interested，而另一端变为非choking，那么数据传输就开始了。

（也就是说，一个peer，如果想从它的某个peer那里得 到数据，那么，它首先必须将它两之间的连接设置为 interested，其实就是发一个消息过去，而另一个peer，要检查它是否应该给这个家伙发送数据，如果它对这个家伙是 u nchoke，那么就可以给它发数据，否则还是不能给它数据）Interested状态必须一直被设置――任何时候。

要用点技巧才能比较好的实现这个目 的，但它使得下载者能够立刻知道哪些peers将开始下载。

对等协议由一个握手开始，后面是循环的消息流，每个消息的前面，都有一个数字来表示消息的长度。

握手的过程首先是先发送19，然后发送“BitTorrent protocol”。

19就是“BitTorrent protocol”的长度。

后续的所有的整数，都采用big-endian 来编码为4个字节在协议名称之后，是8个保留的字节，这些字节当前都设置为0。

接下来对元文件中的 in f o 信息，通过 sha1计算后得到的 hash值，20个字节长。

接收消息方，也会对 in f o 进行一个 hash 运算，如果这两个结果不一样，那么说明对方要的文件，并不是自己所要提供的，所以切断连接。

接下来是20个字节的 peer id。

这就是握手过程接下来就是以消息长度开始的消息流，这是可选的。

长度为0 的消息，用于保持连接的活动状态，被忽略。

通常每隔2分钟发送一个这样的消息。

其它类型的消息，都有一个字节长的消息类型，可能的值如下：‘choke’,‘u nchoe’,‘interested’, not interested’类型的消息不再含有其它数据了。

‘bit f ield’永远也仅仅是第一个被发送的消息。

它的数据实际是一个位图，如果downloader已经发送了某个片断，那么对应的位置1，否则置0。