macOS에서 Tencent Cloud COS 마운트하기 — NetDrive

3분 읽기 provider-guide tencent-cloud macos
Morgan
MorganStaff Engineer
NetDrive 3.18+로 Tencent Cloud Object Storage를 macOS 네이티브 드라이브로 마운트하는 단계별 가이드. Finder에서 바로 COS 버킷을 탐색하고 편집하세요.

Tencent Cloud Object Storage에 수 기가바이트의 자산이 쌓여 있고, 이를 Finder에서 바로 사용하고 싶다면 — 웹 콘솔이나 CLI 도구가 아니라 파일을 자유롭게 드래그해서 넣고 뺄 수 있는 실제 드라이브로 말이다. NetDrive는 버전 3.17.799부터 Tencent Cloud를 네이티브로 지원하며, macOS 14 Sonoma 이상과 결합하면 다른 볼륨과 똑같이 동작하는 COS 버킷을 얻을 수 있다.

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

Finder에서 바로 Tencent Cloud COS 마운트하기

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

  • 동기화 없이 COS 버킷을 로컬 드라이브처럼 탐색하고 편집
  • Google Drive, S3, Dropbox 등과 함께 사용 가능
  • 네이티브 Apple Silicon 지원, macOS 14 Sonoma 이상
WindowsmacOS
macOS용 NetDrive 다운로드 →

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

시작하기 전에 필요한 것

NetDrive를 열기 전에 Tencent Cloud 콘솔에서 다음 세 가지를 준비하자.

  • SecretId — API 액세스 키 식별자 (Tencent에서 access key ID에 해당)
  • SecretKey — 이에 대응하는 비밀 자격 증명
  • 버킷 이름과 리전 — 예를 들어 리전 ap-guangzhou의 project-assets-1234567890

Tencent Cloud CAM 콘솔에 로그인해 Access Management → API Keys에서 API 키 쌍을 찾거나 생성한다. 루트 계정 자격 증명을 사용하는 대신, COS 권한만 범위를 한정한 서브 계정을 만드는 것이 좋다 — 읽기 전용이라면 QcloudCOSReadOnlyAccess, 특정 버킷에 쓰기 권한이 필요하다면 커스텀 정책을 사용한다. NetDrive는 자격 증명을 macOS 키체인에 저장하지만, 나중에 키를 교체해야 할 경우를 대비해 API 키의 범위를 제한해두는 것은 여전히 가치가 있다.

여러 클라우드 제공업체를 각각의 드라이브로 마운트한 NetDrive 드라이브 관리자, Tencent Cloud COS 포함

macOS 버전 참고: Tencent Cloud 지원은 NetDrive 3.17.799에서 도입되었다. macOS 14 Sonoma 이상을 사용 중이라면 NetDrive 3.18 이상이 필요하다(Sonoma는 3.18부터 지원). macOS 13 Ventura 사용자는 NetDrive 3.17까지 사용할 수 있다.

드라이브로 Tencent Cloud 추가하기

  1. NetDrive를 열고 드라이브 관리자에서 +(드라이브 추가) 버튼을 클릭한다.
  2. 제공업체 목록에서 Tencent Cloud를 선택한다.
  3. 자격 증명 입력란에 SecretId와 SecretKey를 입력한다.
  4. 버킷의 홈 리전에 맞게 Region을 설정한다 — 예를 들어 화난 지역은 ap-guangzhou, 싱가포르는 ap-singapore, 북미는 na-ashburn. 이 값이 틀리면 빈 드라이브가 조용히 마운트되는 대신 연결 오류가 발생하므로, Tencent Cloud COS 콘솔에서 리전을 다시 한번 확인하자.
  5. 특정 버킷 이름을 입력하면 해당 버킷 하나만 드라이브 루트로 마운트할 수 있다. 비워두면 계정의 모든 버킷을 탐색할 수 있다.
  6. 드라이브 이름을 지정한다(이는 Finder의 /Volumes/ 아래에서 볼륨 이름이 된다).
  7. Connect를 클릭한다.

