在 Android TV 上透過 WebDAV 播放 OpenList 或 Alist 裡的影片

Android TV 上的楊桃播放器可以透過 WebDAV 播放 OpenList 或 Alist 裡的影片。兩者的 WebDAV 都在 /dav 路徑下，連接埠和網頁介面相同。位址填成像 http://192.168.1.20:5244/dav 這樣，使用者名稱和密碼則用一個開啟了 WebDAV 讀取權限的 OpenList 使用者。下面的步驟我們在 OpenList 4.2.7 和 Alist 3.45.0 上實際操作過一遍。

在 Android 手機或平板上也一樣，只是位址由你直接填進表單（請見在楊桃播放器裡）。

你需要準備

• 一台執行 OpenList 或 Alist 的電腦、NAS 或伺服器，電視要連得到它，而且裡面至少已新增一個儲存。
• 它的位址，也就是你在瀏覽器裡開啟網頁介面用的位址，例如 http://192.168.1.20:5244。沒改過的話，連接埠就是 5244。
• 電視上裝好楊桃播放器（到下載頁面下載）；不想用遙控器打字的話，再準備一支手機。

請填執行 OpenList 那台機器的 IP 位址，不要填 localhost，也不要填電視不一定查得到的主機名稱。

在 OpenList 裡

下面是 OpenList 的操作方式。Alist 是 OpenList 分支出來的前身，WebDAV 同樣在 /dav 下，也需要同樣的權限，在 Alist 裡叫 Webdav read。OpenList 官方的 WebDAV 說明在 doc.oplist.org/guide/advanced/webdav。

用 admin 登入

打開 OpenList 的管理頁面：在位址後面加上 /@manage，例如 http://192.168.1.20:5244/@manage，並以 admin 登入。如果你用 Docker 執行 OpenList，第一次啟動時記錄檔裡會顯示 admin 的密碼；要設定新密碼，請見 OpenList 的 Docker 安裝說明。

為電視建立一個使用者

1. 進入使用者，按新增。
2. 填好給電視用的使用者名稱和密碼。
3. 基本路徑填 / 就能看到整個檔案庫，也可以只填其中某個資料夾。
4. 在權限裡勾選 WebDAV 讀取。楊桃播放器只會讀取檔案，所以這一項就夠了。沒有勾選的話，OpenList 會拒絕這個使用者的 WebDAV 請求。
5. 按新增。

直接用 admin 登入也可以，但在電視上存一個只能讀取的帳號比較安全。

看看檔案庫裡有什麼

儲存裡的每個儲存，在 WebDAV 裡都會是一個資料夾，名稱就是它的掛載路徑。想把同一台機器上的某個資料夾放進檔案庫，就新增一個驅動為本機儲存的儲存，並把根資料夾路徑設成放影片的那個資料夾。

在楊桃播放器裡

1. 在 Android TV 上打開楊桃播放器，進入設定、來源、新增來源。選來源類型，再選 WebDAV。
2. 選用手機設定，用手機相機掃描電視上的 QR 碼。
3. 在手機上開啟的頁面裡填好伺服器位址、使用者名稱（如果需要）和密碼（也就是那個 OpenList 使用者的），再按傳送到電視。
   • 位址是 http:// 加上 IP 位址、連接埠和 /dav，例如 http://192.168.1.20:5244/dav。這樣開啟的是檔案庫的最上層，每個儲存都是一個資料夾。
   • 想直接開啟某個儲存或資料夾，就把路徑接在後面，例如 http://192.168.1.20:5244/dav/Movies。
   • http:// 位址沒有加密，表單上會提示「這個位址沒有加密，密碼會在你的網路裡以明文傳輸。」如果你的 OpenList 有透過 HTTPS 提供服務，而且電視信任它的憑證，就改用 https://。
4. 電視上的表單會自動填好。選測試連線，它會去讀取這個資料夾，顯示「連線成功」就表示沒問題。接著選儲存。

比較想用遙控器？跳過第 2 步，直接在表單裡輸入就行：在欄位上按確定鍵會跳出螢幕鍵盤。在你用遙控器選儲存之前，什麼都不會儲存。

在 Android 手機或平板上，點設定、來源、新增來源，再點新增WebDAV，填上同樣的位址、使用者名稱和密碼，再點測試連線和儲存。在 Android 手機或平板、iPhone 或 iPad 上，WebDAV 來源裡的電影或劇集也可以下載後離線觀看。

