Монтирование MinIO на macOS — доступ к S3-хранилищу через NetDrive

Ваша команда развернула кластер MinIO на bare-metal серверах в прошлом квартале. DevOps-инженеры уверенно пользуются mc CLI и S3 SDK. А вот дизайнерам и менеджерам проектов это не подходит — им просто нужно открывать PSD-файлы из бакета assets без обращения в IT. NetDrive напрямую отображает бакеты MinIO в Finder macOS, так что бакет выглядит как обычный USB-накопитель и не мешает работе остальных.

Просматривайте бакеты MinIO в Finder — без CLI

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

• Работает с любым экземпляром MinIO: локальная ВМ, bare-metal или облако
• Нативная поддержка Apple Silicon с версии NetDrive 3.14 — без накладных расходов Rosetta
• Асинхронная загрузка не блокирует приложение, пока передача идёт в фоне

WindowsmacOS

Скачать NetDrive для macOS →

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

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

MinIO предоставляет S3-совместимый API, поэтому NetDrive обращается к нему через провайдер Amazon S3 с пользовательской конечной точкой. Подготовьте следующее перед запуском NetDrive:

• Access Key и Secret Key — из консоли MinIO, раздел Identity → Service Accounts, либо их выдаёт ваш администратор MinIO.
• Endpoint URL — базовый URL порта API вашего сервера MinIO. Для локального сервера: http://192.168.1.50:9000. Для развёртывания с TLS: https://minio.example.com.
• Имя бакета — отображается на вкладке Buckets в консоли MinIO.
• Регион — если ваш экземпляр MinIO не настроен на кастомный регион, используйте us-east-1. MinIO игнорирует это значение, но S3-клиенты обязаны его отправлять.

NetDrive 3.18 и новее требует macOS 14 (Sonoma) или выше. На Mac с Apple Silicon NetDrive работает нативно начиная с версии 3.14.309 — без слоя совместимости.

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

Нажмите на значок NetDrive в строке меню (значок облака в верхней части экрана) и выберите Open Drive Manager:

1. Нажмите +, чтобы добавить новый диск.
2. Выберите Amazon S3 из списка провайдеров — MinIO использует тот же API.
3. В поле Endpoint укажите базовый URL вашего сервера MinIO: http://192.168.1.50:9000 или https://minio.example.com. Имя бакета здесь указывать не нужно.
4. Вставьте ваши Access Key и Secret Key MinIO в соответствующие поля.
5. Установите Region равным us-east-1 (или укажите настроенный вами регион, если он задан явно в MinIO).
6. Нажмите Connect. NetDrive обратится к вашему серверу MinIO и получит список бакетов.
7. Выберите бакет для подключения и нажмите OK.
8. Задайте имя диска — например, MinIO Assets — и установите Auto Mount в значение At Login для постоянного доступа.
9. Нажмите Mount.

Бакет появится в боковой панели Finder под разделом Locations, рядом с сетевыми папками и AirDrop. Перетаскивайте файлы, открывайте их двойным щелчком — обо всём остальном позаботится Finder.

TLS и адресация в стиле path-style

Две особенности конфигурации чаще всего сбивают с толку при развёртывании MinIO:

Самоподписанные сертификаты. Если сервер MinIO использует сертификат, который macOS не распознаёт (частая ситуация в домашних лабораториях и внутренних развёртываниях), подключение завершается ошибкой согласования TLS. Самый чистый способ решения — добавить вашего внутреннего центра сертификации в Связку ключей macOS: откройте Keychain Access, выберите File → Import Items и импортируйте сертификат CA. Отметьте его как Always Trust. Также можно переключиться на HTTP для чисто локального трафика, указав http:// в поле конечной точки.

Адресация бакетов в стиле path-style. По умолчанию MinIO использует адресацию path-style (http://server:9000/bucket-name), а не virtual-hosted-style (http://bucket-name.server:9000). S3-совместимый провайдер NetDrive также по умолчанию использует path-style, так что оба варианта совпадают без дополнительной настройки. Если ваше развёртывание MinIO настроено на virtual-hosted-style, убедитесь, что у вас есть wildcard DNS-запись, соответствующая *.minio.example.com, и обновите конечную точку соответственно.

Большие файлы и многочастичная загрузка

Для бакетов с крупными объектами — снапшотами ВМ, дампами баз данных, несжатым видео — надёжность повышают две настройки:

Асинхронный режим загрузки. Щёлкните правой кнопкой мыши по диску MinIO в Drive Manager и выберите Properties → Upload Mode → Async. Ваше приложение немедленно получает подтверждение успешной записи, а NetDrive ставит фактическую загрузку в MinIO в фоновую очередь. Значок в строке меню показывает прогресс в реальном времени, и вы можете отменить отдельную передачу, не прерывая другие текущие загрузки.

Порог многочастичной загрузки. NetDrive использует многочастичную загрузку S3 для объектов размером более 5 ГБ — эта возможность появилась в версии 3.5.434. Снапшот базы данных на 20 ГБ загружается параллельными частями, а не единым последовательным потоком, что повышает устойчивость при работе через VPN или WAN-каналы, которыми обычно подключены удалённые серверы MinIO.

Итог

S3-совместимый API MinIO делает его готовой к использованию целью для любого инструмента, работающего с S3, — включая NetDrive. После подключения бакет ведёт себя как обычная папка: превью Finder работают, Spotlight индексирует имена файлов, и ни одному приложению не нужно знать, что хранилище находится на отдельном сервере.

Тот же путь через провайдер S3 подходит и для других S3-совместимых сервисов. См. Mount Wasabi on macOS о различиях в конечных точках и Mount Amazon S3 on macOS, если ваша команда использует MinIO вместе с размещённым предложением AWS.

— Steve, NetDrive