---
title: "خطای Permission Denied داکر: سوکت API را درست کن"
description: "خطای permission denied while trying to connect to the Docker API: گروه docker، rootless، DOCKER_HOST و context اشتباه."
author: "Mohammad Pouya Ghourchiani"
canonical: "https://ghourchiani.ir/fa/blog/docker-permission-denied-api-socket"
image: "https://ghourchiani.ir/og/mark-square.png"
date: "2026-11-17"
lang: "fa"
generated: "2026-11-19"
---
# خطای Permission Denied داکر: سوکت API را درست کن

> **خلاصه:** خطای permission denied while trying to connect to the Docker daemon API یعنی CLI به سوکت موتور رسیده و کرنل گفته نه. معمولاً نصب خراب نیست. به ترتیب چک کن: عضویت در گروه docker، لاگ‌اوت/newgrp، مسیر و دسترسی سوکت، قاطی rootless/rootful، و DOCKER_HOST یا context اشتباه.

## پاسخ مستقیم

**`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` اشتباه.

```sh
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` (رایج‌ترین روی لینوکس)

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

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

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

```sh
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 می‌گیری.

```sh
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 دروغ می‌گویند

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

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

```sh
unset DOCKER_HOST
docker context use default
docker info
```

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

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

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

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

## اثبات

```sh
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 سالم).

## لینک‌ها

- [/fa/blog/cve-2026-98432-docker-container-namespaces](/fa/blog/cve-2026-98432-docker-container-namespaces) — هاست «اوکی»، کانتینرها هنوز دروغ
- [/fa/blog/mirror-first-dx](/fa/blog/mirror-first-dx) — وقتی بعد از سوکت، درد بعدی Hub/egress است
- [/fa/about](/fa/about) · [/fa/contact](/fa/contact)
