마그넷 링크는 여러 컨텍스트에서 사용될 수 있지만, P2P 파일 공유 네트워크에서 특히 유용하다. 이는 지속적으로 사용 가능한 호스트 없이도 자원을 참조할 수 있게 해주며, 파일을 이미 가지고 있는 누구든지 중앙 기관의 발행 없이도 생성할 수 있기 때문이다. 이로 인해 마그넷 링크는 파일 공유 커뮤니티 내에서 "보장된" 검색어로 널리 사용되며, 검색 방법에 관계없이 마그넷 링크를 배포하여 해당 링크로 검색된 자원이 의도된 것인지 확인할 수 있게 한다.
역사
마그넷 URI 표준은 2002년 비트지에 의해 개발되었는데, 부분적으로는 각각 이동키2000과 하이퍼넷 (구 프리넷)에서 사용되던 ed2k: 및 freenet: URI 스키마의 "벤더 및 프로젝트 중립적인 일반화"로서, 공식 IETFURI 표준을 최대한 따르려 노력한다. 비트토렌트는 2020년 비트토렌트 v2 변경사항의 일부로 btmh: 프로토콜을 도입했다.[1]
형식
마그넷 URI는 하나 이상의 매개변수들로 구성되며, 순서는 중요하지 않고, 일반적으로 HTTP URL의 끝에 오는 쿼리 문자열과 동일한 방식으로 포맷된다.
URL 트래커; DHT 지원 없이 비트토렌트 다운로드용 자원을 얻는 데 사용된다.[3] 값은 URL 인코딩되어야 한다.
tr=http%3A%2F%2Fexample.org%2Fannounce
ws
웹 시드 (Web Seed)
HTTP(S)를 통해 제공되는 페이로드 데이터
as
허용 가능한 소스 (Acceptable Source)
웹 서버에서 직접 다운로드를 참조한다. 클라이언트가 지원하는 P2P 네트워크에서 링크된 파일을 찾거나 다운로드할 수 없는 경우의 대체 소스로만 간주된다.
as=[파일의 웹 링크(URL 인코딩됨)]
xs
정확한 소스 (eXact Source)
마그넷 링크가 가리키는 파일에 대한 HTTP (또는 HTTPS, FTP, FTPS 등) 다운로드 소스, 파일에 대한 P2P 소스의 주소 또는 허브의 주소(DC++의 경우). 클라이언트는 이 주소를 통해 직접 연결을 시도하며, 파일 및 해당 소스를 요청한다. 이 필드는 일반적으로 P2P 클라이언트가 소스를 저장하는 데 사용되며, 파일 해시를 포함할 수 있다.
xs=http://[클라이언트 주소]:[클라이언트 포트]/uri-res/N2R?[ URN을 포함하는 파일 해시 ]
토렌트 클라이언트가 다운로드해야 할 특정 파일들을 나열하며,[6] 개별 파일 인덱스 또는 (포함) 범위로 표시된다.
so=0,2,4,6-8
x.pe
피어 (PEer)
연결할 고정된 피어 주소를 지정한다. (예를 들어) 트래커나 DHT가 없는 경우 피어 검색을 부트스트랩하는 데 사용된다.[3]
x.pe=hostname:port
x.pe=ipv4-literal:port
x.pe=[ipv6-literal]:port
이 표준은 또한 "x"로 시작해야 하는 애플리케이션별 실험적 매개변수를 허용한다.
정확한 항목 (xt)
xt 매개변수는 주어진 P2P 프로토콜에 대한 URN을 지정한다. 그 목적은 토렌트의 메타데이터를 찾기 위한 검색 매개변수를 제공하는 것이다. 이는 .torrent 파일을 대체하는 효과를 가지는데, .torrent 파일 자체가 토렌트 메타데이터를 포함하는 반면, 대신 P2P 네트워크에서 (URN을 사용하여) 해당 메타데이터를 검색한다. 각 프로토콜은 URN을 고유하게 처리한다. 예를 들어, xt=urn:btih:FFC7E738EAA4CD4ECF51EC6FD669C6CDE2C281A8는 btih(비트토렌트 v1 프로토콜)를 사용하므로, 비트토렌트 클라이언트는 해시를 가져와 비트토렌트 DHT에서 토렌트의 메타데이터를 찾을 수 있다.[7] DHT의 경우 클라이언트는 미리 알려진 노드들을 검색하고 정보 해시에 대한 메타데이터를 요청한다. 이 노드들은 결국 스웜이 발견되고 반환될 때까지 다른 알려진 노드들에게 동일한 요청을 한다.
xt는 또한 그룹 설정도 허용한다. 각 링크 매개변수에 점(.)으로 시작하는 카운트 번호를 추가하여 여러 파일을 포함할 수 있다.
magnet:?xt.1=[ 첫 번째 파일의 URN ]&xt.2=[ 두 번째 파일의 URN ]
이것은 비트토렌트에서 다운로드 가능한 파일 또는 파일 세트를 식별하는 데 사용되는 비트토렌트 메타파일의 "정보" 섹션에 대한 십육진법 인코딩된 SHA-1 해시 합계이다. 기존 링크와의 하위 호환성을 위해 클라이언트는 해시의 Base32 인코딩 버전도 지원해야 한다.[3]
이 경우, 포함된 링크는 클라이언트 IP나 직접 소스가 아닌, 동일한 파일을 다운로드하기 위해 연결하는 다른 클라이언트의 IP를 저장하는 소스 캐시를 가리킨다. 클라이언트가 캐시에 연결하면, 대체 소스의 IP가 제공되고, 자신의 IP는 캐시 내에 저장되어 캐시에 연결하는 다음 클라이언트에게 전달된다. 이 시스템은 비트토렌트 트래커와 유사하게 작동한다.