作者： Matt Connor
Immich 上電視：Google Cast、Android TV、Apple TV 怎麼選
想在客廳電視看 Immich 相簿？依你手上的電視或盒子選路：官方 Google Cast 從網頁投放需要公開 HTTPS 網域，手機 app 投放只要電視連得到伺服器，Apple TV 與 Android TV 靠第三方 app，另外要處理 API 金鑰權限和 HEVC 影片轉檔。
Immich 上電視，先看結論
想把 Immich 的相簿放到客廳電視上看，Immich 官方文件裡寫的路只有一條：Google Cast 投放。這條路有條件。Immich 必須能從公開網路用 HTTPS 連到，網域名稱也必須能被 Google 的 DNS 伺服器查到。Apple TV 和 Android TV 上的 Immich app 都是第三方開發的，跟 Immich 專案沒有隸屬關係。
所以順序是這樣：先確認你的電視或盒子能不能當 Cast 接收端，再確認你的 Immich 符合投放條件。兩邊都不行，才考慮第三方 app，而且只給它一把權限最窄的 API 金鑰。每一步都在網頁或 app 的介面裡完成，不需要打任何指令。
名詞先說清楚。HTTPS 是加密的網頁連線，網址列會顯示鎖頭。DNS（網域名稱系統）負責把 photos.example.com 這種名稱換成 IP 位址。API 金鑰是一串字元，app 拿它代替帳號密碼去存取 Immich。
你家是哪一種電視或盒子
先照手上的設備對號入座，後面各節再說明原因。
- Google TV、Android TV 電視或盒子，或 Chromecast 電視棒：先走官方的 Google Cast。第三方的 Android TV app 是第二選擇。
- Apple TV：Apple TV 不是 Cast 接收端。App Store 上有三個第三方 app 可以選：Immich Viewer、ImmichTV、Immich Gallery。
- LG webOS 電視：社群有非官方移植版，但要用 IPK 安裝檔側載，下面不涵蓋。改用一支 Cast 電視棒接到 HDMI。
- Samsung Tizen 電視：先在電視的 app 商店搜尋 Immich。找不到可靠的 app，就改用 Cast 電視棒。
- Xbox、電信業者的 MOD 機上盒：如果裝置不讓你自己安裝 app，就不要在它上面找解法。在電視另一個 HDMI 輸入插一支 Cast 電視棒，比較省事。
- 來路不明的「電視盒」：不建議把 APK 側載上去。側載是指從官方商店以外安裝 app 檔案。你得把伺服器網址和 API 金鑰交給這台盒子，而它的韌體被誰改過，你沒有辦法查證。
怎麼知道電視是不是 Cast 接收端？讓手機和電視連同一個 Wi-Fi，在手機打開任何有投放按鈕的 app（例如 YouTube），按下投放圖示。清單裡出現這台電視，它就能接收 Cast。
官方路線：Immich 的 Google Cast 投放
Immich 的投放文件在 2026 年 10 月 21 日更新過。上面寫了幾件要先知道的事。
- 這是實驗性功能。 文件原文說它「considered experimental」，並列出幾項限制。
- 預設是關閉的。 原因是網頁介面要從 Google 的伺服器載入 Google 提供的程式碼，這對一部分使用者是隱私疑慮，所以改成自己選擇打開。
- 開啟位置：文件寫的是
Account Settings > Features > Cast > Google Cast。v1.135.0 的發布說明寫的路徑是Account Settings > Features > Settings > Cast。不同版本的標籤可能不一樣，在 Features 裡找 Cast 就對了。 - 它在個人的 Account Settings 裡，所以家裡每個帳號要各自打開。Account Settings 從網頁右上角的使用者圖示進入。
投放要符合的三個條件
文件列出三個前提，原意如下：
- 你必須用 HTTPS 連線打開 Immich，投放選單才會出現。
- Immich 必須能從公開網路用 HTTPS 連到，而且伺服器的 DNS 紀錄要能透過 Google 的 DNS 伺服器（
8.8.8.8和8.8.4.4）查到。 - 影片格式必須是 Google Cast 支援的格式。
第二條最常卡住人。投放時，畫面不是從你的電腦傳到電視。電視上的 Cast 接收端會自己去 Immich 伺服器拿照片。所以接收端必須查得到你的網域，也必須連得到你的伺服器。
放在 VPS 上、有自己網域的 Immich 為什麼符合條件
如果 Immich 跑在 VPS（虛擬私人伺服器）上，網域的 DNS 紀錄設在公開的 DNS 服務商，前面再用反向代理提供 HTTPS，三個條件裡的前兩個就都符合了。理由很直接：公開的 DNS 紀錄，8.8.8.8 查得到；VPS 有公開 IP，電視連得到。
反向代理還沒設好的話，可以參考在 VPS 上用 Caddy 做反向代理並自動取得 HTTPS 憑證。Immich 本身還沒架的話，先看在 VPS 上自架 Immich 取代 Google 相簿。
要注意一件事：符合投放條件，就代表 Immich 的登入頁面對整個網際網路公開。請保持 Immich 在最新版本。截至 2026 年 10 月 25 日，最新的伺服器版本是 v3.3.5（10 月 21 日發布），發布說明裡帶有一項安全性修正。
如果你在 Immich 前面多加了一層登入閘道（例如單一登入的轉發驗證），請實際測試投放。v1.135.0 的發布說明寫明，接收端必須能透過伺服器網址直接連到伺服器。多一層登入頁，接收端未必過得去。
家裡 NAS 只有區網 IP 或 tailnet 名稱，為什麼投不出去
很多台灣和香港家庭把 Immich 放在家裡的 NAS 上，用 192.168.1.20 這類區網 IP 連線。這不符合第二個條件。區網 IP 沒有公開的 DNS 紀錄，從網際網路也連不到，所以投放會失敗。用區網 IP 打開網頁時通常也不是 HTTPS，連第一個條件都不符合，投放選單根本不會出現。
用 Tailscale 連回家的情況也一樣。MagicDNS 名稱是給 tailnet 裡的裝置解析用的。Google 的 8.8.8.8 不在你的 tailnet 裡，查不到這個名稱。電視棒也不在 tailnet 裡，就算查到了也連不過去。
不想租 VPS，又想讓家裡的 NAS 對外有一個公開的 HTTPS 名稱，有兩種常見做法。一種是用 Cloudflare Tunnel 對外公開服務，不必在路由器開連接埠，名稱落在你自己的網域。另一種是下一節的 Tailscale Funnel。兩種在書面上都提供公開的 HTTPS 名稱，但 Immich 的文件沒有提到其中任何一種，請以實際投放的結果為準。
Tailscale Funnel 的 ts.net 名稱能用來投放嗎
這個問題沒有官方答案，所以下面只列出事實和要測試的地方。
Tailscale 的 Funnel 文件這樣寫：Funnel 目前是 beta，所有方案都能用。它需要 MagicDNS、HTTPS，以及 Tailscale v1.38.3 或更新版本。它會把服務公開到網際網路，連沒有用 Tailscale 的人也能連。Funnel 的名稱只能用你 tailnet 的 ts.net 網域。裝置連 Funnel 網址時，會先向公開的 DNS 伺服器查詢，得到的是 Funnel 中繼伺服器的 IP，而不是你那台裝置的 IP。
從這段描述看，ts.net 的 Funnel 名稱是公開可查的，而且走 HTTPS，看起來接近 Immich 的條件。可是 Tailscale 的文件沒有提到 Google 的 DNS 伺服器或 Chromecast，Immich 的文件也沒有提到 Funnel。所以它能不能投放，要你自己按下投放才知道。
影片是另一個問題。Funnel 文件說，經過 Funnel 的流量受到「無法調整的頻寬限制」，但沒有公布數字，也沒有提到影片串流。另外，Funnel 只能聽 443、8443、10000 三個連接埠，而且只接受 TLS（傳輸層安全）加密的連線。照片投放通常量不大。一段長影片能不能順暢播放，請找一支幾分鐘的影片實測。限制的細節整理在Tailscale Funnel 的頻寬限制與可用連接埠。
手機 app 能不能投放？文件和發布說明不一致
投放文件目前寫著：這個功能只有網頁版支援，Android 和 iOS 的支援「計劃在未來加入」。這段已經過時了。
Immich v1.135.0 在 2025 年 6 月 18 日發布，發布說明寫明手機 app 可以投放到 Google Cast 裝置，照片和影片都支援，跟網頁版類似。對應的變更是 feat(mobile): add cast support。截至 2026 年 10 月 25 日，Immich 主分支的手機 app 程式碼仍然包含投放功能，版本號是 3.3.0-rc.0。
手機投放有自己的規則，同樣出自 v1.135.0 的發布說明：
- 只有已經上傳到伺服器的照片和影片可以投放。手機裡還沒備份的照片不行。
- 手機 app 裡設定的伺服器網址，接收端也必須連得到。
- 手機投放不受網頁版那個「Google Cast 選擇開啟」設定控制。網頁版沒打開，手機一樣可以投。
書面上，手機版的條件比網頁版寬鬆，只要求接收端連得到伺服器網址，沒有提到 Google 的 DNS。但這個差異沒有實測根據。家裡手機用區網 IP 連 NAS、電視棒在同一個網路的情況能不能成功，請自己試一次。
Android TV 與 Google TV：先用 Cast，第三方 app 要看清楚
Google TV 和 Android TV 裝置如果出現在投放清單裡，最省事的做法就是用網頁或手機投放，什麼都不用裝。
想要一個在電視上直接瀏覽相簿、還能當螢幕保護程式的 app，社群裡最常被提到的是 giejay 開發的 Immich Android TV（GitHub 上的 giejay/Immich-Android-TV，GPL-3.0 授權）。它是獨立專案，不是 Immich 官方出品。
- 發行方式：這個專案在 GitHub 上有 APK 版本，截至 2026 年 10 月 25 日，最新是 2026 年 10 月 16 日的 6.2.0。從 GitHub 下載 APK 來裝，就是側載，下面不教。
- Play 商店：專案的 README 沒有連到 Google Play 的上架頁面。請在電視的 Play 商店搜尋看看，找得到正式上架的版本再考慮。
- 螢幕保護程式：README 說要開啟電視的開發者模式和 USB 偵錯，再用 ADB（Android Debug Bridge，Android 的除錯工具）從電腦下設定。這已經超出介面操作的範圍，有需要的話請直接照 README 做。
README 列出這個 app 需要的 17 項 API 金鑰權限。大多是讀取、檢視、下載類，但 tag.asset 例外：在 Immich 的原始碼裡，它管的是替照片加上或移除標籤，屬於寫入權限。讀取標籤的是另一項 tag.read。
activity.read album.download album.read archive.read
asset.download asset.read asset.view face.read
folder.read library.read memory.read partner.read
person.read session.read tag.asset tag.read
timeline.read這是開發者寫的需求清單，不是測試過的最小集合。
Apple TV：三個第三方 app 的差別
Apple TV 上沒有 Cast，所以只能用 app。下面三個都在美國區 App Store 上架，每個都在自己的頁面寫明跟 Immich 專案無關。以下內容來自 2026 年 10 月看到的商店頁面。台灣和香港區的價格和上架狀態可能不同，請在自己的 App Store 確認。
Immich Viewer（開發者 Adrian Lothar Kraemer）：免費，只支援 Apple TV，需要 tvOS 18.2 或更新版本。1.7 版的更新說明寫著相容最新的 Immich v3 伺服器。商店頁面沒有寫它用什麼方式登入。
ImmichTV（開發者 David Lüthi）：美國區售價 US$2.99，另有 App 內購買。支援 Apple TV、iPhone、iPad 和 Mac，需要 tvOS 17.6 或更新版本，登入時要填伺服器網址和 API 金鑰。要特別注意，商店頁面寫著它「只跟你區域網路裡的 immich-server 溝通」。如果你的 Immich 在遠端 VPS 上，這個 app 不一定適合，先試用或先問開發者。
Immich Gallery（開發者 Sanketh Kumar N M，GitHub 上是 mensadilabs）：免費，App Store 頁面寫需要 tvOS 18.2 或更新版本，目前是 1.3.7 版。GitHub README 說可以用密碼或 Immich API 金鑰登入。README 寫的系統需求是 tvOS 15.0，跟商店頁面不一致，以你在商店看到的為準。
Immich Gallery 是三個裡唯一公開權限清單的。它的權限說明頁列出 11 項必要權限：
album.read asset.download asset.read asset.statistics
asset.view folder.read person.read stack.read
tag.read user.read userProfileImage.read同一頁說，沒用到的功能可以拿掉對應權限，例如不用標籤就拿掉 tag.read，但只給部分權限的組合沒有測試過。
給電視用的 API 金鑰：權限越窄越好
目前的 Immich 伺服器支援細分權限的 API 金鑰。伺服器原始碼裡的權限清單有一個萬用的 all，也有 asset.read、asset.view、asset.download、album.read 這類只讀的權限。前面兩個 app 列出的權限，在 Immich 的清單裡都找得到。
電視是全家共用的裝置，誰都按得到。所以建立金鑰時請照這幾個原則：
- 不要選
all。all包含刪除和修改的權限，電視用不到。 - 照該 app 的清單勾選。 有公開清單的，例如 Immich Gallery 和 giejay 的 Android TV app，就照清單給。沒有公開清單的，先只給讀取、檢視、下載類，缺什麼再補。
- 一台裝置一把金鑰。 金鑰名稱寫上裝置，例如「客廳 Apple TV」。電視送修、換掉或賣掉時，刪掉那一把就好，不影響其他裝置。
- 想限制電視看得到哪些照片，就另開一個帳號。 金鑰的權限是跟著帳號的。用一個只看得到家庭共享相簿的帳號建立金鑰，電視就看不到你的私人照片。
金鑰在 Account Settings 裡建立，Account Settings 從網頁右上角的使用者圖示進入。Immich 的文件沒有逐一說明每項權限的作用，權限名稱就是最直接的線索。
影片投不出來：Cast 支援的格式與 HEVC
照片能投、影片不能播，最常見的原因是編碼格式。HEVC（高效率視訊編碼，又叫 H.265）是很多手機錄影的格式。它的檔案比較小，但不是每一台 Cast 裝置都能解。
Google 的 Cast 媒體格式文件逐一列出各裝置支援的影片編碼。HEVC 只出現在 Chromecast Ultra、Chromecast with Google TV 和 Google TV Streamer。第一到第三代 Chromecast 和 Nest Hub 列的是 H.264 加上 VP8 或 VP9，沒有 HEVC。例如第三代 Chromecast 最高是 H.264 High Profile level 4.2（1080p/60fps），Nest Hub 是 level 4.1（720p/60fps）。所以同一支 HEVC 影片，在 Google TV Streamer 上能播，在舊的 Chromecast 上可能播不出來。
容器格式和圖片格式也有清單。容器是 MP2T、MP3、MP4、OGG、WAV、WebM。圖片是 APNG、BMP、GIF、JPEG、PNG、WEBP。清單裡沒有 HEIC。iPhone 常見的 HEIC 照片能不能顯示，要看 Immich 送給接收端的是原檔還是它產生的預覽圖。Immich 的文件沒有寫清楚這一點，請實際投一張試試。
Immich 這邊有轉檔機制。依照目前主分支的原始碼，預設的轉檔策略是 required（必要時轉檔），預設接受的影片編碼只有 H.264，目標編碼是 H.264 加 AAC 音訊，目標解析度 720。依文件，required 會把 HDR、非 yuv420p，或不在接受清單裡的影片轉檔。所以在預設設定下，HEVC 影片會被另外轉出一份 H.264 的版本。
有兩點要注意。第一，這些是預設值，管理員可能改過。請到管理員的系統設定裡，打開影片轉檔（Video Transcoding）那一區確認。文件也提醒，把策略設成 disabled（停用）可能在某些裝置上造成播放問題。第二，接收端拿到的是原檔還是轉檔後的版本，文件沒有寫明，所以轉檔開著也不保證一定能播。剛上傳的影片要等轉檔跑完才有可播的版本，轉檔吃多少 CPU，可以參考Immich 需要多少記憶體和儲存空間。
投放失敗時，先對照這幾個症狀
網頁上找不到投放按鈕。 網址列沒有顯示 HTTPS，或是這個帳號還沒在 Account Settings 打開 Google Cast。用區網 IP 開網頁的情況，兩個原因通常同時存在。
按了投放，電視顯示連線後就失敗。 接收端查不到你的網域，或連不到伺服器。區網 IP、MagicDNS 名稱都屬於這一類。換成公開的 HTTPS 網域再試。
電視只顯示藍色標誌，圖片一直不出來。 Immich 有一個 2026 年 7 月 4 日開啟、截至 10 月 25 日仍未關閉的問題回報（#29579），內容是伺服器設定 IMMICH_HELMET_FILE=true 會讓 Google Cast 出現這個症狀。請伺服器管理員確認這個設定。
影片轉向不對。 另一個仍未關閉的問題回報（#24399，2025 年 12 月 5 日開啟）就是投放影片時方向錯誤。這是已知問題，不是你的設定錯了。
照片正常，影片不能播。 對照上一節：先看電視棒支不支援影片的編碼，再看 Immich 的轉檔設定。
FAQ
Immich 的 Google Cast 投放要怎麼打開？
這個功能預設是關閉的，而且是實驗性功能。用 HTTPS 打開 Immich 網頁版，從右上角的使用者圖示進入 Account Settings，在 Features 裡找到 Cast，打開 Google Cast。文件寫的路徑是 Account Settings > Features > Cast > Google Cast，不同版本的標籤可能略有不同。這是每個帳號自己的設定，家人要各自打開。
為什麼家裡 NAS 上的 Immich 投放到 Chromecast 會失敗？
Immich 的文件要求伺服器能從公開網路用 HTTPS 連到，而且 DNS 紀錄要能被 Google 的 8.8.8.8 和 8.8.4.4 查到。區網 IP 和只在 tailnet 裡有效的 MagicDNS 名稱都查不到，電視上的接收端就拿不到照片。改用有公開 DNS 紀錄的 HTTPS 網域，例如放在 VPS 上的 Immich 或經過 Cloudflare Tunnel 公開的服務，並實際測試一次。
Immich 手機 app 可以直接投放到電視嗎？
可以。投放文件還寫著只有網頁版支援，但 Immich v1.135.0（2025 年 6 月 18 日發布）的發布說明寫明手機 app 已經能投放照片和影片，目前的程式碼也仍然包含這個功能。只有已上傳到伺服器的照片能投，而且電視必須連得到手機 app 裡設定的伺服器網址。手機投放不受網頁版的 Google Cast 開關控制。
手機拍的 HEVC 影片為什麼在電視上播不出來？
Google 的 Cast 格式文件裡，只有 Chromecast Ultra、Chromecast with Google TV 和 Google TV Streamer 支援 HEVC。第一到第三代 Chromecast 和 Nest Hub 只列 H.264、VP8 或 VP9。Immich 預設只接受 H.264，會把 HEVC 影片另外轉成 H.264，但前提是轉檔沒有被管理員關掉，而且要等轉檔跑完。請到系統設定的影片轉檔區確認策略不是 disabled。