如何在樹莓派上安裝 OSMC

要在樹莓派上安裝 OSMC，請先下載適用於您電腦的官方 OSMC 安裝程序，然後使用該程序為您的樹莓派型號準備一張 microSD 卡，最後從該卡啟動樹莓派，並等待設備上的安裝程序完成安裝。請先確認您的樹莓派型號：截至 2026 年 10 月，樹莓派 5 已不再受支持，OSMC 僅提供 2020 年發布的舊版本，適用於初代樹莓派 1 和第一代 Zero 型號。

檢查你的樹莓派並準備一張卡

OSMC 列出了適用於 Pi 2、3、3+、Zero 2 W、Pi 4 和 Pi 400 的當前鏡像；最新版本為 2026.05-2。 Pi 1 和初代 Zero/Zero W 僅支援 2020.11-1 舊版鏡像，Pi 5 不受支援。請查看 OSMC 的支援設備說明，然後從其官方下載頁面下載匹配的鏡像。

準備一張至少 8GB 的​​ microSD 卡（建議使用 Class 10），一個讀卡器，一台 HDMI 顯示器，以及一個適用於您樹莓派的穩定電源。鍵盤或相容的遙控器會很有幫助。安裝程式會擦除所選的 microSD 卡，因此請先備份。避免使用電視 USB 電源；不穩定的電源可能會導致系統當機或檔案系統問題。請參閱樹莓派常見問題。

在 microSD 卡上安裝 OSMC

1. 下載桌面安裝程式。在 OSMC 下載頁面，選擇適用於 Windows、macOS 或 Linux 的安裝程式。 OSMC 目前支援 macOS 12.6 或更高版本，並提供適用於 AMD 64 位元系統的 Linux AppImage 版本。在配備讀卡機的電腦上安裝或啟動程式。



2. 選擇您的樹莓派型號和版本。在安裝程式中，選擇與您的樹莓派主機板相符的樹莓派系列，然後選擇適用於該系列的最新版本。請勿選擇其他型號的鏡像。如果您使用的是樹莓派 1 或初代 Zero，請使用下載頁面磁碟鏡像部分提供的舊版鏡像；OSMC 沒有提供適用於該系列的最新版本。



3. 選擇安裝目標。對於常規設置，請選擇 SD 卡作為 OSMC 的目標位置和安裝文件存放位置。請確認磁碟機名稱和容量，以避免覆蓋其他磁碟。
4. 設定網路選項，然後寫入卡。如果提供乙太網路或 Wi-Fi 選項，請進行設定；DHCP 適用於大多數家庭網路。開始寫入，並在收到完成訊息後再移除卡片。

啟動樹莓派並完成首次運行設置

6. 從記憶卡啟動樹莓派。彈出記憶卡，在樹莓派斷電的情況下插入，並連接HDMI線、可選的乙太網路線和樹莓派的電源。首次啟動時，OSMC會準備儲存並安裝系統。讓它運行一段時間；安裝完成後它可能會重新啟動。



7. 依照設定提示操作。選擇介面語言，並完成顯示的任何裝置名稱或 SSH 提示。啟用 SSH 是可選的；如果您不需要遠端命令列訪問，請保持停用狀態。特定螢幕顯示內容可能因安裝程式版本和裝置而異。



8. 連接到您的網路。如果您尚未預先設定網絡，請在設定過程中選擇乙太網路或 Wi-Fi。對於 Wi-Fi，請選擇您的網路名稱並輸入密碼。 OSMC 的網路設定指南會說明如何稍後在「我的 OSMC」中變更連線設定。



9. 完成安裝並檢查系統。選擇皮膚或其他選用設置，然後等待 OSMC 主畫面出現。測試遙控器或鍵盤，並確認樹莓派已連接到網絡，然後再添加媒體庫或插件。

安裝後：更新並保護 OSMC

新增插件前請檢查更新。如果您啟用了 SSH，請將 OSMC 文件中記錄的預設密碼（osmc）變更為 [此處應填入預設密碼] passwd osmc，並且不要透過路由器連接埠轉送暴露 SSH 服務。請參閱命令列安全指南。

如果安裝未啟動

• 沒有啟動畫面：請確認您的樹莓派型號是否受支持，鏡像檔案是否與型號匹配，以及讀卡機是否已完成寫入。如有其他 Class 10 讀卡機或記憶卡，請嘗試使用。
• 安裝過程中出現當機或網路斷線：請使用專為樹莓派設計的穩定電源，不要使用電視的 USB 連接埠。請檢查 OSMC 常見問題中所述的電源和溫度指示器。
• 設定無法連接：請先嘗試乙太網路連接，重新輸入 Wi-Fi 密碼，或稍後在 My OSMC 中完成設定並設定網路。
• 之後電腦上只顯示一個很小的卡片分區：這可能是正常的。 OSMC會在樹莓派首次啟動時準備好這張卡，並將剩餘空間用於系統運作。