Архитектура подсистемы Docker Storage и синтаксический анализ путей

Ошибка Error response from daemon: create <path>: invalid characters for a local volume name или invalid volume specification возвращается парсером аргументов CLI/API демона dockerd. Это происходит, когда строка маппинга томов (флаг -v или директива volumes: в Compose) не соответствует стандарту POSIX/Windows, содержит недопустимые двоеточия, пробелы, относительные пути без точки или некорректные флаги монтирования (например, :ro,z,invalid).

Бизнес-риски:

Срыв сборки и развертывания приложений в гетерогенных средах (CI/CD на Windows/Linux runners), невозможность сохранения персистентных данных БД и потеря конфигурационных файлов при деплое.

Сравнительная таблица синтаксиса монтирования томов

Пошаговое исправление спецификаций монтирования томов

Сценарий 1: Переход на безопасный расширенный флаг --mount

Флаг --mount использует явные пары ключ-значение, исключая ошибки синтаксиса парсера флага -v:

# Использование строгого синтаксиса --mount:
docker run -d \
  --name webapp \
  --mount type=bind,source='/opt/my app/data',target=/app,readonly \
  nginx:alpine

Сценарий 2: Корректное экранирование путей в Windows и WSL2

При использовании PowerShell или Git Bash на Windows пути преобразуются автоматически, что вызывает ошибки:

# Для PowerShell (абсолютный путь с использованием переменных):
docker run -v '${PWD}/config:/etc/config:ro' nginx

# Для Git Bash (отключение автоматической конвертации путей POSIX):
MSYS_NO_PATHCONV=1 docker run -v 'C:/project/data:/data' alpine

Сценарий 3: Исправление спецификации в docker-compose.yml

Проверьте корректность YAML-разметки и кавычек при наличии переменных окружения:

services:
  db:
    image: postgres:15
    volumes:
      # Именованный том
      - pgdata:/var/lib/postgresql/data
      # Относительный путь (обязательно начинается с ./)
      - ./init.sql:/docker-entrypoint-initdb.d/init.sql:ro

volumes:
  pgdata:

Типовые ошибки администраторов

• Использование относительных путей без точки: Запись myfolder:/app воспринимается Docker как именованный том myfolder, а не локальная папка. Для bind mount обязательно писать ./myfolder:/app.
• Использование символа двоеточия в именах папок: Двоеточие является зарезервированным разделителем между хостом и контейнером.