N_m3u8DL-RE 使用教學：安裝、指令、GUI 與 Mac 設定完整指南（2026）

N_m3u8DL-RE M3U8下載工具

想下載 N_m3u8DL-RE 又怕裝完跑不起來？N_m3u8DL-RE（常被簡稱 n_m3u8dl、m3u8dl）是開源、跨平台的串流下載工具，支援 HLS、DASH、MSS，點播和直播都能處理。

本文內容已對照官方 README 與最新版本（v0.6.0-beta，2026 年 6 月）逐一核對。網路上不少舊教學還在用已經不存在的參數，下面的指令都是目前真的能用的寫法。

請只下載你有權保存的串流：自己錄製的內容、公有領域或開放授權影片，或服務條款允許下載的內容。N_m3u8DL-RE 不會（也無法）移除 DRM。

N_m3u8DL-RE 是什麼？

N_m3u8DL-RE（GitHub：nilaoda/N_m3u8DL-RE）是開發者 nilaoda 維護的命令列工具，以 C# / .NET 撰寫，發佈成免安裝 .NET 執行環境的單一執行檔。

它取代了舊版 m3u8DL-CLI（只支援 Windows，已停止維護），RE 是 Remake（重製）的意思。

主要特點

  • ✅ 支援 HLS / DASH / MSS，點播與直播皆可
  • ✅ 多執行緒下載分片（--thread-count，預設等於 CPU 執行緒數）
  • ✅ 可依解析度、編碼、語言、位元率挑選軌道（-sv / -sa / -ss）
  • ✅ 標準 HLS AES-128 自動解密
  • ✅ 自訂 HTTP Header（Referer、User-Agent、Cookie）
  • ✅ 直播錄製，可設定錄製時長、邊錄邊合併
  • ✅ Windows / macOS / Linux / Android 皆有 x64 與 ARM64 版本

想先了解 M3U8 下載的原理，可以看 👉 M3U8 下載教學

安裝方式

所有版本都在 GitHub Releases 頁面，依你的系統挑檔案：

系統 要下載的檔案（v0.6.0-beta）
Windows 10/11（一般電腦） N_m3u8DL-RE_v0.6.0-beta_win-x64_20260629.zip
Windows ARM 筆電 ..._win-arm64_....zip
Apple Silicon Mac（M1～M4） ..._osx-arm64_....tar.gz
Intel Mac ..._osx-x64_....tar.gz
Linux x64 ..._linux-x64_....tar.gz
Linux ARM64（例如樹莓派 64 位元） ..._linux-arm64_....tar.gz

第 0 步：先裝 ffmpeg（合併必備）

N_m3u8DL-RE 自己負責下載分片，但最後合併、封裝成 MP4/MKV 要靠 ffmpeg。沒裝的話，下載到最後會出現「找不到 ffmpeg」的錯誤。

  • Windows：到 gyan.dev 下載，把 ffmpeg.exe 放在跟 N_m3u8DL-RE.exe 同一個資料夾（或加入 PATH）
  • macOS：brew install ffmpeg
  • Linux：sudo apt install ffmpeg（Debian/Ubuntu）

也可以用 --ffmpeg-binary-path "C:\Tools\ffmpeg.exe" 直接指定路徑。

Windows 安裝

  1. 下載 win-x64 的 zip 並解壓，例如放到 C:\Tools\N_m3u8DL-RE\
  2. 把 ffmpeg.exe 放進同一個資料夾
  3. 在該資料夾開啟 Windows Terminal 或 PowerShell，執行：
.\N_m3u8DL-RE.exe "https://example.com/stream.m3u8"

較舊 Windows 內建的 cmd.exe 可能無法正常顯示互動介面，建議改用 Windows Terminal（或 cmder）。

macOS 安裝

# 以 Apple Silicon 為例，Intel Mac 請改用 osx-x64
tar -xzf N_m3u8DL-RE_v0.6.0-beta_osx-arm64_20260629.tar.gz
chmod +x N_m3u8DL-RE

# 移除下載隔離標記，讓 Gatekeeper 放行
xattr -d com.apple.quarantine N_m3u8DL-RE

./N_m3u8DL-RE "https://example.com/stream.m3u8"

如果 macOS 跳出 「無法打開 N_m3u8DL-RE，因為無法驗證開發者」，執行上面的 xattr 指令就能解決。另一個方法是到 系統設定 → 隱私權與安全性，按 「強制打開」後再執行一次。

想在任何資料夾都能直接呼叫，就把它移到 PATH：

sudo mv N_m3u8DL-RE /usr/local/bin/

