# Membaiki ralat 403 Forbidden pada yt-dlp

Kemas kini versi nightly, kurangkan permintaan serentak, semak Deno, kemudian uji kuki dan IP keluar yang berfungsi.

Referensi boonical: https://flashdata.dev/ms/docs/guides/yt-dlp-403-forbidden
Diulas: 2026-11-13 oleh FlashData

- [Kegagalan selepas kerja](https://flashdata.dev/ms/docs/guides/yt-dlp-403-forbidden/reference.md#versions) — Meningkatkan pekerja sebenar kepada malam
- [Kegagalan apabila persaingan meningkat](https://flashdata.dev/ms/docs/guides/yt-dlp-403-forbidden/reference.md#rate) — Mengurangkan pekerja, fragmen dan sambungan
- [IP Proxy ini kekal gagal](https://flashdata.dev/ms/docs/guides/yt-dlp-403-forbidden/reference.md#environment) — Ujian dan mengekalkan laluan penggantian keluar
- [Peringatan Runtime atau Token](https://flashdata.dev/ms/docs/guides/yt-dlp-403-forbidden/reference.md#challenges) — Periksa Deno terlebih dahulu, kemudian konteks token

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

## Cuba ini terlebih dahulu


1. **Memperbaharui pada waktu malam.**Memperbaharui persekitaran Python yang digunakan oleh pekerja yang gagal.
2. **Mengurangkan beban.** Berhenti kerja paralel pada IP ini; menguji satu video dan satu fragmen pada satu masa.
3. **Pastikan Deno.** Mengesahkan bahawa log verbous mengesan masa kerja.
4. **Cuba kuki yang sah.** Untuk kerja kecil, gunakan sesi pelayar yang boleh memainkan sumber.
5. **Tukar IP yang ditolak.** Mulakan ekstraksi segar melalui penyelenggara yang sihat atau keluar proxy.

**Update, kemudian semak masa kerja yang diperlukan**

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

**1 sumber, 1 pengangkutan beban rendah**

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

Gunakan URL yang gagal, kemudian video awam pendek sebagai kawalan. kaji audio sahaja ini mengelakkan FFmpeg dan menyimpan nama fail yang baru bertepatan masa untuk setiap percubaan.

**Berlari pada pekerja yang gagal.** Periksa verbo `Proxy map` untuk laluan sebenar. `--ignore-config` menghapuskan opsyen yang disimpan tetapi mengekalkan plugins dan proxy persekitaran yang dipasang.

**Sukses bermaksud fail yang disimpan.** Sebaik sahaja audio berfungsi, ujian video dengan `-f bv`, kemudian pulih seting output penuh anda. `--simulate` dan `-F` tidak menguji pemindahan media. Kap `2M` merupakan titik permulaan bagi diagnosis.

- [Setup Linux: malam, Deno dan curl-cffi](https://flashdata.dev/ms/docs/guides/how-to-use-yt-dlp/reference.md#install)
- [Kesilapan dalam login / bot-check](https://flashdata.dev/ms/docs/guides/yt-dlp-sign-in-not-a-bot/reference.md)
- [HTTP 429 had kadar](https://flashdata.dev/ms/docs/guides/yt-dlp-429-too-many-requests/reference.md)

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

## 1. update kepada malam


**Perintah yang telah bekerja tiba-tiba gagal:** update pertama. perubahan pemutar YouTube boleh memecahkan pengekstrak yang lebih tua; yang terakhir malam mungkin sudah mengandungi penyesuaian.

**Meningkatkan persekitaran Python pekerja**

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

**Jika anda menggunakan penguatkuasaan rasmi sebaliknya**

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

yt-dlp -U hanya kemas kini dalam saluran semasa. gunakan --update-to malam untuk beralih daripada stabil.

Memulihkan dan memulakan semula bekas jika imejnya mengandungi pakej yang lebih tua; kemas kini Python pada host tidak mengemas kini bekas itu.

Menghilangkan lama player_client, player_js_version dan format=missing_pot berlebihan untuk garis asas. Seorang pekerja daripada insiden lama kini boleh memilih pelanggan yang tidak sesuai atau mendedahkan aliran yang token masih hilang. Issue #14680 ialah contoh perubahan pemain yang tetap upstream; menyalin override sementara tidak berkesudahan bukanlah penyelesaian.

- [Rilis saluran dan kemas kini](https://github.com/yt-dlp/yt-dlp#update)
- [Perubahan dalam permainan : #14680](https://github.com/yt-dlp/yt-dlp/issues/14680)

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

## 2 Mengurangkan permintaan yang bersaing


**Download berfungsi, kemudian gagal apabila jumlah meningkat:** mengurangkan beban keseluruhan pada IP output.Dalam pengalaman FlashData, pemindahan paralel yang cepat boleh mencetuskan penolakan.

| Sumber beban | diagnostik pertama |
| --- | --- |
| Video kerja persaingan | Satu video aktif untuk IP keluar ini; berhenti selebihnya tali sementara. |
| Permintaan Fragment asli | --concurrent-fragments 1. |
| aria2 atau lain-lain pemacu luaran | Kembali kepada --downloader native. Jika menggunakan aria2 semula, mulakan dengan -x 1 -s 1 -j 1. |
| Media lebar | Cuba --limit-rate 2M sebagai ujian konservatif, kemudian meningkat secara beransur-ansur. |
| Pengeluaran dan muat turun baru | Menggunakan --sleep-requests 2 dan --sleep-interval 5 --max-sleep-interval 10. |
| Pergi ke Pensiun | Pastikan kedua-dua tahap pekerjaan dan tahap penarikan pengiraan terhad; jangan berbilang mereka di kalangan pekerja. |

**Mengembalikan aliran video yang diperlukan pada beban rendah**

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

Jika pemindahan beban rendah berfungsi, simpan garis asas itu dan meningkatkan satu dimensi pada satu masa sambil menonton kegagalan. Jika ia masih gagal segera selepas pemeriksaan nightly/runtime, jangan terus mengurangkan lebar jalur tanpa henti: menguji IP keluar yang berbeza. Rute yang telah ditandakan oleh YouTube mungkin kekal ditolak selepas trafik yang memicu ia telah berhenti.

- [aria2 Pengawal sambungan](https://flashdata.dev/ms/docs/guides/how-to-use-yt-dlp/reference.md#aria2)
- [Permintaan untuk pakej untuk metadata dan captions](https://flashdata.dev/ms/docs/guides/yt-dlp-429-too-many-requests/reference.md#pacing)

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

## 3 Periksa Deno


**Pastikan kedua-dua ketergantungan pada pekerja:** Deno menjalankan cabaran; `yt-dlp-ejs` menyediakan skrip penyelesai. `[default]` tambahan memasang skrip.

**Periksa ketergantungan pekerja**

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

**Pemeriksaan masa kerja dan penyelesaian cabaran**

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

Baca garis runtime JS untuk Deno, dan apa-apa [jsc:deno] mesej yang menyelesaikan. Masa berjalan yang hilang atau peringatan signature/n-challenge perlu diselesaikan sebelum menjalankan muat turun besar yang lain. Deno 2.3+ ialah minimum semasa dalam dokumentasi EJS upstream; gunakan versi yang disokong sehingga kini.

**Perkhidmatan Linux dengan Deno di luar 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"
```

Menggantikan /opt/deno/bin/deno dengan yang boleh dijalankan. pada macOS atau Windows, gunakan laluan Deno mutlak pekerja itu.

Yang curl-cffi tambahan membolehkan --impersonate="". Ia menyediakan pencetakan jari seperti permintaan pelayar; ia tidak menggantikan Deno. Jika tarikan pelayar tidak tersedia, memasang tambahan dalam persekitaran Python yang sama. Sekiranya impersonasi menunjukkan kegagalan pada laluan kerja, bandingkan permintaan yang sama tanpa bendera.

Selepas pemeriksaan ketagihan, pemindahan media sebenar berkurangan. Jika malam semasa masih melaporkan kegagalan penyelesaian tandatangan untuk pemain yang sama, simpan ID pemain dan mesej penyelesai untuk masalah upstream yang sepadan. Jika penyelesaian berjaya dan media mendapat 403, teruskan kepada session/IP pemeriksaan.

- [Menyokong runtime dan setup EJS](https://github.com/yt-dlp/yt-dlp/wiki/EJS)
- [Setup Linux yang lengkap](https://flashdata.dev/ms/docs/guides/how-to-use-yt-dlp/reference.md#install)

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

## 4. cuba kuki yang sah untuk pekerjaan kecil


**Test satu sesi yang diketahui-kerja.** Mengesahkan bahawa pelayar boleh memainkan sumber yang tepat, kemudian cuba kuki dengan perintah dan laluan yang sama.

**Menggunakan sesi Firefox yang berfungsi**

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

**Menggunakan sesi yang dikeksport pada pekerja tanpa kepala**

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

Gunakan cookies format Netscape. simpan fail peribadi dan boleh ditulis untuk kerja ini; untuk rahsia bacaan sahaja, buat salinan per kerja.

Jika anda memuatkan kuki tetapi YouTube mengatakan mereka tidak lagi sah, menggantikan sesi daripada berulang kali melepasi fail yang sama. Untuk beberapa video, mengekalkan login pelayar boleh menjadi praktikal. Untuk koleksi video awam yang besar, mencari dan memperbaharui banyak sesi pelayar bukanlah strategi pengukuran yang boleh dipercayai.

Untuk kerja besar, menguruskan sekumpulan IP keluar proxy yang boleh digunakan dan berputar di sempadan kerja, dengan bajet permintaan per IP yang rendah. Simpan kuki akaun untuk sumber yang sebenarnya memerlukan akses akaun. Perubahan IP tidak membenarkan akses kepada video peribadi atau tidak tersedia.

- [Kegunaan Kuki Eksport dan Pembaharuan](https://flashdata.dev/ms/docs/guides/yt-dlp-sign-in-not-a-bot/reference.md#renew-session)
- [Menyimpan salinan cookie dalam bekas](https://flashdata.dev/ms/docs/guides/yt-dlp-sign-in-not-a-bot/reference.md#server)

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

## 5. menggantikan IP keluar yang ditolak


**Video awam yang sama, tetapan yang sama, hasil IP yang berbeza:** menggantikan output yang gagal. FlashData melihat banyak persisten 403s yang disebabkan oleh IP proxy yang buruk atau bercahaya. Menginstal semula yt-dlp tidak memperbaiki laluan itu.

1. Simpan sumber, pemeriksaan malam, Deno, kuki jika perlu, dan format selektor yang sama.
2. Ujian satu penggantian keluar IP dengan ekstraksi segar dan pemindahan media sebenar.
3. Mengesahkan bahawa proxy sebenarnya mengubah IP outboundnya. nama tuan rumah atau pengesahan gateway baru masih boleh membawa kepada output yang sama.
4. Mengekalkan sesi proxy yang bertekanan sepanjang ekstraksi, pengeluaran token dan pemindahan media.
5. Menghilangkan atau menyejukkan keluar yang gagal di kolam renang anda. berputar ke keluar yang sihat untuk pekerjaan baru atau penarikan yang dikendalikan.

**Menguji sesi proxy penggantian**

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

Menggantikan proxy sesi yang sebenar secara peribadi. log verbo boleh mendedahkan pengesahan proxy; tulis sebelum berkongsi.

**Perbandingan akses tetamu langsung apabila tersedia**

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

Ini menghalang environment/configured proxy untuk ujian. meletakkannya apabila tuan rumah tidak dapat mencapai YouTube secara langsung.

**Perbandingan laluan IPv4 tuan rumah**

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

Rute IPv4 yang berfungsi mungkin berbeza daripada rute IPv6 yang gagal.Dengan proxy, -4 tidak semestinya memilih keluar keluar keluarga IP proxy.

| Hasil | Tindakan berikutnya |
| --- | --- |
| Sumber yang sama berjaya pada output IP baru | Tetap laluan itu dan baseline beban rendah. kuarantine keluar yang gagal daripada menarik balik untuk setiap video. |
| Perubahan pengesahan proxy tidak mempunyai kesan | Semak dasar IP dan sesi yang sebenarnya; proxy masih boleh menggunakan output yang sama. |
| Pemain berfungsi, media gagal hanya melalui proxy | Semak akses googlevideo.com dan media yang menggunakan yang sama exit/session. |
| Satu sumber gagal pada setiap laluan yang diuji; kawalan berfungsi | Menyiasat sumber, format dan keadaan hidup.Jangan menandakan keseluruhan kolam proxy yang rosak daripada satu video. |

- [Upstream network/IP dan diagnosis permintaan-volume](https://github.com/yt-dlp/yt-dlp/issues/17103)

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

## Advanced: Mengekalkan ekstraksi dan pemindahan pada satu IP


Salah satu ralat aplikasi yang biasa ialah mengekstrak `info['url']` pada satu mesin, menyimpannya dalam tali, dan muat turunnya kemudian di tempat lain. URL media yang ditandatangani tamat tempoh dan boleh bergantung kepada IP asal dan tajuk permintaan. Proxy berputar boleh mencipta pembahagian yang sama walaupun dalam satu aplikasi.

Menguji ID video YouTube dan tetapan output yang dikehendaki. Pastikan pekerja melakukan ekstraksi segar dan muat turun bersama-sama. Jika pekerja menggunakan proxy, simpan yang sama melalui ekstraksi pemain, pengeluaran token dan permintaan media. Tanya pembekal proxy untuk sesi yang bertekanan daripada memutar setiap permintaan HTTP.

**Mengekalkan ekstraksi dan pemindahan dalam kerja Python yang sama**

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

Ini adalah muat turun tempatan langsung; ia tidak memerlukan kunci API. Tambah opsyen cookie/provider yang disahkan anda hanya jika ujian terdahulu memerlukan mereka.

Jika ini berjaya semasa `requests.get(saved_media_url)` atau proses FFmpeg yang berasingan gagal, semak yang hilang: URL umur, tajuk yang disediakan oleh pengekstrak, kuki dan kemajuan sebenar. Simpan URL media daripada rekod pekerjaan yang berterusan. Apabila mengembalikan hasil pengekstrakan yang tamat tempoh, meminta URL segar daripada ID video asal.

- [Penjelasan Upstream Kesilapan URL yang dikeluarkan](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: mengesan permintaan yang gagal


**Permintaan sekuel**

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

`-F` senarai format yang dikeluarkan; `--simulate` berhenti sebelum menyimpan media. Ia juga tidak membuktikan bahawa aliran yang dipilih akan mengembalikan byte. Jika log mencapai `Downloading 1 format(s)` dan kemudian gagal dengan data media 403, mengubah nama fail output atau memasang FFmpeg tidak akan memperbaiki permintaan HTTP.

Profil klien YouTube seperti `mweb` dan `web_safari` mengubah yang pemain menjawab yt-dlp permintaan. Sesetengah jawapan memerlukan penandatanganan atau transformasi parameter n; sesetengah permintaan media juga memerlukan token bukti asal GVS. Token PO untuk permintaan pemain tidak boleh ditukar dengan satu untuk penghantaran media atau subtitle.

| Lokasi log | interpretasi |
| --- | --- |
| `Unable to download API page` / `Unable to download webpage` | Permintaan pengekstrakan telah ditolak. mengenal pasti tuan rumah itu sebelum memperlakukan ia sebagai kegagalan media-server. |
| `unable to download video data: HTTP Error 403: Forbidden` | Permintaan media yang dipilih telah ditolak.Sila ikuti cawangan solver/token/route di bawah. |
| Perbincangan Fragment Retry | Menjaga kesilapan fragmen dan protokol; membandingkan format lain yang tersedia daripada mengembalikan fragmen yang sama secara tidak berkesudahan. |
| FFmpeg berkata HTTP 403 semasa membaca satu input | FFmpeg adalah menangkap media jauh, contohnya untuk klip. semak URL dan rangkaian yang dipindahkan ke FFmpeg; ini bukan kesilapan kodek tempatan. |
| Penyimpanan upload mengembalikan `AccessDenied` | Fail mencapai peringkat muat naik anda. mengesetkan akses bucket dan retry yang muat naik, bukan muat turun YouTube. |

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

## Advanced: memasang pembekal PO-token


Gunakan cawangan ini apabila format yang diperlukan disingkirkan untuk token GVS yang hilang, atau token yang dikonfigurasi anda ditolak. Token terikat kepada konteks client/request dan boleh terikat kepada ID video. Token yang disalin untuk satu video bukanlah pengesahan yang boleh digunakan semula untuk satu tali penuh. Gunakan pembekal untuk menghasilkan token untuk permintaan semasa.

> **Peringatan boleh menggambarkan jatuh terlepas**
> Jika klien lain telah menyampaikan fail yang dikehendaki, peringatan klien yang terlepas sahaja tidak merupakan muat turun yang gagal.Sekiranya aliran yang dikehendaki hilang atau permintaan media yang dipilih gagal.

Seting berikut menggunakan bgutil 2.0.2. Ia mempunyai dua bahagian: plugin Python yang dimuat turun oleh yt-dlp dan perkhidmatan JavaScript yang menghasilkan token. Tetap disesuaikan versi mereka semasa menaik taraf. Contoh-contoh di bawah menggunakan perkhidmatan yang boleh diakses di host yang sama di pelabuhan 4416.

**Pemasangan penyambung dalam persekitaran Python yt-dlp**

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

**Docker**

Untuk yt-dlp menjalankan pada host Docker. menerbitkan hanya port loopback.


**Mulakan Pembekal**

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


**Node Tanpa Docker**

Permintaan Git, Node 22+ dan npm. menjalankan perintah terakhir dalam terminal yang berasingan dan biarkan ia berjalan. jika folder sudah wujud, gunakan cek yang sedia ada untuk pelepasan yang sepadan.


**Membina dan memulakan pembekal asli**

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


**Semak perkhidmatan daripada persekitaran download**

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

Menunggu HTTP 200. menjalankan ini di dalam bekas pekerja jika ia adalah di mana yt-dlp berjalan.

**Permintaan mweb media dengan pembekal**

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

**Apa yang perlu dicari dalam 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%
```

Ini adalah garis pendek daripada operasi tempatan kami yang berfungsi. penemuan pembekal, pengeluaran token dan pemindahan media adalah tiga pemeriksaan berasingan.

| Hasil yang dilihat | Fix |
| --- | --- |
| `PO Token Providers: none` | Plugin tidak dimuat naik. memasangnya dengan penerjemah Python yang sama; menghapuskan --no-plugin-dirs. Untuk binari berasingan, gunakan pemasangan ZIP plugin yang didokumenkan oleh pembekal daripada pip ke dalam persekitaran yang tidak berkaitan. |
| `Error reaching GET … /ping` | Mulakan pembekal atau membetulkan base_url. semak daripada proses muat turun, bukan sahaja pelayar laptop anda. |
| Pembekal disenaraikan, tetapi tiada generasi berlaku | Baca kesilapan pemain terdahulu. `LOGIN_REQUIRED` boleh menghentikan permintaan sebelum peringkat token. plugin yang dimuat naik tidak membuktikan bahawa ia telah digunakan. |
| (a) Menerima tanda-tanda yang dikeluarkan, kemudian bot/sign-in penolakan | Bergerak ke diagnosis session/network. menghasilkan token tidak mengesahkan akaun pelayar. |
| mweb token berfungsi, pelanggan lama masih gagal | Jangan gunakan token mweb untuk klien lain. biarkan pembekal mengendalikan konteks yang dipilih, atau kembali kepada konfigurasi klien yang berfungsi. |

Untuk dua bekas, `127.0.0.1` di dalam pekerja menunjuk kepada pekerja itu sendiri. Letakkan kedua-dua perkhidmatan di rangkaian Docker yang sama dan gunakan nama perkhidmatan pembekal, contohnya `http://bgutil-provider:4416`. Jangan mendedahkan pelabuhan pembekal secara terbuka.

**Gunakan pembekal pada rangkaian Docker pekerja**

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

Masalah #17681 merekodkan kegagalan token manual yang diselesaikan dengan beralih kepada pembekal. Ia juga mengandungi satu pengulangan kemudian: memperlakukan pembaikan kerja sebagai bukti kegagalan token itu, bukan bukti bahawa setiap kemudian 403 mempunyai punca yang sama.

- [Pembekal pemasangan dan pengesahan](https://github.com/Brainicism/bgutil-ytdlp-pot-provider)
- [Konteks Token dan keperluan pelanggan semasa](https://github.com/yt-dlp/yt-dlp/wiki/PO-Token-Guide)
- [Kejadian Token manual : #17681](https://github.com/yt-dlp/yt-dlp/issues/17681)

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

## Advanced: satu format, klip atau aliran langsung gagal


Format senarai dengan kuki yang sama, pembekal dan pilihan rangkaian seperti kegagalan muat turun. Menggunakan format yang gagal secara langsung. Jika format yang berbeza yang tersedia berfungsi, anda telah menyempit kegagalan kepada laluan delivery/client; anda tidak menetapkan bahawa setiap resolusi atau kodek telah rosak.

**Senarai format untuk konteks permintaan ini**

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

**Menguji ID yang gagal daripada senarai ini**

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

Menggantikan YOUR_FORMAT_ID. Untuk pemilihan gabungan, ujian ID video dan audio secara berasingan. untuk klip, pertama-tama ujian aliran yang tidak dipotong.

Peringatan SABR berkaitan dengan format yang ditawarkan oleh pelanggan. Mereka tidak sama seperti kegagalan n-challenge. Sekiranya satu kelebihan lama `web` hanya menghasilkan format unavailable/unsupported, lepaskan kelebihan atau gunakan laluan yang didokumenkan mweb/provider. Jangan menambah `formats=missing_pot` sebagai penyesuaian: ia mendedahkan format tanpa menyediakan token yang hilang mereka.

Video hidup, baru-baru ini selesai dan biasa dimuat naik boleh mendedahkan manifestasi yang berbeza. Masukkan keadaan itu apabila mencari upstream. Jika aliran baru-baru ini masih diproses, format alternatif yang kini tersedia atau ekstraksi kemudian boleh menjadi ujian seterusnya yang berguna; menambah kodek global yang berlebihan kepada setiap pekerja tidak.

- [Perubahan format SABR: #12482](https://github.com/yt-dlp/yt-dlp/issues/12482)
- [Laporan dalam post-live 403 : #15586](https://github.com/yt-dlp/yt-dlp/issues/15586)

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

## Menggambarkan seorang pekerja


Pertama-tama mengulangi sumber yang gagal dengan output asal yang dikehendaki video/audio. Kemudian mengembalikan satu pekerja menggunakan manifest, arkib dan dasar output yang sedia ada. Jika semua pekerjaan berkongsi sesi atau laluan yang gagal yang sama, berhenti yang mengejek daripada mengulangi kegagalan.

**Menggunakan pacing kepada konfigurasi koleksi anda yang sedia ada**

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

Gunakan konfigurasi yang mengandungi masa kerja, pembekal, output dan opsyen arkib. tidur preset ruang permintaan dalam proses ini; ia tidak menyelaras pekerja lain.

A 403 yang kembali pada setiap percubaan memerlukan keadaan yang berubah sebelum bersara. Jangan menetapkan retries fragmen yang tidak berkesudahan atau memindahkan ID yang gagal ke dalam arkib kejayaan. Jika media selesai dan hanya penyimpanan penghantaran gagal, memulakan semula muat naik fail yang disimpan.

- [Konfigurasi Koleksi yang boleh digunakan](https://flashdata.dev/ms/docs/guides/how-to-use-yt-dlp/reference.md#repeatable)
- [Python penyelesaian dan rekod batch](https://flashdata.dev/ms/docs/guides/yt-dlp-python-api/reference.md#completion)

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

## Masih gagal?Siapkan laporan kesilapan yang berguna


- Menangkap pemindahan sebenar yang gagal dengan --verbose, bukan sahaja berjalan yang berjaya --simulate.
- Mengekalkan yt-dlp penilaian, runtime/EJS versi, pembekal yang dimuat naik dan yang dipilih format/protocol.
- Termasuk amaran sebelum kesilapan, sama ada token telah diminta, dan sama ada kegagalan berlaku sebelum atau selepas pemilihan media.
- Mencatat hasil daripada sumber yang sama di atas IPv4/direct/proxy hanya untuk perbandingan yang anda sebenarnya menjalankan.
- Menghapuskan kandungan cookie, pengesahan proxy, URL yang ditandatangani dan token sebelum berkongsi log.

Cari upstream menggunakan amaran tertentu yang terdahulu dan pelepasan anda. Jika regresi yang sepadan masih terbuka, simpan item yang gagal dan gunakan laluan kerja yang disahkan semasa menjejaki pembaikan itu. Log bersih yang hanya mengatakan '403' kurang berguna daripada rekod pendek yang menunjukkan perubahan permintaan dan kawalan gagal.

- [Mencari masalah upstream](https://github.com/yt-dlp/yt-dlp/issues)
- [Bot-check dan cookie pengesahan](https://flashdata.dev/ms/docs/guides/yt-dlp-sign-in-not-a-bot/reference.md)
- [Pengurusan YouTube Downloads](https://flashdata.dev/ms/products/youtube-download)
