Magnet URI scheme/ru

URI-схема magnet: — открытый, находящийся в стадии рабочего черновика, стандарт, определяющий URI-схему т. н. magnet-ссылок, предназначенных преимущественно для указания на ресурсы, доступные к загрузке через пиринговые сети. Такие ссылки в основном идентифицируют файлы не по их расположению или имени, а по содержанию, точнее, по хеш-коду.

Поскольку ссылки указывают на файл, основываясь на его содержании и метаинформации, а не на расположении, их можно считать разновидностью URN, а не более общего URI. Хотя magnet-ссылки могут использоваться в других сферах, они наиболее полезны в связке с пиринговыми сетями, так как в этих сетях указание на ресурсы не требует постоянно доступного их источника.

Стандарт был создан в 2002 году, отчасти как обобщение, независимое от конкретных производителей программного обеспечения и проектов, URI-схем ed2k: и freenet:, использующихся сетями eDonkey2000 и Freenet соответственно. Создание стандарта сопровождалось попыткой следовать стандартам URI от IETF настолько, насколько это было возможным. Среди приложений, поддерживающих magnet-ссылки, Shareaza, aMule, DC++, Azureus, BearShare, gtk-gnutella, Kazaa, LimeWire, Morpheus, TrustyFiles и μTorrent.

Применение

На данный момент чаще всего используются на DC++ порталах, где они публикуются вместе с подробным описанием файла.

Поскольку не все парсеры воспринимают магнет ссылку так же, как и любую другую URL ссылку, они могут встречаться как обычный текст (может быть разбита на несколько строк). Встретив такую ссылку, её необходимо предварительно «собрать» (удалить символы перевода строки).

Использование хеш-кодов

Наиболее распространенное использование magnet-ссылок — указание на конкретный файл при помощи его уникального идентификатора, подобного ISBN, но основанного на хеш-коде содержимого. В отличие от типичных идентификаторов, он может быть сгенерирован любым обладателем файла, а потому нет необходимости в каком-либо централизованном институте, контролирующем присвоение таких идентификаторов.

Стоит отметить, что технически возможна ситуация, когда два файла будут обладать одинаковым хеш-кодом, но статистически она крайне маловероятна, см. статью «Коллизия хэш-функции».

Одно из преимуществ magnet-ссылок — их открытость и независимость от платформы: ссылка может быть использована для загрузки файла при помощи разнообразных приложений на практически всех операционных системах. Т. к. ссылки кратки и представляют из себя строку текста, пользователи могут просто использовать операции копирования и вставки для отправки ссылок по электронной почте и программам мгновенного обмена сообщениями.

Техническое описание

Магнет может содержать один или несколько параметеров, разделенных между собой знаком '&'. Порядок следования параметров не документирован. Для некоторых значений важно положение параметра для правильного синтаксического анализа клиентом магнет ссылки.

 magnet:?xl=[Размер в байтах]&dn=[Имя файла (URL encoded)]&xt=urn:tree:tiger:[ TTH хеш  файла (Base32) ]

Параметры

dn (Display Name) — Имя файла
xl (eXact Length) — Размер файла в байтах
xt (eXact Topic) — URN, содержащий хеш файла
as (Acceptable Source) — Веб-ссылка на файл в Интернете
xs (eXact Source) — P2P ссылка.
kt (Keyword Topic) — Ключевые слова для поиска
mt (Manifest Topic) — Ссылка на метафайл, который содержит список магнетов (MAGMA — MAGnet MAnifest)
tr (TRacker) — Адрес трекера для BitTorrent клиентов.

URN, содержащий хеш (xt)

Данная часть магнет ссылки является самой главной. Именно по указанному в ней хешу производится поиск источников и проверка файла.

TTH (Tiger Tree Hash)

Хеш используется в сетях Direct Connect и Gnutella

 xt=urn:tree:tiger:[ TTH хеш  файла (Base32) ]

SHA-1 (Secure Hash Algorithm 1)

Хеш используется в сетях Gnutella, Gnutella2

 xt=urn:sha1:[ sha1 хеш  файла (Base32) ]

BitPrint<ref>What is a Bitzi Bitprint? Template:Ref-en</ref>

