유튜브 다운로드 — Makyeon Tools

⚠️ 저작권 안내 — 유튜브 영상의 저작권은 크리에이터 및 플랫폼에 귀속됩니다. 개인 소장 목적으로만 사용하세요.

⚡ Cloudflare Worker 설정 (필수 — 5분 소요)

공용 CORS 프록시들이 Piped 서버 IP를 차단하여 다운로드가 되지 않습니다.
아래 안내대로 무료 Cloudflare Worker를 만들어 URL을 입력하면 안정적으로 동작합니다.

① Cloudflare 무료 가입 → Workers & Pages → Create → Hello World (JS) 선택

② 에디터에서 아래 코드 전체를 붙여넣기

export default {
  async fetch(request) {
    const { searchParams } = new URL(request.url);
    const target = searchParams.get('url');
    if (!target) return new Response('{"error":"missing url"}', { status: 400 });
    try {
      const r = await fetch(target, {
        headers: { 'User-Agent': 'Mozilla/5.0', Accept: 'application/json' }
      });
      const body = await r.arrayBuffer();
      return new Response(body, {
        status: r.status,
        headers: {
          'Content-Type': r.headers.get('Content-Type') ?? 'application/json',
          'Access-Control-Allow-Origin': '*',
        },
      });
    } catch (e) {
      return new Response(JSON.stringify({ error: e.message }), {
        status: 502,
        headers: { 'Content-Type': 'application/json', 'Access-Control-Allow-Origin': '*' },
      });
    }
  },
};

③ Save & Deploy → 주소 복사 (예: https://my-worker.이름.workers.dev)

④ 아래 입력란에 붙여넣기 후 저장

🔧 동작 원리

Piped 공개 API로 스트림 URL을 받아옵니다. Cloudflare Worker가 설정돼 있으면 Worker를 통해 요청하고, 없으면 공용 CORS 프록시로 폴백합니다.

1080p 이상은 유튜브 특성상 영상·오디오 스트림이 분리되어 있어, 브라우저 내 ffmpeg.wasm으로 자동 합칩니다 (처음 클릭 시 ~30MB 로드).

❌ 다운로드가 안 되는 경우

비공개 / 연령 제한 / 지역 제한 영상
현재 생방송 중인 스트림 (다시보기는 가능)
Cloudflare Worker 미설정 — 위 안내대로 설정하면 해결

💡 잘 안 될 때

Cloudflare Worker URL을 올바르게 입력했는지 확인 (https:// 포함)
Cloudflare 대시보드에서 Worker가 배포(Deployed) 상태인지 확인
브라우저 강제 새로고침 (Ctrl+Shift+R) 후 재시도
그래도 안 된다면 piped.video에서 직접 다운로드

▶ 유튜브 다운로드