# Memperbaiki galat 403 Forbidden di yt-dlp

Perbarui versi nightly, kurangi permintaan serentak, periksa Deno, lalu uji cookie dan IP keluar yang berfungsi.

Referensi kanonikal: https://flashdata.dev/id/docs/guides/yt-dlp-403-forbidden
Diulang: 2026-11-13 oleh FlashData

- [Kegagalan setelah bekerja](https://flashdata.dev/id/docs/guides/yt-dlp-403-forbidden/reference.md#versions) — Upgrade karyawan yang sebenarnya ke malam
- [Kegagalan saat kompetisi meningkat](https://flashdata.dev/id/docs/guides/yt-dlp-403-forbidden/reference.md#rate) — Mengurangi karyawan, fragmen dan koneksi
- [Proxy IP ini tetap gagal](https://flashdata.dev/id/docs/guides/yt-dlp-403-forbidden/reference.md#environment) — Menguji dan mengekalkan rute penggantian
- [Peringatan Runtime atau Token](https://flashdata.dev/id/docs/guides/yt-dlp-403-forbidden/reference.md#challenges) — Periksa Deno pertama, kemudian konteks token

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

## Cobalah ini dulu


1. **Update malam.** Upgrade lingkungan Python yang digunakan oleh pekerja yang gagal.
2. **Mengurangkan beban.** Berhenti kerja paralel pada IP ini; menguji satu video dan satu fragmen sekaligus.
3. **Pastikan Deno.** Mengkonfirmasi bahwa log verbous mengidentifikasi waktu kerja.
4. ***Cuba cookie yang valid.** * Untuk pekerjaan kecil, gunakan sesi browser yang dapat memainkan sumber.
5. **Tukar IP yang ditolak.** Mulai ekstraksi segar melalui host yang sehat atau output proxy.

**Update, kemudian periksa waktu yang diperlukan**

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

**1 sumber, 1 transfer 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 publik pendek sebagai kontrol. sonde audio-only ini menghindari FFmpeg dan menyimpan nama file baru yang ditandai waktu untuk setiap percobaan.

**Berjalan pada pekerja yang gagal.** Periksa verboza `Proxy map` untuk rute yang sebenarnya. `--ignore-config` menghapus opsi yang disimpan tetapi tetap menginstal plugins dan proxy lingkungan.

**Sukses berarti file yang disimpan.** Setelah audio bekerja, menguji video dengan `-f bv`, kemudian mengembalikan pengaturan output penuh Anda. `--simulate` dan `-F` tidak menguji transfer media. Kap `2M` adalah titik permulaan untuk diagnosis.

- [Linux setup: malam, Deno dan curl-cffi](https://flashdata.dev/id/docs/guides/how-to-use-yt-dlp/reference.md#install)
- [Kesalahan Sign-in / Bot-check](https://flashdata.dev/id/docs/guides/yt-dlp-sign-in-not-a-bot/reference.md)
- [HTTP 429 batas nilai](https://flashdata.dev/id/docs/guides/yt-dlp-429-too-many-requests/reference.md)

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

## 1. update untuk malam hari


**Perintah yang sebelumnya bekerja tiba-tiba gagal:** update pertama. perubahan pemain YouTube dapat memecahkan ekstraktor yang lebih tua; malam terakhir mungkin sudah mengandung perbaikan.

**Mengemas kini lingkungan Python karyawan**

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

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

yt-dlp -U hanya update di dalam saluran saat ini. gunakan --update-to malam untuk beralih dari stabil.

Mengembalikan dan memulai kembali konten jika gambarnya mengandung paket yang lebih tua; mengemas kini Python pada host tidak memperbarui konten tersebut.

Menghapus player_client lama, player_js_version dan format=missing_pot overrides untuk garis dasar. Seorang pekerja dari insiden lama sekarang dapat memilih klien yang tidak sesuai atau mengeksposkan aliran yang tokennya masih hilang. Masalah #14680 adalah contoh perubahan pemain tetap upstream; menyalin override sementara tidak terbatas tidak menjadi fix.

- [Menerima saluran dan update](https://github.com/yt-dlp/yt-dlp#update)
- [Perubahan pemain terjadi: #14680](https://github.com/yt-dlp/yt-dlp/issues/14680)

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

## 2 Mengurangi permintaan yang bersaing


**Download bekerja, kemudian gagal karena volume meningkat:** mengurangi beban total pada output IP. Dalam pengalaman FlashData, transfer paralel cepat dapat memicu penolakan.

| Sumber dari load | Diagnosis pertama |
| --- | --- |
| Video kompetitif | Satu video aktif untuk IP output ini; menghentikan sisa tali sementara. |
| Permintaan Fragment asli | --concurrent-fragments 1. |
| aria2 atau download eksternal lainnya | Kembali ke --downloader native. Jika aria2 digunakan lagi nanti, mulai dengan -x 1 -s 1 -j 1. |
| Media Bandwidth | Cobalah --limit-rate 2M sebagai tes konservatif, kemudian meningkat secara bertahap. |
| Extraction dan download baru | Gunakan --sleep-requests 2 dan --sleep-interval 5 --max-sleep-interval 10. |
| Pensiun yang terbelah | Tetap terbatas kedua-dua tingkat pekerjaan dan tingkat download penghitungan pensiun; jangan berbilang mereka di antara pekerja. |

**Mengembalikan streaming 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 transfer beban rendah bekerja, tetaplah garis dasar itu dan meningkatkan satu dimensi sekaligus sambil menonton kegagalan. Jika masih gagal segera setelah pemeriksaan nightly/runtime, jangan terus mengurangi lebar jalur banding tanpa batas: menguji IP output yang berbeda. Rute yang sudah ditandai oleh YouTube mungkin tetap ditolak setelah lalu lintas yang memicu itu telah berhenti.

- [aria2 Pengendalian koneksi](https://flashdata.dev/id/docs/guides/how-to-use-yt-dlp/reference.md#aria2)
- [Meminta paket untuk metadata dan captions](https://flashdata.dev/id/docs/guides/yt-dlp-429-too-many-requests/reference.md#pacing)

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

## 3. periksa Deno


**Pastikan kedua ketergantungan pada pekerja:** Deno menjalankan tantangan; `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 waktu kerja dan tantangan penyelesaian**

```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 pesan yang menyelesaikan [jsc:deno]. Waktu berjalan yang hilang atau peringatan signature/n-challenge perlu diperbaiki sebelum menjalankan download besar lainnya. Deno 2.3+ adalah minimum saat ini dalam dokumentasi EJS upstream; gunakan versi yang didukung up-to-date.

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

Mengganti /opt/deno/bin/deno dengan yang sebenarnya dapat dijalankan. pada macOS atau Windows, gunakan jalur Deno mutlak pekerja itu.

Yang curl-cffi tambahan memungkinkan --impersonate="". Ini menyediakan pencetakan jari seperti permintaan browser; itu tidak menggantikan Deno. Jika target browser tidak tersedia, instalasi tambahan di lingkungan Python yang sama. Jika impersonasi menunjukkan kegagalan pada rute kerja, bandingkan permintaan yang sama tanpa bendera.

Setelah pemeriksaan ketergantungan, transfer media nyata akan kembali. Jika malam saat ini masih melaporkan kegagalan penyelesaian tandatangan untuk pemain yang sama, simpan ID pemain dan pesan penyelesai untuk masalah upstream yang sesuai. Jika penyelesaian berhasil dan media mendapat 403, lanjutkan ke session/IP cek.

- [Menggunakan Runtime dan EJS](https://github.com/yt-dlp/yt-dlp/wiki/EJS)
- [Sistem Linux lengkap](https://flashdata.dev/id/docs/guides/how-to-use-yt-dlp/reference.md#install)

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

## 4.Coba cookie yang valid untuk pekerjaan kecil


**Test satu sesi yang diketahui-kerja.** Periksa bahwa browser dapat memainkan sumber yang tepat, kemudian coba cookie dengan perintah dan jalur yang sama.

**Menggunakan sesi Firefox yang bekerja**

```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 diekspor 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 cookie format Netscape.Tahan file pribadi dan dapat ditulis untuk pekerjaan ini; untuk sebuah rahasia membaca, buat salinan per pekerjaan.

Jika cookie diisi tetapi YouTube mengatakan bahwa mereka tidak lagi sah, mengganti sesi daripada berulang kali melewati file yang sama. Untuk beberapa video, menjaga login browser dapat praktis. Untuk koleksi video publik yang besar, menemukan dan memperbarui banyak sesi browser bukanlah strategi scaling yang dapat dipengaruhi.

Untuk kerja besar, mengelola kolam IP output proxy yang dapat digunakan dan berputar di batas pekerjaan, dengan anggaran permintaan per IP yang rendah. Simpan cookie akun untuk sumber yang sebenarnya membutuhkan akses akun. Perubahan IP tidak memberikan akses ke video pribadi atau tidak tersedia.

- [Proyek Ekspor dan Renovasi Cookie](https://flashdata.dev/id/docs/guides/yt-dlp-sign-in-not-a-bot/reference.md#renew-session)
- [Kode Cookie yang dapat ditulis dalam konten](https://flashdata.dev/id/docs/guides/yt-dlp-sign-in-not-a-bot/reference.md#server)

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

## 5. menggantikan IP output yang ditolak


**Video publik yang sama, pengaturan yang sama, hasil yang berbeda oleh IP:** FlashData melihat banyak persisten 403s yang disebabkan oleh IP proxy yang buruk atau berlapis. reinstalling yt-dlp tidak memperbaiki rute itu.

1. Simpan sumber, revisi malam, Deno, cookie jika perlu, dan format selektor yang sama.
2. Uji satu pengganti keluar IP dengan ekstraksi segar dan transfer media nyata.
3. Mengkonfirmasi proxy sebenarnya mengubah outbound IP. Nama host gateway baru atau pengesahan masih dapat menyebabkan output yang sama.
4. Tetap sesi proxy yang kuat sepanjang extraction, generasi token dan transfer media.
5. Menghilangkan atau menyejukkan keluar yang gagal di kolam renang Anda. berputar ke keluar yang sehat lain untuk pekerjaan baru atau penarikan terkontrol.

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

Mengganti proxy sesi yang benar secara pribadi. log verbous dapat mengeksposkan pengesahan proxy; menyusunnya sebelum berbagi.

**Perbandingan akses langsung tuan rumah ketika 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 menghentikan environment/configured proksia untuk tes. menghentikan ketika host tidak dapat mengakses YouTube secara langsung.

**Perbandingan Rute IPv4 dari host**

```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 bekerja dapat berbeda dari rute IPv6 yang gagal. dengan proxy, -4 tidak semestinya memilih keluar keluar keluarga IP proxy.

| Hasil | Aksi berikutnya |
| --- | --- |
| Sumber yang sama berhasil pada output IP baru | Tetaplah laluan itu dan garis dasarnya yang rendah beban. kuarantine keluar yang gagal daripada mengembalikannya untuk setiap video. |
| Mengubah proxy tidak ada efek | Periksa kebijakan IP dan sesi yang sebenarnya; proxy masih dapat menggunakan output yang sama. |
| Player bekerja, media gagal hanya melalui proxy | Periksa googlevideo.com akses dan media yang menggunakan yang sama exit/session. |
| Satu sumber gagal di setiap jalur yang diuji; kontrol bekerja | Meneliti sumber, format dan status hidup.Jangan menandakan seluruh proxy pool yang rusak dari satu video. |

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

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

## Advanced: Mengekstraksi dan transfer pada satu IP


Salah satu bug aplikasi yang biasa adalah mengekstrak `info['url']` pada mesin, menyimpannya di kue, dan kemudian men-downloadnya di tempat lain. URL media yang ditandatangani akan tamat dan mungkin tergantung pada IP asli dan headers permintaan. Proxy berputar dapat membuat pembagian yang sama bahkan dalam satu aplikasi.

Menguji ID video YouTube dan pengaturan output yang diinginkan. Pastikan karyawan melakukan ekstraksi segar dan muat turun bersama. Jika pekerja menggunakan proxy, tetap sama egress melalui ekstraksi pemain, generasi token dan permintaan media. Tanyakan kepada penyedia proxy untuk sesi yang bercinta bukannya memutar setiap permintaan HTTP.

**Mengekstraksi dan transfer dalam pekerjaan 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 download lokal langsung; tidak memerlukan kunci API. Tambah pilihan cookie/provider yang disahkan hanya jika tes sebelumnya membutuhkan mereka.

Jika ini berhasil saat `requests.get(saved_media_url)` atau proses yang terpisah FFmpeg gagal, periksa yang hilang: URL umur, headers yang disediakan oleh extractor, cookie dan egress nyata. Simpan URL media dari rekaman pekerjaan yang berkelanjutan. Ketika menarik hasil ekstraksi yang habis, minta URL segar dari ID video asli.

- [Penjelasan Upstream tentang kegagalan 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: mengidentifikasi permintaan yang gagal


**Permintaan sekuensi**

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

`-F` daftar format yang dikeluarkan; `--simulate` berhenti sebelum menyimpan media. Tidak ada bukti bahwa aliran yang dipilih akan mengembalikan byte. Jika log mencapai `Downloading 1 format(s)` dan kemudian gagal dengan data media 403, mengubah nama file output atau menginstal FFmpeg tidak akan memperbaiki permintaan HTTP.

Profil klien YouTube seperti `mweb` dan `web_safari` mengubah yang pemain menjawab yt-dlp permintaan. Beberapa jawaban membutuhkan tanda tangan atau transformasi n-parameter; beberapa permintaan media juga membutuhkan token bukti asal GVS. Token PO untuk permintaan pemain tidak dapat ditukar dengan satu untuk pengiriman media atau subtitle.

| Lokasi log | Interpretasi |
| --- | --- |
| `Unable to download API page` / `Unable to download webpage` | Permintaan ekstraksi ditolak. mengenal pasti host tersebut sebelum memperlakukan sebagai kegagalan media-server. |
| `unable to download video data: HTTP Error 403: Forbidden` | Permintaan media yang dipilih ditolak. ikuti solver/token/route cawangan di bawah. |
| Pesan Retry Fragment | Tetaplah error fragmen dan protokol; bandingkan format lain yang tersedia daripada mengembalikan fragmen yang sama secara tidak terbatas. |
| FFmpeg berkata HTTP 403 saat membaca sebuah input | FFmpeg adalah memegang media jauh, misalnya untuk klip. periksa URL dan jaringan yang ditransfer ke FFmpeg; ini bukan kesalahan kodek lokal. |
| Penyimpanan upload kembali `AccessDenied` | File mencapai tahap upload Anda.Fix bucket access and retry that upload, not the YouTube download. |

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

## Advanced: Menginstal penyedia PO-token


Gunakan cawangan ini ketika format yang diperlukan ditarik untuk token GVS yang hilang, atau token yang dikonfigurasi Anda ditolak. Token terikat dengan konteks client/request dan dapat terikat dengan ID video. Token yang disalin untuk satu video tidak merupakan pengesahan yang dapat digunakan kembali untuk seluruh kue. Gunakan penyedia untuk menghasilkan token untuk permintaan saat ini.

> **Peringatan dapat menggambarkan jatuh terlepas**
> Jika klien lain sudah memberikan file yang diperlukan, peringatan klien yang terlepas itu sendiri tidak akan menjadi download yang gagal.Cerikan ketika aliran yang diperlukan hilang atau permintaan media yang dipilih gagal.

Setup berikut menggunakan bgutil 2.0.2. Ini memiliki dua bagian: plugin Python yang diisi oleh yt-dlp dan layanan JavaScript yang menghasilkan token. Tetaplah versi mereka teratur saat upgrade. Contoh di bawah menggunakan layanan yang dapat diakses di host yang sama di pelabuhan 4416.

**Instal konektor di lingkungan Python yt-dlp**

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

**Docker**

Untuk yt-dlp berjalan di host Docker. hanya menerbitkan port loopback.


**Mulai dengan penyedia**

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

Memerlukan Git, Node 22+ dan npm. menjalankan perintah terakhir di terminal yang terpisah dan biarkan berjalan. jika folder sudah ada, gunakan cek yang ada dari pelepasan yang sepadan.


**Membangun dan memulai penyedia 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
```


**Periksa layanan dari lingkungan download**

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

Harapkan HTTP 200. menjalankan ini di dalam wadah pekerja jika itu di mana yt-dlp berjalan.

**Permintaan mweb media dengan penyedia**

```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 harus dicari di 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 dari berjalan lokal kami yang bekerja. penemuan penyedia, generasi token dan transfer media adalah tiga pemeriksaan terpisah.

| Hasil yang diperhatikan | Perbaiki |
| --- | --- |
| `PO Token Providers: none` | Plugin tidak diisi.Memasang dengan penerjemah Python yang sama; menghapus --no-plugin-dirs.Untuk binari terpisah, gunakan instalasi ZIP plugin yang didokumentasikan penyedia bukannya pip ke lingkungan yang tidak terkait. |
| `Error reaching GET … /ping` | Mulai penyedia atau perbaiki base_url. periksa dari proses download, bukan hanya browser laptop Anda. |
| Pembekal terdaftar, tetapi tidak terjadi generasi | Baca kesalahan pemain sebelumnya. `LOGIN_REQUIRED` dapat menghentikan permintaan sebelum tahap token. plugin yang dimuat tidak membuktikan bahwa itu digunakan. |
| Sebuah token dihasilkan, kemudian bot/sign-in penolakan | Move to session/network diagnosis. menghasilkan token tidak mengautentikasi akun browser. |
| mweb token bekerja, klien lama masih gagal | Jangan menggunakan token mweb untuk klien lain. biarkan penyedia mengendalikan konteks yang dipilih, atau kembali ke konfigurasi klien yang bekerja. |

Untuk dua kontena, `127.0.0.1` di dalam pekerja menunjuk kepada pekerja itu sendiri. Letakkan kedua layanan di jaringan Docker yang sama dan gunakan nama layanan penyedia, misalnya `http://bgutil-provider:4416`. Jangan mendedahkan pelabuhan penyedia secara terbuka.

**Gunakan penyedia di jaringan Docker karyawan**

```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 merekam kegagalan token manual yang diselesaikan dengan beralih ke penyedia. Ini juga mengandung reaksi kemudian: memperlakukan fix kerja sebagai bukti kegagalan token itu, tidak membuktikan bahwa setiap kemudian 403 memiliki penyebab yang sama.

- [Pembekal instalasi dan verifikasi](https://github.com/Brainicism/bgutil-ytdlp-pot-provider)
- [Konteks Token dan persyaratan klien saat ini](https://github.com/yt-dlp/yt-dlp/wiki/PO-Token-Guide)
- [Pengaturan yang dilakukan oleh : #17681](https://github.com/yt-dlp/yt-dlp/issues/17681)

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

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


Format daftar dengan cookie, penyedia dan opsi jaringan yang sama seperti gagal download. Menggunakan format yang gagal secara langsung. Jika format yang berbeda yang tersedia bekerja, Anda telah menyempit kegagalan ke jalur delivery/client; Anda tidak menetapkan bahwa setiap resolusi atau codec pecah.

**Daftar 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 dari daftar 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"
```

Mengganti YOUR_FORMAT_ID. Untuk pemilihan gabungan, coba ID video dan audio secara terpisah. Untuk klip, pertama-tama coba streaming yang tidak dipotong.

Peringatan SABR berkaitan dengan format yang ditawarkan oleh klien. Mereka tidak sama dengan kegagalan n-tuntutan. Jika suatu override lama `web` hanya menghasilkan format unavailable/unsupported, lepaskan override atau gunakan jalur yang didokumentasikan mweb/provider. Jangan menambahkan `formats=missing_pot` sebagai perbaikan: ia mengeksposkan format tanpa menyertakan token yang hilang.

Video langsung, baru-baru ini selesai dan biasa diunggah dapat mengeksposkan manifestasi yang berbeda. Termasuk kondisi itu saat mencari upstream. Jika aliran yang baru selesai masih diproses, format alternatif yang tersedia saat ini atau ekstraksi kemudian mungkin menjadi tes berikutnya yang berguna; menambahkan kode global yang berlebihan untuk setiap pekerja tidak.

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

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

## Mengumpulkan 1 pekerja


Pertama, ulangi sumber yang gagal dengan output yang diperlukan video/audio asli. Kemudian mengembalikan satu pekerja menggunakan kebijakan manifesto, arkib dan output yang ada. Jika semua pekerjaan berbagi sesi atau rute yang gagal yang sama, istirahat yang mengganggu bukannya mengulangi kegagalan.

**Menggunakan pacing ke konfigurasi koleksi Anda yang 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 berisi waktu kerja, penyedia, output dan pilihan arkib yang sedang bekerja. ruang tidur ditentukan permintaan dalam proses ini; itu tidak mengkoordinasi pekerja lain.

A 403 kembali pada setiap percobaan membutuhkan kondisi yang berubah sebelum bersara. Jangan menetapkan retries fragmen yang tak terbatas atau memindahkan ID yang gagal ke dalam arkib keberhasilan. Jika media selesai dan hanya penyimpanan pengiriman gagal, kembali upload file yang disimpan.

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

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

## Masih gagal? menyiapkan laporan kesalahan yang berguna


- Menangkap transfer yang sebenarnya gagal dengan --verbose, tidak hanya berjalan sukses --simulate.
- Tetap yt-dlp revisi, runtime/EJS versi, penyedia yang dimuat dan yang dipilih format/protocol.
- Termasuk peringatan sebelum kesalahan, apakah token diminta, dan apakah kegagalan terjadi sebelum atau setelah pemilihan media.
- Mencatat hasil dari sumber yang sama di atas IPv4/direct/proxy hanya untuk perbandingan yang sebenarnya Anda lakukan.
- Menghapus konten cookie, proxy credentials, URL yang ditandatangani dan token sebelum berbagi log.

Cari upstream menggunakan peringatan sebelumnya spesifik dan pelepasan Anda. Jika regresi yang sepadan masih terbuka, simpan item yang gagal dan gunakan jalur kerja yang disahkan sambil menjejaki perbaikan itu. Sebuah log bersih yang hanya mengatakan '403' kurang berguna daripada rekaman pendek yang menunjukkan permintaan dan perubahan yang dikendalikan gagal.

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