Это последовательная запись хеша SHA-1 и TTH, разделённых точкой. Хеш используется в Gnutella2. Direct Connect использует только TTH часть BitPrint

 xt=urn:bitprint:[ sha1 хеш  файла (Base32) ].[ TTH хеш  файла (Base32) ]

ED2K (EDonkey2000) Hash

Хеш используется в EDonkey2000

 xt=urn:ed2k:[ ed2k хеш  файла (Hex) ]

AICH<ref>AICH Template:Ref-en</ref> (Advanced Intelligent Corruption Handler)

Неофициальный URN для магнет. EDonkey2000 клиентами пока не читается. Хеш используется в EDonkey2000 для восстановления целостности файла. Магнет ссылки с AICH на данный момент создаёт только одна программа — Rhash (rhash -a --magnet).

 xt=urn:aich:[ aich хеш  файла (Base32) ]

Updated: AICH-хеш также вычисляется программой AviSower

Kazaa Hash

Хеш используется в FastTrack

 xt=urn:kzhash:[ Kazaa хеш  (Hex) ]

BTIH (BitTorrent Info Hash)

Хеш используется в сетях BitTorrent(Azureus,uTorrent)

 xt=urn:btih:[ BTIH  (Base32) ]

MD5 (Message Digest 5)

Хеш используется в Gnutella2

 xt=urn:md5:[ MD5 хеш  (Hex) ]

CRC-32 (Cyclic Redundancy Check)

Неофициальный URN для магнет. В P2P сетях не используется.

 xt=urn:crc32:[ CRC-32 (Base10) ]

Веб-ссылки на файл

Существует два вида ссылок, которые можно вставить в магнет ссылку.

Обычная (as)

Эта ссылка указывает адрес файла на сервере. Клиент не сразу обращается по ней, а только по прошествии некоторого времени. Это было сделано, чтобы не перегружать сервер запросами, а сначала попытаться найти файл в P2P сетях.

 as=[веб ссылка на файл (URL encoded)]

P2P (xs)

Эта ссылка — обычно адрес файла не на сервере, а на P2P клиенте или адрес хаба (в случае DC++). По этой ссылке клиент пытается сразу соединиться и запросить файл или его источники. Данное поле обычно используется p2p клиентами для хранения источника. Ссылка может содержать хеш файла.

Content-Addressable Web URL

Данный вид ссылки в основном используется только клиентом Shareaza.

 xs=http://[Адрес клиента]:[Порт клиента]/uri-res/N2R?[ URN содержащий хеш файла ]

Ссылка на DirectConnect хаб с источниками файла

По этой ссылке клиент DirectConnect сразу же соединяется с указанным хабом. Правильно работает только в raw виде в конце магнет ссылки. Позволяет собраться качающим один тот же файл по этой магнет ссылке на одном хабе.

 xs=dchub://[Адрес хаба]:[Порт хаба]

Для вставки в магнет ссылку желательно использовать адрес крупного публично доступного Direct Connect хаба на котором нет ограничений по размеру шары (доступных для скачивания с клиента файлов).

Ссылка на кеш источников файла для Gnutella2

В данном случае ссылка указывает не на клиент, а на кеш источников. Кеш не имеет у себя файла, но записывает и выдаёт адреса тех, у кого открыт порт на раздачу и он обратился по этому адресу. Тем самым, те, кто обращался за этим файлом по этому адресу, возможно, уже получили файл и теперь могут передать его следующему запросившему. Эта система работает аналогично BitTorrent трекеру.

 xs=http://cache.freebase.be/[ sha1 хеш файла ]

Ссылка на ED2K источник

 xs=ed2kftp://[Адрес клиента]:[Порт клиента]/[ed2k hash]/[file size]/

Манифест (mt)

Это ссылка на список ссылок (файл лист). Может быть как веб-ссылкой,

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

так и URN

 mt=urn:sha1:3I42H3S6NNFQ2MSVX7XZKYAYSCX5QBYJ

Ключевые слова (kt)

Это поле задаёт строку для поиска в P2P сетях.

 kt=martin+luther+king+mp3

Адрес трекера (tr)

