بلاگ

خطای Permission Denied داکر: سوکت API را درست کن

خطای permission denied while trying to connect to the Docker API: گروه docker، rootless، DOCKER_HOST و context اشتباه.

نویسنده محمدپویا قورچیانیقورچیانی

engineeringinfrastructuredeveloper-tooling

پاسخ مستقیم

permission denied while trying to connect to the Docker daemon API at unix:///var/run/docker.sock یعنی docker CLI به یک سوکت رسیده و کرنل دسترسی نداده. معمولاً نصب داکر «خراب» نیست. ترتیب فیکس: (۱) کاربر داخل گروه docker، (۲) لاگ‌اوت کامل یا newgrp docker، (۳) مسیر/پرمیشن سوکت، (۴) قاطی rootless با rootful، (۵) DOCKER_HOST یا docker context اشتباه.

Shell
docker info >/dev/null
# اگر خطا داد:
groups
ls -l /var/run/docker.sock
echo "DOCKER_HOST=${DOCKER_HOST:-<unset>}"
docker context show

حال‌وهوا 🫠

داکر را نصب کردی. آموزش نوشته بود تمام. زدی docker ps و سیستم مثل نگهبان جواب داد:

Permission denied. خوب سعی کردی.

همان حس قفل‌کردن لابی و جاگذاشتن کارت خودت. موتور اغلب سالم است. یوزر تو مشکل است — یا همان exportی که سه ساعت پیش از یک کامنت کپی کردی.

فیکس ۱ — گروه docker (رایج‌ترین روی لینوکس)

Shell
sudo usermod -aG docker "$USER"
# بعد کامل خارج/وارد شو، یا:
newgrp docker
docker ps

فقط usermod کافی نیست. شل فعلی هنوز گروه قدیمی را دارد. برای همین نصف اینترنت می‌گوید «اضافه شدم به docker ولی هیچی عوض نشد.»

فیکس ۲ — سوکت را ببین، نه حسّت را

Shell
ls -l /var/run/docker.sock
# چیزی شبیه: srw-rw---- root docker ... /var/run/docker.sock
stat /var/run/docker.sock

اگر گروه docker نیست یا برای آن گروه قابل‌نوشتن نیست، پکیج/dockerd ایراد دارد — سوکت را chmod 777 نکن و اسمش را امنیت نگذار.

فیکس ۳ — Rootless در برابر Rootful

Rootless معمولاً جای دیگری گوش می‌دهد (اغلب زیر $XDG_RUNTIME_DIR/docker.sock). اگر rootless راه انداختی ولی شل هنوز می‌رود سراغ /var/run/docker.sock، روی سوکت rootfulی که حقش را نداری permission denied می‌گیری.

Shell
systemctl --user status docker 2>/dev/null || true
echo "DOCKER_HOST=${DOCKER_HOST:-<unset>}"
# برای rootless (وقتی از rootless kit استفاده می‌کنی):
# export DOCKER_HOST=unix://$XDG_RUNTIME_DIR/docker.sock

یکی را انتخاب کن. dockerd با sudo را با DOCKER_HOST روتلس قاطی نکن.

فیکس ۴ — DOCKER_HOST و context دروغ می‌گویند

Shell
env | grep -E '^DOCKER_' || true
docker context ls
docker context show

یک DOCKER_HOST=tcp://... کهنه یا context دسکتاپ روی سرور بدون UI، CLI را جایی می‌فرستد که auth نداری. پاکش کن:

Shell
unset DOCKER_HOST
docker context use default
docker info

روی Docker Desktop (ویندوز/مک) خیلی‌وقت‌ها یعنی VM/موتور خاموش است — Desktop را روشن کن، سالم شد، دوباره بزن. داستان سوکت لینوکس مال engine روی لینوکس است.

فیکس ۵ — Snap / نصب‌های عجیب

اگر داکر از Snap یا اسکریپت تصادفی آمده، مسیر سوکت و گروه با داک رسمی یکی نیست. برای سرور پکیج توزیع یا Docker Inc. را ترجیح بده. سیگنال سریع:

Shell
which docker
docker version
ps aux | grep -E '[d]ockerd'

اثبات

Shell
docker run --rm hello-world
docker compose version  # اگر compose داری

اگر docker info اوکی است و compose می‌ترکد، مشکل نصب Compose است — نه سوکت API.

چک‌لیست

  1. groups شامل docker باشد (بعد از re-login / newgrp).
  2. /var/run/docker.sock روی rootful باشد root:docker با rw گروهی.
  3. تصادفی نروی روی سوکت rootful وقتی rootless زندگی می‌کنی.
  4. DOCKER_HOST خالی یا درست؛ docker context همانی که فکر می‌کنی.
  5. موتور واقعاً بالا باشد (dockerd / Desktop سالم).

لینک‌ها