磁铁连接

将磁铁 URI 分析成对象

港口 网约车/磁铁里 以 恶作剧 在打字符中使用较少的依赖性

演示数字 : https://magnet-link.ep.works.dev 互联网档案馆的存檔,存档日期2013-12-02

安装

npm install @ctrl/magnet-link

使用

解码

import { magnetDecode } from '@ctrl/magnet-link';

const uri =
  'magnet:?xt=urn:btih:d2474e86c95b19b8bcfdb92bc12c9d44667cfa36&dn=Leaves+of+Grass+by+Walt+Whitman.epub&tr=udp%3A%2F%2Ftracker.example4.com%3A80&tr=udp%3A%2F%2Ftracker.example5.com%3A80&tr=udp%3A%2F%2Ftracker.example3.com%3A6969&tr=udp%3A%2F%2Ftracker.example2.com%3A80&tr=udp%3A%2F%2Ftracker.example1.com%3A1337';
const parsed = magnetDecode(uri);
console.log(parsed.dn); // "Leaves of Grass by Walt Whitman.epub"
console.log(parsed.infoHash); // "d2474e86c95b19b8bcfdb92bc12c9d44667cfa36"

整个解析对象

{
  "xt": "urn:btih:d2474e86c95b19b8bcfdb92bc12c9d44667cfa36",
  "dn": "Leaves of Grass by Walt Whitman.epub",
  "tr": [
    "udp://tracker.example4.com:80",
    "udp://tracker.example5.com:80",
    "udp://tracker.example3.com:6969",
    "udp://tracker.example2.com:80",
    "udp://tracker.example1.com:1337"
  ],
  "name": "Leaves of Grass by Walt Whitman.epub",
  "infoHash": "d2474e86c95b19b8bcfdb92bc12c9d44667cfa36",
  "announce": [
    "udp://tracker.example4.com:80",
    "udp://tracker.example5.com:80",
    "udp://tracker.example3.com:6969",
    "udp://tracker.example2.com:80",
    "udp://tracker.example1.com:1337"
  ]
}

重复的跟踪器,网络种子,和对等地址按照插入顺序被去除.

编码

import { magnetEncode } from '@ctrl/magnet-link';

// convert object to magnet uri
const uri = magnetEncode({
  xt: [
    'urn:ed2k:354B15E68FB8F36D7CD88FF94116CDC1',
    'urn:tree:tiger:7N5OAMRNGMSSEUE3ORHOKWN4WWIQ5X4EBOOTLJY',
    'urn:btih:QHQXPYWMACKDWKP47RRVIV7VOURXFE5Q',
  ],
  xl: '10826029',
  dn: 'mediawiki-1.15.1.tar.gz',
  tr: ['udp://tracker.openbittorrent.com:80/announce'],
  as: 'http://download.wikimedia.org/mediawiki/1.15/mediawiki-1.15.1.tar.gz',
  xs: ['http://cache.example.org/XRX2PEFXOOEJFRVUCX6HMZMKS5TWG4K5', 'dchub://example.org'],
});

也可以使用名称(dn),infoHash(xt),infoHashIntArray(xt),公告(tr),关键词(kt),公钥(xs)和盐(s)等方便键名.

const hybrid = magnetEncode({
  infoHash: '631a31dd0a46257d5078c0dee4e66e26f73e42ac',
  infoHashV2: 'd8dd32ac93357c368556af3ac1d95c9d76bd0dff6fa9833ecdac3d53134efabb',
});

const mutable = magnetEncode({
  publicKey: '8543d3e6115f0f98c944077a4493dcd543e49c739fd998550a1f614ab36ed63e',
  salt: '6e',
});

const selectOnly = magnetEncode({
  infoHash: 'd2474e86c95b19b8bcfdb92bc12c9d44667cfa36',
  so: [0, 2, 4, 6, 7, 8],
});

另见

• 磁铁里 https://github.com/webtorrent/magnet-uri (英语)
• BEP9 - 同行发送元数据文件的扩展 http://www.bittorrent.org/beps/bep 0009.html (中文(简体) )
• BEP46 - 更新种子 Via DHT 可变项目 http://www.bittorrent.org/beps/bep 0046.html (中文(简体) )
• BEP53 - Magnet URI 扩展名 - 选择特定文件索引下载 http://www.bittorrent.org/beps/bep 0053.html (中文(简体) )