پاسخ مستقیم
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 اشتباه.
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 (رایجترین روی لینوکس)
sudo usermod -aG docker "$USER"
# بعد کامل خارج/وارد شو، یا:
newgrp docker
docker psفقط usermod کافی نیست. شل فعلی هنوز گروه قدیمی را دارد. برای همین نصف اینترنت میگوید «اضافه شدم به docker ولی هیچی عوض نشد.»
فیکس ۲ — سوکت را ببین، نه حسّت را
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 میگیری.
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 دروغ میگویند
env | grep -E '^DOCKER_' || true
docker context ls
docker context showیک DOCKER_HOST=tcp://... کهنه یا context دسکتاپ روی سرور بدون UI، CLI را جایی میفرستد که auth نداری. پاکش کن:
unset DOCKER_HOST
docker context use default
docker infoروی Docker Desktop (ویندوز/مک) خیلیوقتها یعنی VM/موتور خاموش است — Desktop را روشن کن، سالم شد، دوباره بزن. داستان سوکت لینوکس مال engine روی لینوکس است.
فیکس ۵ — Snap / نصبهای عجیب
اگر داکر از Snap یا اسکریپت تصادفی آمده، مسیر سوکت و گروه با داک رسمی یکی نیست. برای سرور پکیج توزیع یا Docker Inc. را ترجیح بده. سیگنال سریع:
which docker
docker version
ps aux | grep -E '[d]ockerd'اثبات
docker run --rm hello-world
docker compose version # اگر compose داریاگر docker info اوکی است و compose میترکد، مشکل نصب Compose است — نه سوکت API.
چکلیست
groupsشاملdockerباشد (بعد از re-login /newgrp)./var/run/docker.sockروی rootful باشدroot:dockerبا rw گروهی.- تصادفی نروی روی سوکت rootful وقتی rootless زندگی میکنی.
DOCKER_HOSTخالی یا درست؛docker contextهمانی که فکر میکنی.- موتور واقعاً بالا باشد (
dockerd/ Desktop سالم).
لینکها
- /fa/blog/cve-2026-98432-docker-container-namespaces — هاست «اوکی»، کانتینرها هنوز دروغ
- /fa/blog/mirror-first-dx — وقتی بعد از سوکت، درد بعدی Hub/egress است
- /fa/about · /fa/contact