hmjz100/LinkSwift 딥다이브
— 9대 중국 클라우드의 직접 다운로드 링크를 꺼내는 유저스크립트

1프로젝트 한 줄 요약

LinkSwift는 "클라우드 저장소 웹페이지에 다운로드 버튼을 몰래 붙여 주는 브라우저 부가 스크립트"다. 중국의 대표 클라우드(网盘, "왕판")들은 웹에서 파일을 받으려 하면 느린 전용 클라이언트를 설치하라고 강요하거나 속도를 조인다. LinkSwift를 깔아 두면, 네트디스크 페이지에 "下载助手(다운로드 도우미)" 버튼이 생기고, 파일을 고른 뒤 그 버튼을 누르면 브라우저가 대신 파일의 실제 다운로드 URL을 알아내 준다.

이 실제 URL(직링크)을 손에 쥐면, 그걸 내가 원하는 다운로더에 붙여 넣어 받을 수 있다 — 예컨대 IDM으로 다중 연결 다운로드를 하거나, 리눅스 서버에서 aria2c 명령으로 받거나, NAS의 Motrix로 원격 다운로드를 걸거나. LinkSwift는 그 URL을 5가지 형식(API 링크 / aria2 명령 / cURL 명령 / BitComet 푸시 / 브라우저 내 증강 다운로드)으로 예쁘게 포장해 준다.

2왜 지금 주목받는가

LinkSwift는 갑자기 튀어나온 신생 프로젝트가 아니라, 중국에서 어마어마한 사용자층을 가진 유틸리티 계보 위에 있다. 원조 【网盘直链下载助手】(油小猴/syhyz1990)는 오래된 인기 스크립트지만 활성화 "暗号(암호)"를 위챗으로 받아야 하고 광고가 붙는 제약이 있었다. LinkSwift는 이걸 포크해 그 제약을 걷어낸 판이라, "원조보다 낫다"는 입소문으로 트렌딩에 올랐다. (TrendShift의 굵은 숫자는 별 수가 아니라 사회적 언급 모멘텀이다.) 인기 이유를 네 갈래로 본다.

주목 포인트 1 — "개원·자용·거광(开源・自用・去广)"

LinkSwift의 슬로건이 곧 차별점이다. 오픈소스(开源)라 코드가 전부 공개돼 있고, 원조가 요구하던 활성화 암호·유료 요소·광고를 제거(去广)했다. 원조는 무료 사용을 위해 위챗 스캔으로 "暗号"를 받아 버튼을 "점등"시켜야 했는데, LinkSwift는 그 관문 없이 바로 쓴다. "그냥 깔면 되고, 코드도 볼 수 있다"는 투명함이 가장 큰 매력.

주목 포인트 2 — 9개 네트디스크 한 방 지원

바이두 하나만 지원하는 도구가 많은데, LinkSwift는 百度·阿里·中国移动·天翼·迅雷·光鸭·夸克·UC·123云盘 아홉 곳을 한 스크립트로 커버한다. 중국 사용자는 파일마다 다른 네트디스크를 쓰기 때문에, "하나로 다 되는" 통합이 실질적 편의를 준다. 각 사이트의 페이지 구조·API가 자주 바뀌는데도 업데이트 로그를 보면 거의 매달 적응(适配) 패치가 돈다.

주목 포인트 3 — 외부 다운로더 5종 + 브라우저 내 증강 다운로드

꺼낸 직링크를 IDM·NDM·AB Download Manager(API 링크), aria2/XDown/Motrix(Aria·RPC), cURL 터미널, BitComet(BC)에 각각 맞는 형식으로 만들어 준다. 게다가 다운로더를 아예 못 까는 환경(회사·학교 PC 등)을 위해, 브라우저 안에서 도는 멀티스레드 "증강 다운로드(Beta)"까지 넣었다 — 이게 기술적으로 가장 흥미로운 부분이다(§4-4).

주목 포인트 4 — UI·경험 개선

