Windows에서 MinIO 마운트하기 — NetDrive S3 호환 설정 가이드

팀의 빌드 아티팩트를 위해 MinIO 클러스터를 구축했다고 가정해 보세요 — 테스트 픽스처, Docker 레이어 캐시, 야간 익스포트가 담긴 2테라바이트 데이터가 직접 관리하는 하드웨어에 있습니다. 이제 모든 Windows 개발자가 익숙한 드라이브 문자를 열고 탐색기에서 바로 파일을 드래그하길 원하며, MinIO 자체 클라이언트를 설치하거나 모든 걸 스크립트로 감싸고 싶지 않습니다. NetDrive는 이를 깔끔하게 해결합니다. MinIO의 S3 호환 API에 연결해 버킷을 몇 초 만에 네이티브 드라이브로 표시합니다.

MinIO를 Windows 드라이브로 마운트

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

• S3 호환 연결 — 모든 MinIO 엔드포인트와 작동
• Windows 탐색기에서 버킷과 오브젝트를 바로 탐색
• 실시간 진행률을 보여주는 백그라운드 업로드

WindowsmacOS

NetDrive 다운로드 →

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

시작하기 전에 필요한 것

NetDrive를 열기 전에 다음을 준비하세요.

• MinIO 엔드포인트 URL — 로컬 또는 LAN 인스턴스라면 보통 http://your-server:9000 형태이고, 리버스 프록시 뒤의 서버라면 https://minio.yourdomain.com 형태입니다. MinIO의 기본 API 포트는 9000이며, 콘솔은 9001에서 실행되지만 NetDrive가 연결하는 대상은 이곳이 아닙니다.
• Access Key와 Secret Key — MinIO 콘솔의 Identity → Service Accounts에서 서비스 계정을 만들거나 mc admin user svcacct add로 생성하세요. 루트 자격 증명 대신 서비스 계정을 사용하고, 최소 권한 원칙에 따라 특정 버킷으로 범위를 제한하세요.
• 버킷 이름 — NetDrive는 버킷 단위로 연결합니다. 여러 버킷을 노출하려면 NetDrive에서 각각에 대해 별도의 드라이브를 추가해야 합니다.
• Windows 8, 8.1, 10, 11에 설치된 NetDrive. 여기에서 설치 파일을 다운로드하세요.

MinIO의 최신 릴리스는 기본적으로 path-style 주소 지정 방식을 사용하며, 이는 NetDrive가 S3 호환 제공자에 사용하는 방식이기도 합니다. 사용 중인 MinIO 버전이 RELEASE.2022-10-08 이전이라면, MinIO 설정에서 path-style 접근이 명시적으로 비활성화되어 있지 않은지 확인하세요(MINIO_API_REQUESTS_MAX 및 virtual-hosted 관련 설정).

Windows에서 NetDrive를 MinIO에 연결하기

NetDrive를 열고 Drive Manager의 + 버튼을 클릭해 새 드라이브를 추가하세요. 제공자 목록에서 Amazon S3를 선택합니다 — MinIO는 S3 API를 사용하므로, MinIO뿐 아니라 Wasabi 등 다른 자체 호스팅 솔루션을 포함한 모든 S3 호환 스토리지에 올바른 항목입니다.

연결 필드를 채워 넣으세요.

• Access Key ID: MinIO 액세스 키
• Secret Access Key: MinIO 시크릿 키
• Region: us-east-1을 입력하세요 — MinIO는 이 값을 무시하지만 필드는 비워둘 수 없습니다
• Endpoint: MinIO API URL, 예: http://192.168.1.50:9000 또는 https://minio.example.com
• Bucket: 마운트할 특정 버킷, 예: build-artifacts

Path style(NetDrive 버전에 따라 Force path style로 표시되기도 함)을 활성화하세요. bucket.minio.example.com 같은 virtual-hosted-style URL은 자체 호스팅 MinIO에서는 보통 존재하지 않는 DNS 항목이 필요합니다. 버킷이 minio.example.com/bucket처럼 경로 구성 요소로 나타나는 path style이 여기서 원하는 방식입니다.