연결이 완료되면 버킷이 Finder와 사이드바에 마운트된 볼륨으로 나타난다. Preview로 이미지를, Numbers로 스프레드시트를, 아무 편집기로나 텍스트 파일을 — 파일을 직접 열고, 별도의 업로드 단계 없이 변경 사항을 COS에 그대로 저장할 수 있다. 파일은 필요할 때마다 가져오며, NetDrive는 버킷 전체를 Mac에 다운로드하지 않는다.

성능과 대용량 파일

NetDrive는 버킷 전체를 Mac에 다운로드하지 않는다 — 마운트된 볼륨으로서 콘텐츠를 탐색하며, 직접 열거나 다운로드한 파일만 전송된다. 업로드는 백그라운드에서 자동으로 실행되며, 업로드 매개변수를 관리하거나 대용량 파일을 수동으로 분할할 필요가 없다.

대용량 버킷의 디렉터리 목록은 처음 열 때 몇 초 걸릴 수 있다. 버킷 루트에 평면 구조로 수만 개의 객체가 있다면, COS 쪽에서 프리픽스(가상 폴더)로 구성하면 탐색 속도가 눈에 띄게 빨라진다 — NetDrive는 프리픽스를 폴더로 렌더링하며, 5만 개 파일이 평면적으로 나열된 것보다 훨씬 빠르게 표시한다.

연결 직후 403 Access Denied가 표시된다면 API 키에 필요한 COS 읽기 또는 쓰기 권한이 없을 가능성이 크다. 드라이브는 마운트되었지만 버킷에 콘텐츠가 있는데도 비어 보인다면, 리전 설정이 가장 흔한 원인이다 — COS 콘솔에 표시된 값과 정확히 일치하는지 확인하자.

macOS Finder에서 로컬 드라이브와 함께 네이티브 볼륨으로 접근 가능한 Tencent Cloud COS 버킷 콘텐츠

로그인 시 자동 마운트 설정하기

NetDrive에서 드라이브 설정을 열고 Mount Timing을 On Login으로 설정한다. 이후에는 macOS에 로그인할 때마다 COS 드라이브가 자동으로 Finder에 나타난다. 공유 Mac이나 파일 릴레이 역할을 하는 헤드리스 Mac mini처럼 사용자 로그인 전에 드라이브가 필요하다면 대신 On Boot으로 설정한다.

연결된 Tencent Cloud 드라이브의 마운트 상태를 보여주는 NetDrive

드라이브 관리자는 드라이브가 마운트되어 접근 가능할 때 녹색 표시를 보여준다. 연결이 끊긴 것으로 표시되면 마운트 아이콘을 클릭해 수동으로 재연결하거나, COS 엔드포인트에 대한 네트워크 접근을 확인해보자.

마무리

API 키 쌍만 준비되어 있다면 NetDrive로 macOS에 Tencent Cloud COS를 마운트하는 데는 약 2분이면 충분하다. 결과물은 COS 버킷을 백엔드로 하는 Finder 볼륨이며 — 별도의 동기화 클라이언트도, 수동 업로드 대기열도, 웹 콘솔로의 전환도 필요 없다.

Windows에서의 동일한 설정은 같은 NetDrive 릴리스에서 추가된 Windows에 Alibaba Cloud 마운트하기와 거의 동일한 단계를 따른다. Tencent COS와 함께 S3 호환 스토리지를 다룬다면, macOS에 Wasabi 마운트하기는 엔드포인트 설정만 다를 뿐 비슷한 흐름을 사용한다. CI 파이프라인에서 오브젝트 스토리지의 픽스처를 읽는 DevOps 팀이라면, S3 테스트 픽스처 사용 사례가 Tencent COS에도 그대로 적용되는 패턴을 다룬다.

— Morgan, NetDrive

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