# Cách sử dụng yt-dlp

Hướng dẫn tải xuống hằng ngày ưu tiên Linux, gồm cài đặt bản nightly, chọn định dạng, lấy phụ đề, tạo tập dữ liệu và tiếp tục thu thập khi bị gián đoạn.

Tài liệu tham khảo chính điển: https://flashdata.dev/vi/docs/guides/how-to-use-yt-dlp
Xem lại: 2026-11-13 by FlashData

- [Thiết lập các công cụ](https://flashdata.dev/vi/docs/guides/how-to-use-yt-dlp/reference.md#install) — Python, FFmpeg và JavaScript
- [Chọn sản xuất](https://flashdata.dev/vi/docs/guides/how-to-use-yt-dlp/reference.md#formats) — Video, Audio và Captions
- [Lặp lại một bộ sưu tập](https://flashdata.dev/vi/docs/guides/how-to-use-yt-dlp/reference.md#repeatable) — Manifest, config và archive
- [Đặt lại một chạy thất bại](https://flashdata.dev/vi/docs/guides/how-to-use-yt-dlp/reference.md#maintain) — Tìm đúng chẩn đoán

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

## Cài đặt dòng sử dụng hàng ngày


**Bắt đầu với đêm + Deno + FFmpeg.** Sử dụng một môi trường ảo dự án và kích hoạt trình duyệt cá nhân hóa với `--impersonate=""`. cài đặt Linux bên dưới cài đặt các công cụ; macOS và Windows thay thế là trong tab.

**Linux**

Ví dụ Ubuntu / Debian với Python 3.11+. cài đặt các công cụ hệ thống, tạo một môi trường ảo dự án, sau đó cài đặt đêm hiện tại và các chi tiết của nó. chạy bộ cài đặt Deno như người dùng tương tự sở hữu nhân viên.


**Linux Workers thiết lập**

```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**

Với Homebrew cài đặt, sử dụng nó cho Python, Deno, FFmpeg và aria2. Giữ yt-dlp trong môi trường dự án để lệnh cập nhật ban đêm là tương tự như trên Linux.


**Cài đặt 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**

Cài đặt Python 3.11+, Deno và các executables FFmpeg, sau đó mở một terminal mới. Sử dụng trình dịch môi trường trực tiếp nếu PowerShell chặn kích hoạt. aria2 là tùy chọn; cài đặt nó riêng biệt nếu sử dụng công thức tải xuống bên ngoài.


**Windows môi trường**

```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
```


| Công cụ | Điều nó làm | Kiểm tra |
| --- | --- | --- |
| Python 3.11+ | Thực hiện gói Python và các ví dụ trong loạt này. | python --version |
| Cuối cùng yt-dlp đêm + mặc định,curl-cffi thêm | YouTube hiện tại extractor, phù hợp với EJS solver và trình duyệt impersonalation hỗ trợ. | python -m yt_dlp --version |
| FFmpeg và ffprobe | Kết hợp các dòng, chuyển đổi âm thanh, cắt clip và kiểm tra các phương tiện được tiết kiệm. | ffmpeg -version / ffprobe -version |
| Deno 2.3+ (được yêu cầu trong dòng công việc này) | Tạo các thách thức của YouTube. cài đặt nó trên mỗi nhân viên, không chỉ máy phát triển của bạn. | deno --version |

**Cài đặt các executables cũng.** `[default]` cung cấp các bản EJS; Deno được phân biệt. FFmpeg và ffprobe cũng phải trên PATH của nhân viên.

**Xem toàn bộ 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
```

Lệnh cuối cùng nên liệt kê các mục tiêu trình duyệt có sẵn. Nếu mục tiêu không có sẵn, hãy chắc chắn rằng curl-cffi được cài đặt trong môi trường ảo chính xác này.

**Thử nghiệm với Deno và trình duyệt Impersonal**

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

Kiểm tra các dòng chạy JS và yêu cầu-thân thủ. một mô phỏng kiểm tra khai thác; theo nó với một chuyển đổi thực tế.

Dòng hoạt động của FlashData bao gồm --impersonate=": nó cho phép curl-cffi chọn một dấu vân tay trình duyệt có sẵn. Điều này thay đổi dấu vân tay yêu cầu; nó không cung cấp cookie đăng nhập, giải quyết các thách thức của JavaScript hoặc thay đổi IP xuất. Nếu tùy chọn này làm chậm một con đường làm việc hoặc nhập lỗi, lặp lại cùng một bài kiểm tra video mà không có nó và giữ cấu hình làm việc.

> **Một dịch vụ cần có con đường riêng của mình**
> Các nhà cài đặt Deno thường đặt binary trong ~/.deno/bin. Một cái bẫy tương tác tìm thấy nó không thể chứng minh một dịch vụ hệ thống, container hoặc cron công việc có thể. Cài đặt công nhân PATH hoặc pass --js-runtimes deno:/absolute/path/to/deno. Sử dụng con đường Python của môi trường ảo trong lệnh dịch vụ.

- [Cài đặt chính thức](https://github.com/yt-dlp/yt-dlp/wiki/Installation)
- [FFmpeg Tải về](https://ffmpeg.org/download.html)
- [Cài đặt Deno](https://docs.deno.com/runtime/getting_started/installation/)
- [YouTube Runtime thiết lập](https://github.com/yt-dlp/yt-dlp/wiki/EJS)

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

### Kiểm tra giải phóng trước khi đặt nó trên một nhân viên


Nhận executables từ trang phát hành của dự án chính thức, hoặc cài đặt gói Python từ nguồn gói được công bố. Nếu bạn tải xuống một binary độc lập, so sánh SHA-256 của nó với tên file tương ứng trong SHA2-256SUMS của phiên bản đó. Ghi lại bản phát hành và số kiểm tra với hình ảnh của nhân viên của bạn để bạn có thể xác định chính xác những gì đã chạy.

**Linux**


**Hash file download**

```bash
sha256sum yt-dlp
```


**macOS**


**Hash file download**

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


**Windows**


**Hash file download**

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


Một so sánh tiền kiểm toán chỉ hữu ích khi giá trị dự kiến đến từ phát hành đáng tin cậy, không phải gương không rõ như thể thực hiện. Nếu phần mềm bảo mật bay một tập tin, hãy kiểm tra nguồn và báo cáo trước khi thực hiện ngoại lệ. Chỉ có khả năng truy cập nguồn mở không phải là bằng chứng rằng mọi plugin nhị phân hoặc bên thứ ba được tải xuống đều an toàn.

Trả các tệp cấu hình chung như mã để xem xét: các tùy chọn như --exec có thể khởi động lệnh, và plugin thêm mã vào quá trình tải xuống. giữ cookie trình duyệt, chứng nhận proxy và URL đã ký từ ví dụ cấu hình và báo cáo chẩn đoán.

- [Báo cáo chính thức và checksums](https://github.com/yt-dlp/yt-dlp/releases)

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

## Download 1 video


**Sử dụng một đoạn video ngắn đầu tiên.** Nhập URL, thêm `--no-playlist` và đặt tên tệp bằng ID video.

**1 video, 1 thư mục xuất**

```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"
```

Đường được in là file sau khi kết hợp và post-processing. mở đường đó; đừng giả định file sẽ kết thúc trong .mp4.

Không có quá trình định dạng, yt-dlp chọn dòng có sẵn được ưa thích của nó. Nguồn chất lượng cao thường có các dòng video và âm thanh riêng biệt, vì vậy hai chuyển đổi theo sau là một FFmpeg kết hợp là bình thường. Các tệp trung gian và một tệp .part có thể xuất hiện trong khi công việc đang chạy.

> **Đừng mã hóa phần mở rộng**
> Giữ %(ext)s trong mẫu xuất khẩu.Những tên WebM dòng file.mp4 chỉ thay đổi tên của nó.Phần chọn định dạng, chuyển đổi và chuyển đổi quyết định những gì nằm bên trong tệp.

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

## Chọn chất lượng và codec


**Kiểm tra các định dạng video này**

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

**Chọn một chính sách, không phải là một ID định dạng sao chép.** Kiểm tra độ phân giải, mã hóa và các dấu audio/video riêng biệt.

| Selector hoặc Option | Nghĩa là | Khi nào nên sử dụng |
| --- | --- | --- |
| Đánh giá + ba | Chọn một video-only stream và một audio-only stream; FFmpeg kết hợp chúng. | Bạn cần cả hai con đường và có thể kết hợp địa phương. |
| A/B | Hãy thử chọn A, sau đó B nếu A không sẵn dùng. | Định nghĩa một sự sụp đổ rõ ràng thay vì giả định rằng mỗi nguồn có cùng định dạng. |
| [height<=1080] | Trừ dòng trên 1080 pixel cao. | Một mối liên kết cao hơn là một yêu cầu. |
| -S res:1080 | Thích độ phân giải lên đến 1080; bạn có thể chọn một lớn hơn khi không có bất kỳ bên dưới nào có sẵn. | 1080p là một ưu điểm hơn là một mái nhà cứng. |
| --merge-output-format mp4 | Chọn container khi kết hợp các dòng riêng biệt. | Bạn đã chọn các dòng tương thích. nó không làm cho codec transcode. |

**Giữ các codec nguồn, với một mái nhà cứng 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"
```

Điều này có thể tạo WebM, MP4 hoặc một container hỗ trợ khác. nó thất bại nếu không có định dạng đáp ứng mái nhà; nó không im lặng tải 4K.

Đối với một bộ biên tập hoặc playback đĩa mà cụ thể yêu cầu H.264 video và AAC âm thanh, lọc các codec đó và kết hợp với MP4. MP4 là một container: một dòng trong một container MP4 vẫn có thể chứa một codec ứng dụng của bạn không thể phân mã.

**Yêu cầu H.264 + AAC, lên đến 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"
```

Nếu các codec cần thiết không sẵn dùng, bộ chọn nghiêm ngặt này sẽ thất bại. quyết định xem có phải chấp nhận codec nguồn khác hay transcode; đừng loại bỏ yêu cầu bằng sự cố.

Remuxing tái đóng gói dòng mà không mã hóa lại chúng. Chuyển mã hóa thay đổi codec và tiêu thụ CPU trong khi có thể thay đổi chất lượng. Sử dụng --remux-video khi dòng đã phù hợp với container mục tiêu; sử dụng một chuyển đổi FFmpeg cố ý khi một bộ giải mã downstream yêu cầu codec khác nhau.

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

## Lưu âm thanh hoặc MP3


Nếu đường ống chuyển đổi của bạn chấp nhận mã nguồn âm thanh, tải xuống đó trực tiếp. Điều này ngăn chặn sự chuyển đổi mất mát không cần thiết. MP3 hữu ích khi một người tiêu dùng cụ thể yêu cầu nó; tỷ lệ bit cao MP3 không thể khôi phục lại chi tiết đã bị mất trong nguồn.

**Giữ dòng âm thanh tốt nhất có sẵn**

```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"
```

Tính đến container nguồn và codec, thường M4A/AAC hoặc WebM/Opus.

**Chuyển đổi âm thanh sang 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"
```

Yêu cầu FFmpeg. --audio-quality 0 chọn thiết lập chất lượng biến tốt nhất của nó; sử dụng tốc độ bit như 192K khi thông số kỹ thuật downstream của bạn yêu cầu một.

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

## Lưu captions và metadata


Một bộ sưu tập hữu ích cần nhiều hơn là tên philena. Giữ ID video, URL nguồn, tiêu đề, thời gian và các bản ghi có sẵn để bạn có thể tìm kiếm bộ sưu tập và theo dõi tài sản trở lại nguồn. Bắt đầu bằng cách liệt kê các dấu vết; yêu cầu en không có nghĩa là mỗi video có một dấu vết tiếng Anh.

**Kiểm tra các bản ghi, sau đó lưu các bản ghi tiếng Anh mà không có phương tiện truyền thông**

```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 chọn các tiêu đề được cung cấp; --write-auto-subs cũng cho phép các bản ghi tự động. Điều này thu thập các dấu vết hiện có và không chuyển đổi video mà không có.

**Truyền thông với metadata và một thợ nhỏ**

```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"
```

Tệp .info.json là các metadata hoạt động chi tiết, không phải là một phản ứng API công cộng sạch. Nó có thể bao gồm các URL phương tiện đã hết hạn và các trường liên quan đến yêu cầu. Giữ toàn bộ hộp bên với bộ sưu tập, và xuất chỉ các trường cần thiết của hệ thống downstream của bạn. Nếu bạn cần SRT thay vì VTT, hãy thêm --convert-subs srt và đảm bảo FFmpeg có sẵn.

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

## Xây dựng một AI Dataset item


Đối với một tập luyện, quyết định phương tiện truyền thông và kết quả văn bản cùng nhau. Một yêu cầu chung là video và âm thanh tốt nhất có sẵn, kết hợp vào MP4, với các đoạn ghi và dữ liệu ngoại trừ được giữ dưới cùng ID video. Một mái độ phân giải hữu ích cho các dự báo thường là mặc định sai cho một bộ dữ liệu chất lượng nguồn.

**Tải về một mục dữ liệu đầy đủ**

```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"
```

FFmpeg kết hợp các dòng riêng biệt; --remux-video cũng bao gồm một dòng kết hợp. Sử dụng một thẻ ngôn ngữ chính xác từ --list-subs; thay thế en với ngôn ngữ mà nhu cầu tập dữ liệu của bạn.

Bắt đầu bằng một ngôn ngữ viết chính xác. Trong kiểm tra trực tiếp của chúng tôi, en.* đã chọn en, en-en và en-de; con đường thứ ba trở lại 429 trước khi tải xuống phương tiện truyền thông bắt đầu. Một lỗi ghi chú có thể dừng mục ở giai đoạn đó. Sau một cuộc lạnh, chỉ rút lại các con đường cần thiết, hoặc chia media và ghi lại công việc nếu bộ sưu tập của bạn phải giữ cho sự hấp thụ media di chuyển.

/best fallback cho phép một dòng kết hợp video/audio khi các đường dẫn riêng biệt không sẵn dùng. Xóa bỏ sự suy giảm đó nếu hợp đồng thu thập của bạn yêu cầu các nguồn bestvideo và bestaudio riêng biệt. MP4 không có nghĩa là H.264: công thức này giữ cho các codec nguồn được chọn. Sử dụng bộ chọn H.264/AAC nghiêm ngặt ở trên nếu bộ giải mã đào tạo của bạn yêu cầu các codec đó, hoặc transcode như một bước riêng biệt, ghi lại.

**Các tập tin mong đợi khi có một track tiếng Anh**

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

Không có tệp tweet được tạo khi đường theo yêu cầu không sẵn dùng; đừng chỉ ra việc bao phủ văn bản hoàn thành chỉ vì MP4 đã hoàn thành.

| Cần thiết | Quyết định thu thập |
| --- | --- |
| Chất lượng nguồn cấp cao nhất | Sử dụng bestvideo+bestaudio, giữ codec nguồn và kiểm tra các dòng kết hợp với ffprobe. |
| Tờ văn bản | Giữ các phân đoạn VTT/SRT và ngôn ngữ bên cạnh ID video. Text Flattening discards timing required for clip alignment. |
| Thiếu chú thích | Ghi lại văn bản bị mất một cách rõ ràng.Hãy chuyển âm thanh được lưu đến giai đoạn chuyển đổi của bạn nếu văn bản là bắt buộc. |
| Captions cho nhiều ngôn ngữ | Mỗi track bổ sung thêm yêu cầu và có thể gặp 429 độc lập với phương tiện truyền thông. |
| Truyền thông + Text Delivery | Sử dụng một tập tin dữ liệu riêng biệt và một hồ sơ với các trạng thái phương tiện truyền thông, metadata và caption. Một bản ghi lưu trữ không chứng minh tất cả các trang cần thiết tồn tại. |

Đừng sử dụng lại một tập tin được tạo bởi một phương tiện truyền thông trước đó chỉ chạy cho chính sách mới này: video lưu trữ có thể bị bỏ qua trước khi các bản ghi thiếu của họ được thu thập. Hoặc chạy chính sách tập dữ liệu với bản lưu trữ của riêng bạn hoặc lên lịch một hộ chiếu sửa chữa bản ghi riêng biệt cho ID không có văn bản. Lưu trữ các bản gốc; nếu mô hình của bạn cần văn bản chuyển bản sạch, lấy nó trong một bước xử lý phiên bản.

- [Công thức dữ liệu tương tự trong Python](https://flashdata.dev/vi/docs/guides/yt-dlp-python-api/reference.md#dataset)
- [Chức năng và dữ liệu 429s](https://flashdata.dev/vi/docs/guides/yt-dlp-429-too-many-requests/reference.md)

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

## Tăng cường giao thông chuyển đổi mà không làm hỏng IP


aria2c có thể giúp ích khi một kết nối duy nhất gây ra một liên kết không đáng tin cậy hoặc độ chậm cao. Nó không thể sửa chữa một yêu cầu người chơi bị từ chối hoặc một IP xuất phát nhãn. Đầu tiên làm cho trình tải xuống bản địa làm việc trên một nguồn; sau đó so sánh thời gian chuyển giao và lỗi với một số lượng nhỏ các kết nối aria2.

**Bắt đầu với hai kết nối mỗi chuyển 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"
```

Cài đặt aria2 đầu tiên. giữ DASH/HLS với trình tải về bản địa ở đây để cạnh tranh phân đoạn vẫn rõ ràng.

| kiểm soát | Điều gì giới hạn |
| --- | --- |
| aria2c -x 2 | Kết nối với một máy chủ để tải xuống. |
| aria2c -s 2 | Các phân chia được yêu cầu cho một tệp; phân chia cũng phụ thuộc vào kích thước tệp và hỗ trợ máy chủ. |
| aria2c -j 1 | Các mục tương đối bên trong aria2 lời mời gọi, không phải các công nhân yt-dlp khác. |
| --concurrent-fragments 1 | Fragment download inside the native DASH/HLS downloaders. |
| Công việc của bạn quue | Tổng video hoạt động chia sẻ cùng một host hoặc proxy exit IP. |

curl-cffi Impersonality thuộc về yêu cầu của yt-dlp; nó không cấu hình dấu vân tay TLS của aria2. Nếu bản địa tải xuống làm việc nhưng aria2 nhận được 403, trở lại bản địa trước khi thay đổi cài đặt máy thu không liên quan. Giữ chiết xuất và chuyển giao bên ngoài trong cùng một phiên proxy.

Trong hoạt động của FlashData, việc tăng cường sự cạnh tranh quá hung hăng có thể làm cho một con đường làm việc bắt đầu quay trở lại 403 ngay lập tức. Nếu điều này xảy ra, dừng lại các công việc khác, quay trở lại một nhân viên và một kết nối, sau đó kiểm tra lại. Đừng bù đắp bằng cách thêm nhiều aria2 phân chia hoặc rút lại cùng dòng bị từ chối song song. Nếu IP đó vẫn bị từ chối ở tải thấp, hãy sử dụng dòng công việc thay thế IP 403.

**Chuyển đổi người bản địa bảo thủ để so sánh**

```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 là một đường dây chênh lệch chẩn đoán, không phải là giới hạn YouTube phổ biến. tăng đường qua dần chỉ sau khi con đường đang hoạt động.

- [aria2 kết nối và phân chia tùy chọn](https://aria2.github.io/manual/en/html/aria2c.html)
- [403 Lệnh phục hồi](https://flashdata.dev/vi/docs/guides/yt-dlp-403-forbidden/reference.md#rate)
- [Kiểm soát tỷ lệ cho metadata và captions](https://flashdata.dev/vi/docs/guides/yt-dlp-429-too-many-requests/reference.md#pacing)

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

## Chuẩn bị một bộ sưu tập


Đối với một bộ nhỏ được biết đến, tạo một UTF-8 urls.txt với một URL đồng hồ mỗi dòng. Đối với một danh sách phát trên YouTube, trước tiên liệt kê ID của nó trong một biểu hiện. Phân tích phẳng kiểm tra danh sách phát mà không thực hiện một chi tiết đầy đủ cho mỗi video; nó hữu ích cho việc xem xét phạm vi, nhưng các bài đăng của nó có thể thiếu thời gian, định dạng và chi tiết sẵn dùng.

**Tạo một danh sách phát trên YouTube Manifest**

```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
```

Thay thế YOUR_PLAYLIST_ID. kiểm tra urls.txt trước khi bắt đầu chuyển giao phương tiện truyền thông. chuyển hướng thay thế biểu hiện này nếu bạn chạy nó một lần nữa.

Để thử nghiệm một bộ sưu tập, hãy chọn một vài bài đăng danh sách chơi với --playlist-items 1:5. Một tab /video của kênh là điểm khởi đầu rõ ràng hơn cho video được tải lên hơn là một trang chủ kênh không rõ ràng. Đừng coi lệnh danh sách chơi là một danh tính: các mục có thể được nhập, đặt lại hoặc xóa.

| Bộ lọc | Dùng | hậu quả |
| --- | --- | --- |
| --playlist-items 1:5 | 5 bài đầu tiên trong danh sách hiện tại | Thích hợp cho một thử nghiệm nhỏ, không phải là điểm kiểm tra lâu dài. |
| --dateafter 20260101 | Lưu các bài đăng có ngày vào hoặc sau tháng 1, 2026. | Ngày lọc vẫn có thể yêu cầu thu thập video. |
| --match-filters "!is_live & duration <= 1800" | Yêu cầu một mục không sống với thời gian được biết đến tối đa 30 phút. | Các bài viết có độ dài không rõ sẽ không phù hợp với bộ lọc nghiêm ngặt này. |
| --download-archive archive.txt | Tải ID nguồn đã được ghi lại bởi các bản tải xuống trước đó. | Hoạt động trên các tiêu đề thay đổi và vị trí playlist. |

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

## Tạo lại một bộ sưu tập an toàn


Lưu các điều sau đây như yt-dlp-work.conf trong thư mục thu thập của bạn, bên cạnh urls.txt. Nó xác định chính sách xuất khẩu một lần, cho bộ sưu tập bản thân, và giới hạn rút tiền. Giữ tệp xuất và lưu trữ này cùng nhau: một lưu trữ ghi lại thành công của người khai thác và ID, không phải bởi số kiểm tra hoặc vị trí của tệp hiện tại.

**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
```

Định cấu hình văn bản thẳng, một tùy chọn mỗi dòng. Các con đường trong ví dụ này là tương đối với thư mục làm việc. Sử dụng con đường tuyệt đối khi một kế hoạch có thể bắt đầu ở nơi khác.

**chạy bộ sưu tập**

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

--ignore-config xóa cấu hình user/system mặc định; một tệp --config-locations được cung cấp rõ ràng vẫn được tải lên.

Lặp lại cùng một lệnh sau khi bị gián đoạn. ID hoàn thành được bỏ qua, và chuyển đổi phần tái định hướng tiếp tục ở nơi được hỗ trợ. Các thất bại khai thác có thể được sửa lại trong vòng tiếp theo. Các tệp .part mặc định là trạng thái hữu ích; đừng xóa chúng như một bước rút tiền thường xuyên.

> **Khác lưu trữ riêng cho các kết quả riêng biệt**
> Một ID duy nhất trong archive.txt không phân biệt MP3, 1080p và 4K. Sử dụng các tệp lưu trữ khác nhau cho các chính sách xuất phát khác nhau. Nếu bạn xóa một tệp phương tiện nhưng giữ lại bản ghi lưu trữ, yt-dlp vẫn sẽ bỏ qua nó. Nếu bạn sau đó tải lên các tập tin vào lưu trữ đám mây, ghi lại thành công tải lên riêng biệt với thành công tải xuống địa phương.

--no-abort-on-error tiếp tục qua các bản nhập không sẵn dùng, nhưng một chạy vẫn có thể xuất ra nonzero và lỗi sau xử lý cần chú ý. Tránh thêm --ignore-errors chỉ để có được một công việc xanh: nó có thể xử lý thất bại sau khi xử lý như tải xuống thành công. Xem lại hồ sơ và kết thúc kết quả trước khi tuyên bố bộ sưu tập hoàn thành.

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

## Kiểm tra các tập tin đã hoàn thành


Tệp completed-paths.txt là một bản ghi bắt đầu hữu ích. Kiểm tra kết quả thực tế thay vì một video chỉ tạm thời. ffprobe đọc container và stream metadata; một thông qua phân mã riêng biệt thu thập các vấn đề mà một tiêu đề có thể đọc sẽ thiếu.

**Kiểm tra 1 file đã hoàn thành**

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

Thay thế con đường bằng một từ completed-paths.txt. kiểm tra thời gian dự kiến, cần audio/video dòng chảy và codec tương thích với decoder.

**Chọn Full Decode Check**

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

Đọc và giải mã toàn bộ tệp mà không tạo ra một kết quả phương tiện truyền thông mới. kiểm tra tình trạng xuất phát cũng như tin nhắn; điều này mất nhiều hơn ffprobe.

| Tìm kiếm | Cách xử lý |
| --- | --- |
| Chỉ có một tệp .part hoặc tệp lưu trữ riêng rẽ còn lại | Kiểm tra lỗi transfer/merge và khôi phục lại công việc ban đầu; không đánh dấu tệp trung gian hoàn thành. |
| Video chơi mà không có âm thanh | Kiểm tra định dạng đã chọn và ffprobe dòng. một định dạng video chỉ cần một lựa chọn âm thanh và kết hợp. |
| MP4 sẽ không mở trong biên tập của bạn | Kiểm tra các codec, không chỉ mở rộng; chọn các dòng tương thích hoặc transcode rõ ràng. |
| - Lưu trữ ID nhưng không có tệp địa phương | Kiểm tra xem tệp có moved/deleted. Đặt lại hồ sơ trước khi thay đổi bản ghi lưu trữ. |

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

## 9. di chuyển một lệnh đã được chứng minh vào một công việc có kế hoạch


Thực hiện lệnh hoàn chỉnh thành công bằng tay trước khi lên lịch. Một lịch thường bắt đầu với một PATH và thư mục làm việc khác nhau. Hãy cho nó con đường Python đầy đủ của môi trường ảo, con đường cấu hình đầy đủ và một thư mục làm việc rõ ràng; cũng làm cho FFmpeg và thời gian chạy JavaScript sẵn dùng cho quá trình đó.

- Sử dụng một nhân viên duy nhất cho collection/archive. Đừng để chạy hôm qua vượt quá chạy hôm nay chống lại cùng các kết quả.
- Trên Linux, sử dụng timer/service hoặc cron entry với một thư mục làm việc và một khóa như flock. Giữ các bản ghi bên ngoài thư mục phương tiện và xoay chúng.
- Trên macOS, sử dụng khởi động với các con đường hoàn toàn có thể thực hiện và hướng dẫn làm việc.
- Trên Windows Task Scheduler, hãy đặt Chương trình vào môi trường python.exe, Arguments to -m yt_dlp cộng với các tùy chọn cấu hình và gói, và Start vào thư mục thu thập.
- Lưu start/end thời gian, phiên bản có thể thực hiện, nguồn hiển thị, trạng thái xuất xứ và completed/failed tính toán. một nonzero batch outt không có nghĩa là mỗi item thất bại.
- Giữ tệp cookie và tín hiệu đích ra khỏi lưu trữ cấu hình chung.Hãy cung cấp cho một công việc chỉ những tín hiệu mà nó cần.

Các tùy chọn giấc ngủ trong cấu hình hoạt động trong một quá trình. Mười công nhân sử dụng cùng thiết lập vẫn sản xuất mười dòng yêu cầu lấp lánh. Tăng --concurrent-fragments thay đổi sự cạnh tranh của các mảnh bên trong một tải xuống, không phải số lượng video trong chuỗi công việc của bạn.

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

## Chọn đúng hướng dẫn lỗi


**Cập nhật môi trường Python này**

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

Khi một nguồn làm việc trước đó bị phá vỡ, cập nhật cho đêm cuối cùng đầu tiên, bao gồm các chi tiết phù hợp. Đối với việc sử dụng nhị phân độc lập yt-dlp --update-to ban đêm; -U chỉ ở lại trên kênh hiện tại. Chạy một con đường nhỏ sau mỗi bản cập nhật, sau đó xây dựng lại các nhân viên và ghi lại bản sửa đổi để hạm đội không lặng lẽ trộn các bản phát hành.

| Triệu chứng | Bắt đầu tại đây |
| --- | --- |
| `Requested format is not available` | Danh sách các định dạng và kiểm tra các bộ lọc nghiêm ngặt của bạn trước khi thay đổi các rút. |
| `ffmpeg not found` / `ffprobe and ffmpeg not found` | Kiểm tra PATH từ tài khoản nhân viên hoặc kế hoạch thực tế. |
| JavaScript Challenge / Lắng thời gian chạy cảnh báo | Kiểm tra việc phát hiện thời gian chạy và gói EJS phù hợp. |
| HTTP 403 trong quá trình chuyển giao | Xác định chủ và giai đoạn bị từ chối; khai thác riêng biệt từ truyền thông. |
| HTTP 429 | Ngừng IP bị ảnh hưởng, cho phép một lạnh và tần số yêu cầu thấp hơn extraction/caption. |
| `Sign in to confirm you’re not a bot` | Ngừng việc và chẩn đoán một nguồn, phiên và mạng. |

- [403 Diagnostic Workflow](https://flashdata.dev/vi/docs/guides/yt-dlp-403-forbidden/reference.md)
- [Bot-check Diagnostic Workflow (liên kết  sửa đổi)](https://flashdata.dev/vi/docs/guides/yt-dlp-sign-in-not-a-bot/reference.md)
- [429 Tỷ lệ-thời hạn phục hồi](https://flashdata.dev/vi/docs/guides/yt-dlp-429-too-many-requests/reference.md)
- [Lệnh hàng ngày Reference](https://flashdata.dev/vi/docs/guides/yt-dlp-commands/reference.md)
- [Xây dựng một công nhân Python](https://flashdata.dev/vi/docs/guides/yt-dlp-python-api/reference.md)

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

## Khi sản lượng thuộc về một đường ống đám mây


Nếu bạn muốn sở hữu trình tải xuống, dòng công việc trên sẽ cho bạn kiểm soát các tập tin, định dạng và xử lý. Nếu ứng dụng của bạn cần các phương tiện truyền thông hoàn thành được cung cấp để lưu trữ, FlashData cung cấp các công việc tải YouTube theo dõi, xử lý bot, hướng dẫn proxy và rút tiền. Ứng dụng của bạn gửi các cài đặt nguồn và xuất khẩu, sau đó giữ ID công việc và hồ sơ giao hàng.

- [So sánh hai mô hình hoạt động](https://flashdata.dev/vi/docs/guides/flashdata-vs-yt-dlp/reference.md)
- [Tải video YouTube hàng loạt](https://flashdata.dev/vi/products/youtube-download#bulk-downloads)
- [Thử demo download](https://flashdata.dev/vi/products/youtube-download#playground)
- [Tải về API Reference](https://flashdata.dev/vi/docs/sources/youtube_download/reference.md)

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

## Mục tiêu tài liệu


Các tùy chọn upstream tham chiếu là nguồn sự thật cho phiên bản cài đặt của bạn. Sử dụng các phần này khi thay đổi chính sách thu thập hoặc cập nhật hình ảnh của một nhân viên.

- [Format Selection và Sortering](https://github.com/yt-dlp/yt-dlp#format-selection)
- [Configuration tải](https://github.com/yt-dlp/yt-dlp#configuration)
- [Tương mẫu xuất](https://github.com/yt-dlp/yt-dlp#output-template)
- [yt-dlp hakkında sık sorulan sorular](https://github.com/yt-dlp/yt-dlp/wiki/FAQ)
