# Khắc phục lỗi 403 Forbidden trong yt-dlp

Cập nhật bản nightly, giảm số yêu cầu đồng thời, kiểm tra Deno rồi thử cookie và địa chỉ IP đầu ra hoạt động.

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

- [Bắt đầu thất bại sau khi làm việc](https://flashdata.dev/vi/docs/guides/yt-dlp-403-forbidden/reference.md#versions) — Tăng nhân viên thực sự lên đêm
- [thất bại khi cạnh tranh tăng](https://flashdata.dev/vi/docs/guides/yt-dlp-403-forbidden/reference.md#rate) — Giảm lao động, mảnh và kết nối
- [Proxy IP vẫn thất bại](https://flashdata.dev/vi/docs/guides/yt-dlp-403-forbidden/reference.md#environment) — Kiểm tra và duy trì một con đường thoát thay thế
- [Runtime hoặc token cảnh báo](https://flashdata.dev/vi/docs/guides/yt-dlp-403-forbidden/reference.md#challenges) — Kiểm tra Deno trước, sau đó khung token

<a id="clean-test"></a>

## Cố gắng điều này trước


1. **Cập nhật vào ban đêm.** Cập nhật môi trường Python được sử dụng bởi công nhân thất bại.
2. **Giảm tải.** Ngừng việc làm song song trên IP này; kiểm tra một video và một đoạn cùng một lúc.
3. **Đánh giá Deno.** Kiểm tra rằng log verbose phát hiện thời gian chạy.
4. **Các cookie có hiệu lực.** Đối với một công việc nhỏ, sử dụng một phiên trình duyệt có thể chơi nguồn.
5. **Chọn thay cho IP bị từ chối.** Bắt đầu một chiết xuất tươi thông qua một nhà chủ khỏe mạnh hoặc một cuộc ra đi proxy.

**Update, sau đó kiểm tra thời gian chạy cần thiết**

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

**1 nguồn, 1 tải thấp chuyển**

```bash
python -m yt_dlp --ignore-config --js-runtimes deno --impersonate="" --verbose --no-playlist \
  -f ba -o "diagnostics/%(id)s-%(epoch)s.%(ext)s" --downloader native \
  --concurrent-fragments 1 --limit-rate 2M --sleep-requests 2 \
  "https://www.youtube.com/watch?v=jNQXAC9IVRw"
```

Sử dụng URL thất bại của bạn, sau đó một đoạn video công cộng ngắn như một điều khiển. quét âm thanh duy nhất này tránh FFmpeg và lưu một tên tệp mới theo thời gian cho mỗi nỗ lực.

**Hãy chạy trên người lao động thất bại.** Kiểm tra verbose `Proxy map` cho con đường thực tế của nó. `--ignore-config` xóa các tùy chọn được tiết kiệm nhưng giữ các plugin và proxy môi trường được cài đặt.

**Thành công có nghĩa là một tệp được lưu.** Một khi âm thanh hoạt động, kiểm tra video với `-f bv`, sau đó khôi phục lại cài đặt kết quả đầy đủ của bạn. `--simulate` và `-F` không kiểm tra chuyển giao phương tiện. Cáp `2M` là điểm khởi đầu cho chẩn đoán.

- [Cài đặt Linux: đêm, Deno và curl-cffi](https://flashdata.dev/vi/docs/guides/how-to-use-yt-dlp/reference.md#install)
- [Lỗi đăng nhập / bot-check error](https://flashdata.dev/vi/docs/guides/yt-dlp-sign-in-not-a-bot/reference.md)
- [HTTP 429 giới hạn tỷ lệ](https://flashdata.dev/vi/docs/guides/yt-dlp-429-too-many-requests/reference.md)

<a id="versions"></a>

## 1. cập nhật đến đêm


**Một lệnh làm việc trước đó đột nhiên thất bại:** cập nhật lần đầu tiên. thay đổi người chơi YouTube có thể phá vỡ các máy thu cũ; đêm cuối cùng có thể đã chứa sửa chữa.

**Cập nhật môi trường Python của nhân viên**

```bash
python -m pip install -U --pre "yt-dlp[default,curl-cffi]"
python -m yt_dlp --version
python -c "import sys, yt_dlp; print(sys.executable); print(yt_dlp.__file__)"
```

**Nếu bạn sử dụng chức năng thực thi thay vì**

```bash
yt-dlp --update-to nightly
yt-dlp --version
```

yt-dlp -U chỉ cập nhật trong kênh hiện tại. Sử dụng --update-to ban đêm để chuyển từ ổn định.

Tải về và khởi động lại một container nếu hình ảnh của nó chứa một gói cũ; cập nhật Python trên host không cập nhật container đó. giữ lại bản sửa đổi chính xác trong sổ làm việc và chạy lại nguồn tương tự trước khi thay đổi cài đặt khác.

Xóa các player_client cũ, player_js_version và định dạng=missing_pot các lỗ hổng cho dòng cơ bản. Một nhân viên từ một sự cố cũ bây giờ có thể chọn một khách hàng không phù hợp hoặc tiết lộ một dòng mà token vẫn còn thiếu. Vấn đề #14680 là một ví dụ về một người chơi thay đổi dòng upstream cố định; sao chép quá trình tạm thời của nó vô hạn không phải là sửa chữa.

- [Tải kênh và cập nhật](https://github.com/yt-dlp/yt-dlp#update)
- [Chuyển đổi người chơi: #14680](https://github.com/yt-dlp/yt-dlp/issues/14680)

<a id="rate"></a>

## 2 Giảm các yêu cầu cạnh tranh


**Tải xuống làm việc, sau đó thất bại khi khối lượng tăng lên:** giảm tải tổng trên IP xuất phát. Trong trải nghiệm của FlashData, chuyển đổi song song nhanh có thể kích hoạt sự từ chối.

| Nguồn tải | Chế độ chẩn đoán đầu tiên |
| --- | --- |
| Video công việc cạnh tranh | Một video hoạt động cho IP xuất hiện này; tạm dừng phần còn lại của dây đeo. |
| yêu cầu fragment | --concurrent-fragments 1. |
| aria2 hoặc một trình tải bên ngoài khác | --downloader native seçeneğine dönün. Daha sonra aria2'yi yeniden kullanırsanız -x 1 -s 1 -j 1 ile başlayın. |
| Media Bandwidth thông tin | Hãy thử --limit-rate 2M như một bài kiểm tra bảo thủ, sau đó tăng dần. |
| Extraction và các bản tải xuống mới | Sử dụng --sleep-requests 2 và --sleep-interval 5 --max-sleep-interval 10. |
| Nên nghỉ hưu | Giữ cả mức công việc và mức tải về số lượng nghỉ hưu giới hạn; đừng tăng lên chúng trên các nhân viên. |

**Khôi phục video cần thiết trong tải thấp**

```bash
python -m yt_dlp --ignore-config --js-runtimes deno --impersonate="" --verbose --no-playlist \
  --downloader native --concurrent-fragments 1 --limit-rate 2M --sleep-requests 2 \
  --sleep-interval 5 --max-sleep-interval 10 --retries 1 --fragment-retries 1 -f bv \
  -o "diagnostics/%(id)s-%(epoch)s.%(ext)s" "https://www.youtube.com/watch?v=jNQXAC9IVRw"
```

Nếu chuyển tải thấp hoạt động, hãy giữ nguyên và tăng một chiều cùng một lúc trong khi xem các thất bại. Nếu nó vẫn thất bại ngay sau khi kiểm tra nightly/runtime, đừng tiếp tục giảm băng thông vô hạn: kiểm tra một IP xuất phát khác. Một con đường đã được YouTube đánh dấu có thể vẫn bị từ chối sau khi lưu lượng truy cập gây ra nó đã dừng lại.

- [aria2 Kiểm soát kết nối](https://flashdata.dev/vi/docs/guides/how-to-use-yt-dlp/reference.md#aria2)
- [Yêu cầu pacing cho metadata và captions](https://flashdata.dev/vi/docs/guides/yt-dlp-429-too-many-requests/reference.md#pacing)

<a id="challenges"></a>

## 3. kiểm tra Deno


**Các phụ thuộc vào nhân viên kiểm tra:** Deno chạy các thách thức; `yt-dlp-ejs` cung cấp các kịch bản giải quyết; `[default]` thêm cài đặt các kịch bản.

**Kiểm tra các phụ thuộc lao động**

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

**Kiểm tra phát hiện thời gian chạy và giải quyết thách thức**

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

Đọc dòng chạy JS cho Deno, và bất kỳ [jsc:deno] giải quyết tin nhắn. Một thời gian chạy không có hoặc cảnh báo signature/n-challenge cần được sửa chữa trước khi chạy tải xuống lớn khác. Deno 2.3+ là mức tối thiểu hiện tại trong tài liệu EJS nâng cấp; sử dụng phiên bản được hỗ trợ cập nhật.

**Dịch vụ Linux với Deno bên ngoài PATH**

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

Thay thế /opt/deno/bin/deno với thực tế có thể thực hiện. trên macOS hoặc Windows, sử dụng con đường Deno tuyệt đối của nhân viên thay thế.

curl-cffi thêm cho phép --impersonate="". Nó cung cấp các dấu vân tay yêu cầu giống như trình duyệt; nó không thay thế Deno. Nếu mục tiêu trình duyệt không sẵn dùng, hãy cài đặt thêm trong cùng một môi trường Python. Nếu việc nhân vật hóa đưa ra một thất bại trên một con đường làm việc, so sánh yêu cầu tương tự mà không có lá cờ.

Sau khi kiểm tra sự phụ thuộc, chuyển giao truyền thông thực sự được cải thiện. Nếu đêm hiện tại vẫn báo cáo thất bại giải quyết chữ ký cho cùng một người chơi, hãy lưu ID người chơi và thông điệp giải quyết cho vấn đề phù hợp với dòng trên. Nếu giải quyết thành công và phương tiện truyền thông nhận được 403, tiếp tục session/IP kiểm tra.

- [Hỗ trợ runtime và EJS setup](https://github.com/yt-dlp/yt-dlp/wiki/EJS)
- [Tính năng Linux Setup](https://flashdata.dev/vi/docs/guides/how-to-use-yt-dlp/reference.md#install)

<a id="cookies"></a>

## 4.Các cookie có hiệu lực để làm việc nhỏ


**Các phiên làm việc được biết đến.** Kiểm tra rằng trình duyệt có thể chơi nguồn chính xác, sau đó thử cookie của nó với cùng một lệnh và đường dẫn.

**Sử dụng phiên hoạt động Firefox**

```bash
python -m yt_dlp --ignore-config --js-runtimes deno --impersonate="" --verbose --no-playlist \
  -f ba -o "diagnostics/%(id)s-%(epoch)s.%(ext)s" --cookies-from-browser firefox \
  "https://www.youtube.com/watch?v=jNQXAC9IVRw"
```

**Sử dụng một buổi xuất khẩu trên một công nhân không đầu**

```bash
python -m yt_dlp --ignore-config --js-runtimes deno --impersonate="" --verbose --no-playlist \
  -f ba -o "diagnostics/%(id)s-%(epoch)s.%(ext)s" --cookies private/youtube-cookies.txt \
  "https://www.youtube.com/watch?v=jNQXAC9IVRw"
```

Sử dụng cookie định dạng Netscape. giữ tệp riêng tư và viết cho công việc này; cho một bí mật đọc chỉ, làm một bản sao mỗi công việc.

Nếu cookie tải nhưng YouTube nói rằng chúng không còn có hiệu lực, thay thế phiên thay vì lặp lại cùng một tệp. Đối với một vài video, duy trì một trình duyệt đăng nhập có thể thực tế. Đối với một bộ sưu tập video công cộng lớn, tìm kiếm và làm mới nhiều phiên trình duyệt không phải là một chiến lược quy mô đáng tin cậy.

Đối với công việc hàng loạt, quản lý một bể số IP xuất xứ proxy có thể sử dụng và xoay trên giới hạn công việc, với ngân sách yêu cầu thấp per-IP. Lưu cookie tài khoản cho các nguồn thực sự yêu cầu truy cập tài khoản. Một thay đổi IP không cho phép truy cập vào một video riêng hoặc không sẵn dùng.

- [Cookie xuất khẩu và tái chế](https://flashdata.dev/vi/docs/guides/yt-dlp-sign-in-not-a-bot/reference.md#renew-session)
- [Bản sao cookie có thể viết trong container](https://flashdata.dev/vi/docs/guides/yt-dlp-sign-in-not-a-bot/reference.md#server)

<a id="environment"></a>

## 5. thay thế một IP xuất xứ bị từ chối


**Các video công cộng tương tự, cài đặt tương tự, kết quả IP khác nhau:** thay thế sự ra đi thất bại. FlashData thấy nhiều liên tục 403s gây ra bởi IP proxy xấu hoặc nhãn hiệu. Cài đặt lại yt-dlp không sửa chữa con đường đó.

1. Giữ nguồn, sửa đổi ban đêm, Deno, cookie nếu cần thiết, và định dạng bộ chọn giống nhau.
2. Kiểm tra một thay thế IP xuất phát với một chiết xuất mới và một truyền thông thực tế.
3. Kiểm tra proxy thực sự thay đổi IP xuất phát của nó. một tên lưu trữ cổng mới hoặc xác nhận vẫn có thể dẫn đến cùng một xuất phát.
4. Giữ một phiên proxy phù hợp trong suốt quá trình khai thác, tạo token và chuyển giao phương tiện.
5. Xóa hoặc làm mát ra khỏi thất bại trong hồ bơi của bạn. xoay sang một chuyến đi lành mạnh khác cho một công việc mới hoặc một cuộc nghỉ hưu được kiểm soát.

**Thử một phiên proxy thay thế**

```bash
python -m yt_dlp --ignore-config --js-runtimes deno --impersonate="" --verbose --no-playlist \
  -f ba -o "diagnostics/%(id)s-%(epoch)s.%(ext)s" --proxy "http://USER:PASSWORD@HOST:PORT" \
  "https://www.youtube.com/watch?v=jNQXAC9IVRw"
```

Thay thế một proxy phiên thực sự riêng tư. log verbose có thể tiết lộ các chứng nhận proxy; viết nó trước khi chia sẻ.

**So sánh quyền truy cập trực tiếp của chủ khi có sẵn**

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

Điều này ngăn chặn environment/configured proxy cho bài kiểm tra.Hãy bỏ nó khi chủ sở hữu không thể truy cập trực tiếp YouTube.

**So sánh đường IPv4 của chủ**

```bash
python -m yt_dlp --ignore-config --js-runtimes deno --impersonate="" --verbose --no-playlist \
  -f ba -o "diagnostics/%(id)s-%(epoch)s.%(ext)s" \
  --force-ipv4 "https://www.youtube.com/watch?v=jNQXAC9IVRw"
```

Một tuyến đường IPv4 hoạt động có thể khác với tuyến đường IPv6 thất bại. Với một proxy, -4 không nhất thiết chọn gia đình IP xuất xứ của proxy.

| Kết quả | Hành động tiếp theo |
| --- | --- |
| Nguồn tương tự thành công trên một IP xuất phát mới | Giữ con đường đó và tuyến đường cơ sở tải thấp của nó. quỹ đạo ra khỏi thất bại thay vì rút nó cho mỗi video. |
| Thay đổi các chứng chỉ proxy không có hiệu quả | Kiểm tra chính sách IP và phiên thực sự; các proxy vẫn có thể sử dụng cùng một xuất khẩu. |
| Người chơi hoạt động, phương tiện truyền thông thất bại chỉ thông qua proxy | Kiểm tra truy cập googlevideo.com và phương tiện truyền thông sử dụng cùng exit/session. |
| Một nguồn thất bại trên mỗi con đường được thử nghiệm; kiểm soát hoạt động | Tìm kiếm nguồn, định dạng và trạng thái sống.Đừng đánh dấu toàn bộ hồ bơi proxy bị phá vỡ từ một video. |

- [Upstream network/IP và chẩn đoán yêu cầu-tô số](https://github.com/yt-dlp/yt-dlp/issues/17103)

<a id="media-urls"></a>

## Tiếp tục: giữ chiết xuất và chuyển giao trên một IP


Một lỗi ứng dụng phổ biến là lấy `info['url']` trên một máy, lưu nó trong một cái bìa, và tải nó sau đó ở nơi khác. URL của phương tiện được ký kết hết hạn và có thể phụ thuộc vào IP gốc và tiêu đề yêu cầu. Một proxy xoay có thể tạo cùng một phân chia ngay cả trong một ứng dụng.

Xóa ID video YouTube và cài đặt output mong muốn. Hãy để người lao động thực hiện một chiết xuất mới và tải xuống cùng nhau. Nếu người lao động sử dụng một proxy, giữ cùng một cơn thịnh nộ thông qua việc rút game thủ, tạo token và yêu cầu phương tiện truyền thông. Yêu cầu nhà cung cấp proxy cho một phiên liên tục thay vì xoay mỗi yêu cầu HTTP.

**Giữ khai thác và chuyển giao trong cùng một công việc Python**

```python
from yt_dlp import YoutubeDL
from yt_dlp.networking.impersonate import ImpersonateTarget

options = {
    "js_runtimes": {"deno": {}},
    "impersonate": ImpersonateTarget(),
    "format": "ba",
    "outtmpl": "diagnostics/%(id)s-%(epoch)s.%(ext)s",
    "noplaylist": True,
    "verbose": True,
    # If required, configure one sticky proxy for the entire job:
    # "proxy": "http://USER:PASSWORD@HOST:PORT",
}
with YoutubeDL(options) as downloader:
    downloader.download(["https://www.youtube.com/watch?v=jNQXAC9IVRw"])
```

Đây là một tải xuống trực tiếp tại địa phương; nó không cần một khóa API. Chỉ thêm tùy chọn cookie/provider xác minh của bạn nếu các thử nghiệm trước đó yêu cầu chúng.

Nếu điều này thành công trong khi `requests.get(saved_media_url)` hoặc một quy trình riêng biệt FFmpeg thất bại, kiểm tra lỗi đó: URL tuổi, tiêu đề được cung cấp bởi nhà khai thác, cookie và thực tế. Giữ URL phương tiện ra khỏi hồ sơ công việc lâu dài. Khi thu hồi kết quả rút ra hết hạn, yêu cầu URL mới từ ID video ban đầu.

- [Giải thích về các lỗi URL được rút ra](https://github.com/yt-dlp/yt-dlp/wiki/FAQ#i-extracted-a-video-url-but-it-does-not-play-on-another-machine--in-my-web-browser)

<a id="triage"></a>

## Advanced: xác định yêu cầu thất bại


**Lời yêu cầu sequence**

```text
Watch page / player response
  → available streams and their signed URLs
  → googlevideo.com media bytes or fragments
  → local FFmpeg processing
```

`-F` danh sách các định dạng được lấy ra; `--simulate` dừng trước khi lưu truyền thông. Nó cũng không chứng minh rằng dòng được chọn sẽ trả về byte. Nếu sổ ghi chép đạt `Downloading 1 format(s)` và sau đó thất bại với một dữ liệu phương tiện 403, thay đổi tên tệp xuất khẩu hoặc cài đặt FFmpeg sẽ không sửa chữa yêu cầu HTTP.

Các hồ sơ khách hàng YouTube như `mweb` và `web_safari` thay đổi câu trả lời người chơi yt-dlp yêu cầu. Một số câu trả lời cần một chữ ký hoặc n-parameter chuyển đổi; một số yêu cầu phương tiện truyền thông cũng cần một GVS chứng minh nguồn gốc token. Một token PO cho yêu cầu của người chơi không thể trao đổi với một cho giao hàng truyền thông hoặc các tiêu đề phụ.

| Log Location Địa điểm | giải thích |
| --- | --- |
| `Unable to download API page` / `Unable to download webpage` | Một yêu cầu rút tiền đã bị từ chối.Tìm nhận chủ đó trước khi xử lý nó như một lỗi máy chủ phương tiện. |
| `unable to download video data: HTTP Error 403: Forbidden` | Yêu cầu phương tiện được chọn đã bị từ chối. theo các chi nhánh solver/token/route bên dưới. |
| Fragment Retry Thông điệp | Giữ lỗi và giao thức phân đoạn; so sánh định dạng có sẵn khác thay vì rút lại cùng một phân đoạn vô hạn. |
| FFmpeg nói HTTP 403 trong khi đọc một bài viết | FFmpeg là bắt nguồn từ xa phương tiện, ví dụ cho một clip. kiểm tra URL và mạng đã chuyển sang FFmpeg; đây không phải là lỗi codec địa phương. |
| Lưu trữ tải về `AccessDenied` | Tải về bucket access và retry that upload, not the YouTube download. |

<a id="po-token"></a>

## Advanced: cài đặt một nhà cung cấp PO-token


Sử dụng rào cản này khi các định dạng cần thiết bị bỏ qua cho một token GVS thiếu, hoặc token được cấu hình của bạn bị từ chối. Tokens được gắn kết với một bối cảnh client/request và có thể được gắn kết với ID video. Một token được sao chép cho một video không phải là một xác nhận tái sử dụng cho một vòng tròn toàn bộ. Sử dụng một nhà cung cấp để tạo token cho yêu cầu hiện tại.

> **Một cảnh báo có thể mô tả một sự sụp đổ bị bỏ rơi**
> Nếu một khách hàng khác đã cung cấp tệp yêu cầu, chỉ có một cảnh báo khách hàng bị bỏ rơi không phải là một tải xuống thất bại. Xác định nó khi dòng yêu cầu bị mất hoặc yêu cầu phương tiện truyền thông được chọn thất bại.

Các thiết lập sau đây sử dụng bgutil 2.0.2. Nó có hai phần: một plugin Python được tải bởi yt-dlp và một dịch vụ JavaScript tạo token. Giữ phiên bản của họ phù hợp khi nâng cấp. Các ví dụ dưới đây sử dụng một dịch vụ có thể truy cập trên cùng một host tại cảng 4416.

**Cài đặt kết nối trong môi trường Python của yt-dlp**

```bash
python -m pip install "bgutil-ytdlp-pot-provider==2.0.2"
```

**Docker**

Để yt-dlp chạy trên máy chủ Docker. Chỉ xuất bản cổng loopback.


**Bắt đầu nhà cung cấp**

```bash
docker run --name bgutil-provider -d --init -p 127.0.0.1:4416:4416 brainicism/bgutil-ytdlp-pot-provider:2.0.2
```


**Node không có Docker**

Yêu cầu Git, Node 22+ và npm. chạy lệnh cuối cùng trong một terminal riêng biệt và để nó chạy. nếu thư mục đã tồn tại, sử dụng kiểm tra hiện có của bạn cho phiên bản phù hợp.


**Xây dựng và bắt đầu nhà cung cấp bản địa**

```bash
git clone --depth 1 --branch 2.0.2 https://github.com/Brainicism/bgutil-ytdlp-pot-provider.git
cd bgutil-ytdlp-pot-provider/server
npm ci
npx tsc
node build/main.js --host 127.0.0.1 --port 4416
```


**Kiểm tra dịch vụ từ môi trường của downloader**

```bash
python -c "from urllib.request import urlopen; print(urlopen('http://127.0.0.1:4416/ping', timeout=5).status)"
```

Hãy chờ HTTP 200. chạy điều này bên trong container người lao động nếu đó là nơi yt-dlp chạy.

**Yêu cầu mweb phương tiện truyền thông với nhà cung cấp**

```bash
python -m yt_dlp --ignore-config --js-runtimes deno --impersonate="" --verbose --no-playlist \
  -f ba -o "diagnostics/%(id)s-%(epoch)s.%(ext)s" \
  --extractor-args "youtube:player_client=mweb" \
  --extractor-args "youtubepot-bgutilhttp:base_url=http://127.0.0.1:4416" \
  "https://www.youtube.com/watch?v=jNQXAC9IVRw"
```

**Tìm kiếm gì trong log**

```text
PO Token Providers: bgutil:http-2.0.2 (external)
Generating a gvs PO Token for mweb client via bgutil HTTP server
[download] 100%
```

Đây là các dòng ngắn từ hoạt động địa phương của chúng tôi. phát hiện nhà cung cấp, tạo token và truyền thông là ba kiểm tra riêng biệt.

| Kết quả quan sát | Sửa |
| --- | --- |
| `PO Token Providers: none` | Plugin không được tải lên. cài đặt nó với cùng một trình diễn Python; xóa --no-plugin-dirs. Đối với các nhị phân độc lập, sử dụng cài đặt plugin ZIP được tài liệu của nhà cung cấp thay vì pip vào một môi trường không liên quan. |
| `Error reaching GET … /ping` | Bắt đầu nhà cung cấp hoặc sửa base_url. kiểm tra từ quá trình tải xuống, không chỉ trình duyệt máy tính xách tay của bạn. |
| Nhà cung cấp được liệt kê, nhưng không có thế hệ xảy ra | Đọc các lỗi người chơi trước đây. `LOGIN_REQUIRED` có thể dừng yêu cầu trước khi giai đoạn token. một plugin tải không chứng minh rằng nó đã được sử dụng. |
| Một token được tạo ra, sau đó bot/sign-in từ chối | Diagnosis session/network. tạo token không xác thực tài khoản trình duyệt. |
| mweb token hoạt động, khách hàng bắt buộc cũ vẫn thất bại | Đừng sử dụng lại token mweb cho khách hàng khác. để nhà cung cấp xử lý bối cảnh được chọn, hoặc quay trở lại cấu hình khách hàng làm việc. |

Đối với hai container, `127.0.0.1` bên trong của người lao động điểm đến người lao động chính nó. Cài đặt cả hai dịch vụ trên cùng một mạng Docker và sử dụng tên dịch vụ của nhà cung cấp, ví dụ `http://bgutil-provider:4416`. Đừng tiết lộ cổng nhà cung cấp công khai.

**Sử dụng một nhà cung cấp trên mạng Docker của nhân viên**

```bash
python -m yt_dlp --ignore-config --js-runtimes deno --impersonate="" --verbose --no-playlist \
  -f ba -o "diagnostics/%(id)s-%(epoch)s.%(ext)s" \
  --extractor-args "youtube:player_client=mweb" \
  --extractor-args "youtubepot-bgutilhttp:base_url=http://bgutil-provider:4416" \
  "https://www.youtube.com/watch?v=jNQXAC9IVRw"
```

Vấn đề #17681 ghi lại một thất bại bằng tay-token được giải quyết bằng cách chuyển sang một nhà cung cấp. Nó cũng chứa một sự lặp lại sau: xử lý sửa chữa làm việc như bằng chứng cho sự thất bại của token, không bằng chứng rằng mỗi lần 403 sau đó có cùng nguyên nhân.

- [Nhà cung cấp cài đặt và xác minh](https://github.com/Brainicism/bgutil-ytdlp-pot-provider)
- [Khung ngữ cảnh token và yêu cầu khách hàng hiện tại](https://github.com/yt-dlp/yt-dlp/wiki/PO-Token-Guide)
- [Tác động thủ công: #17681](https://github.com/yt-dlp/yt-dlp/issues/17681)

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

## Advanced: One format, clip hoặc live stream fails


Danh sách các định dạng với cùng cookie, nhà cung cấp và tùy chọn mạng như không tải xuống. Thực hiện các định dạng thất bại trực tiếp. Nếu một định dạng khác có sẵn hoạt động, bạn đã làm giảm sự thất bại đến một con đường delivery/client; bạn không xác định rằng mỗi giải pháp hoặc codec bị phá vỡ.

**Danh sách các định dạng cho yêu cầu này ngữ cảnh**

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

**Kiểm tra ID thất bại từ danh sách này**

```bash
python -m yt_dlp --ignore-config --js-runtimes deno --impersonate="" --verbose --no-playlist \
  -f YOUR_FORMAT_ID -o "diagnostics/%(id)s-%(epoch)s.%(ext)s" \
  "https://www.youtube.com/watch?v=jNQXAC9IVRw"
```

Thay thế YOUR_FORMAT_ID. Đối với một lựa chọn kết hợp, kiểm tra ID video và âm thanh riêng biệt. Đối với một clip, trước tiên kiểm tra một dòng không được cắt.

SABR cảnh báo liên quan đến các định dạng được cung cấp bởi một khách hàng. Họ không giống như một thất bại n-challenge. Nếu một `web` cũ quá trình chỉ tạo ra unavailable/unsupported định dạng, hãy loại bỏ quá trình hoặc sử dụng con đường mweb/provider được ghi lại. Đừng thêm `formats=missing_pot` như một sửa chữa: nó tiếp xúc với các định dạng mà không cung cấp token bị mất của họ.

Video trực tiếp, gần đây kết thúc và bình thường tải lên có thể tiết lộ các biểu hiện khác nhau. Nhập trạng thái đó khi tìm kiếm upstream. Nếu một dòng gần đây đã kết thúc vẫn đang được xử lý, một định dạng thay thế hiện có hoặc một chiết xuất sau này có thể là thử nghiệm tiếp theo hữu ích; việc thêm một codec toàn cầu trên hàng cho mỗi công nhân không phải là.

- [Sự thay đổi định dạng SABR: #12482](https://github.com/yt-dlp/yt-dlp/issues/12482)
- [Post-live 403 báo cáo: #15586](https://github.com/yt-dlp/yt-dlp/issues/15586)

<a id="batch-recovery"></a>

## Đánh giá 1 công nhân


Trước tiên, lặp lại nguồn thất bại với nguồn gốc cần thiết video/audio. Sau đó, một nhân viên được tái sử dụng chính sách biểu hiện, lưu trữ và xuất khẩu hiện có. Nếu tất cả các công việc chia sẻ cùng một phiên thất bại hoặc đường đi, nghỉ ngơi mà thắt hơn là tăng cường thất bại của nó.

**Ứng dụng pacing cho cấu hình thu thập hiện có của bạn**

```bash
python -m yt_dlp --ignore-config --config-locations yt-dlp-work.conf -t sleep --retries 3 \
  --fragment-retries 3 --batch-file urls.txt
```

Sử dụng cấu hình chứa các tùy chọn giờ làm việc hiện đang hoạt động, nhà cung cấp, sản xuất và lưu trữ. giấc ngủ đặt trước các yêu cầu không gian trong quá trình này; nó không phối hợp các nhân viên khác.

Một 403 trở lại trên mỗi nỗ lực cần một điều kiện thay đổi trước khi nghỉ hưu. Đừng đặt các rút ngắn vô hạn hoặc di chuyển ID thất bại vào lưu trữ thành công. Nếu phương tiện truyền thông đã kết thúc và chỉ giao hàng lưu trữ thất bại, hãy tải lại tệp được lưu lại.

- [cấu hình thu thập được](https://flashdata.dev/vi/docs/guides/how-to-use-yt-dlp/reference.md#repeatable)
- [Python hoàn thành và bản ghi batch](https://flashdata.dev/vi/docs/guides/yt-dlp-python-api/reference.md#completion)

<a id="report"></a>

## - Chưa có lỗi? - Đặt báo cáo lỗi hữu ích


- Nhập chuyển giao thực sự thất bại với --verbose, không chỉ một chạy thành công --simulate.
- Giữ yt-dlp sửa đổi, runtime/EJS phiên bản, nhà cung cấp tải và format/protocol. được chọn
- Bao gồm cảnh báo trước khi lỗi, liệu có một token được yêu cầu hay không, và liệu sự thất bại xảy ra trước hoặc sau khi lựa chọn phương tiện truyền thông.
- Ghi lại kết quả của cùng một nguồn trên IPv4/direct/proxy chỉ cho so sánh bạn thực sự chạy.
- Xóa nội dung cookie, mã hóa proxy, URL đã ký và token trước khi chia sẻ hồ sơ.

Tìm upstream bằng cách sử dụng cảnh báo trước cụ thể và phát hành của bạn. Nếu một sự trở lại phù hợp vẫn mở, giữ cho mục thất bại và sử dụng một con đường làm việc được xác nhận trong khi theo dõi sửa chữa đó. Một sổ ghi chép sạch chỉ nói '403' ít hữu ích hơn một bản ghi ngắn cho thấy yêu cầu và thay đổi được kiểm soát thất bại.

- [Tìm kiếm Upstream](https://github.com/yt-dlp/yt-dlp/issues)
- [Bot-check và cookie fix](https://flashdata.dev/vi/docs/guides/yt-dlp-sign-in-not-a-bot/reference.md)
- [Tải xuống YouTube](https://flashdata.dev/vi/products/youtube-download)
