在 NAS 上安裝 Oulim(測試版)

Oulim Player NAS 是在 NAS 上全天候執行、沒有畫面的 Oulim 伺服器。它的工作和「把電腦當成 NAS 來用」裡的 Oulim 桌面版 一樣:整理影片、尋找海報和作品資訊、註冊裝置,以及在外連線。只要貼上一個 compose 檔案,改兩行就好。

注意 目前尚未推出,暫時無法安裝。Oulim Player NAS 映像會在 App 推出時一併公開,屆時依照本說明安裝即可。

注意 目前是測試版。我們還在各種 NAS 機型上確認,可能會遇到意想不到的問題。發生問題時,請透過管理頁面左下角的回報問題告訴我們。NAS 伺服器的記錄會一起送出,比較容易找出原因(位址和路徑會先遮蔽)。

事前準備

  • 支援 Docker(容器)的 NAS — Synology 的 Container Manager、QNAP 的 Container Station,或已安裝 Docker 的 Linux 裝置
  • 64 位元 CPU — Intel、AMD(x64)或 ARM64。不支援 32 位元 ARM 的 NAS
  • 至少 1 GB 可用記憶體(建議 2 GB 以上)
  • 連上同一個 Wi-Fi、已安裝 Oulim Player 的手機、平板或電視

提示 如果有一台常開的電腦,也可以不用 NAS,改在電腦上安裝 Oulim 桌面版,效果一樣。請參考「把電腦當成 NAS 來用」說明。

1. 準備 compose 檔案

複製下面的內容。只要依你的 NAS 修改標有 <- 的兩行即可。

compose.yaml
services:
  oulim-player:
    image: <published at app launch>
    container_name: oulim-player
    network_mode: host
    user: "1000:1000"              # <- your NAS user id (id -u : id -g)
    environment:
      - OULIM_NAME=Oulim NAS
      - OULIM_MEDIA=/volume1       # folders you can add in the admin page (several: /volume1:/volume2)
    volumes:
      - ./config:/config
      - ./cache:/cache
      - /volume1:/volume1:ro       # <- your video storage, read-only
    restart: unless-stopped
行要填的內容
user你在 NAS 上的使用者 ID。用 SSH 連上 NAS 並執行 id,會看到類似 uid=1026(…) gid=100(…) 的結果。用這兩個數字填寫,例如 "1026:100"
/volume1:/volume1:ro存放影片的儲存空間最上層資料夾。冒號左右填寫相同的 NAS 路徑。:ro 代表唯讀,Oulim 無法刪除或修改你的影片
OULIM_MEDIA在管理頁面中可以選為媒體庫資料夾的位置。填寫和上面掛載的路徑相同的路徑
OULIM_NAME顯示在手機和電視清單中的名稱(不改也可以)
NAS儲存路徑範例
Synology/volume1 · /volume2 …(USB 外接硬碟為 /volumeUSB1/usbshare)
QNAP/share/CACHEDEV1_DATA · /share/CACHEDEV2_DATA …
其他 Linux影片硬碟的掛載位置(例如 /mnt/media)

提示 有多個儲存空間時,在 volumes 下為每個空間各加一行,並在 OULIM_MEDIA 中用 : 串起來,例如 OULIM_MEDIA=/volume1:/volume2

注意 請不要掛載整台 NAS(/),否則連系統資料夾都會顯示出來。只要掛載存放影片的儲存空間就好。

2. 執行

在 NAS 上建立一個資料夾,讓 Oulim 儲存設定(例如 docker/oulim)。在這個資料夾中執行 compose 後,裡面會產生 config 和 cache 資料夾。

NAS執行方式
SynologyContainer Manager › Project › Create → 路徑選擇剛建立的資料夾 → 在 Create docker-compose.yml 貼上複製的內容 → 完成
QNAPContainer Station › Applications › Create → 在 YAML 貼上複製的內容 → 建立
其他 Linux在該資料夾中儲存為 compose.yaml,然後執行 docker compose up -d

提示 NAS 上的選單名稱可能因 DSM 或 QTS 版本而略有不同。實際畫面請參考上面的官方說明。

3. 初始設定

  1. 在同一個 Wi-Fi 的電腦瀏覽器中開啟 http://NAS-address:45800,會出現初始設定畫面。
  2. 在容器記錄中找到設定代碼。Synology 請到 Container Manager › Container › oulim-player › Log 查看,Linux 則執行 docker logs oulim-player。
  3. 輸入設定代碼,設定管理員密碼(至少 8 個字元),然後選擇開始。
初始設定 — 容器記錄中的設定代碼和管理員密碼
初始設定 — 容器記錄中的設定代碼和管理員密碼

提示 管理頁面只能在家用網路中開啟。密碼只會儲存在這台 NAS 上。