원조 대비 SweetAlert2 팝업 + Font Awesome 아이콘으로 UI를 다시 그렸고, 다크 모드, 네트디스크 페이지 자체를 깔끔하게 정리하는 "绿化/美化(녹화·미화)", 다운로드 속도·남은 시간 표시, 링크 캐시 등을 붙였다. "기능은 원조를 넘고, 보기도 예쁘다"는 완성도가 재방문을 부른다.

비슷한 도구와의 비교

3기술 스택 전체 지도

LinkSwift는 백엔드가 없다. 서버·데이터베이스·빌드 파이프라인이 전부 없고, 모든 로직이 사용자의 브라우저 안 스크립트 매니저 샌드박스에서 돈다. 스택을 세 계층으로 나눠 본다.

계층 1 — 실행 기반 (스크립트 매니저 + GM API)

LinkSwift는 브라우저가 아니라 스크립트 매니저 확장 위에서 실행된다. 이 확장이 제공하는 특수 함수들(GM_*)이 일반 웹페이지 JS로는 불가능한 일을 가능케 한다.

계층 2 — 프런트엔드 라이브러리 (외부 @require)

빌드 도구가 없으므로, 의존 라이브러리는 헤더의 @require로 CDN에서 직접 로드한다. 딱 3개다.

계층 3 — 데이터 · 설정 (config/*.json)

config/ 폴더의 JSON들은 원조 油小猴 서버 설정의 "백업본"이다 — 스크립트가 그 서버에 못 붙을 때 대신 읽는 폴백. 네트디스크별로 API 엔드포인트·DOM 선택자·다국어 문구가 들어 있다.

4아키텍처 심화 분석

파일 하나지만 내부는 객체 단위로 잘 나뉜 미니 프레임워크다. info(스크립트 정보) → temp(런타임 상태) → message(다국어) → config(엔드포인트·선택자) → base(거대한 코어 엔진) → 네트디스크별 핸들러($baidu·$aliyun…) → main(초기화·라우팅) 순서로 구성된다. 하나씩 해부한다.

4-1. 실행 흐름 — 페이지가 열리면 벌어지는 일

main.init()이 진입점이다. 가장 먼저 현재 페이지 주소(hostname)를 보고 어느 네트디스크인지 판별해, 그에 맞는 핸들러 객체를 temp.main에 꽂는다.

// main.init() 내부 — 호스트명으로 핸들러 라우팅
if (/(pan|yun).baidu.com/.test(location.host))        temp.main = $baidu;
else if (/www.(aliyundrive|alipan).com/.test(host))    temp.main = $aliyun;
else if (/(yun|caiyun).139.com/.test(host))            temp.main = $mcloud;   // 中国移动
else if (/cloud.189.cn/.test(host))                    temp.main = $tcloud;   // 天翼
else if (/pan.xunlei.com/.test(host))                  temp.main = $xunlei;
else if (/pan.quark.cn/.test(host))                    temp.main = $quark;
else if (/drive.uc.cn/.test(host))                     temp.main = $uc;
else if (/123(pan|684|865|952|912)/.test(host))        temp.main = $123pan;
// … 이어서 공통 초기화 …
base.initDefaultConfig();      // 스마트 기본 설정
base.addPanLinkerStyle();      // 美化 CSS 주입
base.addPageListener();        // 버튼 클릭 이벤트 위임 바인딩
temp.main.initPanLinker();     // 이 사이트에 다운로드 버튼 심기
temp.main.greenerPage();       // 광고 제거·페이지 绿化

즉 "어느 집에 왔는지 확인 → 그 집 열쇠(핸들러) 꺼내기 → 공통 인테리어(스타일·이벤트) 깔기 → 그 집 전용 버튼 심기" 순서다. 전체 그림:

4-2. base 엔진 — 스크립트의 심장 (약 9천 줄 중 대부분)

base는 사이트에 무관한 공용 도구 상자다. 네트디스크 핸들러들은 자기 API만 알고, 나머지 궂은일(HTTP·다운로드·UI·설정)은 전부 base에 위임한다.

4-3. 링크 취득 파이프라인 — 각 네트디스크 핸들러

$baidu·$aliyun 등 9개 핸들러는 각자 "파일 선택 감지 → 자기 API 호출 → dlink 추출"만 담당한다. 예를 들어 바이두는 공식 xpan/multimedia?method=filemetas&dlink=1로 메타데이터와 dlink를, 아리는 get_download_url/get_share_link_download_url로 링크를 받는다.

// 핸들러가 만드는 표준 file 객체 (모든 네트디스크 공통 형태)
const file = {
    index: status.item.data("index"),   // 몇 번째 파일
    link:  status.item.data("link"),    // ★ 추출한 실제 dlink
    name:  status.item.data("name"),    // 파일명
    size:  status.item.data("size") || 0 // 바이트
};
// 이 file.link 를 base 의 다운로드/명령 생성기에 넘기면 끝
base.download(file.link, { "User-Agent": ua.downloadLink, "Referer": "" }, {
    ...file,
    onProgress: (d) => updateBar(d.progress, d.speedText, d.etaText)
});

핵심 설계 관찰: 모든 핸들러가 동일한 file 객체 형태로 수렴하기 때문에, 그 뒤 단계(다운로드·명령 생성·UI)는 어느 네트디스크든 완전히 공유된다. "사이트별 차이는 핸들러에 가두고, 그 아래는 통일"이 9개 지원의 비결이다. 참고로 바이두는 보안을 위해 예전 BDUSS 쿠키 방식을 폐기하고 AccessToken(OAuth)로 옮겼다(v1.1.1.6).

4-4. 증강 다운로드(Beta) — 브라우저 안의 멀티스레드 다운로더

이 스크립트에서 가장 공학적으로 재미있는 부분. 외부 다운로더를 못 쓰는 환경을 위해, GM_xmlhttpRequest로 파일을 여러 조각(Range)으로 병렬 요청해 브라우저 안에서 직접 받고, 조각들을 Blob으로 합쳐 저장한다. 단순 병렬이 아니라 네트워크 상태에 맞춰 조각 크기를 실시간으로 조절하는 적응형 알고리즘이 들어 있다.

// 증강 다운로드의 핵심 로직 (요지)
const maxThreads = Math.min(extra.thread || 3, global_maxThreads); // 동시 스레드
let chunk = Math.min(256 * 1024, absoluteMaxChunk);              // 시작 조각 = 256KB

// 각 워커: [start, end] 범위를 Range 헤더로 요청
const end = Math.min(start + chunk - 1, size - 1);
base.head(url, { ...headers, Range: `bytes=${start}-${end}` });

// ── 적응형 조각 크기 (AIMD 비슷한 혼잡 제어) ──
if (오류_또는_끊김) chunk = Math.max(minChunk, Math.floor(chunk * 0.5)); // 반토막
else {
    nextOptimalChunk = 측정속도 * 목표시간;
    nextOptimalChunk = Math.min(nextOptimalChunk, chunk * 2.0);   // 급등 방지(최대 2배)
    nextOptimalChunk = Math.max(nextOptimalChunk, chunk * 0.33);  // 급락 방지(최소 1/3)
    chunk = Math.floor(chunk * 0.4 + nextOptimalChunk * 0.6);     // 평활화(EMA)
}

4-5. 5대 출력 모드 — 명령 생성기와 RPC 푸시

추출한 dlink를 사용자의 다운로드 도구별로 변환한다. 명령 문자열 생성은 순수 함수, 원격 푸시는 JSON-RPC 호출이다.

// cURL 명령 (터미널용, 이어받기 -C - 포함)
return `curl -L -C - "${link}" -o "${filename}"${headers ? " "+headers : ""}`;

// aria2c 명령 (XDown·리눅스 셸용)
return `aria2c "${link}" --out "${filename}"${headers ? " "+headers : ""}`;

// aria2 RPC 푸시 (Motrix 등 원격 다운로더로 전송)
{ jsonrpc: "2.0", method: "aria2.addUri", params: [ `token:${token}`, [link], { out: filename, dir } ] }

4-6. 페이지 주입과 绿化 — SPA에 버튼을 붙이는 법

네트디스크들은 대부분 SPA(단일 페이지 앱)라, 요소가 비동기로 나타났다 사라진다. LinkSwift는 waitForKeyElements(내부적으로 MutationObserver 기반)로 목표 요소가 DOM에 등장할 때까지 감시하다가 버튼을 심는다. 마운트 지점은 idontknow("LinkSwift")로 만든 커스텀 태그를 <head> 뒤에 붙여, 페이지 재렌더에도 자기 UI가 날아가지 않게 격리한다.

绿化(녹화)·美化(미화)는 config의 선택자로 광고·프로모션 요소를 숨기고, 네트디스크 UI에 테마색을 입히는 기능. 이것도 config JSON의 선택자에 의존하므로, 사이트 개편 때 코드가 아니라 선택자만 고치면 된다.

5디렉토리 · 파일 구조 해부

대형 프레임워크와 달리 LinkSwift는 파일 수가 아주 적다. 거의 모든 로직이 단일 스크립트에 있고, 나머지는 설정·문서·부속이다.

6학습 포인트

LinkSwift는 "네트디스크 다운로드"라는 목적을 넘어, 브라우저 확장·유저스크립트로 남의 웹사이트를 증강하는 기술의 종합 교재다. 기술별로 배울 거리를 정리한다.

배울 것 1 — 유저스크립트 & GM API 생태계

UserScript 메타블록(@match·@grant·@require·@connect·@run-at)을 어떻게 설계하는지, GM_xmlhttpRequest로 CORS를 넘고, GM_setValue로 설정을 저장하고, GM_registerMenuCommand로 메뉴를 만드는 법을 통째로 볼 수 있다. Tampermonkey로 무언가를 자동화하려는 사람에게 살아있는 레퍼런스다.

배울 것 2 — 웹 API 관찰과 활용

각 네트디스크가 자기 웹페이지에서 쓰는 내부/공식 API를 관찰(네트워크 탭)하고 그 요청을 재현하는 방법론을 배운다. 파라미터 서명(js-md5), 토큰·타임스탬프, Range 헤더 활용까지 — "웹은 결국 HTTP 요청의 집합"이라는 감각을 길러 준다. (단, 실제 적용은 대상 사이트 ToS를 반드시 확인.)

배울 것 3 — Range 기반 멀티스레드 다운로드 + 혼잡 제어

§4-4의 적응형 청킹은 네트워크 프로그래밍의 좋은 축소 실습이다. Range로 병렬 다운로드를 구현하고, "끊기면 줄이고 잘 되면 늘리되 상·하한을 두는" AIMD식 제어와 EMA 평활화를 코드로 익힐 수 있다. TCP 혼잡 제어의 직관을 애플리케이션 레벨에서 체득.

배울 것 4 — SPA에 UI 주입하기 (MutationObserver)

동적으로 바뀌는 남의 SPA에 버튼·패널을 안정적으로 심는 기술(waitForKeyElements/MutationObserver, 격리된 마운트 태그)은 브라우저 확장·자동화·크롤링에 두루 쓰인다. "요소가 언제 나타날지 모르는 페이지"를 다루는 정석을 배운다.

배울 것 5 — 설정 주도(config-driven) 다중 대상 설계

9개 사이트를 한 코드로 지원하는 비결은 사이트별 차이(API·선택자)를 JSON으로 외부화하고 핸들러 인터페이스를 통일한 것이다. "변하는 것(설정)과 안 변하는 것(엔진)을 분리"하는 설계 원칙의 실전 사례 — 멀티 테넌트·멀티 플랫폼 도구를 만들 때 그대로 응용된다.

7시스템 · 설치 요구사항

실행 요구가 매우 가볍다. 스크립트 매니저 확장 하나만 있으면 되고, 외부 다운로더(IDM·aria2 등)는 선택이다.

설치 흐름 (정식판 기준)

8직접 해볼 수 있는 실습 과제

9관련 기술 심화 학습 로드맵

10핵심 키워드 사전

11참고 링크