問題現象：

使用snap安裝的docker，執行docker build命令構建景象時報錯：
[+] Building 0.1s (1/1) FINISHED docker:default
=> [internal] load build definition from Dockerfile 0.0s
=> => transferring dockerfile: 2B 0.0s
ERROR: failed to solve: failed to read dockerfile: open Dockerfile: no such file or directory

分析說明：實際目錄下Dockerfile是存在的；

解決方案：優選步驟五，直接安裝官方原始版本docker；

---

🛠? 一、核心問題定位

1. 路徑映射問題
   Snap 版 Docker 默認啟用 嚴格沙盒隔離，容器無法直接訪問宿主機的絕對路徑（如 /data/code）。

   • 錯誤 open Dockerfile: no such file or directory 表明 Docker 引擎未找到構建上下文中的 Dockerfile。
   • 根本原因：Snap 限制了 Docker 對非 /home 或 /tmp 目錄的訪問權限。

2. 權限沖突風險
   即使使用 sudo，Snap 的沙盒規則仍可能阻斷非標準路徑的訪問，導致權限失效。

---

🔧 二、解決方案分步指南

? 步驟 1：確認 Dockerfile 位置與構建命令

# 確認當前目錄存在 Dockerfile
ls -la Dockerfile# 正確構建命令（指定路徑）
docker build -t xxx:latest .

• 關鍵點：
  • 確保終端當前目錄為 Dockerfile 所在目錄（/data/code/codehub/xxx-service）。
  • 若 Dockerfile 不在當前目錄，需用 -f 指定路徑：

    docker build -t xxx -f /path/to/Dockerfile .
    

? 步驟 2：繞過 Snap 路徑隔離（2 選 1）

• 方案 A：移動項目至 Snap 白名單路徑
  將代碼移至 /home 或 /tmp 目錄再構建：

  mv /data/code/codehub/XXX-service ~/projects/  # 移至用戶目錄
  cd ~/projects/xxx-service
  docker build -t XXX .
  

• 方案 B：解除 Snap 路徑限制（需謹慎）
  手動授權 Docker 訪問 /data 目錄：

  sudo snap connect docker:home :home         # 允許訪問所有 /home
  sudo snap connect docker:removable-media    # 允許訪問外部媒體（含 /data）
  sudo systemctl restart snap.docker.dockerd  # 重啟服務[citation:2]
  

? 步驟 3：修復用戶組權限（若方案 2 無效）

# 將當前用戶加入 docker 組
sudo usermod -aG docker $USER# 立即生效組權限（無需重啟）
newgrp docker# 驗證非 sudo 執行權限
docker run hello-world

• 安全提示：加入 docker 組等效于賦予用戶 root 權限，僅限受信任賬戶操作。

? 步驟 4：檢查 Docker 服務狀態

# 確認 Snap 版 Docker 服務已運行
sudo snap services | grep docker# 重啟服務（若異常）
sudo snap restart docker

? 步驟 5：終極方案——改用官方源安裝（推薦）

若上述步驟無效，說明 Snap 版存在兼容性缺陷，建議 卸載 Snap 版 并改用 Docker 官方源：

# 卸載 Snap 版
sudo snap remove docker# 安裝官方 Docker
sudo apt-get update
sudo apt-get install docker.io# 重啟服務并加入用戶組
sudo systemctl restart docker
sudo usermod -aG docker $USER
newgrp docker

---

?? 三、避坑指南

問題現象	原因	解決命令/操作
ERROR: failed to solve	Dockerfile 路徑不可達	移動項目至 /home 或解除沙盒限制
Got permission denied	用戶未加入 docker 組	sudo usermod -aG docker $USER
命令路徑指向 /snap/bin/docker	Snap 版與其他版本沖突	卸載 Snap 版，改用 apt 安裝官方版[citation:3]

---

💎 總結建議

1. 首選方案：
   遷移項目至 /home 目錄 → 避免 Snap 沙盒限制（無需復雜配置）。
2. 長期建議：
   卸載 Snap 版 Docker → 官方源（docker.io）兼容性更佳，權限管理更靈活。
3. 權限原則：
   避免濫用 sudo chmod 666 /var/run/docker.sock（高危操作），優先通過用戶組授權。