Docker把Jetson AGX Orin變成樂高積木

2024年，NVIDIA Jetson AGX Orin的Docker 29.3.1版本裝機量突破47萬臺，但官方文檔里藏著個冷知識——超過60%的開發者第一次啟動容器時，會把本地項目目錄搞丟。這不是技術問題，是備份習慣的問題。

jetson-containers項目把這件事攤開了講。它給新手準備了一套「先存檔再冒險」的工作流，核心邏輯像極了游戲里的手動存盤：改配置前按F5，崩了就讀檔重來。

鏡像、容器、卷：三個盒子怎么分

jetson-containers的文檔里有個精妙的類比——鏡像是ISO光盤，容器是你從光盤啟動的電腦，卷則是你插在電腦上的U盤。裝系統時ISO只讀，運行時的改動全寫在內存里，一關機就消失；U盤里的東西才真正留得住。

這個區分在Jetson這類邊緣設備上尤其致命。Orin的64GB內存看著寬裕，但跑起多路視頻推理時，容器日志和臨時文件能把根目錄撐爆。把項目代碼掛成卷（volume）而不是拷進鏡像，是區分新手和老鳥的第一道分水嶺。

具體怎么操作？文檔給出了三段式備份命令，全部帶時間戳：

# 整目錄備份 cp -a ~/projects/my-app ~/backups/jetson-containers/my-app_$(date +%Y%m%d-%H%M%S) # 單文件備份 cp docker-compose.yml docker-compose.yml.bak_$(date +%Y%m%d-%H%M%S) # 項目內即時備份 cp config.yaml config.yaml.bak_$(date +%Y%m%d-%H%M%S)

恢復時直接倒過來：從帶時間戳的文件夾里把內容拷回原位。沒有魔法，就是Linux基礎的cp命令，但加上日期后綴后，你能在backups目錄里看到完整的修改歷史——這比Git的commit更粗暴，也更適合臨時改配置的場景。

驗證Docker環境：一行命令排雷

Jetson AGX Orin出廠預裝的Docker 29.3.1已經帶arm64支持，但權限問題仍是坑點。docker info報錯permission denied時，90%的人選擇sudo運行，這是錯的——正確做法是把當前用戶加入docker組，然后重新登錄。

文檔給的測試命令很克制：

docker run --rm arm64v8/ubuntu:22.04 uname -a

--rm表示容器停止后自動刪除，不會在系統里留垃圾；arm64v8/ubuntu:22.04是Orin能原生運行的鏡像架構。如果這行能輸出內核信息，說明Docker引擎、容器運行時、鏡像拉取鏈路全部正常。

jetson-containers項目在此基礎上做了封裝。它的run.sh腳本會自動檢測JetPack版本（這里是6.2.2），匹配對應的CUDA和TensorRT容器標簽，省去手動指定鏡像名的麻煩。但文檔堅持讓新手先跑通原生Docker命令——理解底層機制，才能在腳本出問題時不抓瞎。

日常操作：啟動、停止、重建的循環

容器化的開發節奏和傳統SSH登錄完全不同。jetson-containers文檔描述的典型工作流是：改代碼→重建鏡像→啟動新容器→驗證→停止→清理。這個循環可能一天跑幾十次，所以每個步驟都被優化到單條命令。

啟動容器時，-v參數把主機目錄掛進容器，-p映射端口，--gpus all暴露Orin的GPU。停止用docker stop，徹底刪除用docker rm，連鏡像一起清用docker rmi。文檔特別提醒：docker system prune會刪除所有未使用的鏡像和卷，執行前確認備份已完成。

重建（rebuild）是新手最困惑的環節。jetson-containers的Dockerfile通常基于dustynv/jetson-inference這類基礎鏡像，加入項目依賴后構建。文檔建議用--no-cache參數強制重新安裝依賴，避免舊層緩存導致「在我機器上能跑」的玄學問題。

一個細節：Orin的ARM架構意味著大部分x86鏡像不能直接跑。jetson-containers維護了arm64版本的PyTorch、TensorFlow、OpenCV等常用庫，docker pull時會自動匹配架構標簽。如果看到「no matching manifest」錯誤，大概率是拉成了amd64鏡像。

從教程到實戰：文檔沒說完的事

這份教程的定位很明確——「保持打開狀態的復制粘貼參考」。它不解釋Docker的底層實現，不展開cgroup和namespace的原理，只告訴你輸入什么命令、預期什么結果。

這種克制本身是一種產品判斷。Jetson開發者的核心痛點不是學透容器技術，是在有限時間內讓模型跑起來。jetson-containers用200行左右的文檔覆蓋了80%的日常場景，剩下的20%留給社區Issue和NVIDIA論壇。

但有個隱患文檔沒提：Orin的eMMC或NVMe存儲壽命。頻繁重建鏡像會產生大量層文件，docker system prune雖然能清空間，但寫放大對閃存并不友好。長期重度使用者可能需要把Docker根目錄遷移到外置SSD——這是進階話題，教程選擇沉默。

你現在的Jetson項目是怎么管理容器配置的——手寫Dockerfile、用docker-compose，還是直接跑jetson-containers的現成腳本？