При Permission denied в подключённой папке сначала сравните пользователя процесса и владельца каталога. На Linux важны числовые UID и GID: одинаковое имя пользователя на хосте и в образе не доказывает одинаковую идентичность. Отдельно посмотрите, не подключён ли каталог только для чтения. chmod 777 скрывает часть причин и расширяет доступ всем локальным пользователям.
Сохраните точный путь из ошибки и определите, какой mount его покрывает. Приложение может писать в соседний каталог или пытаться создать временный файл рядом с целевым. Для безопасной диагностики достаточно метаданных и пробной операции с новым тестовым файлом в выделенной папке, без изменения существующих пользовательских данных.
Каталог образа и подключённая папка — разные объекты
Bind mount перекрывает содержимое в точке подключения. Права, заданные при сборке образа для /app/uploads, не исправят автоматически права каталога хоста, подключённого туда позднее. Документация Docker также отмечает, что source bind mount относится к машине Docker daemon. При удалённом daemon сравнивать папку на ноутбуке бессмысленно.
# условный сервис app с каталогом /app/uploads
docker compose exec app id
docker compose exec app ls -ldn /app /app/uploadsКоманды подходят для Linux-образа, в котором есть id и ls. Вывод exec относится к запущенной диагностической команде; если приложение меняет пользователя после старта, отдельно установите UID именно записывающего процесса. На хосте прочитайте числового владельца фактического source. Не копируйте UID из случайного образа: после смены базового образа он мог измениться.
Четыре проверки до смены владельца
| Признак | Проверка |
|---|---|
| Mount только для чтения | режим ro или readonly и RW в inspect |
| UID процесса другой | user сервиса и пользователь приложения |
| Каталог виден, создание не работает | write и execute на каталоге |
| Обычные права подходят, доступ запрещён | ACL, SELinux и namespace mapping |
При включённом userns-remap идентификаторы контейнера сопоставляются идентификаторам хоста. Docker прямо предупреждает: владение подключёнными файлами требуется согласовать с таким mapping. Не отключайте user namespaces ради быстрого обхода отказа. Сначала установите действующую схему; аналогично не отключайте SELinux глобально, если журнал показывает запрет политики.
Исправление ограничивается каталогом данных
Назначьте согласованного владельца или группу только папке, в которую сервис действительно должен писать. Код приложения и конфигурация обычно не требуют такого же доступа. Перед рекурсивной операцией перечислите точную выборку, сохраните прежние метаданные и проверьте, что путь не указывает на общий каталог другого проекта. Универсальной безопасной команды chown для всех установок нет.
- Отделить uploads и временные файлы от кода.
- Согласовать UID/GID со способом запуска приложения.
- Не делать read-only mount записываемым без обоснования.
- Оценить доступ соседних сервисов к общему каталогу.
- Зафиксировать права в процедуре развёртывания, а не только исправить вручную.
При нескольких workers проверьте владельца новых файлов каждого экземпляра. Один root-worker может создавать объекты, которые второй экземпляр уже не сможет изменить. Повторная обработка загрузки должна сохранять выбранную схему доступа; иначе ошибка вернётся после первого успешного запроса.
Приёмка включает чтение после перезапуска
Создайте обезличенный тестовый файл через приложение, прочитайте его, замените штатным действием и удалите через тот же интерфейс. Затем пересоздайте контейнер и повторите тест: ручная правка внутри временного слоя могла исчезнуть. Убедитесь, что соседний пользователь не получил лишний доступ, и что backup по-прежнему читает нужные данные.
Откат возвращает сохранённые права только затронутой выборки и учитывает файлы, созданные после исправления. Для технического разбора соберите строку Permission denied, Mounts без секретов, числовые UID/GID и способ запуска процесса. Содержимое пользовательских файлов и полный inspect с переменными окружения отправлять не требуется.