Docker 串流媒體模組推薦

沒問題，在 MacBook Air 上先試跑是最聰明的做法，這能讓你先熟悉 Jellyfin 的介面，並確認你的外接 HDD 讀取是否順暢。

以下是針對 MacBook Air 環境優化後的完整實作清單，確保你的系統依然保持「潔癖級」的乾淨。

🛠 第一階段：前置準備（手動建立目錄）

手動建立目錄可以確保資料夾的「擁有人」是你（mlee），避免 Docker 以 root 權限建立後導致你以後想刪除卻權限不足。

• 開啟終端機 (Terminal)，執行以下指令：Bash# 建立專案總目錄並進入 mkdir -p ~/jellyfin cd ~/jellyfin # 手動建立設定與快取目錄 mkdir config cache

• 確認外接硬碟名稱：插上硬碟後，在終端機輸入：Bashls /Volumes 假設看到 MyPassport，那你的影片路徑就是 /Volumes/MyPassport/Movies。

📝 第二階段：建立 docker-compose.yml

在 ~/jellyfin 目錄下建立檔案（你可以使用 nano docker-compose.yml 或用常用的編輯器開啟）：

YAML

`services: jellyfin: image: jellyfin/jellyfin:latest container_name: jellyfin-server # 使用 host 模式，讓小米盒子在區網內最容易連線 network_mode: host volumes: # 本機 SSD 目錄 (存放海報與設定) - ./config:/config - ./cache:/cache # 外接 HDD 目錄 (唯讀掛載，保護原始檔) # 請將 /Volumes/MyPassport/Movies 改成你實際的硬碟路徑 - “/Volumes/MyPassport/Movies:/data/movies:ro” restart: “no”

## 🚀 第三階段：日常操作指令（照著做即可）

這套流程完全符合你 up -d` 啟動、`down` 清除的習慣。

### 1. 啟動服務（看片前）

確保硬碟已插好，執行：

Bash

`cd ~/jellyfin
docker compose up -d

提示：第一次執行會下載約 800MB 的 Image，之後啟動只需 1 秒。

2. 初始設定（僅限第一次）

• 打開瀏覽器：http://localhost:8096`。

• 設定語系為 Chinese (Traditional)。

• 設定帳號密碼。

• 新增媒體庫：內容類型選「電影」，資料夾路徑請選擇容器內的 /data/movies。

3. 關閉並銷毀容器（看完後）

看完電影後，執行以下指令，這會把容器、虛擬網路徹底拔除，不留任何痕跡：

Bash

`cd ~/jellyfin docker compose down

```

⚠️ MacBook Air 試用特別提醒

• 防止睡眠：MacBook Air 預設在闔上螢幕或長時間不操作時會進入睡眠，這會導致小米盒子斷線。建議試用時下載 Amphetamine (咖啡因軟體) 或在「系統設定」中暫時開啟「防止進入睡眠」。

• 電池負擔：雖然 Jellyfin 在「直接播放」時不噴電，但如果你同時跑了 OpenClaw (AI) 和 WordPress，建議接上電源線，避免低電量觸發 macOS 的降頻機制導致影片卡頓。

• USB Hub 穩定性：既然你用的是有供電的 Hub，請務必接上 Hub 的電源線，這對傳統 HDD 的連續讀取至關重要。

這份清單讓你現在就能在 MacBook Air 上體驗「個人影音中心」。等你未來買了 Mac mini，只需要把整個 ~/jellyfin` 資料夾拷貝過去，設定就能完美接軌！