URI-схема magnet: — открытый, находящийся в стадии рабочего черновика стандарт, определяющий URI-схему т. н. magnet-ссылок, предназначенных преимущественно для указания на ресурсы, доступные к загрузке через пиринговые сети. Такие ссылки в основном идентифицируют файлы не по их расположению или имени, а по содержанию — вернее, по его хеш-коду.
Поскольку такие ссылки позволяют найти файл на основе его содержания и метаинформации, а не его фактического расположения, их можно считать разновидностью URN, а не более общего URI. Хотя magnet-ссылки могут использоваться в других сферах, они наиболее востребованы в пиринговых сетях, поскольку в таких сетях ссылка на некий ресурс не означает, что он должен быть постоянно доступен.
Стандарт был создан в 2002 году, отчасти как обобщение, независимое от конкретных производителей программного обеспечения и проектов, URI-схем ed2k:
и freenet:
, использующихся сетями eDonkey2000 и Freenet соответственно. Создание стандарта сопровождалось попыткой следовать стандартам URI от IETF настолько, насколько это было возможно.
Поскольку не все парсеры воспринимают magnet-ссылку так же, как и любую другую URL ссылку, такие ссылки могут встречаться в текстовом виде (разбитыми на несколько строк) — в таком случае они должны быть предварительно «собраны» путём удаления переводов строки. Существуют специальные плагины для браузеров, которые позволяют воспринимать magnet-ссылку так же, как и любую другую.
Также magnet-ссылки могут распространяться в виде файлов с расширением *.magnet.
Наиболее распространённое использование magnet-ссылок — указание на конкретный файл при помощи его уникального идентификатора, подобного ISBN, но основанного на хеш-коде содержимого файла. В отличие от других видов идентификаторов, magnet-ссылку может сгенерировать любой обладатель файла по стандартному алгоритму, благодаря чему наличие централизованной организации, отвечающей за их присвоение, не требуется.
Поскольку любое хеширование является сужающим преобразованием, теоретически возможны ситуации, в которых два разных файла будут обладать одинаковыми хеш-кодами, однако на практике они возникают исключительно редко.
Одним из преимуществ magnet-ссылок является их открытость и независимость от платформы: они могут быть использованы для загрузки файла при помощи разнообразных приложений на практически всех операционных системах. Благодаря тому, что magnet-ссылка представляет собой короткую строку текста, она может быть легко скопирована через буфер обмена, отправлена по электронной почте, при помощи программы мгновенного обмена сообщениями, SMS или службы микроблоггинга. Также существуют интернет-службы для генерации коротких ссылок из magnet-ссылок любой длины.
Magnet-ссылка может содержать один или несколько параметров, разделенных между собой знаком '&'. Порядок следования параметров не документирован. Для некоторых значений важно положение параметра для правильного синтаксического анализа клиентом магнет-ссылки.
magnet:?xl=Размер_в_байтах&dn=Имя_файла&xt=urn:tree:tiger:TTH-хеш_файла
Данная часть магнет-ссылки является самой главной. Именно по указанному в ней хешу производится поиск источников и проверка файла.
Хеш используется в сетях Direct Connect и Gnutella
xt=urn:tree:tiger:[ TTH хеш файла (Base32) ]
Хеш используется в сетях Gnutella, Gnutella2 а также для создания микро-торрента из магнет-ссылки.
xt=urn:sha1:[ sha1 хеш файла (Base32) ]
Это последовательная запись хеша SHA-1 и TTH, разделённых точкой. Хеш используется в Gnutella2. Direct Connect использует только TTH часть BitPrint
xt=urn:bitprint:[ sha1 хеш файла (Base32) ].[ TTH хеш файла (Base32) ]
Хеш ED2K (для файлов с размером не более 9 728 000 байт соответствует MD4) используется в EDonkey2000
xt=urn:ed2k:[ ed2k хеш файла (Hex) ]
Неофициальный URN для магнет. eDonkey2000 клиентами пока не читается. Хеш используется в eDonkey2000 для восстановления целостности файла.
xt=urn:aich:[ aich хеш файла (Base32) ]
Магнет-ссылки с AICH создаёт, к примеру, Rhash (rhash --aich --magnet filename).
xt=urn:kzhash:[ Kazaa хеш (Hex) ]
Хеш используется в сетях BitTorrent (Azureus, µTorrent)
xt=urn:btih:[ BTIH (Hex) ]
xt=urn:md5:[ MD5 хеш (Hex) ]
Неофициальный URN для магнет. В P2P сетях не используется.
xt=urn:crc32:[ CRC-32 (Base10) ]
Существует 3 вида ссылок, которые можно вставить в magnet-ссылку.
Эта ссылка указывает адрес файла на обычном веб-сервере. Клиент обращается по ней не сразу, а только по прошествии некоторого времени; таким образом, эта ссылка используется только в том случае, если файл не удалось обнаружить в P2P-сетях, что позволяет избежать излишней нагрузки на сервер.
as=[веб-ссылка на файл (URL encoded)]
Это прямая ссылка на файл или каталог для загрузки. GetRight поддерживает загрузку по протоколам HTTP, HTTPS, FTP и FTPS. Возможно использование и других протоколов, например, RTSP или MMS, если их поддержка реализована в клиенте.
ws=[веб-ссылка на файл/каталог (URL encoded)]
Эта ссылка — обычно адрес файла не на сервере, а на P2P-клиенте или адрес хаба (в случае DC++). По этой ссылке клиент пытается сразу соединиться и запросить файл или его источники. Данное поле обычно используется P2P-клиентами для хранения источника. Ссылка может содержать хеш файла.
[4] Данный вид ссылки в основном используется только клиентом Shareaza.
xs=http://[Адрес клиента]:[Порт клиента]/uri-res/N2R?[ URN содержащий хеш файла ]
По этой ссылке клиент DirectConnect сразу же соединяется с указанным хабом. Правильно работает только в не URI кодированном виде в конце магнет-ссылки. Позволяет собраться качающим один тот же файл по этой магнет-ссылке на одном хабе.
xs=dchub://[Адрес хаба]:[Порт хаба]
Для вставки в магнет-ссылку желательно использовать адрес крупного публично доступного Direct Connect хаба на котором нет ограничений по размеру шары (доступных для скачивания с клиента файлов).
В данном случае ссылка указывает не на клиент, а на кеш источников. Кеш не имеет у себя файла, но записывает и выдаёт адреса тех, у кого открыт порт на раздачу и он обратился по этому адресу. Тем самым, те, кто обращался за этим файлом по этому адресу, возможно, уже получили файл и теперь могут передать его следующему запросившему. Эта система работает аналогично BitTorrent-трекеру.
xs=http://cache.freebase.be/[ sha1 хеш файла ]
xs=ed2kftp://[Адрес клиента]:[Порт клиента]/[ed2k hash]/[file size]/
Магнитные ссылки ссылаются только на один файл. В некоторых DC++-клиентах есть работающая реализация ссылок на каталоги. Такие ссылки инвариантны относительно переименования файлов в каталоге, но неинвариантны относительно удаления, изменения или добавления таких файлов, как Thumbs.db, program.ini и тому подобных, поэтому более надёжный способ сослаться на каталог — создать метафайл. Метафайл является файлом, его можно послать в приложении или сохранить на web-сайте, но также на него можно сослаться магнитной ссылкой, например, в чате. Однако, параметр xl такой ссылки характеризует размер метафайла, но не размер каталога, что неудобно. Параметр dl характеризует именно размер каталога, описываемого метафайлом. ПО, распознающее и отображающее магнитные ссылки в читаемом виде, должно отдавать предпочтение параметру dl при отображении размера. dl не является техническим параметром, влияющим на скачивание или поиск, поэтому этот параметр применим в других вариантах использования, например, в магнитных ссылках на составные раздачи BitTorrent.
Это ссылка на список ссылок (файл лист). Может быть как веб-ссылкой,
mt=http://weblog.foo/all-my-favorites.rss
так и URN
mt=urn:sha1:3I42H3S6NNFQ2MSVX7XZKYAYSCX5QBYJ
Совместно с остальными может использоваться для получения дополнительной информации по файлу.
Пример:
magnet:?xl=10826029&dn=mediawiki-1.15.1.tar.gz &xt=urn:tree:tiger:7N5OAMRNGMSSEUE3ORHOKWN4WWIQ5X4EBOOTLJY &mt=urn:btih:QHQXPYWMACKDWKP47RRVIV7VOURXFE5Q
Данный магнет содержит данные одного файла, а часть mt содержит BTIH .torrent файла который содержит дополнительную информацию по файлу.
Это поле задаёт строку для поиска в P2P сетях.
kt=martin+luther+king+mp3
URL трекера. Используется для получения BitTorrent источников без использования сети DHT. Позволяет обойтись без торрент файла (он скачивается у полученных источников).[5]
tr=http://example.com/announce
Скорость загрузки(битрейт) при которой части файла можно запрашивать последовательно. Загрузка последовательно происходит только в части файла от начала и до точки воспроизведения[6]. Если пир не имеет доступных частей для последовательной загрузки запрашивается случайная из другой части файла.[7]
br=192000
Расчёт:
br=[размер файла в байтах]*8 / [продолжительность аудио или видео в секундах]
Алгоритм использования в p2p клиенте:
1 Если (скорость загрузки файла меньше заданного битрейта) то файл загружается случайным порядком; 2 Иначе Если (скорость загрузки непрерывного участка от начала файла меньше или равна битрейту) то файл загружается последовательно; Иначе файл загружается случайно;
Для самостоятельного дополнения формата неофициальными параметрами для них предусмотрен префикс 'x.'
x.[название нового параметра]=[данные нового параметра (URL encoded)]
Названиям параметров одной группы добавляется суффикс '.' (точка) и индекс группы.
magnet:?xt.1=[ URN первого файла ]&xt.2=[ URN второго файла ]
Некоторые программы, создающие magnet-ссылку, не кодируют специальные и национальные символы в URI представление (%20) и тем самым эти ссылки на веб-странице могут вызвать ошибки. Особенно это важно, когда ссылка, вставляемая в magnet-ссылку, содержит знаки «&»; они должны быть заменены на «%26».
Вставляемые ссылки в предназначенные для этого поля (as, xs, tr) перед этим должны быть URI-кодированы[8]
URL трекера
http://tracker.example.org/announce.php?uk=1111111111&
в magnet-ссылке должен выглядеть так
magnet:?tr=http%3A%2F%2Ftracker.example.org%2Fannounce.php%3Fuk%3D1111111111%26
" | #[9] | % | &[9] | ' | * | ,[9] | :[9] | ;[9] | < | > | ?[9] | [ | ^ | ` | { | | | } | <пробел> |
%22 | %23 | %25 | %26 | %27 | %2a | %2c | %3a | %3b | %3c | %3e | %3f | %5b | %5e | %60 | %7b | %7c | %7d | %20[10] |
Перед вставкой в 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 (&<>")
При необходимости разбить ссылку на строки[11], переход на новую строку лучше ставить перед знаком «&» (амперсанд). В таком случае, встретив его в начале строки, можно легко понять, что это продолжение magnet-ссылки.
magnet:?xl=10826029&dn=mediawiki-1.15.1.tar.gz &xt=urn:tree:tiger:7N5OAMRNGMSSEUE3ORHOKWN4WWIQ5X4EBOOTLJY &xt=urn:btih:QHQXPYWMACKDWKP47RRVIV7VOURXFE5Q
В некоторых форумах делают специальный BBCode тег [magnet], но, если его нет, можно попробовать воспользоваться тегом [url].
При вставке магнета в тег [url] парсер форума может сделать его непригодным для использования. Чтобы обойти это ограничение, можно воспользоваться сайтом[12], который позволит сделать из магнет-ссылки url, добавив его адрес в начало.
Пример:
https://ivan386.github.io/#magnet:?xl=10826029&dn=mediawiki-1.15.1.tar.gz&xt=urn:tree:tiger:7N5OAMRNGMSSEUE3ORHOKWN4WWIQ5X4EBOOTLJY
Кликнув по такой ссылке, пользователь попадёт на страницу, которая перенаправит его на исходную magnet-ссылку. Сама magnet-ссылка при этом не отправляется в GET-запросе серверу, что делает её невидимой для провайдера и сервера. Но в соцальных сетях при публикации такая ссылка может обрезаться из-за символов «#» и «:» до символа «?». В таком случае, удалив их, можно обойти это ограничение, но при этом данные magnet-ссылки уже будут передаваться в GET-запросе серверу.
Пример:
https://ivan386.github.io/magnet?xl=10826029&dn=mediawiki-1.15.1.tar.gz&xt=urn:tree:tiger:7N5OAMRNGMSSEUE3ORHOKWN4WWIQ5X4EBOOTLJY
Magnet-ссылка на файл 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:sha1:XRX2PEFXOOEJFRVUCX6HMZMKS5TWG4K5 &xt=urn:aich:7ZDRR3ZQW4JMHUQZUMJGQN2VNGLV3CVN &xt=urn:btih:QHQXPYWMACKDWKP47RRVIV7VOURXFE5Q &tr=http%3A%2F%2Ftracker.example.org%2Fannounce.php%3Fuk%3D1111111111%26 &tr=wss%3A%2F%2Ftracker.webtorrent.io &as=http%3A%2F%2Fdownload.wikimedia.org%2Fmediawiki%2F1.15%2Fmediawiki-1.15.1.tar.gz &ws=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[13]
Данная ссылка может быть закодирована в виде QR-кода.
Также данная ссылка может быть сокращена с помощью некоторых служб сокращения ссылок, поддерживающих URI-схему magnet:
, например, TinyURL или mgnet.me (схема (протокол) http:
опущен):
tinyurl.com/lr85y2g
Это может быть полезно в ряде случаев, например, при публикации magnet-ссылки в Twitter, размер сообщения в котором ограничен 140 символами, или при кодировании magnet-ссылки в виде QR-кода с целью уменьшения размера последнего.
Данная ссылка содержит необходимую информацию для возможности скачивания по ней в пяти P2P-сетях: eDonkey2000, Direct Connect, BitTorrent, Gnutella, Gnutella2. Это позволяет программам-клиентам, поддерживающим несколько P2P-сетей, осуществлять межсетевую загрузку и раздачу файлов.
Большинство программ-клиентов не могут корректно обработать (разобрать) универсальную ссылку и/или не поддерживают некоторые протоколы и не умеют игнорировать неподдерживаемые параметры, либо чувствительны к взаимному расположению параметров в magnet-ссылках. В таких случаях ссылку необходимо предварительно подготовить: расположить параметры в ссылке в нужном порядке и/или удалить неподдерживаемые параметры.
Также в ней реализована схожая с торрент-трекером система для сетей Gnutella2 и Direct Connect.
Универсальные | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Клиент | dn | xl | xt | as | xs | ws | kt | mt | tr | Перехват | Вставка |
Shareaza | Да | Да | urn: sha1: urn: tree: tiger: urn: bitprint: urn: ed2k: urn: md5: urn: btih: |
http: ftp: |
http: ftp: |
? | Да | Нет | Да | Да | Да |
Mldonkey | ? | ? | ? | ? | ? | ? | ? | ? | ? | ? | ? |
Direct Connect | |||||||||||
ApexDC++ 1.0.1 | Да | Да | urn: tree: tiger: urn: bitprint: |
dchub://[hubaddress]: [hubport] | dchub://[hubaddress]: [hubport] | ? | Нет | ? | Нет | Да | Нет |
FlylinkDC++ r500 release | Да | Да | urn: tree: tiger: urn: bitprint: urn: btih: (только передача торрент клиенту) |
dchub://[hubaddress]: [hubport] | dchub://[hubaddress]: [hubport] | ? | Да | Нет | Нет | Да | Да |
EiskaltDC++ 2.2.6 | Да | Да | urn: tree: tiger: urn: bitprint: |
dchub://[hubaddress]: [hubport] | dchub://[hubaddress]: [hubport] | ? | Да | ? | Нет | Да | Да |
GreyLink 0.39 | Да | Да | urn: tree: tiger: urn: bitprint: |
? | ? | ? | ? | ? | Нет | Да | Да |
BitTorrent | |||||||||||
Vuze (старое название: Azureus) 3.0 | ? | ? | urn: btih: | ? | ? | ? | ? | ? | ? | ? | ? |
LeechCraft 0.5 | Да | Да | urn: btih: | ? | ? | ? | Да | ? | Да | Да | Да |
μTorrent 3.4 | Да | Да | urn: btih: | ? | ? | http: https: |
? | ? | http: udp: |
Да | Да |
BitComet | Да | Да | urn: btih: | Нет | Нет | ? | Нет | Нет | Да | Да | Да |
Transmission (as of v2.84)[16][17] | Да | Нет | urn: btih: | Нет | Нет | Да | Нет | Нет | Да | Да | Да |
Gnutella | |||||||||||
LimeWire | Да | Да | urn: sha1: | http: urn: guid: |
? | ? | Нет | Нет | Нет | Да | Да |
EDonkey2000 | |||||||||||
aMule 2.2.1 | Да | Да | urn: ed2k: | ? | ? | ? | ? | ? | ? | Возможен при помощи MLDonkey Protocol Handler для FireFox | Да |
WebTorrent (BitTorrent over WebRTC) | |||||||||||
instant.io | Да | ? | urn: btih: | http: https: |
? | http: https: |
? | ? | wss: ws: |
Да | Да |
βTorrent (btorrent.xyz) | Да | ? | urn: btih: | http: https: |
? | http: https: |
? | ? | wss: ws: |
Нет | Да |
Клиент | dn | xl | xt | as | xs | ws | kt | mt | tr | Перехват | Вставка |
«Да» — поддерживается; «Нет» — не поддерживается; «?» — поддержка неизвестна.
Большинство клиентов «перехватывают» magnet-ссылку только из браузера. Поэтому magnet-ссылку необходимо вставить в адресную строку браузера и нажать кнопку «Переход» (в браузере рядом с адресной строкой) или Enter (на клавиатуре). Для другого типа достаточно просто кликнуть мышью по ссылке. GreyLink и FlylinkDC++ позволяют вводить magnet-ссылки в клиенте («Файл → Ввести магнитную ссылку…», либо «Ctrl+M»). EiskaltDC++ позволяет передавать magnet-ссылку в качестве аргумента при запуске программы, открывать ссылку из буфера обмена («Файл → Открыть магнет-ссылку», либо «Ctrl+I») или можно просто скопировать ссылку в панель быстрого поиска и нажать Enter (на клавиатуре).
«воспринимает» магнет, только если его вставить в строку eD2k Link внизу клиента. Поэтому магнет-ссылку необходимо предварительно «собрать», скопировать, вставить в это поле и нажать кнопку добавить.
ED2K Хеш, размер, имя файла должны быть первыми и в этом порядке. Клиент делит ссылку. Данные о размере файла и его хеш могут быть в разных частях. Из-за этого ссылка может стать непригодной для скачивания.
Данная страница на сайте WikiSort.ru содержит текст со страницы сайта "Википедия".
Если Вы хотите её отредактировать, то можете сделать это на странице редактирования в Википедии.
Если сделанные Вами правки не будут кем-нибудь удалены, то через несколько дней они появятся на сайте WikiSort.ru .