磁力連接

磁力連結（Magnet URI scheme），是對等網絡中進行資訊檢索和下載文件的電腦程式。和基於「位置」連接的統一資源定位符不同，磁力連結是基於元數據檔案內容，屬於統一資源名稱。也就是說，磁力連結不基於文件的IP位址或定位符，而是在分散式資料庫中，通過雜湊函數值來辨識、搜尋來下載文件。因為不依賴一個處於啟動狀態的主機來下載文件，所以特別適用沒有中心伺服器的對等網絡。它符合開源標準。

「Magnet」重新導向至此。關於其他用法，請見「Magnet (消歧義)」。

歷史

這個標準的草稿出現於2002年，是為了對eDonkey2000的「ed2k:」和Freenet的「freenet:」兩個URI格式進行「廠商與專案中立化」（vendor- and project-neutral generalization）而制定的。同時這個標準也嘗試緊密地跟進IETF官方的URI標準。

內容雜湊函數的應用

磁力連結最常見的用途是基於檔案內容的雜湊函數值來連結到特定檔案，生成一個唯一的檔案識別碼，類似於ISBN。不像常規的識別碼，內容雜湊可以被任意一位持有此檔案的人生成，所以並不需要一個中心機構，這使其在檔案共用領域經常被用作搜尋條件，因任何人都可以分發一個磁力連結來確保該連結指向的資源就是他想要的，而和得到該資源的方式無關。（雖然技術上講，兩個不同的檔案可能具有相同的雜湊值，但實際上這是極不可能發生的）

另一個磁力連結的優勢是開放性和跨平台性：一個磁力連結可被執行在幾乎所有平台上的應用程式們使用以下載一個檔案。因為磁力連結十分簡潔且為純文字格式，所以用戶可以很方便地將其複製到電子郵件或即時訊息中，比如種子檔案。

技術描述

磁力連結由一組參陣列成，參數間的順序沒有講究，其格式與在HTTP連結末尾的查詢字串相同。最常見的參數是"xt"，是"exact topic"的縮寫，通常是一個特定檔案的內容雜湊函數值形成的URN，例如：

magnet:?xt=urn:sha1:YNCKHTQCWBTRNJIV4WNAE52SJUQCZO5C

其值是Base32（英語：Base32）編碼的檔案的SHA-1雜湊。

注意，雖然這個連結指向一個特定檔案，但是客戶端應用程式仍然必須進行搜尋來確定哪裏，如果有，能夠取得那個檔案。

在標準的草稿中其他參數的定義如下:

• "dn" ("顯示名稱"）:為了方便，為用戶顯示檔案名稱

• "kt" ("關鍵字"):更籠統的搜尋，指定搜尋鍵碼而不是特定檔案

• "mt" ("檔案列表"):一個URI指向一個列表，例如一個專案列表

• 應用程式定義的實驗參數，必須以"x."開頭

標準還建議同類的多個參數可以在參數名稱後面加上".1", ".2"等來使用，例如

magnet:?xt.1=urn:sha1:YNCKHTQCWBTRNJIV4WNAE52SJUQCZO5C&xt.2=urn:sha1:TXGCZQTH26NL6OUQAJJPFALHG2LTGBC7

描述

磁力連結可以包括一個或多個參數，之間用'&'隔開。參數的順序在檔案在標準中沒有記錄。有一些參數的值對於客戶端正確解析磁力連結很重要。

   magnet:? xl = [位元組大小]& dn = [檔案名（已編碼URL）]& xt = urn: tree: tiger: [ TTH hash（Base32）]

參數

• dn（顯示名稱）- 檔名
• xl（絕對長度）- 檔案位元組數
• xt（eXact Topic）- 包含檔案雜湊函數值的URN
• as（可接受來源） - 線上檔案的網絡連結
• xs（絕對資源）- P2P連結
• kt（關鍵字）- 用於搜尋的關鍵字
• mt（檔案列表）- 連結到一個包含磁力連結的元檔案 (MAGMA - MAGnet MAnifest （頁面存檔備份，存於互聯網檔案館））
• tr（Tracker地址）- BT下載的Tracker URL

xt參數

磁力連結的這部分最重要。用於尋找和驗證包含着磁力連結中的檔案。

TTH（Tiger Tree雜湊函數）

TigerTree雜湊函數被用在包括Direct Connect (protocol)（英語：Direct Connect (protocol)）和Gnutella2（英語：Gnutella2）在內的幾個網絡中。

xt=urn:tree:tiger:[ TTH Hash（Base32（英語：Base32））]

SHA-1（安全雜湊演算法1）

Gnutella和Gnutella2（英語：Gnutella2）使用的雜湊函數。

xt=urn:sha1:[ SHA-1 Hash（Base32（英語：Base32））]

BitPrint（英語：BitPrint）

這種雜湊函數包含一個SHA-1雜湊函數和一個TTH雜湊函數，用"."隔開。

Gnutella和Gnutella2（英語：Gnutella2）使用。

xt=urn:bitprint:[ SHA-1 Hash（Base32（英語：Base32））].[ TTH Hash（Base32（英語：Base32））]

eD2k Hash（eDonkey2000）雜湊函數

eDonkey2000使用的雜湊函數演算法。

xt=urn:ed2k:[ ED2K Hash（Hex）]

AICH（進階智能型損壞處理）

不是正式的磁力連結的一部分。eDonkey2000使用的雜湊函數演算法，用於儲存和控制下載完成、正在下載的檔案的完整性。

xt=urn:aich:[ aich Hash（Base32（英語：Base32））]

Kazaa（英語：Kazaa）雜湊函數

FastTrack（英語：FastTrack）使用的雜湊函數演算法。

xt=urn:kzhash:[ Kazaa（英語：Kazaa） Hash（Hex）]

BTIH（BitTorrent Info Hash）

BitTorrent使用的雜湊函數演算法。出於向下相容的考慮，客戶端需要同時支援被Base32（英語：Base32）編碼過^[1]的BTIH雜湊結果。

xt=urn:btih:[ BitTorrent Info Hash（Hex）]

MD5（資訊-摘要演算法5）

Gnutella2（英語：Gnutella2）支援的雜湊函數演算法。

xt=urn:md5:[ MD5 Hash（Hex）]

CRC-32（迴圈冗餘校驗）

不是正式的磁力連結的一部分。沒有任何已知的P2P網絡使用。

xt=urn:crc32:[ CRC-32（Base10）]

網絡連結至檔案

有兩種可以插入到磁力連結的下載連結作為直接或者備用資源。

普通連結（as）

"as"的意思是"acceptable source"。這種連結指向從網絡伺服器的直接下載。只有在指定的逾時後才會連結，防止伺服器過載。客戶端在考慮向伺服器傳送下載請求前會先花一定時間在P2P網絡中定位檔案。

as=[檔案的網路連結（已編碼URL）]

P2P連結（xs）

連結可以是連結到磁力連結的檔案的HTTP（SHTTP、FTP、SFTP等）下載源、檔案的P2P源地址或是hub（使用DC++時）地址。對於這一連結，客戶端嘗試直接連結，並請求檔案或其來源，有時會同時請求二者。這一欄位常被P2P客戶端用來儲存源。參照中可能包含檔案hash。

內容定址網絡（CAN）URL

這類連結被Gnutella還有G2應用程式使用，基於RFC 2168。

xs=http://[客户端地址]:[客户端端口]/uri-res/N2R?[包含一个文件hash的URN ]

例：

xs=http://192.0.2.0.27:6346/uri-res/N2R?urn:sha1:FINYVGHENTHSMNDSQQYDNLPONVBZTICF

連結到DirectConnect（英語：DirectConnect） hub並為檔案尋找源

這一連結立即將DirectConnect客戶端連接到剛才討論的hub。

xs=dchub://[hub 地址]:[hub端口]

為Gnutella2（英語：Gnutella2）上的檔案參照基於網絡的源快取

這種情況下，連結包含的點不是客戶端IP或直接來源，而是來源快取。這樣的快取並不包含檔案本身，而是儲存了其他客戶端的IP，這些客戶端連接到快取來下載相同的檔案。一旦客戶端連接到快取並獲得其他替代來源的IP，其自身IP就會存入到快取中，然後繼續連接到下一個快取，繼續請求替代來源。這種系統類似於BitTorrent tracker的操作。

xs=http://cache.freebase.be/[ SHA-1 hash ]

參照ED2K源

xs=ed2k://[客户端地址]:[客户端端口]/[ed2k hash]/[文件大小]/

檔案列表（mt）

這是一個導向一系列連連結列表（也許是個網頁）的連結……

mt=http://weblog.foo/all-my-favorites.rss

或者是一個URN

mt=urn:sha1:3I42H3S6NNFQ2MSVX7XZKYAYSCX5QBYJ

關鍵字（kt）

該部分代表了一串用於P2P網絡搜尋用的關鍵字

kt=martin+luther+king+mp3

Tracker地址（tr）

Tracker URL.用於在不需要分散式雜湊表支援下下載BitTorrent資源。

tr=http://example.com/announce

補充格式（x.）

對於實驗性且自補的非正式選項，可以使用字首x後加已選擇的第二個字母

x.[新參數名]=[新參數資料（已編碼URL）]

參陣列

通過在每個參數後編號並用"."來分隔允許一個Magnet連結中包含多個檔案及它們URN,檔名和雜湊函數值。

magnet:?xt.1=[第一個檔案的URN]&xt.2=[第二個檔案的URN]

範例

連結到一個0位元組長度的檔案。

magnet:?xt=urn:ed2k:31D6CFE0D16AE931B73C59D7E0C089C0&xl=0&dn=zero_len.fil&xt=urn:bitprint:3I42H3S6NNFQ2MSVX7XZKYAYSCX5QBYJ.LWPNACQDBZRYXW3VHJVCJ64QBZNGHOHHHZWCLNQ&xt=urn:md5:D41D8CD98F00B204E9800998ECF8427E

mediawiki-1.15.1.tar.gz

magnet:?xt=urn:ed2k:354B15E68FB8F36D7CD88FF94116CDC1&xl=10826029&dn=mediawiki-1.15.1.tar.gz&xt=urn:tree:tiger:7N5OAMRNGMSSEUE3ORHOKWN4WWIQ5X4EBOOTLJY&xt=urn:btih:QHQXPYWMACKDWKP47RRVIV7VOURXFE5Q&tr=http%3A%2F%2Ftracker.example.org%2Fannounce.php%3Fuk%3D1111111111%26&as=http%3A%2F%2Fdownload.wikimedia.org%2Fmediawiki%2F1.15%2Fmediawiki-1.15.1.tar.gz&xs=http%3A%2F%2Fcache.example.org%2FXRX2PEFXOOEJFRVUCX6HMZMKS5TWG4K5&xs=dchub://example.org （頁面存檔備份，存於互聯網檔案館）

url magnet

https://web.archive.org/web/20110716164755/http://sure-raza.com/magnet:/?xl=10826029&dn=mediawiki-1.15.1.tar.gz&xt=urn:tree:tiger:7N5OAMRNGMSSEUE3ORHOKWN4WWIQ5X4EBOOTLJY

客戶端

客戶端	起始支援版本
μTorrent	1.8[2]
BitComet	1.17[3]
BitSpirit	3.6.0.126[4]
迅雷	5.9.17[5]
Transmission	1.80
qBittorrent	1.5.0
NeoLoader	0.10 Public Beta Release[6][7][8]

此外，支援磁力連結的應用程式還包括Vuze、BearShare、DC++、Deluge、gtk-gnutella、Kazaa、LimeWire、FrostWire、MP3 Rocket、Morpheus、Shareaza、MLdonkey、aMule、KCeasy和TrustyFiles。

參見

• Metalink
• DHT

參考文獻

1. （英文）BEP-9: Extension for Peers to Send Metadata Files. [2016-04-28]. （原始內容存檔於2016-05-10）.
2. （英文）µTorrent 1.8 released - Announcements - µTorrent Community Forums. Firon. [2014-12-13]. （原始內容存檔於2014-12-15）.
3. （英文）The lastest 1.17 version is released［20091228］ - Comet Forums. sophia0316. [2014-12-13]. （原始內容存檔於2014-12-13）.
4. 更新历史 比特精灵. sophia0316. [2014-12-13]. （原始內容存檔於2014-12-13）.
5. 关于磁力链接（Magnet URI）的简单介绍 – 迅雷阳台-晒出新鲜事. 強伊文. [2014-12-13]. （原始內容存檔於2014-12-13）.
6. NeoLoader v0.10公开测试版发布 eMule Fans 电骡爱好者. author. [2014-12-13]. （原始內容存檔於2014-12-15）.
7. （英文）NeoLaoder 0.10 Public Beta Release. DavidXanatos. [2014-12-13]. （原始內容存檔於2014-12-13）.
8. （英文）NeoLoader ChangeLog. DavidXanatos. [2014-12-13]. （原始內容存檔於2014-12-13）.

外部連結

• MAGNET-URI專案網站 （頁面存檔備份，存於互聯網檔案館）
• Magnet.so （頁面存檔備份，存於互聯網檔案館），Magnet.so搜尋引擎
• ENBT.org （頁面存檔備份，存於互聯網檔案館），Magnet搜尋引擎
• Freebase （頁面存檔備份，存於互聯網檔案館），使用磁力連結索引免費軟件的網站
• RHash （頁面存檔備份，存於互聯網檔案館），開源命令列工具，可以計算磁力連結
• torrent2magnet （頁面存檔備份，存於互聯網檔案館），Magnet轉換工具，可以把torrent檔案轉換成磁力連結