Magnet URI scheme/ru
Languages: |
English • Deutsch • Español • Français • עברית • Italiano • Nederlands • Polski • Português • Русский • 中文(繁體) | e |
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
xt=urn:kzhash:[ Kazaa хеш (Hex) ]
BTIH (BitTorrent Info Hash)
Хеш используется в сетях BitTorrent(Azureus,uTorrent)
xt=urn:btih:[ BTIH (Base32) ]
MD5 (Message Digest 5)
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
« | #<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 код в ссылке необходимо заменить все знаки „&“ на „&“.
Исходный магнет
magnet:?dn=file.ext&tr=http%3A%2F%2Ftracker.example.org%2Fannounce.php%3Fuk%3D1111111111%26
при вставке в HTML код должен выглядеть так
<a href="magnet:?dn=file.ext&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
- Сборка Магнет-ссылки из известных данных о файле