Test를 클릭해 연결을 확인하세요. 녹색 체크 표시는 NetDrive가 MinIO에 도달해 인증할 수 있음을 의미합니다. 테스트가 실패한다면 가장 흔한 원인은 9000번 포트를 막는 방화벽, 자체 서명 인증서를 사용하는 HTTPS 엔드포인트, 또는 대상 버킷에 대한 s3:ListBucket 권한이 액세스 키에 없는 경우입니다.

드라이브 문자 지정 및 자동 마운트

연결 테스트를 통과했다면 Mount 섹션으로 스크롤하세요.

1. 드라이브 문자 — 사용하지 않는 문자를 선택하세요. 공용 워크스테이션이라면 M:(MinIO를 의미)처럼 팀 규칙을 정해두면 여러 기기에서 일관성을 유지할 수 있습니다.
2. 마운트 유형 — 완전한 읽기/쓰기 접근이 필요하면 네트워크 드라이브, 워크스테이션에서 수정되면 안 되는 참조용 데이터셋이 담긴 버킷이라면 읽기 전용 드라이브를 선택하세요.
3. 자동 마운트 옵션:
   • 로그인 시 — 사용자가 Windows에 로그인한 후 드라이브가 나타납니다. 개발자 워크스테이션에 적합합니다.
   • 부팅 시 — 로그인 전에 드라이브가 마운트됩니다. 시스템 계정으로 실행되며 시작 시 MinIO에서 읽어야 하는 예약 작업이나 서비스에 유용합니다.
   • 비활성화 — Drive Manager에서 수동으로 마운트합니다. 드물게 접근하는 버킷에 유용합니다.

Mount(재생) 버튼을 클릭하세요. 몇 초 안에 Windows 탐색기에 새 드라이브 문자가 나타납니다. 해당 드라이브로 이동하면 MinIO 버킷의 최상위 폴더와 오브젝트가 마치 로컬 파일처럼 보입니다.

Windows 탐색기에서 파일 다루기

드래그 앤 드롭 업로드는 기대한 그대로 작동합니다. NetDrive는 전송을 백그라운드에서 대기열에 넣고 시스템 트레이 아이콘을 통해 진행 상황을 표시합니다. 5GB보다 큰 오브젝트의 경우 NetDrive가 자동으로 S3 멀티파트 업로드로 전환하므로, 대용량 아티팩트 번들이나 데이터셋 파일에도 별도 설정이 필요 없습니다.

탐색 중에 다른 프로세스가 버킷에 기록한다면 — 예를 들어 CI 파이프라인이 새 테스트 픽스처를 푸시하는 경우 — 드라이브 목록이 즉시 갱신되지 않을 수 있습니다. 마운트된 드라이브를 탐색기에서 우클릭한 뒤 NetDrive 컨텍스트 메뉴에서 Force folder refresh를 선택하면 최신 디렉터리 목록을 가져옵니다.

스크립팅이나 CI 러너에서 접근하려면 nd3cmd CLI 도구(NetDrive 3.8.921부터 제공)를 사용해 명령줄에서 드라이브를 마운트·언마운트할 수 있습니다. GUI 대신 빌드 스크립트에서 연결을 자동화해야 할 때 유용합니다.

마무리

자격 증명만 있다면 Windows에서 MinIO를 NetDrive에 연결하는 데 3~5분이면 충분합니다. 동일한 S3 호환 연결 방식은 Wasabi, Backblaze B2 등 다른 자체 호스팅 또는 관리형 S3 호환 스토어에도 적용되므로, 이 설정 패턴은 여러 스토리지에 걸쳐 그대로 확장됩니다. macOS 버전은 NetDrive로 macOS에서 MinIO 마운트하기를 참고하세요. AWS S3 자체에 대해서는 NetDrive로 Windows에서 Amazon S3 마운트하기에서 리전 선택과 IAM 자격 증명 설정을 다룹니다.

— Steve, NetDrive