MinIO¶
직접 운영하는 MinIO 서버의 버킷을 Windows 드라이브로 마운트합니다.
시작하기 전에¶
다음을 미리 준비하세요:
- MinIO 서버 URL (포트 포함, 예:
https://minio.example.com:9000). - MinIO 사용자 또는 서비스 계정의 엑세스 키 ID와 비밀 엑세스 키.
키 발급 위치 — MinIO Console(웹 UI)에서: 로그인 후 Access
Keys에서 Create access key를 클릭하거나, 명령줄로
mc admin user svcacct add를 사용합니다. 서버 루트 자격증명도 되지만
일상 사용에는 권장하지 않습니다.
MinIO 도움말
연결¶
- 툴바에서 추가를 클릭합니다.
- Enterprise → MinIO를 선택합니다.
- 서버 URL, 엑세스 키 ID, 비밀 엑세스 키를 입력하고 버킷 입력란 옆 새로 고침 버튼을 클릭합니다.
- 버킷을 선택하고 연결을 클릭합니다.
버킷 직접 입력
키에 버킷 나열 권한이 없으면, 버킷 입력란 왼쪽 체크박스를 켜고 버킷 이름을 직접 입력합니다.
설정¶
| 설정 | 설명 | 기본값 |
|---|---|---|
| 엔드포인트 | 포트를 포함한 MinIO 서버 URL | — |
| 엑세스 키 ID / 비밀 엑세스 키 | MinIO 자격증명 | — |
| 버킷 | 마운트할 버킷 (목록 또는 직접 입력) | — |
| 읽기전용 | 드라이브 쓰기 차단 | 꺼짐 |
동작과 제한¶
- RaiDrive가 엔드포인트가 실제 MinIO인지 검증합니다(서버가
MinIO로 자신을 식별). 다른 서버는 "invalid endpoint"로 거부됩니다. - 연결은 path-style 주소를 사용하고 사설·자체 서명 TLS 인증서를 허용합니다 — LAN 구축에 적합합니다.
문제 해결¶
| 증상 | 원인 | 조치 |
|---|---|---|
| "invalid endpoint" | MinIO 서버가 아님 (예: 리버스 프록시가 Server 헤더 제거) | MinIO S3 포트를 직접 지정 |
| 연결 거부 | 포트 차단 또는 오류 | S3 API 포트(기본 9000) 접근 확인 |