macOS에 MinIO 마운트 — NetDrive로 셀프 호스팅 S3 스토리지 접근

3분 읽기 provider-guide minio macos
Steve
SteveSenior Engineer
NetDrive로 MinIO 버킷을 macOS 드라이브로 마운트하는 방법. macOS 14 Sonoma 이상, Apple Silicon 지원. 설정 후에는 CLI가 필요 없습니다.

여러분의 팀은 지난 분기에 베어메탈에 MinIO 클러스터를 구축했습니다. DevOps 엔지니어들은 mc CLI와 S3 SDK에 익숙하지만, 디자이너와 프로젝트 매니저들은 그렇지 않습니다—이들은 그저 IT에 티켓을 넣지 않고 assets 버킷에서 PSD 파일을 열고 싶을 뿐입니다. NetDrive는 MinIO 버킷을 macOS Finder에 직접 매핑해, 버킷이 USB 드라이브처럼 보이고 아무도 신경 쓸 필요가 없게 만들어줍니다.

NetDrive drive manager showing Google Drive, S3 and pCloud mounted as drive lettersMounted clouds appearing as native drives in Windows File Explorer

Finder에서 MinIO 버킷 탐색—CLI 불필요

NetDrive 는 Google Drive, OneDrive, S3, SFTP, WebDAV 등을 Windows 와 macOS 에서 일반 드라이브처럼 보이게 합니다 — 동기화도, 전체 다운로드도 없이.

  • 로컬 VM, 베어메탈, 클라우드 호스팅 등 모든 MinIO 인스턴스와 호환
  • NetDrive 3.14부터 Apple Silicon 네이티브 지원—Rosetta 오버헤드 없음
  • 비동기 업로드로 전송이 백그라운드에서 진행되는 동안 앱은 계속 반응성 유지
WindowsmacOS
macOS용 NetDrive 다운로드 →

무료 체험. 평생 라이선스와 구독 플랜 제공.

연결 전에 필요한 것

MinIO는 S3 호환 API를 제공하므로, NetDrive는 커스텀 엔드포인트를 사용하는 Amazon S3 공급자를 통해 이를 액세스합니다. NetDrive를 열기 전에 다음을 준비하세요.

  • 액세스 키와 시크릿 키 — MinIO 콘솔의 Identity → Service Accounts에서 확인하거나, MinIO 관리자로부터 전달받습니다.
  • 엔드포인트 URL — MinIO API 포트의 기본 URL입니다. 로컬 서버의 경우: http://192.168.1.50:9000. TLS가 적용된 배포라면: https://minio.example.com.
  • 버킷 이름 — MinIO 콘솔의 Buckets 탭에서 확인할 수 있습니다.
  • 리전 — MinIO 인스턴스에 커스텀 리전이 설정되어 있지 않다면 us-east-1을 사용하세요. MinIO는 이 값을 무시하지만 S3 클라이언트는 반드시 이를 전송해야 합니다.

NetDrive 3.18 이상은 macOS 14(Sonoma) 이상이 필요합니다. Apple Silicon Mac에서는 버전 3.14.309부터 별도의 호환 레이어 없이 NetDrive가 네이티브로 실행됩니다.

여러 S3 호환 공급자가 구성된 macOS의 NetDrive 드라이브 관리자

NetDrive를 MinIO에 연결하기

NetDrive 메뉴 바 아이콘(화면 상단의 클라우드 아이콘)을 클릭하고 Open Drive Manager를 선택합니다.

  1. **+**를 클릭해 새 드라이브를 추가합니다.
  2. 공급자 목록에서 Amazon S3를 선택합니다—MinIO는 동일한 API를 사용합니다.
  3. Endpoint 필드에 MinIO 서버의 기본 URL을 입력합니다: http://192.168.1.50:9000 또는 https://minio.example.com. 여기에 버킷 이름은 포함하지 마세요.
  4. MinIO의 액세스 키와 시크릿 키를 해당 필드에 붙여넣습니다.
  5. Region을 us-east-1로 설정합니다(MinIO에서 명시적으로 리전을 설정했다면 해당 값 사용).
  6. Connect를 클릭합니다. NetDrive가 MinIO 서버에 접속해 버킷 목록을 가져옵니다.
  7. 마운트할 버킷을 선택하고 OK를 클릭합니다.
  8. 드라이브 이름을 지정합니다—예를 들어 MinIO Assets—그리고 지속적인 접근을 위해 Auto Mount를 At Login으로 설정합니다.
  9. Mount를 클릭합니다.