URL трекера. Используется для получения BitTorrent источников без использования сети DHT. Позволяет обойтись без торрент файла (он скачивается у полученных источников). <ref>magnet URI format Template:Ref-en</ref>

 tr=http://example.com/announce

Дополнение формата (x.)

Для самостоятельного дополнения формата неофициальными параметрами предусмотрен для них префикс 'x.'

 x.[название нового параметра]=[данные нового параметра (URL encoded)]

Группы параметров

Названиям параметров одной группы добавляется суффикс '.' (точка) и индекс группы.

 magnet:?xt.1=[ URN первого файла ]&xt.2=[ URN второго файла ]

Замечание

Некоторые программы, создающие магнет ссылку, не кодируют специальные и национальные символы в URI представление (%20) и тем самым эти ссылки на веб-странице могут вызвать ошибки. Особенно это важно, когда ссылка, вставляемая в магнет, содержит знаки «&»; они должны быть замены «%26».

URI Кодирование

Вставляемые ссылки в предназначенные для этого поля (as, xs, tr) перед этим должны быть URI-кодированы<ref>, то есть, некоторые символы должны быть заменены на %XX (%XX%XX), где XX — это код символа в кодировке UTF-8</ref>

URL трекера

http://tracker.example.org/announce.php?uk=1111111111&

в магнет ссылке должен выглядеть так

magnet:?tr=http%3A%2F%2Ftracker.example.org%2Fannounce.php%3Fuk%3D1111111111%26

Это можно сделать, воспользовавшись программой Notepad++ v5.4.5+, при помощи пункта меню TextFX -> TextFX Convert -> Encode URI Component

Кодирование URL

«

#<ref name="s">Символ допустим, но при указании прямым текстом несёт специальное синтаксическое значение</ref>

%

&<ref name="s"/>

'

*

,<ref name="s"/>

:<ref name="s"/>

;<ref name="s"/>

<

>

?<ref name="s"/>

