Instagram 的 yt-dlp 指令產生器

為 Instagram 的貼文與 reels 產生 yt-dlp 指令。cookies 預設開啟，因為沒有它幾乎什麼都做不了。

影片、播放清單或頻道網址

選填。留空的話指令會以 URL 結尾，由你自己填。

你的指令

yt-dlp --merge-output-format mp4 --no-playlist --cookies-from-browser chrome https://www.instagram.com/p/Cxxxxxxxxxx/

基本

你要什麼

影片僅音訊

僅音訊會擷取聲音軌並捨棄影像串流。

影片與畫質

最高畫質 -f

限制高度上限。yt-dlp 仍會挑該上限以下最好的一路串流。

Container --merge-output-format 需要 ffmpeg

把分離的影像與音訊串流合併進去的檔案類型。

進階選項（3）

自訂 format selector -f

會取代畫質下拉選單。給已經熟悉 format 語法的人用。

Remux 成 --remux-video 需要 ffmpeg

不重新編碼，只重新封裝。快而且無損。

重新編碼成 --recode-video 需要 ffmpeg

重新編碼影片。慢而且有損 —— 只在 remux 行不通時才用。

音訊

音訊格式 --audio-format 需要 ffmpeg

音訊要轉換成的檔案類型。

音訊品質 --audio-quality 需要 ffmpeg

VBR 的檔案大小與品質之比最好；固定 bitrate 比較好預估大小。

字幕

內嵌會把字幕放進影片裡；另存則在旁邊寫一個獨立的 .srt 檔。

字幕語言 --sub-langs

用逗號分隔。想要所有可用語言就寫 all。

自動產生的字幕 --write-auto-subs 在沒有人工字幕時，把機器產生的字幕也算進來。

播放清單與頻道

播放清單處理

當網址同時屬於一支影片和一份播放清單時該怎麼做。

要哪幾項 -I

範圍與清單都可以，例如 1-10,15，或用 -5::2 表示從尾端起每隔一項取一項。

進階選項（1）

紀錄檔 --download-archive

記下已經下載過的項目，於是重新執行會跳過它們。這就是讓一個頻道保持同步的做法。

片段與章節

進階選項（2）

只下載其中一段 --download-sections 需要 ffmpeg

像 *00:01:30-00:03:00 這樣的時間範圍，或章節名稱。開頭的星號表示這是時間點。

依章節切分 --split-chapters 需要 ffmpeg 每個章節寫成一個檔案，而不是一整個長檔。

中繼資料與封面

內嵌縮圖 --embed-thumbnail 需要 ffmpeg 把影片縮圖當作封面。

內嵌中繼資料 --embed-metadata 需要 ffmpeg 把標題、上傳者與日期寫進檔案本身。

內嵌章節 --embed-chapters 需要 ffmpeg 加入章節標記，播放器可以在它們之間跳轉。

進階選項（3）

另存縮圖檔 --write-thumbnail 把封面圖片寫在影片旁邊。

另存簡介 --write-description 把簡介寫進一個 .description 檔。

另存中繼資料 JSON --write-info-json 把 yt-dlp 對這支影片知道的一切寫進 .info.json 檔。

SponsorBlock

移除片段 --sponsorblock-remove 需要 ffmpeg

依 SponsorBlock 資料，把社群標記的片段直接從檔案裡剪掉。

進階選項（1）

把片段標成章節 --sponsorblock-mark

片段保留，但會被標出來，讓你自己跳過。

檔案與資料夾

檔名範本 -o

欄位名稱寫在 %(...)s 裡。斜線會建立資料夾。

安全（純 ASCII）檔名 --restrict-filenames 去掉重音符號、空白，以及某些挑剔的檔案系統可能拒絕的字元。

覆寫已存在的檔案 --force-overwrites 取代已經存在的檔案。

續傳未完成的下載 -c 從中斷的地方接著下。

進階選項（4）

下載資料夾 -P

檔案要寫到哪裡。搭配上面的範本可以產生子資料夾。

相容 Windows 的檔名 --windows-filenames 去掉 Windows 不接受的字元，即使你在別的系統上執行。

檔名裁到 --trim-filenames

檔名最大長度，以字元計。

永不覆寫 -w 跳過任何已經下載過的東西。

篩選

進階選項（5）

上傳時間晚於 --dateafter

YYYYMMDD，或像 now-1month 這樣的相對日期。

上傳時間早於 --datebefore

YYYYMMDD，或相對日期。

最小檔案大小 --min-filesize

跳過更小的檔案。可以寫 5M、500K 之類。

最大檔案大小 --max-filesize

跳過更大的檔案。

下載幾個後停止 --max-downloads

停下來之前要下載的檔案數量。

網路

限速 -r

例如 2M 或 500K。當你需要把剩下的頻寬留給別的事情時很有用。

進階選項（5）

