我一直在嘗試讓我的 Coral AI 加速器在我的機器上運作。最近終於有時間坐下來解決這個問題,並且成功了!你可以在下方看到我是如何做到的……
我的環境設定:
NAS:TS-873(或類似 x86/AMD 型號)
QTS 版本:5.2.9.3410
應用程式版本:Multimedia Console 2.10.0,Container Station 3.1.2.1742
硬體:Google Coral Edge TPU(USB)
症狀:
你插入 Google Coral Edge TPU,打開 Multimedia Console,進入 AI Engines,嘗試啟用「QNAP AI Core」。它可能會短暫顯示「啟動中」,但立刻又跳回「已停用」。網頁介面不會顯示錯誤訊息,只是靜默失敗。
在透過 SSH 和隱藏日誌深入調查後,我發現根本原因不是硬體本身,而是 QNAP 架構中的隱藏 Docker 守護程序損毀。
根本原因:隱藏的 Docker 守護程序
QNAP 實際上運行兩個 Docker 守護程序。一個是你在 Container Station 看到的(docker),另一個則是專供 QNAP 專有應用程式使用的完全隱藏守護程序(system-docker)。
如果你的 NAS 曾經發生過硬重啟、應用程式遷移或電源突波,system-docker 守護程序的虛擬硬碟很可能已經損毀。AI Core 腳本嘗試啟動 QuMagie AI 容器時,遇到損毀的隱藏硬碟,導致在背景中立刻崩潰。
以下是如何清除損毀的隱藏資料庫並從零重建 AI Core。
重要警告:請備份你的人臉資料 ![]()
請不要跳過這一步,除非你想從頭開始 AI 分析。清除隱藏的 Docker 儲存空間會刪除 AI Core 的人臉辨識向量快取。如果你沒有先備份 QuMagie 資料庫,你將失去所有已命名的人臉和自訂標籤,NAS 也必須從頭重新索引你的整個照片庫。
(免責聲明:我自己在執行這個步驟前並沒有備份——我吃了虧,失去了人臉標籤。因此,恢復行為可能會有所不同,但以下是 QNAP 儲存資料庫的標準系統路徑。)
1. 備份你的 QuMagie 資料庫到 Public 資料夾:
SSH 連入你的 NAS,執行以下指令,將人臉資料和縮圖安全複製到備份資料夾:
mkdir -p /share/Public/qumagie_backup
cp -avr /share/CACHEDEV1_DATA/.system/data/s01 /share/Public/qumagie_backup/s01_db
cp -avr /share/CACHEDEV1_DATA/.system/facedata /share/Public/qumagie_backup/facedata
(如果你需要還原,只要在 AI Core 運作後把它們複製回 .system 資料夾即可,但還是提醒——實際行為可能會不同!)
終端機修復步驟說明
以下路徑以 CACHEDEV1_DATA 為 Container Station 使用的儲存區。如果你的應用程式安裝在其他位置,請自行調整路徑。
2. 停止隱藏守護程序並清除殭屍鎖檔:
rm -f /var/run/system-docker.sock
rm -f /var/run/system-docker.pid
killall -9 system-docker 2>/dev/null
3. 清除損毀的隱藏 Docker 儲存空間:
警告:這個指令可能會執行好幾分鐘,因為它要刪除成千上萬的小型分層檔案。請耐心等候完成。
rm -rf /share/CACHEDEV1_DATA/.qpkg/container-station/system-docker/*
4. 重新啟動 Container Station 以重建核心結構:
/share/CACHEDEV1_DATA/.qpkg/container-station/container-station.sh restart
5. 重建遺失的符號連結資料夾:
因為我們已經清空儲存空間,守護程序可能忘記重建 overlay2 儲存驅動需要的特定目錄。請手動建立,以免安裝程式出錯:
mkdir -p /share/CACHEDEV1_DATA/.qpkg/container-station/system-docker/tmp
chmod 777 /share/CACHEDEV1_DATA/.qpkg/container-station/system-docker/tmp
mkdir -p /share/CACHEDEV1_DATA/.qpkg/container-station/system-docker/overlay2/l
6. 清除任何未完全解壓的映像快取:
docker -H unix:///var/run/system-docker.sock system prune -a -f
7. 重新安裝 AI Core:
現在隱藏的 Docker 守護程序已經完全健康並準備好全新環境:
打開 QNAP 網頁介面的 App Center。
找到 QNAP AI Core,解除安裝,然後立刻重新安裝。
這會強制安裝程式重新解壓大型 AI/Ubuntu 映像,並乾淨地注入全新的 system-docker 守護程序。
安裝完成後,回到 Multimedia Console > AI Engines,切換 QNAP AI Core 開關。它應該會立刻切換到「已啟動」。
額外疑難排解:USB 供電不足(Brownout)
如果你已經完成上述軟體修復,但開關依然跳回停用,或 Coral Edge TPU 根本沒出現在 Multimedia Console,可能是硬體供電限制的問題。
Google Coral Edge TPU 在初始化瞬間會有極大的電流突波。許多舊型 QNAP NAS 內建的 USB 埠無法即時提供足夠電力,導致 Coral 立刻因電壓不足而斷線,AI 軟體也隨之崩潰。
硬體修復方法: 將 Coral 插在有外接電源的 USB 3.0 集線器(需插牆壁插座供電),再將集線器接到 NAS。這樣集線器能吸收初始化突波,為 Coral 提供穩定電力。
總之,希望這對你有幫助。我的 AI 人臉辨識約 1,000,000 張照片,預計要跑 10 天左右,但這比其他方法快多了!