[

^

`

{

|

}

<пробел>

%22

%23

%25

%26

%27

%2a

%2c

%3a

%3b

%3c

%3e

%3f

%5b

%5e

%60

%7b

%7c

%7d

%20<ref>Следует отметить, что MediaWiki избегает кодирования пробела как %20, вместо этого он везде заменяется символом подчёркивания „_“. Многие поисковики заменяют пробел на символ „+“.</ref>

Вставка в HTML

Перед вставкой в HTML код в ссылке необходимо заменить все знаки „&“ на „&amp;“.

Исходный магнет

magnet:?dn=file.ext&tr=http%3A%2F%2Ftracker.example.org%2Fannounce.php%3Fuk%3D1111111111%26

при вставке в HTML код должен выглядеть так

<a href="magnet:?dn=file.ext&amp;tr=http%3A%2F%2Ftracker.example.org%2Fannounce.php%3Fuk%3D1111111111%26">file.ext</a>

Это можно сделать, воспользовавшись программой Notepad++ v5.4.5+, при помощи пункта меню TextFX -> TextFX Convert -> Encode HTML (&<>»)

Разбиение на строки

При необходимости разбить ссылку на строки<ref> например, когда ссылка будет отображаться пользователю простым текстом</ref>, переход на новую строку лучше ставить перед знаком «&» (Амперсанд). В таком случае, встретив его в начале строки, можно легко понять, что это продолжение магнет ссылки.

magnet:?xl=10826029&dn=mediawiki-1.15.1.tar.gz
&xt=urn:tree:tiger:7N5OAMRNGMSSEUE3ORHOKWN4WWIQ5X4EBOOTLJY
&xt=urn:btih:QHQXPYWMACKDWKP47RRVIV7VOURXFE5Q

Публикация

В некоторых форумах делают специальный BBCode тег [magnet] но если его нет можно попробовать воспользоваться тегом [url]. При вставке магнета в тег [url] парсер форума может сделать его не пригодным для использования.

Пример

Магнет ссылка на файл 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<ref>Если ссылку на хаб URI кодировать то она не будет корректно распознаваться Direct Connect клиентом поэтому она вставляется в исходном виде и только в конце магнет ссылки</ref>

Данная ссылка содержит необходимую информацию для возможности скачивания по ней в 5и p2p сетях: eDonkey2000, Direct Connect, BitTorrent, Gnutella, Gnutella2

Также в ней реализована схожая с торрент трекером система для сетей Gnutella2 и Direct Connect.

• Клиент сети Gnutella2<ref>Shareaza например</ref> может получить источники файла по ссылке на кеш источников "http://cache.example.org/FXRX2PEFXOOEJFRVUCX6HMZMKS5TWG4K5».<ref>Ссылка находится в предпоследнем поле xs магнет ссылки и URI кодирована, поэтому не похожа на исходный вариант.</ref>
• Клиент сети Direct Connect может соединиться с хабом «dchub://example.org», где может быстро найти источники файла. Но данная возможность не приветствуется пользователями и администраторами хабов, поскольку при клике на ссылку клиент автоматически соединяется с хабом, не спросив пользователя.

Особенности поддержки в клиентах

Клиент	dn	xl	xt	as	xs	kt	mt	tr	Перехват	Вставка
ApexDC++ 1.0.1	Template:Да	Template:Да	urn:tree:tiger: urn:bitprint:	dchub://[hubaddress]:[hubport]	dchub://[hubaddress]:[hubport]	Template:Нет	?	?	Template:Да	Template:Нет
FlyLinkDC++ r392 release	Template:Да	Template:Да	urn:tree:tiger: urn:bitprint:	dchub://[hubaddress]:[hubport]	dchub://[hubaddress]:[hubport]	Template:Нет	?	?	Template:Да	Template:Нет
Shareaza 2.3.1.0	Template:Да	Template:Да	urn:sha1: urn:tree:tiger: urn:bitprint: urn:ed2k: urn:md5: urn:btih:	http: ftp:	http: ftp:	Template:Да	Template:Нет	?	Template:Да	Template:Да
Azureus 3.0	?	?	urn:btih:	?	?	?	?	?	?	?
LeechCraft 0.3	Template:Да	Template:Да	urn:btih:	?	?	Template:Да	?	Template:Да	Template:Да	Template:Да
μTorrent 1.8.4	Template:Да	?	urn:btih:	?	?	?	?	Template:Да	Template:Да	Template:Да
aMule 2.2.1	Template:Да	Template:Да	urn:ed2k:	?	?	?	?	?	Возможен при помощи MLDonkey Protocol Handler для Firefox	Template:Да

Да - поддерживается Нет - не поддерживается ? - Поддержка неизвестна

DC++ клиенты

"Перехватывают" магнет ссылку только из браузера. Поэтому текстовый магнет надо вставить в адресную строку браузера и нажать кнопку "Переход" (В браузере рядом с адресной строкой) или Enter (На клавиатуре). Для другого типа достаточно просто кликнуть мышью по ссылке.

aMule 2.2

«воспринимает» магнет, только если его вставить в строку eD2k Link внизу клиента. Поэтому магнет ссылку необходимо предварительно «собрать», скопировать, вставить в это поле и нажать кнопку добавить.

ED2K Хеш, размер, имя файла должны быть первыми и в этом порядке. Клиент делит ссылку. Данные о размере файла и его хеш могут быть в разных частях. Из-за этого ссылка может стать не пригодной для скачивания.

Ссылки

• Формат магнет-ссылки для BitTorrent Template:Ref-en
• MAGNET v0.1 Template:Ref-en
• Спецификация по магнет ссылкам Template:Ref-en
• Сайт проекта MAGNET-URI Template:Ref-en
• Bitzi, Сайт по поиску магнетов. Template:Ref-en
• dc-poisk.no-ip.org, Сервер поиска магнет ссылок. В базе данных более 220 000 000 магнет ссылок. Сервер "следит" за содержанием десяти крупнейших хабов России. Template:Ref-ru
• Freebase сайт который использует магнеты чтобы индексировать freeware. Template:Ref-en
• Программа для создания универсальных magnet ссылок RuBoard Template:Ref-ru
• Популярный клиент для Magnet-ссылок Template:Ref-ru
• Универсальный клиент для Magnet-ссылок Template:Ref-en
• Простая инструкция, как скачивать файлы по Magnet-ссылкам популярным клиентом uTorrent
• Сборка Магнет-ссылки из известных данных о файле