Монтирование MinIO в Windows через NetDrive (S3)

Вы развернули кластер MinIO для артефактов сборки вашей команды — два терабайта тестовых фикстур, кэшей слоёв Docker и ночных экспортов на оборудовании, которое вы полностью контролируете. Теперь вы хотите, чтобы каждый Windows-разработчик открывал привычную букву диска и перетаскивал файлы прямо в Проводнике, без установки собственного клиента MinIO и без обёртывания всего в скрипты. NetDrive решает это элегантно: он подключается к S3-совместимому API MinIO и представляет бакет как нативный диск за считаные секунды.

Монтируйте MinIO как диск Windows

NetDrive показывает Google Drive, OneDrive, S3, SFTP, WebDAV и другие хранилища как обычные диски в Windows и macOS — без синхронизации и полной загрузки файлов.

• S3-совместимое подключение — работает с любым эндпоинтом MinIO
• Просмотр бакетов и объектов прямо в Проводнике Windows
• Фоновая загрузка с отслеживанием прогресса в реальном времени

WindowsmacOS

Скачать NetDrive →

Бесплатный пробный период. Доступны бессрочная лицензия и подписка.

Что нужно подготовить перед началом

Соберите следующее перед запуском NetDrive:

• URL эндпоинта MinIO — обычно http://your-server:9000 для локального инстанса или инстанса в локальной сети, либо https://minio.yourdomain.com для сервера за обратным прокси. Порт API MinIO по умолчанию — 9000; консоль работает на 9001, и это не тот адрес, к которому подключается NetDrive.
• Access Key и Secret Key — создайте сервисную учётную запись в консоли MinIO в разделе Identity → Service Accounts или сгенерируйте её командой mc admin user svcacct add. Используйте сервисную учётную запись, а не root-учётные данные; ограничьте её конкретным бакетом для минимальных привилегий.
• Имя бакета — NetDrive подключается на уровне бакета. Если нужно открыть доступ к нескольким бакетам, добавьте в NetDrive отдельный диск для каждого из них.
• Установленный NetDrive на Windows 8, 8.1, 10 или 11. Скачать установщик здесь.

Современные релизы MinIO по умолчанию используют path-style адресацию — именно этот режим NetDrive применяет для S3-совместимых провайдеров. Если ваша версия MinIO старше RELEASE.2022-10-08, убедитесь, что path-style доступ явно не отключён в конфигурации MinIO (MINIO_API_REQUESTS_MAX и настройки virtual-hosted).

Подключение NetDrive к MinIO в Windows

Откройте NetDrive и нажмите кнопку + в Диспетчере дисков, чтобы добавить новый диск. В списке провайдеров выберите Amazon S3 — MinIO использует API S3, поэтому это правильный пункт для всех S3-совместимых хранилищ, включая MinIO, Wasabi и другие самостоятельно размещённые решения.

Заполните поля подключения:

• Access Key ID: ваш access key MinIO
• Secret Access Key: ваш secret key MinIO
• Region: введите us-east-1 — MinIO игнорирует это значение, но поле не должно быть пустым
• Endpoint: URL API вашего MinIO, например http://192.168.1.50:9000 или https://minio.example.com
• Bucket: конкретный бакет для монтирования, например build-artifacts

Включите Path style (в некоторых версиях NetDrive этот параметр называется Force path style). URL в стиле virtual-hosted, например bucket.minio.example.com, требуют DNS-записей, которых обычно нет у самостоятельно размещённого MinIO. Path style — когда бакет отображается как компонент пути, например minio.example.com/bucket, — это то, что вам нужно.

Нажмите Test, чтобы проверить подключение. Зелёная галочка подтверждает, что NetDrive может достучаться до MinIO и пройти аутентификацию. Если проверка не проходит, наиболее частые причины — брандмауэр, блокирующий порт 9000, HTTPS-эндпоинт с самоподписанным сертификатом, либо отсутствие у access key права s3:ListBucket на целевой бакет.

Назначение буквы диска и автомонтирование

Как только проверка подключения прошла успешно, прокрутите до раздела Mount:

1. Drive letter — выберите свободную букву. Для общих рабочих станций удобна командная договорённость вроде M: (для MinIO), чтобы буква была одинаковой на всех машинах.
2. Mount type — Network drive для полного доступа на чтение и запись, либо Read-only drive, если бакет содержит эталонные датасеты, которые не должны изменяться с рабочих станций.
3. Параметры Auto-mount:
   • On login — диск появляется после входа пользователя в Windows. Хороший вариант для рабочих станций разработчиков.
   • On boot — диск монтируется ещё до входа в систему, что полезно для запланированных задач или служб, работающих под системной учётной записью и нуждающихся в доступе к MinIO при старте.
   • Disabled — монтирование вручную из Диспетчера дисков. Удобно для редко используемых бакетов.

Нажмите кнопку Mount (play). Через несколько секунд в Проводнике Windows появится новая буква диска. Перейдите к ней — и вы увидите папки и объекты верхнего уровня вашего бакета MinIO так, будто они локальные.

Работа с файлами в Проводнике Windows

Перетаскивание файлов для загрузки работает именно так, как вы ожидаете. NetDrive ставит передачи в очередь в фоновом режиме и показывает прогресс через значок в системном трее. Для объектов размером более 5 ГБ NetDrive автоматически переключается на multipart-загрузку S3 — никакая дополнительная настройка не требуется для крупных пакетов артефактов или файлов датасетов.

Если другой процесс пишет в бакет, пока вы его просматриваете — например, CI-пайплайн выгружает новые тестовые фикстуры, — список файлов на диске может обновиться не сразу. Щёлкните правой кнопкой мыши по смонтированному диску в Проводнике и выберите Force folder refresh в контекстном меню NetDrive, чтобы подтянуть актуальный список каталога.

Для скриптов или доступа из CI-раннера инструмент командной строки nd3cmd (доступен начиная с NetDrive 3.8.921) позволяет монтировать и размонтировать диски из командной строки — это удобно, когда нужно автоматизировать подключение из сборочного скрипта, а не через графический интерфейс.

Итоги

Подключение MinIO к NetDrive в Windows занимает от трёх до пяти минут, если учётные данные уже под рукой. Тот же способ S3-совместимого подключения работает и для других самостоятельно размещённых или управляемых S3-совместимых хранилищ — Wasabi, Backblaze B2 и прочих, — так что схема настройки масштабируется на весь парк вашего хранилища. О версии для macOS читайте в статье Mount MinIO on macOS with NetDrive. Для настоящего AWS S3 материал Mount Amazon S3 on Windows with NetDrive описывает выбор региона и настройку учётных данных IAM.

— Steve, NetDrive