4. 加入媒體庫資料夾

  1. 在媒體庫分頁中選擇加入資料夾。
  2. 有多個儲存空間時,先在上方選擇一個,再進入影片資料夾,選擇加入此資料夾。
  3. 影片整理會立刻開始。海報和劇情簡介會依整理完成的順序陸續顯示。
加入資料夾 — 從 compose 中掛載的儲存空間裡選擇
加入資料夾 — 從 compose 中掛載的儲存空間裡選擇

資料夾命名的訣竅和「整理檔案和資料夾」說明相同。在資料夾中加入或刪除影片後,Oulim 會自動更新。

5. 新增手機、平板或電視

  1. 管理頁面:在裝置分頁中選擇註冊裝置,會出現 QR 碼和配對代碼。
  2. 手機:點一下網路分頁上方的 QR 碼圖示(新增我的電腦),掃描 QR 碼。電視則在同一個畫面輸入配對代碼。
  3. 管理頁面:收到請求後,確認兩邊畫面上的確認碼相同,再選擇核准。
註冊裝置 — QR 碼和配對代碼;收到請求時核對確認碼,再按核准
註冊裝置 — QR 碼和配對代碼;收到請求時核對確認碼,再按核准

已新增裝置的網路分頁中會出現這台 NAS,首頁和媒體庫也會顯示 NAS 裡的影片。

提示 如果你也在電腦上使用 Oulim Desktop,請不要再透過 SMB 把這個 NAS 資料夾加入電腦的媒體庫。要在電腦上觀看,像手機一樣把電腦登記到這台 NAS 即可。如果已經加入,電腦不會把該資料夾中繼給裝置,以免同一部影片出現兩次。

在外觀看(Pro)

在管理頁面的遠端存取分頁中選擇連線方式。如果路由器支援自動開放連接埠(UPnP),Oulim 會自動幫你開啟。詳細做法請參考「NAS 與網路連線」說明。

提示 外部存取一開始是關閉的(僅家庭網路)。即使開啟,路由器上也只開啟裝置連線的那一個連接埠,管理頁面不會對外網開放。

提示 同時使用 NAS 和安裝 Oulim 桌面版 的電腦時,路由器上的外部連接埠必須各不相同。自動開放時,Oulim 會挑選沒在用的號碼(45810 · 45811 …)。如果在路由器上手動設定連接埠轉送,請直接使用遠端存取分頁中顯示的外部連接埠 — 例如電腦用 45810、NAS 用 45811。

更新與停止

  • 更新:下載新的映像檔後重新執行。Synology 請對專案依序執行 Stop → Build(下載映像檔)→ Start;Linux 先執行 docker compose pull,再執行 docker compose up -d。
  • 設定、已註冊的裝置和整理好的媒體庫都保存在 config 資料夾中,更新後仍會保留。
  • NAS 重新開機後,Oulim 也會自動重新執行。不過如果是你自己停止的,NAS 重新開機後它仍會維持關閉。

硬體轉碼(選用)

具備 Intel(Quick Sync)或 AMD 內建顯示晶片的 NAS,可以把 4K 影片即時轉成 1080p 再傳送。Oulim 每次啟動都會自動檢查能否使用,結果可在管理頁面狀態中的轉碼那一行查看。

不過 Docker 預設不會把 NAS 的顯示裝置交給容器。請在 compose 的 restart 行上方加入下面兩行,允許容器使用這個裝置。沒有顯示裝置的 NAS 加上這兩行後容器會無法啟動,這時刪掉即可 — 影片會以原始格式播放。

    devices:
      - /dev/dri:/dev/dri

疑難排解

問題檢查項目
手機上找不到 NAS是否連上同一個 Wi-Fi、compose 中是否有 network_mode: host、NAS 防火牆是否封鎖了 UDP 45809 或 TCP/UDP 45810
「加入資料夾」裡沒有想要的資料夾是否已在 compose 的 volumes 中掛載該儲存空間、OULIM_MEDIA 中是否填寫了相同路徑
影片沒有顯示或沒有整理該 NAS 帳號能否讀取影片資料夾 — compose 中 user 填寫的號碼就是這個帳號。在 NAS 的檔案管理工具中,該資料夾的權限需要給這個帳號(或所屬群組)「讀取」權限
加入硬體轉碼後容器無法啟動這台 NAS 沒有顯示裝置(/dev/dri)。請刪除 devices 兩行後重新執行
在同一台裝置上執行兩個 Oulim NAS,第二個管理頁面打不開管理頁面的連接埠(45800)衝突了。請在第二個 compose 的 environment 中加入不同的號碼,例如 OULIM_ADMIN_PORT=45801,然後開啟 http://NAS-address:45801
設定代碼不見了重新啟動容器,記錄中會再次顯示(完成初始設定前都會顯示)