同時下載的 fragment 數 -N

能加快分片串流的下載。從 4 開始比較合適。

重試次數 -R

失敗的片段要重試幾次。也可以寫 infinite。

Proxy --proxy

HTTP、HTTPS 或 SOCKS proxy 的網址。

繞過地區限制 --geo-bypass 偽造請求來源。在部分網站有效，並非全部。

偽裝成瀏覽器 --impersonate

讓請求看起來來自真正的瀏覽器。突然出現 403 時，這是最常見的解法。

登入與 cookies

從瀏覽器讀取 cookies --cookies-from-browser

直接讀取你的登入工作階段。私人、年齡限制或會員專屬內容都需要它。

進階選項（1）

Cookies 檔案 --cookies

從瀏覽器匯出的 Netscape 格式 cookies.txt。

直播

進階選項（2）

從直播開頭錄 --live-from-start 從直播開始處錄製，而不是從目前這一刻。

等待直播開始 --wait-for-video

反覆檢查直到預定的直播開始。MIN-MAX 是兩次檢查之間的秒數。

疑難排解

進階選項（3）

User agent --user-agent 已淘汰

已淘汰，應改用 --add-headers。之所以保留，是因為很多舊教學還在用它。

Referer --referer 已淘汰

已淘汰，應改用 --add-headers。

Extractor 參數 --extractor-args

依網站區分的專用選項，例如 youtube:player_client=web。

輸出與除錯

只列出格式 -F 印出可用格式後直接結束，不下載。

進階選項（2）

出錯也繼續 -i 跳過失敗的項目而不是停下來。處理大型播放清單時不可或缺。

模擬執行 -s 除了寫檔以外的一切都做。

重設

這裡最關鍵的選項

從瀏覽器讀取 cookies --cookies-from-browser 直接讀取你的登入工作階段。私人、年齡限制或會員專屬內容都需要它。
Container --merge-output-format 把分離的影像與音訊串流合併進去的檔案類型。
檔名範本 -o 欄位名稱寫在 %(...)s 裡。斜線會建立資料夾。

Instagram 需要登入工作階段

Instagram 對未登入的請求幾乎什麼都不給，所以 --cookies-from-browser 實際上是必需的，而非選填。執行指令前請關掉瀏覽器：Chrome 與 Edge 在執行時會鎖住自己的 cookies 資料庫。

輪播貼文會被當成播放清單，所以要把播放清單處理設為整份播放清單才能取到全部內容。Stories 需要已追蹤該帳號的工作階段，而且 24 小時後就消失。

Instagram 對自動化存取越來越不信任，一次下載太多太快的工作階段會被要求重新登入——徵兆就是昨天還能用的指令今天回傳登入頁面。用專門的小帳號而不是主帳號，每隔一陣子正常登入保持 cookies 新鮮，並且接受這樣使用的帳號偶爾會被標記，無論指令寫得多小心。這是平台的代價，不是 yt-dlp 的 bug。

貼文、reels 與精選動態走同一個 extractor，但不同工作階段看到的東西不一樣。你追蹤的帳號的 reels 能正常下載；探索頁的 reels 對從未接觸過這類內容的工作階段常常拒絕。精選動態——釘在個人頁面上的那些限時動態圈——每一個都作為自己限時動態的播放清單下載。IGTV 已退役：舊連結有時還能解析，但沒有任何新東西在用它。

Instagram 的限速比 yt-dlp 日常面對的任何平台都狠。同時下載 fragment 只會讓事情更糟而不是更好；一次取一項、每次執行之間留出停頓，才是活得下去的模式。多項目的執行在中途失敗是常態——封存檔案加上出錯繼續，會讓重試變成續傳而不是從頭再來，這很重要：等執行跑完，最早那些項目的 CDN 連結通常已過期，全量重跑只會重新抓頁面而不是媒體。

無法挽回的東西：你沒追蹤的私人帳號的貼文、過了 24 小時的 Stories、以及在你執行指令之前就被刪掉的一切。抓回來的頁面裡的 CDN 連結很快就過期，一小時前還能用的媒體網址現在可能拒絕——別重試舊連結，重新抓貼文頁面。這種過期也是「儘早下載而不是以後再說」的理由：Instagram 從不承諾讓媒體一直可達，而它確實說到做到。

常見問題

› 為什麼沒有 cookies 時 Instagram 會失敗？

Instagram 對未登入的請求幾乎什麼都不給。--cookies-from-browser 實際上是必需的，而且那個工作階段必須屬於一個看得到該貼文的帳號。

› 能下載 stories 或 reels 嗎？

reels 和一般貼文一樣。Stories 需要已追蹤該帳號的工作階段，而且 24 小時後就失效。

› 怎麼取到輪播貼文的全部內容？

把播放清單處理設為整份播放清單 —— yt-dlp 把多圖貼文當成播放清單。