圖片放進 Home Assistant 卻是破圖？先做對「重啟」這一步

charles

這篇的內容（8 段）

1. 先記住這一條對應關係
2. 三個最常見的寫錯
3. 步驟 1：進得去設定目錄
4. 方法 D：Terminal & SSH
5. 步驟 2：建立 www 資料夾
6. 步驟 6：先把資料夾結構排好
7. 換了圖片但畫面沒變：快取
8. 檢查清單

做平面圖的第一個關卡不是畫圖，是「把圖片放進 Home Assistant，而且看得到」。

這一關的失敗長得很像路徑打錯：畫面一片空白，或是直接 404。於是大家去改路徑、改權限、換檔名，改一整個晚上都沒用。

真正的原因通常只有一個：Home Assistant 只在「開機的那一瞬間」決定要不要把 www 資料夾公開出去。開機時那個資料夾不存在，之後你放什麼進去都是 404。

這篇做完，你會有一個確定讀得到的圖片網址，以及一張之後一定會用到的全透明圖。



先記住這一條對應關係

檔案放在 www 資料夾裡，網頁上用 /local/ 開頭的網址存取。

1. 檔案實際位置                          網頁上的網址
2. 設定目錄/www/home.png            ->   /local/home.png
3. 設定目錄/www/floorplan/home.png  ->   /local/floorplan/home.png
4. 設定目錄/www/icons/lamp.svg      ->   /local/icons/lamp.svg

複製代碼

HA 只把 www 這一個資料夾公開出去，而公開之後它對外的名字叫 local。

三個最常見的寫錯

1. 錯  /config/www/home.png      這是檔案路徑，不是網址
2. 錯  www/home.png              少了開頭的斜線
3. 錯  /local/www/home.png       多打了一層 www
5. 對  /local/home.png

複製代碼

⚠ 「設定目錄」在不同地方有不同的名字，這是 2023 年底改掉的

這點害很多人把檔案放進一個 HA 永遠不會讀的地方，而且完全不會報錯。

1. 你人在哪裡                        HA 的設定目錄叫什麼
2. HA 官方文件、整合設定裡            /config
3. File editor / Studio Code Server   /homeassistant
4. Terminal & SSH 應用程式            /homeassistant
5. Samba 分享出來的資料夾名稱          homeassistant

複製代碼

以下還有約 80% 的內容
登入後即可閱讀完整教學

登入繼續閱讀使用 Google 登入