在本機用 Docker Compose 跑 n8n 雖然簡單，但常常會遇到一些小問題。以下整理幾個新手（當然也包含我）最常踩到的坑：

1. Port 已被佔用
   錯誤訊息：Error starting userland proxy: listen tcp 0.0.0.0:5678: bind: address already in use
   👉 解法：代表本機 5678 Port 已經被其他程式使用。修改 docker-compose.yml：

ports:
  - "8080:5678"

然後用 http://localhost:8080 開啟。
2. 資料不見 / Workflow 消失
狀況：重新啟動容器後，發現之前建立的 Workflow 不見了。
👉 解法：確保 volumes 有正確掛載，例如：

volumes:
  - ./n8n_data:/home/node/.n8n

這樣 Workflow 與設定才會保存在本機目錄。
3. 權限問題
錯誤訊息：permission denied 或容器內無法寫入 n8n_data。
👉 解法：調整目錄權限：

chmod -R 777 ./n8n_data

（開發環境可以用 777，正式環境建議設定更嚴謹的使用者 UID/GID）
4. 無法連線 Web UI
狀況：啟動成功但瀏覽器打不開 http://localhost:5678。
👉 解法：先檢查容器是否正常運行：

docker ps
docker logs <container_id>

確認服務有正確啟動。如果你是在雲端 VM，要記得開放防火牆規則。
5. 版本更新後出現不相容
狀況：pull 最新的 image 後，舊的 Workflow 無法正常執行。
👉 解法：官方建議在升級前備份 .n8n 資料夾，或使用 Git 管理 workflow JSON 匯出，避免資料遺失。
💡 以上小提醒可以幫助你快速排查問題。到這一步，你已經能穩定在本機跑 n8n，接下來我們會挑戰更進一步：把 n8n 搬到雲端，結合 GCP 的服務打造真正的自動化平台。