# วิธีใช้ yt-dlp

คู่มือดาวน์โหลดที่เน้น Linux ครอบคลุมการติดตั้งรุ่น nightly รูปแบบไฟล์ คำบรรยาย ชุดข้อมูล และการทำงานเก็บข้อมูลต่อหลังหยุดชะงัก

อ้างอิงทางคลอง: https://flashdata.dev/th/docs/guides/how-to-use-yt-dlp
Recorder: 2026-11-13 โดย FlashData

- [สร้างเครื่องมือ](https://flashdata.dev/th/docs/guides/how-to-use-yt-dlp/reference.md#install) — Python, FFmpeg และ JavaScript
- [เลือกการผลิต](https://flashdata.dev/th/docs/guides/how-to-use-yt-dlp/reference.md#formats) — วิดีโอเสียงและภาพถ่าย
- [คู่ครั้งที่เก็บ](https://flashdata.dev/th/docs/guides/how-to-use-yt-dlp/reference.md#repeatable) — แสดง, config และ archive
- [ปรับการทํางานที่ล้มเหลว](https://flashdata.dev/th/docs/guides/how-to-use-yt-dlp/reference.md#maintain) — ค้นหาการวินิจฉัยที่เหมาะสม

<a id="install"></a>

## ติดตั้งฐานการใช้งานประจําวัน


**เริ่มต้นด้วย Nightly + Deno + FFmpeg.** ใช้สภาพแวดล้อมเสมือนของโครงการและเปิดใช้งานการกําหนดเองเบราว์เซอร์ด้วย `--impersonate=""` การตั้งค่า Linux ด้านล่างติดตั้งเครื่องมือ macOS และ Windows ตัวเลือกในแท็บ

**Linux**

ตัวอย่าง Ubuntu / Debian ด้วย Python 3.11+ ติดตั้งเครื่องมือระบบสร้างสภาพแวดล้อมเสมือนโครงการแล้วติดตั้งในเวลากลางคืนและพิเศษของมัน Run Deno ของติดตั้งเป็นผู้ใช้เดียวกันที่เจ้าของงาน


**ทํางาน Linux**

```bash
sudo apt-get update
sudo apt-get install -y python3 python3-venv ffmpeg aria2 curl unzip
python3 -m venv .venv
source .venv/bin/activate
python -m pip install -U --pre "yt-dlp[default,curl-cffi]"
curl -fsSL https://deno.land/install.sh -o /tmp/install-deno.sh
sh /tmp/install-deno.sh
export PATH="$HOME/.deno/bin:$PATH"
deno --version
python -m yt_dlp --version
```


**macOS**

ด้วย Homebrew ติดตั้งใช้สําหรับ Python, Deno, FFmpeg และ aria2 ปกป้อง yt-dlp ตัวเองในสภาพแวดล้อมโครงการเพื่อให้คําสั่งการปรับปรุงคืนเหมือนกับ Linux


**การตั้งค่า macOS**

```bash
brew install python deno ffmpeg aria2
python3 -m venv .venv
source .venv/bin/activate
python -m pip install -U --pre "yt-dlp[default,curl-cffi]"
deno --version
python -m yt_dlp --version
```


**Windows · PowerShell**

ติดตั้ง Python 3.11+ Deno และตัวดําเนินการ FFmpeg จากนั้นเปิด terminal ใหม่ ใช้เครื่องแปลของสภาพแวดล้อมโดยตรงหาก PowerShell ปลั๊กเปิดใช้งาน aria2 เป็นตัวเลือกติดตั้งแยกต่างหากใช้สูตรการดาวน์โหลดภายนอก


**Windows สภาพแวดล้อม**

```powershell
py -3 -m venv .venv
.\.venv\Scripts\python.exe -m pip install -U --pre "yt-dlp[default,curl-cffi]"
deno --version
ffmpeg -version
.\.venv\Scripts\python.exe -m yt_dlp --version
```


| เครื่องมือ | สิ่งที่มันทํา | ตรวจสอบ |
| --- | --- | --- |
| Python 3.11+ | แพคเกจ Python และตัวอย่างในชุดนี้ | python --version |
| ใหม่ล่าสุด yt-dlp คืน + ปล่อย,curl-cffi พิเศษ | เครื่องสกัด YouTube อัปเดตที่ตรงกับ EJS Solver และการสนับสนุนการกําหนดเองของเบราว์เซอร์ | python -m yt_dlp --version |
| FFmpeg และ ffprobe | รวมการไหลแปลงเสียงตัดคลิปและตรวจสอบสื่อที่บันทึกไว้ | ffmpeg -version / ffprobe -version |
| Deno 2.3+ (จําเป็นในกระแสทํางานนี้) | การทํางานของท้าทาย YouTube ติดตั้งมันบนแต่ละคนไม่เพียง แต่เครื่องพัฒนาของคุณ | deno --version |

**ติดตั้งตัวดําเนินการได้** `[default]` จัดส่ง EJS สคริปต์ Deno เป็นแยก FFmpeg และ ffprobe ยังต้องอยู่ใน PATH ของพนักงาน

**ดู Baseline ทั้งหมด**

```bash
deno --version
ffmpeg -version
ffprobe -version
python -m pip show yt-dlp yt-dlp-ejs curl-cffi
python -m yt_dlp --list-impersonate-targets
```

คําสั่งสุดท้ายควรระบุเป้าหมายของเบราว์เซอร์ที่มีอยู่ หากเป้าหมายไม่สามารถเข้าถึงได้ตรวจสอบว่า curl-cffi จะติดตั้งในสภาพแวดล้อมเสมือนนี้

**การทดสอบการสกัดด้วย Deno และตัวอักษรเบราว์เซอร์**

```bash
python -m yt_dlp --ignore-config --js-runtimes deno --impersonate="" --verbose \
  --simulate "https://www.youtube.com/watch?v=jNQXAC9IVRw"
```

ตรวจสอบ JS runtime และ request-handler สาย การทดสอบการสกัด การติดตามมันด้วยการถ่ายโอนจริง

พื้นฐานการทํางานของ FlashData รวมถึง --impersonate="": มันช่วยให้ curl-cffi เลือกหน้าแปลนเบราว์เซอร์ที่มีอยู่ นี่จะเปลี่ยนคําขอการพิมพ์หน้าต่าง ไม่ให้คุกกี้การเข้าสู่ระบบแก้ไขปัญหาของ JavaScript หรือเปลี่ยน IP การออก หากตัวเลือกนี้ช้าทายเส้นทางทํางานหรือนําไปสู่ข้อผิดพลาดแล้วทําทดสอบแบบวิดีโอเดียวโดยไม่มีการทดสอบและรักษาการตั้งค่าทํางาน

> **บริการต้องการเส้นทางของตัวเอง**
> Deno installer โดยปกติจะวางไบนารีใน ~/.deno/bin. การค้นหา shell แบบโต้ตอบไม่สามารถพิสูจน์ให้เห็นว่าบริการระบบหรือคอนเทนเนอร์หรืองาน cron สามารถ ระบุตัวแทนงาน PATH หรือผ่าน --js-runtimes deno:/absolute/path/to/deno. ใช้เส้นทาง Python ของสภาพแวดล้อมเสมือนในคําสั่งบริการ

- [การติดตั้งอย่างเป็นทางการ](https://github.com/yt-dlp/yt-dlp/wiki/Installation)
- [FFmpeg ดาวน์โหลด](https://ffmpeg.org/download.html)
- [ติดตั้ง Deno](https://docs.deno.com/runtime/getting_started/installation/)
- [การตั้งค่าเวลาการทํางานของ YouTube](https://github.com/yt-dlp/yt-dlp/wiki/EJS)

<a id="verify-install"></a>

### ตรวจสอบการปล่อยก่อนที่จะวางไว้บนพนักงาน


รับการดําเนินการจากหน้าการปล่อยของโครงการอย่างเป็นทางการหรือติดตั้งแพคเกจ Python จากแหล่งแพคเกจที่เผยแพร่ หากคุณดาวน์โหลดไบนารีแบบแยกต่างหากเปรียบเทียบ SHA-256 กับชื่อไฟล์ที่ตรงกับใน SHA2-256SUMS ของเวอร์ชันนั้น บันทึกการปล่อยและตรวจสอบด้วยภาพของพนักงานของคุณเพื่อให้คุณสามารถระบุสิ่งที่ทํางานได้อย่างแม่นยํา

**Linux**


**Hash the ดาวน์โหลดไฟล์**

```bash
sha256sum yt-dlp
```


**macOS**


**Hash the ดาวน์โหลดไฟล์**

```bash
shasum -a 256 yt-dlp_macos
```


**Windows**


**Hash the ดาวน์โหลดไฟล์**

```powershell
Get-FileHash -Algorithm SHA256 .\yt-dlp.exe
```


การเปรียบเทียบค่าตรวจสอบจะใช้ได้เฉพาะเมื่อค่าที่คาดหวังมาจากการปล่อยที่เชื่อถือได้ไม่ใช่กระจกที่ไม่รู้จักเดียวกันกับค่าที่สามารถดําเนินการได้ หากซอฟต์แวร์ความปลอดภัยเป็นไฟล์ตรวจสอบแหล่งและรายงานก่อนที่จะทําข้อจํากัด การมีข้อมูลที่มีอยู่ด้วยแหล่งที่มาเปิดเท่านั้นไม่ใช่หลักฐานว่าปลั๊กอินไบนาหรือบุคคลที่สามใด ๆ ที่ดาวน์โหลดจะปลอดภัย

การจัดการไฟล์การกําหนดค่าที่แบ่งปันเป็นรหัสเพื่อตรวจสอบ: ตัวเลือกเช่น --exec สามารถเปิดตัวคําสั่งและปลั๊กอินเพิ่มรหัสไปยังกระบวนการดาวน์โหลด ปรับปรุงคุกกี้เบราว์เซอร์, การรับรองโปรกซี่และ URL ที่ลงทะเบียนออกจากตัวอย่างการกําหนดค่าและรายงานวินิจฉัย

- [การเผยแพร่ทางการและตรวจสอบ](https://github.com/yt-dlp/yt-dlp/releases)

<a id="first-download"></a>

## ดาวน์โหลดวิดีโอ


**ใช้วิดีโอสั้น ๆ ก่อน** ระบุ URL เพิ่ม `--no-playlist` และระบุไฟล์โดย ID วิดีโอ คําสั่งพิมพ์เส้นทางสุดท้ายหลังจากผสมและหลังการประมวลผล

**วิดีโอเดียวโฟลเดอร์ออก**

```bash
python -m yt_dlp --js-runtimes deno --impersonate="" --no-playlist -P downloads \
  -o "%(id)s.%(ext)s" --print after_move:filepath \
  "https://www.youtube.com/watch?v=jNQXAC9IVRw"
```

เส้นทางพิมพ์คือไฟล์หลังจากผสมและหลังการประมวลผล เปิดเส้นทางนี้ อย่าคิดว่าไฟล์จะสิ้นสุดลงใน .mp4

ไม่มีรูปแบบที่เกินไป yt-dlp เลือกการไหลที่มีความต้องการ แหล่งที่มีคุณภาพสูงมักจะมีวิดีโอและเสียงที่แยกต่างหากดังนั้นการถ่ายโอนสองครั้งที่ติดตามโดยการผสมผสานของ FFmpeg เป็นปกติ ไฟล์กลางและไฟล์ .part อาจปรากฏในขณะที่งานจะทํางาน

> **อย่ารหัสความแข็งการขยาย**
> ปล่อย %(ext)s ในรูปแบบการออก ชื่อของ WebM Stream file.mp4 เพียงเปลี่ยนชื่อ ตัวเลือกรูปแบบการรีโมทและการแปลงตัดสินใจว่ามีอะไรภายในไฟล์

<a id="formats"></a>

## เลือกคุณภาพและโค้ด


**ตรวจสอบรูปแบบวิดีโอนี้**

```bash
python -m yt_dlp --js-runtimes deno --impersonate="" --no-playlist \
  -F "https://www.youtube.com/watch?v=jNQXAC9IVRw"
```

**เลือกนโยบายไม่ใช่ ID รูปแบบที่คัดลอก** ตรวจสอบความละเอียดการเข้ารหัสและติดตามที่แยก audio/video ID รูปแบบสามารถแตกต่างกันระหว่างแหล่งข้อมูล

| ตัวเลือกหรือตัวเลือก | หมายความว่า | เมื่อใช้ |
| --- | --- | --- |
| บีวี + บีวี | เลือกวิดีโอเพียงการไหลและเสียงเพียงการไหล FFmpeg รวมพวกเขา | คุณต้องการทั้งสองเส้นและสามารถผสมผสานในท้องถิ่น |
| A/B | ลองตัวเลือก A แล้ว B ถ้า A ไม่ได้ใช้ได้ | กําหนดการลดลงอย่างชัดเจนแทนที่จะคิดว่าแหล่งแต่ละแหล่งมีรูปแบบเดียวกัน |
| [height<=1080] | ปล่อยให้มีการไหลสูงกว่า 1080 พิกเซล | การเชื่อมต่อที่แข็งขึ้นเป็นข้อกําหนด |
| -S res:1080 | ความละเอียดที่ต้องการขึ้นไป 1080 คุณสามารถเลือกหนึ่งที่ใหญ่กว่าเมื่อไม่มีที่อยู่ด้านล่าง | 1080p เป็นความต้องการมากกว่าเพดานที่แข็ง |
| --merge-output-format mp4 | เลือกภาชนะเมื่อรวมกระแสแยก | คุณได้เลือกการไหลที่เข้ากันได้ มันไม่สามารถรหัสผ่าน |

**ปกป้องรหัสแหล่งข้อมูลด้วยหลังคาที่แข็ง 1080p**

```bash
python -m yt_dlp --js-runtimes deno --impersonate="" --no-playlist \
  -f "bv*[height<=1080]+ba/b[height<=1080]" -P downloads \
  "https://www.youtube.com/watch?v=jNQXAC9IVRw"
```

นี้สามารถผลิต WebM, MP4 หรือคอนเทนเนอร์ที่สนับสนุนอื่น ๆ มันไม่ประสบความสําเร็จถ้าไม่มีรูปแบบที่ตรงกับเพดานมันไม่ดาวน์โหลดอย่างเงียบ 4K

สําหรับเครื่องแก้ไขหรือเครื่องเล่นที่ต้องการวิดีโอ H.264 และเสียง AAC กรองโค้ดเหล่านี้และผสมกับ MP4 MP4 เป็นภาชนะ: ระหว่างในภาชนะ MP4 สามารถยังคงมีตัวเข้ารหัสโปรแกรมของคุณไม่สามารถ decode

**คําขอ H.264 + AAC, จนถึง 1080p**

```bash
python -m yt_dlp --js-runtimes deno --impersonate="" --no-playlist \
  -f "bv[vcodec^=avc1][height<=1080]+ba[acodec^=mp4a]/b[vcodec^=avc1][acodec^=mp4a][height<=1080]" \
  --merge-output-format mp4 -P downloads "https://www.youtube.com/watch?v=jNQXAC9IVRw"
```

หากคดเคกที่ต้องการไม่สามารถใช้ได้ตัวเลือกที่เข้มงวดนี้จะผิดพลาด การตัดสินใจว่าจะยอมรับคดเคกแหล่งที่มาหรือ transcode ใด ๆ ไม่ต้องลบข้อกําหนดโดยการฉุกเฉิน

Remuxing ระบายน้ําไหลโดยไม่ต้องรหัสใหม่ การแปลงการเปลี่ยนแปลงของตัวเข้ารหัสและใช้ CPU ในขณะที่อาจเปลี่ยนคุณภาพ ใช้ --remux-video เมื่อการไหลจะเข้ากับภาชนะเป้าหมายแล้ว ใช้การแปลง FFmpeg ที่จะถูกนํามาใช้เมื่อ decoder downstream ต้องใช้ codecs อื่น ๆ

<a id="audio"></a>

## การบันทึกเสียงหรือ MP3


หากท่อการถ่ายโอนของคุณยอมรับรหัสเสียงแหล่งที่มาดาวน์โหลดการไหลโดยตรง นี่จะหลีกเลี่ยงการแปลงที่ขาดทุนที่ไม่จําเป็น MP3 เป็นประโยชน์เมื่อผู้บริโภคต้องการอย่างเฉพาะเจาะจง; ระดับสูง MP3 ไม่สามารถกู้คืนรายละเอียดที่หายไปในแหล่งข้อมูล

**รักษาเสียงที่ดีที่สุดที่พร้อมใช้งาน**

```bash
python -m yt_dlp --js-runtimes deno --impersonate="" --no-playlist -f ba -P audio \
  -o "%(id)s.%(ext)s" "https://www.youtube.com/watch?v=jNQXAC9IVRw"
```

รอตู้แหล่งและโค้ดทั่วไป M4A/AAC หรือ WebM/Opus.

**แปลงเสียงเป็น MP3**

```bash
python -m yt_dlp --js-runtimes deno --impersonate="" --no-playlist -f ba -x \
  --audio-format mp3 --audio-quality 0 -P audio -o "%(id)s.%(ext)s" \
  "https://www.youtube.com/watch?v=jNQXAC9IVRw"
```

ต้องใช้ FFmpeg --audio-quality 0 เลือกการตั้งค่าคุณภาพตัวเลือกที่ดีที่สุดของคุณ ใช้อัตราบิตเช่น 192K เมื่อคุณต้องการการกําหนดค่า downstream ของคุณ

<a id="sidecars"></a>

## การบันทึก captions และ metadata


การเก็บรวบรวมที่มีประโยชน์ต้องการมากกว่าชื่อ filenames เก็บ ID วิดีโอ URL หลักชื่อระยะเวลาและตัวอักษรที่มีอยู่เพื่อให้คุณสามารถค้นหาการเก็บรวบรวมและติดตามสินทรัพย์กลับไปยังแหล่งของมัน เริ่มต้นโดยการจัดอันดับเส้นทางของบันทึก; การขอ en ไม่หมายความว่าวิดีโอแต่ละคนมีเส้นทางภาษาอังกฤษ

**ตรวจสอบการจับภาพแล้วบันทึกการติดตามภาษาอังกฤษโดยไม่ต้องสื่อ**

```bash
python -m yt_dlp --list-subs "https://www.youtube.com/watch?v=jNQXAC9IVRw"
python -m yt_dlp --skip-download --write-subs --write-auto-subs --sub-langs "en.*" \
  --sub-format "vtt/best" -P captions -o "%(id)s.%(ext)s" \
  "https://www.youtube.com/watch?v=jNQXAC9IVRw"
```

--write-subs เลือกหัวข้อที่จัดหา --write-auto-subs นอกจากนี้ยังอนุญาตให้การจับภาพอัตโนมัติ ซึ่งจะรับติดตามที่มีอยู่และไม่ส่งวิดีโอที่มีไม่มี

**Media ด้วยข้อมูลโลหะและขนาดเล็ก**

```bash
python -m yt_dlp --js-runtimes deno --impersonate="" --no-playlist --write-info-json \
  --write-thumbnail -P downloads -o "%(id)s.%(ext)s" \
  "https://www.youtube.com/watch?v=jNQXAC9IVRw"
```

ไฟล์ .info.json เป็นข้อมูลการดําเนินงานรายละเอียดและไม่ใช่การตอบสนอง API สาธารณะที่สะอาด มันสามารถรวมถึง URL ของสื่อที่หมดอายุและฟิลด์ที่เกี่ยวข้องกับคําขอ ปกป้องหน้าจอด้านบนเต็มรูปแบบพร้อมกับการเก็บรวบรวมและส่งออกเพียงฟิลด์ที่ระบบ Downstream ของคุณต้องการ หากคุณต้องการ SRT แทน VTT เพิ่ม --convert-subs srt และให้แน่ใจ FFmpeg มี

<a id="dataset"></a>

## สร้างรายการ AI Dataset


สําหรับการฝึกอบรมตัดสินใจเกี่ยวกับสื่อและข้อความออกจากกัน ข้อกําหนดทั่วไปคือวิดีโอและเสียงที่ดีที่สุดที่มีอยู่รวมเป็น MP4 กับการจับภาพและข้อมูลการสกัดที่กําหนดเองที่เก็บไว้ภายใต้ ID วิดีโอเดียวกัน พื้นที่การแก้ปัญหาที่ใช้งานได้สําหรับการตรวจสอบเป็นข้อกําหนดที่ผิดปกติสําหรับชุดข้อมูลที่มีคุณภาพแหล่งข้อมูล

**ดาวน์โหลดรายการชุดข้อมูลทั้งหมด**

```bash
python -m yt_dlp --js-runtimes deno --impersonate="" --no-playlist \
  -f "bestvideo+bestaudio/best" \
  --merge-output-format mp4 --remux-video mp4 \
  --write-info-json --write-subs --write-auto-subs \
  --sub-langs "en" --sub-format "vtt/best" \
  --sleep-subtitles 5 --concurrent-fragments 1 \
  -P dataset -o "%(id)s/%(id)s.%(ext)s" \
  --print after_move:filepath "https://www.youtube.com/watch?v=jNQXAC9IVRw"
```

ตัวอย่าง Bash. FFmpeg รวมการไหลแยกต่างหาก; --remux-video ยังครอบคลุมการไหลรวม. ใช้แท็กภาษาที่ถูกต้องจาก --list-subs; เปลี่ยน en กับภาษาที่คุณต้องการชุดข้อมูล.

เริ่มต้นด้วยภาษาที่ถูกต้อง ในการตรวจสอบสดของเรา, en.* เลือก en, en-en และ en-de; ระยะทางที่สามกลับ 429 ก่อนที่จะเริ่มดาวน์โหลดสื่อ ข้อผิดพลาดการเขียนสามารถหยุดรายการในขั้นตอนนี้ หลังจากที่การเย็น, ถอนเส้นทางที่ต้องการเท่านั้น, หรือแบ่งสื่อและงานบันทึกถ้าการเก็บรวบรวมของคุณต้องรักษาการเข้าถึงสื่อเคลื่อนไหว.

การ / ดีที่สุด Fallback ช่วยให้มีการไหลรวม video/audio เมื่อเส้นทางแยกต่างหากไม่สามารถใช้ได้ ลบการลบนี้หากสัญญาการเก็บรวบรวมของคุณต้องการแหล่งข้อมูล bestvideo และ bestaudio ที่แยกต่างหาก MP4 ไม่หมายความ H.264: สูตรนี้เก็บรหัสแหล่งที่เลือก ใช้ตัวเลือกที่เข้มงวด H.264/AAC ด้านบนถ้าการฝึกอบรมของคุณ decoder ต้องการ codecs หรือ transcode เป็นขั้นตอนที่แยกออกบันทึก

**ไฟล์ที่คาดหวังเมื่อมี track ภาษาอังกฤษ**

```text
dataset/VIDEO_ID/
  VIDEO_ID.mp4
  VIDEO_ID.info.json
  VIDEO_ID.en.vtt
```

ปลั๊กอินชื่อเสียงใช้แท็กภาษาจริง ไม่มีไฟล์ชื่อเสียงจะถูกสร้างขึ้นเมื่อติดตามที่ขอไม่ได้มีอยู่ อย่าระบุการครอบคลุมข้อความเสร็จสิ้นเพียงเพราะ MP4 หมดอายุ

| เงื่อนไข | การตัดสินใจเก็บ |
| --- | --- |
| คุณภาพแหล่งที่มาที่มีอยู่สูงสุด | ใช้ bestvideo + bestaudio, บันทึกรหัสแหล่งและตรวจสอบการไหลผสมด้วย ffprobe |
| ภาษาไทย | ปกป้องเซ็กซ์และภาษา VTT/SRT พร้อมกับ ID วิดีโอ การแสดงข้อความแบบเรียบจะแสดงให้เห็นถึงเวลาที่จําเป็นสําหรับการปรับแต่งคลิป |
| ไม่มีคำอธิบายภาพ | บันทึกข้อความที่หายไปอย่างชัดเจน หมายเลขเสียงที่บันทึกไว้ไปยังขั้นตอนการแปลของคุณหากข้อความเป็นสิ่งจําเป็น |
| การรับรองสําหรับหลายภาษา | คําถามเฉพาะภาษาที่ต้องการ สารสถักเพิ่มเติมแต่ละครั้งเพิ่มคําขอและสามารถพบ 429 โดยไม่คํานึงถึงสื่อ |
| การส่งข้อความ + การส่งข้อความ | ใช้ไฟล์ไฟล์ชุดข้อมูลที่แยกและสํารองข้อมูลที่มีสถานการณ์สื่อ metadata และ caption หนึ่งรายการไฟล์ไม่สามารถพิสูจน์ให้เห็นว่าทุกหน้าที่จําเป็นมีอยู่ |

อย่าใช้ไฟล์ที่สร้างขึ้นโดยสื่อก่อนหน้านี้เท่านั้นสําหรับการใช้งานนโยบายใหม่นี้: วิดีโอที่เก็บไว้อาจถูกลบก่อนการเก็บรวบรวมภาพถ่ายที่หายไป หรือดําเนินการนโยบายชุดข้อมูลด้วยเอกสารของตัวเองหรือวางแผนการแก้ไขข้อความที่แยกต่างหากสําหรับ IDs ที่ขาดข้อความ เก็บแคปซูลเดิม หากรูปแบบของคุณต้องการข้อความที่สะอาดโปรดสอดคล้องให้ทําตามขั้นตอนการประมวลผลที่ได้รับการแก้ไข

- [สูตรชุดข้อมูลเดียวกันใน Python](https://flashdata.dev/th/docs/guides/yt-dlp-python-api/reference.md#dataset)
- [การจัดการ caption และ metadata 429s](https://flashdata.dev/th/docs/guides/yt-dlp-429-too-many-requests/reference.md)

<a id="aria2"></a>

## ปรับปรุงการส่งผ่านการส่งผ่านโดยไม่ต้องกังวล IP


aria2c สามารถช่วยเมื่อการเชื่อมต่อเดียวจะนําไปสู่การเชื่อมต่อที่ไม่น่าเชื่อถือหรือความช้าสูง มันไม่สามารถแก้ไขคําขอผู้เล่นที่ปฏิเสธหรือ IP ออกแบบ ก่อนอื่นทําให้ดาวน์โหลดที่บ้านทํางานบนแหล่งเดียว จากนั้นเปรียบเทียบเวลาการถ่ายโอนและข้อผิดพลาดกับจํานวนเล็ก ๆ ของการเชื่อมต่อ aria2

**เริ่มต้นด้วยสองเชื่อมต่อต่อ HTTP การถ่ายโอน**

```bash
python -m yt_dlp --js-runtimes deno --impersonate="" --no-playlist \
  --downloader aria2c --downloader "dash,m3u8:native" \
  --downloader-args "aria2c:-x 2 -s 2 -j 1" \
  --concurrent-fragments 1 \
  -P downloads -o "%(id)s.%(ext)s" "https://www.youtube.com/watch?v=jNQXAC9IVRw"
```

ติดตั้ง aria2 ก่อนหน้านี้ ปล่อยให้ DASH/HLS กับดาวน์โหลดที่บ้านที่นี่เพื่อให้การแข่งขันส่วนที่อยู่ชัดเจน

| การควบคุม | สิ่งที่ จํากัด |
| --- | --- |
| aria2c -x 2 | การเชื่อมต่อกับเซิร์ฟเวอร์เดียวสําหรับการดาวน์โหลด |
| aria2c -s 2 | การแบ่งที่ต้องการสําหรับไฟล์เดียว การแบ่งขึ้นอยู่กับขนาดไฟล์และสนับสนุนเซิร์ฟเวอร์ |
| aria2c -j 1 | รายการที่เกี่ยวข้องภายใน aria2 การเรียกใช้, ไม่ใช่คนอื่น yt-dlp |
| --concurrent-fragments 1 | Fragment ดาวน์โหลดภายในดาวน์โหลด native DASH/HLS |
| งานของคุณ Queue | วิดีโอที่ใช้งานทั้งหมดแบ่งปันโฮสต์เดียวกันหรือ IP ออกแบบโปรกซี่ |

curl-cffi การกําหนดเองเป็นของคําขอของ yt-dlp มันไม่กําหนดตัวอักษรของ aria2 TLS หากดาวน์โหลดที่บ้านทํางาน แต่ aria2 ได้รับ 403 กลับไปที่ที่บ้านก่อนที่จะเปลี่ยนการตั้งค่าเครื่องประดับที่ไม่เกี่ยวข้อง ปกป้องการสกัดและการถ่ายโอนภายนอกในเซสชั่น proxy ที่เดียวกัน

ในการทํางานของ FlashData การเพิ่มความแข่งขันอย่างรุนแรงเกินไปสามารถทําให้เส้นทางทํางานเริ่มกลับ 403 ทันที หากสิ่งนี้เกิดขึ้นหยุดงานอื่น ๆ ไปกลับไปยังคนหนึ่งและเชื่อมต่อหนึ่งแล้วทดสอบ อย่าตอบแทนโดยเพิ่ม aria2 ส่วนแบ่งมากขึ้นหรือยึดกลับของกระแสที่ปฏิเสธเดียวกันใน parallel หาก IP ที่ยังคงถูกปฏิเสธในโหลดต่ําใช้การทํางานของ IP ที่เปลี่ยน 403

**การถ่ายโอนชาวบ้านที่รักษารวมสําหรับเปรียบเทียบ**

```bash
python -m yt_dlp --js-runtimes deno --impersonate="" --no-playlist \
  --downloader native --concurrent-fragments 1 --limit-rate 2M \
  --sleep-requests 2 --sleep-interval 5 --max-sleep-interval 10 \
  -P diagnostics "https://www.youtube.com/watch?v=jNQXAC9IVRw"
```

2M เป็นสายเคเบิลแบนด์วิดธ์วินิจฉัยไม่ได้เป็นข้อ จํากัด ของ YouTube ระยะทางเพิ่มขึ้นเพียงหลังจากที่เส้นทางทํางาน

- [aria2 การเชื่อมต่อและตัวเลือกแบ่ง](https://aria2.github.io/manual/en/html/aria2c.html)
- [403 การกู้คืนคําสั่ง](https://flashdata.dev/th/docs/guides/yt-dlp-403-forbidden/reference.md#rate)
- [การควบคุมอัตราสําหรับข้อมูลและ captions](https://flashdata.dev/th/docs/guides/yt-dlp-429-too-many-requests/reference.md#pacing)

<a id="collections"></a>

## การจัดเก็บ


สําหรับชุดที่รู้จักเล็ก ๆ สร้าง UTF-8 urls.txt ด้วย URL ที่ดูหนึ่งต่อเส้น สําหรับรายการการเล่น YouTube ก่อนอื่นระบุ ID ของมันเป็นตัวอักษร การสกัดแบบแบนตรวจสอบรายการการเล่นโดยไม่ต้องทําการสกัดเต็มสําหรับแต่ละวิดีโอ มันเป็นประโยชน์สําหรับการตรวจสอบช่วง แต่รายการของมันอาจขาดระยะเวลารูปแบบและรายละเอียดความพร้อมใช้งาน

**สร้างรายการเล่น YouTube Manifesto**

```bash
python -m yt_dlp --flat-playlist --print "https://www.youtube.com/watch?v=%(id)s" \
  "https://www.youtube.com/playlist?list=YOUR_PLAYLIST_ID" > urls.txt
```

แทน YOUR_PLAYLIST_ID ตรวจสอบ urls.txt ก่อนที่จะเริ่มการถ่ายโอนสื่อ การนําทางใหม่จะแทนที่ตัวอักษรนี้หากคุณเรียกใช้มันอีกครั้ง

เพื่อทดสอบการเก็บรวบรวมช็อตเลือกรายการรายการเล่นหลายรายการที่มี --playlist-items 1:5 บัตร / วิดีโอของช่องเป็นจุดเริ่มต้นที่ชัดเจนมากขึ้นสําหรับวิดีโอที่อัพโหลดกว่าหน้าแรกช่องที่ไม่เห็นได้ชัด อย่าใช้คําสั่งซื้อรายการเล่นเป็นความระบุตัวตน: รายการสามารถใส่ใหม่หรือลบได้

| ฟิล์ม | ใช้ | ผลกระทบ |
| --- | --- | --- |
| --playlist-items 1:5 | 5 รายการแรกในรายการปัจจุบัน | มีประโยชน์สําหรับการทดสอบขนาดเล็กไม่ใช่จุดตรวจสอบที่ทนทาน |
| --dateafter 20260101 | ปล่อยให้เข้าสู่ระบบที่วันที่หรือหลังเดือนกุมภาพันธ์ 1, 2026 | การกรองวันที่อาจต้องใช้การสกัดต่อวิดีโอ |
| --match-filters "!is_live & duration <= 1800" | ต้องการรายการที่ไม่สดที่มีระยะเวลาที่รู้จักในเวลาสูงสุด 30 นาที | การเข้าสู่ระบบที่มีระยะเวลาที่ไม่รู้จักไม่ตรงกับกรองที่เข้มงวดนี้ |
| --download-archive archive.txt | Skip IDs ที่บันทึกไว้แล้วโดยการดาวน์โหลดก่อนหน้านี้ | ทํางานผ่านชื่อที่เปลี่ยนแปลงและตําแหน่ง playlist |

<a id="repeatable"></a>

## การจัดเก็บข้อมูลได้อย่างปลอดภัย


เก็บต่อไปนี้เป็น yt-dlp-work.conf ในโฟลเดอร์การเก็บข้อมูลของคุณนอกเหนือจาก urls.txt มันกําหนดนโยบายการผลิตครั้งเดียวให้เก็บรวบรวมของตัวเองและ จํากัด retries บันทึกไฟล์ออกและไฟล์นี้พร้อมกัน: ไฟล์บันทึกความสําเร็จโดยผู้สกัดและ ID ไม่ได้โดยจํานวนการตรวจสอบหรือสถานที่ของไฟล์ปัจจุบัน

**yt-dlp-work.conf**

```text
# YouTube worker baseline
--js-runtimes deno
--impersonate=""
--concurrent-fragments 1

# Output policy
--no-playlist
-f "bv*[height<=1080]+ba/b[height<=1080]"
-P downloads
-o "%(channel_id)s/%(id)s.%(ext)s"
--write-info-json

# Resume and remember completed media
--continue
--download-archive archive.txt
--no-abort-on-error

# Bound each attempt and spread out work
--retries 5
--fragment-retries 5
--socket-timeout 30
--sleep-requests 1
--sleep-interval 5
--max-sleep-interval 10

# Append paths only after the final move
--print-to-file after_move:filepath completed-paths.txt
```

การกําหนดค่าข้อความเรียบ, ตัวเลือกหนึ่งต่อเส้น ขั้นตอนในตัวอย่างนี้เป็นเรื่องเกี่ยวกับแผนที่ทํางาน ใช้เส้นทางที่สมบูรณ์เมื่อโปรแกรมเริ่มต้นที่อื่น ๆ

**การดําเนินการการเก็บรวบรวม**

```bash
python -m yt_dlp --ignore-config --config-locations yt-dlp-work.conf --batch-file urls.txt
```

--ignore-config จะลบการกําหนดค่า user/system ระบุไว้ และไฟล์ --config-locations ที่จัดหาอย่างชัดเจนยังคงโหลด

ทํางานตามคําสั่งเดียวกันหลังจากหยุด ID ที่เสร็จสิ้นจะถูกลบและการถ่ายโอนส่วนที่สามารถเรียกคืนได้ยังคงอยู่ที่ได้รับการสนับสนุน ความผิดพลาดในการสกัดสามารถแก้ไขได้ในขั้นตอนต่อไป ไฟล์ส่วนที่กําหนดเองเป็นสถานะที่เป็นประโยชน์ อย่าลบพวกเขาเป็นขั้นตอนการคืนเงินแบบปกติ

> **ไฟล์ที่แยกสําหรับผลลัพธ์ที่แยกต่างหาก**
> หนึ่ง ID ใน archive.txt ไม่แตกต่าง MP3, 1080p และ 4K ใช้ไฟล์ไฟล์ที่แตกต่างกันสําหรับนโยบายการออกที่แตกต่างกัน หากคุณลบไฟล์สื่อ แต่เก็บข้อมูลของไฟล์ yt-dlp จะยังคงลบ หากคุณอัพโหลดไฟล์ไปยังจัดเก็บคลาวด์แล้วบันทึกการอัพโหลดประสบความสําเร็จแยกจากการดาวน์โหลดประสบความสําเร็จในท้องถิ่น

--no-abort-on-error ยังคงผ่านการเข้าถึงที่ไม่สามารถใช้ได้ แต่การทํางานยังคงสามารถออกจาก nonzero และข้อผิดพลาดหลังการประมวลผลต้องระวัง อย่าเพิ่ม --ignore-errors เพียงแค่เพื่อให้ได้งานสีเขียว: มันสามารถรักษาความผิดพลาดหลังการประมวลผลเป็นดาวน์โหลดที่ประสบความสําเร็จ ตรวจสอบรายงานและผลลัพธ์ที่เสร็จสิ้นก่อนประกาศการเก็บรวบรวมเสร็จสิ้น

<a id="verify"></a>

## ตรวจสอบไฟล์เสร็จสิ้น


ไฟล์ completed-paths.txt เป็นข้อมูลเริ่มต้นที่ใช้งานได้ การทดสอบผลสุดท้ายจริงแทนที่จะเป็นวิดีโอเพียงการไหลในเวลา ffprobe อ่านคอนเทนเนอร์และข้อมูลโลหะการไหล; การเข้ารหัสผ่านแยกต่างหากจะจับปัญหาที่หัวที่สามารถอ่านได้เท่านั้นจะหายไป

**ตรวจสอบไฟล์เสร็จสิ้น**

```bash
ffprobe -v error -show_entries format=duration,size:stream=codec_type,codec_name,width,height -of json "downloads/CHANNEL_ID/VIDEO_ID.mp4"
```

เปลี่ยนเส้นทางด้วยหนึ่งจาก completed-paths.txt ตรวจสอบระยะเวลาที่คาดหวังการไหล audio/video ที่จําเป็นและโค้ดที่เข้ากันได้กับตัวทําความสะอาด

**การตรวจสอบการตกแต่งเต็มรูปแบบ**

```bash
ffmpeg -v error -i "downloads/CHANNEL_ID/VIDEO_ID.mp4" -f null -
```

อ่านและ decode the whole file without creating a new media output. ตรวจสอบสถานะออกเช่นเดียวกับข้อความ; นี้ใช้เวลานานกว่า ffprobe.

| ค้นหา | วิธีแก้ไข |
| --- | --- |
| เท่านั้นไฟล์ .part หรือไฟล์ Stream ส่วนที่แยกอยู่ | ตรวจสอบข้อผิดพลาด transfer/merge และรีไซเคิลงานเดิม อย่าลบไฟล์แบบกลางที่สมบูรณ์ |
| วิดีโอเล่นโดยไม่มีเสียง | ตรวจสอบรูปแบบที่เลือกและ ffprobe Streams รูปแบบวิดีโอเท่านั้นต้องเลือกเสียงและผสม |
| MP4 จะไม่เปิดในตัวแก้ไขของคุณ | ตรวจสอบโค้ดไม่เพียง แต่การขยายตัว เลือกสตรีมที่เข้ากันได้หรือ transcode ระบุอย่างชัดเจน |
| ไฟล์ที่เก็บไว้ แต่ไม่มีไฟล์ในท้องถิ่น | ตรวจสอบว่าไฟล์คือ moved/deleted. คอมเพลิดเพลินกับสํารองข้อมูลก่อนที่จะเปลี่ยนรายการของไฟล์ |

<a id="schedule"></a>

## 9 การย้ายคําสั่งที่ได้รับการพิสูจน์ไปยังงานที่วางแผน


การดําเนินการคําสั่งทั้งหมดอย่างประสบความสําเร็จด้วยมือก่อนที่จะวางแผน บันทึกทั่วไปเริ่มต้นด้วย PATH และไดเรกทอรีทํางานที่แตกต่างกัน ให้มันเส้นทาง Python เต็มของสภาพแวดล้อมเสมือนเส้นทางการกําหนดค่าเต็มและไดเรกทอรีทํางานที่ชัดเจน นอกจากนี้ยังให้ FFmpeg และเวลาทํางานของ JavaScript มีสําหรับกระบวนการนี้

- ใช้คนเดียวสําหรับ collection/archive. อย่าปล่อยให้การทํางานของวันอาทิตย์เกินไปการทํางานของวันนี้กับผลลัพธ์เดียวกัน
- ใน Linux ใช้ timer/service หรือ cron entry ด้วย directory และ lock เช่น flock ปล่อยบันทึกนอกโฟลเดอร์สื่อและหมุนพวกเขา
- ใน macOS ใช้การเปิดตัวพร้อมเส้นทางที่สามารถดําเนินการได้และทํางานได้
- ใน Windows Task Scheduler, ปรับแต่งโปรแกรมเพื่อสภาพแวดล้อม python.exe, Arguments to -m yt_dlp และตัวเลือกการกําหนดค่าและชุดและเริ่มต้นไปที่โฟลเดอร์การเก็บรวบรวม
- ระยะเวลาบันทึก start/end รุ่นที่สามารถดําเนินการได้ปรากฏตัวของแหล่งข้อมูลสถานะออกและ completed/failed ค่าใช้จ่าย การออกแบบไม่ Zero ไม่หมายความว่ารายการใด ๆ จะล้มเหลว
- เก็บไฟล์คุกกี้และใบรับรองปลายทางออกจากกล่องเก็บข้อมูลการกําหนดค่าที่แบ่งปัน ให้งานเพียงใบรับรองที่ต้องการ

ตัวเลือกนอนใน config จะทํางานภายในกระบวนการเดียว 10 คนที่ใช้การตั้งค่าเดียวกันยังคงผลิต 10 กระแสคําขอที่ผ่านการกระแทก เพิ่ม --concurrent-fragments เปลี่ยนความแข่งขันของ fragments ในภายในการดาวน์โหลดไม่ใช่จํานวนวิดีโอในแถบงานของคุณ

<a id="maintain"></a>

## เลือกคู่มือข้อผิดพลาดที่เหมาะสม


**ปรับปรุงสภาพแวดล้อม Python**

```bash
python -m pip install -U --pre "yt-dlp[default,curl-cffi]"
python -m yt_dlp --version
```

เมื่อแหล่งที่ทํางานก่อนหน้านี้แตกแล้วปรับปรุงให้เร็วที่สุดคืนแรกรวมถึงสารเติมแต่งที่ตรงกัน สําหรับการใช้งานไบนารีแบบแยกต่างหาก yt-dlp --update-to ในตอนเย็น -U เท่านั้นอยู่บนช่องปัจจุบัน การทํางานในช่องว่างเล็ก ๆ หลังจากปรับปรุงแต่ละครั้งแล้วสร้างขึ้นใหม่ของพนักงานและบันทึกการแก้ไขเพื่อให้เรือไม่ผสมตัวอย่างอย่างเงียบสงบ

| Sumpotom | เริ่มที่นี่ |
| --- | --- |
| `Requested format is not available` | รายการรูปแบบและตรวจสอบกรองที่เข้มงวดของคุณก่อนที่จะเปลี่ยนการถอน |
| `ffmpeg not found` / `ffprobe and ffmpeg not found` | ตรวจสอบ PATH จากบัญชีผู้ทํางานหรือชาร์จจริง |
| การท้าทาย JavaScript / การแจ้งเตือนการทํางานที่หายไป | ตรวจสอบการตรวจจับเวลาทํางานและแพคเกจ EJS ที่ตรงกันข้าม |
| HTTP 403 ในระหว่างการถ่ายโอน | การระบุผู้เข้าพักที่ปฏิเสธและสถานการณ์แยกจากการถ่ายโอนสื่อ |
| HTTP 429 | ปิด IP ที่ได้รับผลกระทบให้มีการคูลดอนและอัตราการร้องขอต่ํากว่า extraction/caption |
| `Sign in to confirm you’re not a bot` | ปิดชุดและวินิจฉัยแหล่งหนึ่งเซสชั่นและเครือข่าย |

- [403 การวินิจฉัยการไหลของงาน](https://flashdata.dev/th/docs/guides/yt-dlp-403-forbidden/reference.md)
- [การตรวจวินิจฉัยของ Bot-check Workflow](https://flashdata.dev/th/docs/guides/yt-dlp-sign-in-not-a-bot/reference.md)
- [429 การกู้คืนอัตรา จํากัด](https://flashdata.dev/th/docs/guides/yt-dlp-429-too-many-requests/reference.md)
- [คําสั่งรายวัน](https://flashdata.dev/th/docs/guides/yt-dlp-commands/reference.md)
- [สร้างผู้ทํางาน Python](https://flashdata.dev/th/docs/guides/yt-dlp-python-api/reference.md)

<a id="managed-downloads"></a>

## เมื่อการผลิตอยู่ในท่อคลาวด์


หากคุณต้องการเป็นเจ้าของดาวน์โหลดแล้วการทํางานที่ด้านบนจะช่วยให้คุณสามารถควบคุมไฟล์รูปแบบและประมวลผลได้ หากแอพของคุณต้องการสื่อที่เสร็จสิ้นที่ส่งไปยังจัดเก็บ FlashData ให้การติดตาม YouTube ดาวน์โหลดงานการจัดการ bot, การนําทางโปรกซี่และ retries การสมัครของคุณส่งการตั้งค่าแหล่งและผลผลิตแล้วเก็บรหัสการทํางานและบันทึกการจัดส่ง

- [การเปรียบเทียบสองรูปแบบการดําเนินงาน](https://flashdata.dev/th/docs/guides/flashdata-vs-yt-dlp/reference.md)
- [ดาวน์โหลดวิดีโอ YouTube จำนวนมาก](https://flashdata.dev/th/products/youtube-download#bulk-downloads)
- [ลองดาวน์โหลด demo](https://flashdata.dev/th/products/youtube-download#playground)
- [ดาวน์โหลด API](https://flashdata.dev/th/docs/sources/youtube_download/reference.md)

<a id="references"></a>

## วัสดุการอ้างอิง


ตัวเลือก upstream เป็นแหล่งที่มาของความจริงสําหรับรุ่นที่ติดตั้งของคุณ ใช้ส่วนเหล่านี้เมื่อเปลี่ยนนโยบายการเก็บรวบรวมหรืออัปเดตภาพของผู้ทํางาน

- [การเลือกและจัดรูปแบบ](https://github.com/yt-dlp/yt-dlp#format-selection)
- [การตั้งค่าโหลด](https://github.com/yt-dlp/yt-dlp#configuration)
- [หลักสูตรการส่งออก](https://github.com/yt-dlp/yt-dlp#output-template)
- [คำถามที่พบบ่อยเกี่ยวกับ yt-dlp](https://github.com/yt-dlp/yt-dlp/wiki/FAQ)
