NetDrive 에서 MinIO 마운트 시 Connection Refused 오류 해결하기

NetDrive 를 자체 호스팅 MinIO 클러스터에 연결하고 Test 를 눌렀는데, 초록색 체크 표시 대신 “Connection refused” 가 뜹니다. 버킷은 마운트되지 않고, 오류 메시지만으로는 문제가 엔드포인트인지 자격 증명인지 그 사이의 네트워크 경로인지 알 수 없습니다. 거의 대부분 원인은 셋 중 하나입니다 — 잘못된 포트, 닫힌 방화벽, 또는 콘솔 URL 을 API URL 자리에 넣은 것.

자체 호스팅 S3 호환 스토리지를 드라이브로 마운트하세요

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

• MinIO 를 비롯한 모든 S3 호환 엔드포인트에 연결
• Test 버튼으로 마운트 전에 연결 상태를 확인
• Windows 와 macOS 에서 동일한 연결 항목으로 동작

WindowsmacOS

NetDrive 다운로드 →

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

”Connection Refused” 는 자격 증명 오류가 아니라 네트워크 오류입니다

“Connection refused” 는 NetDrive 가 Access Key 나 Secret Key 를 확인하기도 전에 발생합니다. 엔드포인트로의 TCP 연결 자체가 거부된 것입니다 — NetDrive 가 시도한 주소와 포트에서 아무것도 수신 대기하고 있지 않거나, 내 컴퓨터와 MinIO 서버 사이의 무언가가 연결을 적극적으로 막고 있는 상황입니다. NetDrive 가 MinIO 에 도달했지만 MinIO 가 거절한 “Access Denied” 와는 다른 실패 유형입니다. “Connection refused” 가 보인다면 네트워크 경로부터 고치세요. 그 층이 동작하기 전에는 자격 증명 문제가 드러날 수조차 없습니다.

점검 1: 콘솔 포트와 API 포트

MinIO 는 서로 다른 두 포트에서 두 가지 서비스를 따로 실행합니다. S3 API(기본 9000)와 웹 콘솔(기본 9001)입니다. NetDrive 에 필요한 것은 API 포트입니다 — Endpoint 항목에 콘솔 포트를 넣으면 연결이 바로 거부되거나 엉뚱한 서비스에 붙게 됩니다.

1. Open NetDrive → MinIO 드라이브의 톱니바퀴 아이콘을 눌러 설정을 엽니다.
2. Endpoint 항목이 :9001 이 아니라 http://192.168.1.50:9000 같은 형태인지 확인합니다.
3. MinIO 인스턴스가 API 에 어떤 포트를 쓰는지 확실치 않다면, 서버를 시작할 때 쓴 MINIO_API_PORT 환경 변수나 --address 플래그를 확인하세요. 콘솔은 보통 별도의 --console-address 플래그를 갖습니다.

점검 2: 방화벽과 Docker 포트 공개

포트가 맞는데도 여전히 “Connection refused” 라면, NetDrive 와 MinIO 호스트 사이의 무언가가 연결을 막고 있습니다.

• Docker 배포: 컨테이너가 실제로 포트를 공개하는지 확인하세요 — docker run -p 9000:9000 ... 또는 compose 파일의 동등한 설정. 포트를 공개하지 않은 MinIO 컨테이너는 docker ps 에서 정상으로 보여도 호스트 밖에서는 접근할 수 없습니다.
• 호스트 방화벽: Linux 에서는 ufw status 나 iptables -L 로 인바운드 9000 을 막는 규칙이 있는지 확인합니다. MinIO 를 Windows Server 에서 호스팅한다면 Windows Defender 방화벽의 인바운드 규칙을 확인하세요.
• 네트워크 분리: NetDrive 가 MinIO 호스트와 다른 VLAN 이나 서브넷에 있다면 둘 사이의 라우팅이 해당 포트를 허용하는지 확인합니다 — 서버가 워크스테이션과 다른 세그먼트에 있는 사무실에서 흔히 놓치는 부분입니다.

문제가 NetDrive 인지 네트워크인지 빠르게 가르는 방법: 같은 컴퓨터에서 브라우저를 열고 http://<endpoint>:9000/minio/health/live 로 접속해 보세요. 브라우저도 연결하지 못하면 문제는 전적으로 네트워크 경로에 있고 NetDrive 설정과는 무관합니다.

점검 3: 자체 서명 인증서를 쓰는 HTTPS 엔드포인트

MinIO 엔드포인트가 자체 서명 또는 내부 CA 인증서를 쓰는 리버스 프록시 뒤에서 https:// 로 동작한다면, 일부 TLS 핸드셰이크 실패는 인증서 경고가 아니라 일반적인 연결 실패로 나타납니다. NetDrive 가 실행되는 컴퓨터에서 인증서 체인이 유효한지 확인하세요 — 내부 CA 라면 그 컴퓨터의 신뢰 저장소에 CA 인증서가 설치되어 있어야 합니다. 진단 단계로, 내부 네트워크에서 잠시 http:// 로 테스트해 엔드포인트와 포트가 그 외에는 정상인지 확인한 뒤, 인증서가 신뢰되면 HTTPS 를 다시 켜세요.

연결 다시 테스트하기

포트·방화벽·인증서를 정리했다면:

1. Open NetDrive → Drive Manager 에서 MinIO 드라이브를 선택합니다.
2. Endpoint 를 다시 입력하고, Path style 이 켜져 있는지 확인한 뒤(자체 호스팅 MinIO 는 가상 호스트 방식보다 이 방식이 거의 항상 필요합니다) Test 를 누릅니다.
3. 초록색 체크가 뜨면 TCP 와 TLS 층은 동작하는 것입니다 — 그런데도 드라이브가 마운트되지 않는다면 남은 문제는 거의 항상 연결이 아니라 자격 증명이나 버킷 권한입니다.

정리

MinIO 드라이브의 “Connection refused” 는 거의 모든 경우 네트워크 층의 문제입니다. 잘못된 포트, 접근을 막는 방화벽이나 Docker 포트 공개 규칙, 또는 HTTPS 엔드포인트의 신뢰되지 않은 인증서죠. 대부분의 경우를 차지하는 포트와 방화벽부터 살펴본 뒤에 자격 증명을 의심하세요. 전체 설정 과정은 Windows 에서 NetDrive 로 MinIO 마운트하기 또는 macOS 에서 NetDrive 로 MinIO 마운트하기를 참고하고, 연결은 되는데 그 뒤에 접근이 거부된다면 NetDrive 의 S3 Access Denied 오류 해결하기에서 자격 증명과 정책 쪽을 다룹니다.

— Steve, NetDrive