К содержимому

Ошибка permission denied при монтировании volume в Docker Compose

Ошибка permission denied при работе с volume в Docker Compose означает, что процесс внутри контейнера не имеет прав на чтение или запись в смонтированный каталог. Сначала проверьте, от какого пользователя запущен процесс в контейнере и какие права у каталога на хосте.

Ошибка Docker 3 мин чтения

01Несовпадение UID/GID пользователя в контейнере и владельца каталога на хосте

Процесс в контейнере работает от пользователя с определённым UID, а файлы на хосте принадлежат другому пользователю. Если UID не совпадают, контейнер не может писать в каталог. Проверьте, от какого пользователя запущен процесс: docker compose exec app id. Затем посмотрите владельца каталога на хосте: ls -ln /var/www/example.com. Если UID различаются, измените владельца каталога на хосте или запускайте контейнер от нужного пользователя.

bash
docker compose exec app id
ls -ln /var/www/example.com
sudo chown -R 1000:1000 /var/www/example.com

02Каталог на хосте доступен только root

Если каталог на хосте принадлежит root и имеет права 700 или 750, пользователь внутри контейнера не сможет даже прочитать его. Проверьте права: ls -ld /var/www/example.com. Исправьте права командой chmod, добавив группе или всем пользователям право на запись, либо смените владельца на пользователя с нужным UID.

bash
ls -ld /var/www/example.com
sudo chmod 775 /var/www/example.com

03Процесс в контейнере запущен от root, а файлы принадлежат другому пользователю

Некоторые образы по умолчанию запускают процессы от root. Если при этом volume смонтирован с хоста и принадлежит пользователю с UID 1000, root в контейнере всё равно сможет писать, но созданные файлы будут принадлежать root на хосте. Это может вызвать проблемы при последующем запуске от непривилегированного пользователя. Проверьте, от кого работает процесс: docker compose exec app ps aux. Если это root, а вам нужен другой пользователь, укажите его в docker-compose.yml через user:.

yaml
services:
  app:
    image: php:8.3-fpm
    user: "1000:1000"
    volumes:
      - /var/www/example.com:/var/www/html

04SELinux или AppArmor блокируют доступ

На системах с включённым SELinux (например, CentOS) или AppArmor (Ubuntu) политики безопасности могут запрещать контейнеру доступ к каталогу на хосте, даже если права POSIX позволяют. Проверьте статус SELinux: getenforce. Если SELinux в режиме Enforcing, добавьте метку :z или :Z к монтированию в docker-compose.yml. Для AppArmor проверьте логи dmesg | grep -i apparmor.

yaml
volumes:
  - /var/www/example.com:/var/www/html:z

05Проверка, что ошибка исчезла

После исправления прав или настройки пользователя перезапустите контейнеры и проверьте логи. Убедитесь, что в логах нет сообщений permission denied. Выполните тестовую запись в смонтированный каталог из контейнера.

bash
docker compose down
docker compose up -d
docker compose logs -f app
docker compose exec app sh -c 'touch /var/www/html/test && rm /var/www/html/test'

Что не помогает

  • Запуск контейнера с флагом --privileged или от root для обхода ошибки прав.

    Это даёт избыточные привилегии и не решает проблему несовпадения UID. Настройте пользователя в docker-compose.yml или измените владельца каталога на хосте.

  • Установка прав 777 на каталог с хоста.

    Это делает каталог доступным для записи всем пользователям, что небезопасно. Достаточно выставить владельца с нужным UID и права 775.

  • Игнорирование SELinux/AppArmor и повторная установка прав POSIX.

    Если политики безопасности включены, права POSIX не помогут. Добавьте метку :z к volume или настройте политику SELinux/AppArmor.

Deploykin

Как это делается в Deploykin

В Deploykin Docker-контейнеры создаются, запускаются и останавливаются из панели. Там же видны их статусы и тома, терминал для этого не нужен.

7 дней бесплатно на тарифе Про, без привязки карты.

Вопросы и ответы

Как узнать UID пользователя внутри контейнера?

Выполните docker compose exec app id. Команда покажет UID и GID пользователя, от которого запущен процесс.

Почему после монтирования volume файлы на хосте принадлежат root?

Процесс в контейнере работает от root, поэтому создаваемые файлы получают владельца root. Укажите в docker-compose.yml директиву user: с нужным UID.

Как исправить permission denied для каталога, созданного Docker?

Docker создаёт volume от root. Если контейнер работает от непривилегированного пользователя, измените владельца каталога на хосте командой chown или используйте именованный volume с предварительной настройкой прав.

Ещё по теме

Docker Compose: руководство по работе с многоконтейнерными приложениями: все материалы темы

Мы используем cookies и сервис веб-аналитики «Яндекс Метрика» (включая Вебвизор) для улучшения работы сайта. Подробности — в политике конфиденциальности.