버킷은 AirDrop이나 네트워크 공유와 나란히 Finder 사이드바의 Locations 아래에 나타납니다. 파일을 드래그해 넣고, 더블클릭으로 열면 나머지는 Finder가 알아서 처리합니다.

TLS와 경로 스타일 주소 지정

대부분의 MinIO 배포에서 발목을 잡는 설정은 두 가지입니다.

자체 서명 인증서. MinIO 서버가 macOS가 인식하지 못하는 인증서를 사용하는 경우(홈랩이나 내부 배포에서 흔함), 연결이 TLS 핸드셰이크 오류로 실패합니다. 가장 깔끔한 해결책은 내부 CA를 macOS 키체인에 추가하는 것입니다. 키체인 접근을 열고 File → Import Items를 선택해 CA 인증서를 가져옵니다. 이를 Always Trust로 표시하세요. 또는 순수 로컬 트래픽이라면 엔드포인트 필드에 http://를 입력해 HTTP로 전환할 수도 있습니다.

경로 스타일 버킷 주소 지정. MinIO는 기본적으로 가상 호스팅 스타일(http://bucket-name.server:9000)이 아닌 경로 스타일 주소 지정(http://server:9000/bucket-name)을 사용합니다. NetDrive의 S3 호환 공급자도 기본적으로 경로 스타일을 사용하므로 별도 설정 없이 서로 맞아떨어집니다. MinIO 배포가 가상 호스팅 스타일로 구성되어 있다면 *.minio.example.com에 매칭되는 DNS 와일드카드가 있는지 확인하고 엔드포인트를 그에 맞게 업데이트하세요.

macOS Finder에서 로컬 드라이브로 표시된 MinIO 버킷

대용량 파일과 멀티파트 업로드

VM 스냅샷, 데이터베이스 덤프, 비압축 영상처럼 대용량 객체를 담는 버킷의 경우, 두 가지 설정이 안정성을 높여줍니다.

비동기 업로드 모드. Drive Manager에서 MinIO 드라이브를 우클릭하고 Properties → Upload Mode → Async를 선택합니다. 애플리케이션은 즉시 쓰기 성공 응답을 받고, NetDrive는 실제 업로드를 MinIO로 백그라운드에서 큐에 넣어 처리합니다. 메뉴 바 아이콘에 실시간 진행 상황이 표시되며, 다른 진행 중인 업로드를 방해하지 않고 개별 전송을 취소할 수 있습니다.

멀티파트 임계값. NetDrive는 버전 3.5.434부터 도입된 기능으로, 5GB보다 큰 객체에 대해 S3 멀티파트 업로드를 사용합니다. 20GB짜리 데이터베이스 스냅샷은 단일 순차 스트림이 아니라 병렬 청크로 업로드되며, 이는 원격 MinIO 서버를 연결하는 일반적인 VPN이나 WAN 회선에서 더 안정적입니다.

마무리

MinIO의 S3 호환 API 덕분에 NetDrive를 포함한 모든 S3 지원 도구에 바로 연결할 수 있습니다. 일단 마운트되면 버킷은 일반 폴더처럼 동작합니다. Finder 미리보기가 작동하고, Spotlight가 파일 이름을 색인할 수 있으며, 어떤 애플리케이션도 스토리지가 별도 서버에 있다는 사실을 알 필요가 없습니다.

동일한 S3 공급자 경로는 다른 S3 호환 서비스에도 적용됩니다. 엔드포인트 차이점은 Mount Wasabi on macOS를 참고하고, 팀에서 MinIO와 AWS 호스팅 서비스를 함께 사용한다면 Mount Amazon S3 on macOS를 참고하세요.

— Steve, NetDrive

← 전체 글 포럼에서 이야기하기 →