Raspberry Pi 映像檔編輯器 (Docker 版)

這是一個安全、可靠的解決方案，讓您可以在 macOS、Windows 或 Linux 主機上，透過 Docker 容器來掛載並讀寫 Raspberry Pi 的磁碟映像檔 (.img 檔)。

此工具解決了在非 Linux 系統上原生無法讀寫 ext4 等 Linux 檔案系統的常見問題。它將所有複雜操作封裝在一個自動化的 Docker 環境中，確保您的主機系統保持乾淨，並透過腳本自動處理掛載與卸載，避免映像檔損毀。

✨ 功能特性

• 跨平台相容：只要能執行 Docker，就能在 macOS, Windows, Linux 上使用。
• 安全隔離：所有操作都在 Docker 容器內進行，不需在您的主機上安裝任何核心驅動或第三方軟體。
• 讀寫支援：提供對 ext4 分割區的完整讀寫權限。
• 自動清理：內建的啟動腳本使用 trap 機制，確保在您退出時，檔案系統總是被乾淨地卸載，防止資料損毀。
• 簡單易用：一次性設定後，未來只需一行指令即可進入編輯環境。
• 可重複使用：建立一次 Docker 映像檔後，可用於編輯任何 .img 檔案。

建立 Docker 映像檔

在 `imgtool` 目錄中，執行以下指令來建立映像檔。我們將其命名為 `imgtool`。

```bash
docker build -t imgtool .
```

設定完成！您現在擁有一個可重複使用的強大工具。

🛠️ 如何使用

設定完成後，每次要編輯 .img 檔都非常簡單。

```bash
docker run -it --rm --privileged -v "<path to .img>:/disk.img" imgtool
```

啟動後，您的 .img 檔中的 Linux 檔案系統會被自動掛載到容器內的 /mnt/data 目錄。您可以直接 cd /mnt/data 並開始修改檔案。 完成所有修改後，只需輸入 exit 或按下 Ctrl+D。啟動腳本將會自動為您卸載所有裝置，然後容器會自動銷毀。

⚠️ 重要：備份您的映像檔！ 此工具會直接修改您原始的 .img 檔案。在進行任何重大修改之前，強烈建議您先建立一份備份！