N_m3u8DL-RE 沒有官方的 Homebrew 套件，請從 GitHub Releases 下載。

Linux 安裝

tar -xzf N_m3u8DL-RE_v0.6.0-beta_linux-x64_20260629.tar.gz
chmod +x N_m3u8DL-RE
sudo mv N_m3u8DL-RE /usr/local/bin/

Arch Linux 可以從 AUR 安裝社群維護的套件（非作者本人維護）：

yay -Syu n-m3u8dl-re-bin

基本使用方法

最簡單的下載指令

N_m3u8DL-RE "https://example.com/stream.m3u8"

在一般終端機執行時，工具解析完播放清單後會跳出選單，列出可用的影片、音訊和字幕軌道。用方向鍵移動、空白鍵勾選，按 Enter 開始下載。

不想手動選、直接抓最佳軌道：

N_m3u8DL-RE "https://example.com/stream.m3u8" --auto-select

指定輸出檔名與資料夾

N_m3u8DL-RE "https://example.com/stream.m3u8" --save-name "my_video" --save-dir "D:\Downloads"

指定畫質

用 -sv（--select-video）搭配正規表示式篩選：

# 最佳畫質
N_m3u8DL-RE "https://..." -sv best

# 720p 中最好的一條（寬度 1280）
N_m3u8DL-RE "https://..." -sv res="1280*":for=best

# 只要 4K HEVC
N_m3u8DL-RE "https://..." -sv res="3840*":codecs=hvc1:for=best

指定音訊與字幕

# 最佳英文音軌
N_m3u8DL-RE "https://..." -sa lang=en:for=best

# 所有音軌與所有字幕
N_m3u8DL-RE "https://..." -sa all -ss all

輸出成單一 MP4

預設情況下影片和音訊可能分成兩個檔案。要在下載完成後合併成一個 MP4：

N_m3u8DL-RE "https://..." --auto-select -M format=mp4

多音軌、多字幕的話建議用 -M format=mkv。

進階使用：自訂 Headers、Cookie 與加密串流

自訂 Referer 和 Headers

很多 CDN 會檢查請求來源。如果串流在瀏覽器能播、用 CLI 卻失敗，把瀏覽器本來就會送出的 headers 一起帶上即可。參數是 -H（--header）：

N_m3u8DL-RE "https://example.com/stream.m3u8" \
  -H "Referer: https://example.com/" \
  -H "User-Agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36"

帶入 Cookie（登入後的串流）

N_m3u8DL-RE "https://example.com/stream.m3u8" \
  -H "Cookie: session_id=abc123; token=xyz"

適用於你本來就已登入、有權觀看的串流，帶入自己瀏覽器的 session cookie 即可；不要使用他人帳號或網路流傳的 cookie。

AES-128 加密串流

如果 M3U8 內有 #EXT-X-KEY:METHOD=AES-128，N_m3u8DL-RE 會依播放清單裡的 URI 取得金鑰並自動解密每個分片，不需要額外參數。

如果你手上已經有金鑰（例如測試自己產出的加密 HLS），但金鑰網址連不到，可以直接指定。金鑰可以是檔案、HEX 或 Base64：

N_m3u8DL-RE "https://..." \
  --custom-hls-method AES_128 \
  --custom-hls-key "key.bin" \
  --custom-hls-iv "0x00000000000000000000000000000000"

關於 --key 和 --key-text-file：這兩個參數用於 CENC 加密的 MP4/DASH 內容，而且前提是你本來就持有解密金鑰（例如自己封裝的內容）。它們無法從 Netflix、Disney+ 等 DRM 服務取得金鑰，本文也不涵蓋這部分。

HLS 加密原理請看 👉 M3U8 加密與 DRM 解析

下載速度：執行緒數 vs. 軌道並行

這兩個參數很常被搞混：

# 分片下載的執行緒數（預設 = CPU 執行緒數）
N_m3u8DL-RE "https://..." --thread-count 16

# 讓選好的影片、音訊、字幕軌道同時下載
N_m3u8DL-RE "https://..." -mt

-mt（--concurrent-download）是開關，後面不接數字。想限速可以用 -R 15M（--max-speed）。

⚠️ 執行緒開太高可能被伺服器限流或封 IP，建議先用預設值，不夠再往上調。

錄製直播

# 錄 1 小時，邊錄邊合併
N_m3u8DL-RE "https://example.com/live.m3u8" \
  --live-real-time-merge \
  --live-record-limit 01:00:00

加上 --live-perform-as-vod 則是把直播清單目前已有的內容當成一般影片下載。

只下載其中一段