在 Android TV 上播放 NAS 或隨身碟裡的影片用同一個表單走了一遍，裡面有 WebDAV 的操作影片。

觀看

在首頁左上角的來源標籤裡選取這個來源，再打開瀏覽。它會依名稱把影片分到電影和影集裡；資料夾會先列出資料夾，再列出影片，只顯示檔名和每支影片的大小，在影片上按確定鍵播放。作品會顯示放在它旁邊的海報和簡介（怎麼命名），檔案裡沒有的，楊桃播放器會上網查。

• 播放過的影片會以檔名出現在觀看紀錄裡，也會出現在首頁的繼續播放裡。在那裡選它，就會從上次停下的地方接著播。
• 影片內嵌的字幕，以及和影片同名的字幕檔（Movie.mkv 旁邊的 Movie.srt 或 Movie.en.srt），都可以在播放器的字幕裡選擇（手機或平板上是音軌和字幕）。
• 能不能播放要看電視內建的解碼器：MP4 或 MKV 封裝的 H.264、H.265 最保險。在 Android 上，電視解不了的 AC3、E-AC-3、DTS 和 TrueHD 音訊，楊桃播放器會自己解碼（見Android TV 上的 DTS、TrueHD 和杜比音訊）。

掛載在 OpenList 裡的雲端硬碟

在 OpenList 裡新增的雲端硬碟，到了楊桃播放器裡就和其他資料夾一樣。影片怎麼傳到電視上，要看這個儲存的 WebDAV 策略：在儲存裡找到它，按編輯就能看到。

• 本機代理：由 OpenList 從雲端硬碟取得影片，再轉給電視。影片的播放速度取決於 OpenList 能多快取得資料，所以雲端硬碟速度慢，或執行 OpenList 的機器網路慢，開始播放和拖曳進度時都要等。本機儲存只有這一項和使用代理網址可選。
• 302 重新導向：OpenList 把電視導向檔案本身的連結，電視直接從那裡取得影片。驅動支援的話，OpenList 預設就會選這一項。我們用這種方式播放過影片，不過用的是自己區域網路裡的連結，而不是真正的雲端硬碟。

如果某個雲端硬碟裡的影片在 302 重新導向下無法播放，就把這個儲存改成本機代理試試看，OpenList 的說明文件說它的相容性最好。

免費還是 Pro

一個 OpenList 或 Alist 檔案庫算一個來源，不管裡面掛載了多少個儲存，而第一個來源是免費的。再新增第二個來源，例如 NAS 上的一個共用資料夾或一台 Jellyfin 伺服器，就需要 Pro。在我們網站上的售價是 7.47 美元（優惠價，原價 14.95 美元，優惠持續到 2026年12月31日），一次付清，不是訂閱，一份授權可同時用在最多 5 台裝置上。在 Android TV 以及 Android 手機和平板的應用程式裡，可以免費試用 Pro 7 天，每台裝置一次，不需要任何付款資料，到期會自動結束。怎麼購買和啟用，請見 Yonto Pro。

連不上時

下面這些訊息會出現在瀏覽裡，旁邊有重試按鈕。

「連不上伺服器。請確認它已開機，並且和這台裝置在同一個網路。」請確認 OpenList 正在執行、電視連得到執行它的那台機器，而且伺服器位址裡的 IP 位址和連接埠都正確，例如 http://192.168.1.20:5244/dav。

「伺服器不接受這個使用者名稱或密碼。請在此來源的設定中檢查。」進入設定、來源，選取這個來源，選編輯，改正使用者名稱和密碼。它們就是這個 OpenList 使用者登入網頁介面用的那一組。

「這個資料夾已不存在。」/dav 後面的路徑在檔案庫裡找不到對應的資料夾，或儲存的掛載路徑改過了。請對照儲存裡的路徑，檢查拼字和大小寫。

「這個帳號無權開啟這個資料夾。請在此來源的設定中檢查使用者名稱，或在伺服器上檢查這個帳號的權限。」這個 OpenList 使用者沒有 WebDAV 讀取權限。進入使用者，在這個使用者上按編輯，勾選 WebDAV 讀取，再按儲存。

疑難排解列出了應用程式會顯示的每一則訊息。

楊桃播放器本身不提供任何內容。OpenList 和 Alist 是獨立的開源專案，楊桃播放器與它們沒有關聯，也未獲得它們的認可。