# 第 5 分鐘到第 20 分鐘
N_m3u8DL-RE "https://..." --custom-range 05:00-20:00

N_m3u8DL-RE GUI：圖形介面版本

N_m3u8DL-RE 本身只有命令列。如果你比較想用滑鼠操作，社群有幾個包裝成 GUI 的專案。使用時一樣要另外下載 N_m3u8DL-RE（和 ffmpeg），再讓 GUI 指向它們：

專案 平台 說明
nilaoda/N_m3u8DL-RE-SimpleG 瀏覽器（網頁） 原作者做的簡易指令產生器
naravid19/N_m3u8DL_RE_GUI Windows 2026 年仍持續更新，支援批次下載
LennoC/N_m3u8DL-RE_SimpleBatGUI Windows（.bat） 選單式操作，預設單個、批次、直播錄製

這些都是第三方專案，使用前請先看該 repo 的近期更新和 issues，而且只從 GitHub 下載。

M3U8X 是什麼？跟 N_m3u8DL-RE 有什麼不同？

M3U8X 是 Windows 上的圖形介面下載工具，主打不熟命令列的一般用戶。

功能 N_m3u8DL-RE M3U8X
操作方式 命令列（可搭配社群 GUI） 圖形介面（GUI）
平台 ✅ Windows / macOS / Linux / Android ⚠️ 只有 Windows
自訂 Header ✅ 完整支援 ⚠️ 有限支援
AES-128 ✅ 自動 ✅ 支援
開源 ✅ MIT 授權 ❌ 閉源
免費 ✅ ✅

結論：N_m3u8DL-RE 功能更完整且跨平台；如果你只用 Windows、完全不想碰終端機，M3U8X 比較簡單。

什麼時候用工具下載，什麼時候用線上工具？

情境 建議方案
快速測試串流能否播放 M3U8Go 線上播放器 最方便
短片（30 分鐘內）下載 HLS 瀏覽器下載工具 免安裝
長片 / 需要自訂 Header N_m3u8DL-RE 最穩
錄製直播 N_m3u8DL-RE
批量下載多個串流 N_m3u8DL-RE 命令列腳本
不懂命令列的用戶 社群 GUI 或本站線上工具

常見問題 FAQ

N_m3u8DL-RE 是免費的嗎？

是的，完全開源免費，授權條款為 MIT License，可以自由使用、修改和散佈。

m3u8dl 跟 N_m3u8DL-RE 是同一個東西嗎？

m3u8dl、n_m3u8dl、N_m3u8DL-RE.exe 通常都是指這個工具，或它已停止維護的前身 m3u8DL-CLI。請一律到 GitHub（nilaoda/N_m3u8DL-RE） 下載最新的 N_m3u8DL-RE。

N_m3u8DL-RE 有 GUI 版本嗎？

官方沒有，只有命令列版本。社群做的圖形介面請看上方「N_m3u8DL-RE GUI」段落。

Mac（M1/M2/M3/M4）可以用嗎？

可以。Apple Silicon 下載 osx-arm64 版本（Intel Mac 用 osx-x64），對執行檔跑 chmod +x 和 xattr -d com.apple.quarantine，再用 Homebrew 裝 ffmpeg 即可。

出現「找不到 ffmpeg」怎麼辦？

最後合併需要 ffmpeg。把 ffmpeg 放在跟 N_m3u8DL-RE 同一個資料夾、加入 PATH，或用 --ffmpeg-binary-path 指定路徑。

為什麼我的下載出現 403 錯誤？

403 代表伺服器拒絕請求，通常是少了瀏覽器會送的 Referer、User-Agent 或 token，用 -H 補上即可。更多錯誤解析 👉 M3U8 常見錯誤修復

N_m3u8DL-RE 可以下載 DRM 保護的串流嗎？

不行。Netflix、Disney+ 等 DRM 保護的服務無法用這種方式下載。詳情請看 👉 M3U8 加密與 DRM 解析

下載速度很慢怎麼辦？

適度調高 --thread-count、加上 -mt 讓影音同時下載，或用 --custom-proxy 設定代理。更多方法 👉 M3U8 下載速度慢解法

影片和聲音分成兩個檔 / 下載後沒有聲音怎麼辦？

加上 -M format=mp4 讓工具把軌道合併成一個檔案，並確認有選到音軌（-sa best 或 --auto-select）。如果是音訊編碼本身不相容（例如某些播放器不支援 MP4 裡的 AC-3），再用 ffmpeg 轉碼。詳見 👉 M3U8 轉檔沒聲音修復

想立即測試您的 M3U8 連結嗎？

🚀 立即測試 M3U8 線上播放器