MinIO와 자체 호스팅 S3용 파일 관리자: Nubbo에 연결하기

Nubbo는 MinIO, Ceph, SeaweedFS처럼 Signature V4로 서명하는 모든 S3 호환 스토리지에 연결해요. 직접 운영하는 서버든 다른 프로바이더든 상관없어요. 필요한 것은 엔드포인트 URL, 키, 리전뿐이에요. 이 가이드는 Nubbo 마법사를 단계별로 따라가며 두 가지 방법을 모두 다뤄요: 자동 연결 또는 버킷 하나로 제한된 키를 사용한 연결.

제공되는 기능

• 버킷을 드라이브처럼 탐색하세요: 폴더, 보기 방식, 검색, 휴지통, 라벨, 즐겨찾기.
• 브라우저와 서버 사이에서 파일을 직접 업로드하고 다운로드하세요. 파일은 Nubbo 서버를 거치지 않아요.
• 비밀번호, 만료일, 다운로드 횟수 제한을 걸어 파일과 폴더를 공유하고, 버킷으로 파일을 받고, 갤러리를 만들 수 있어요.
• 키는 AES-256-GCM으로 암호화되어 저장되며, 언제든지 버킷 연결을 해제할 수 있어요.

시작하기 전에

S3 호환 스토리지와 Nubbo 계정이 필요해요. 연결하는 버킷은 각각 요금제 한도에 포함돼요: 무료 요금제는 2개, Personal은 5개까지 연결할 수 있고 Pro는 제한이 없어요. 엔드포인트는 Nubbo 서버와 브라우저 모두 접근할 수 있는 공개 URL이어야 하며, 브라우저가 https://nubbo.app에서 HTTP 콘텐츠를 불러오지 않으므로 HTTPS가 필요해요. Nubbo는 사설 주소나 로컬 주소를 가리키는 엔드포인트를 거부해요. 서버에 리전이 없다면 us-east-1을 그대로 두세요.

연결 방법 선택하기

Nubbo 마법사에는 두 가지 방법이 있어요. 어느 쪽이든 결과는 같아요: 버킷이 연결되고 브라우저에서 업로드할 준비가 돼요.

자동 연결

1단계: 서버에서 키 만들기

1. 서버가 공개 HTTPS URL(예: https://s3.your-domain.com)에서 V4 서명을 사용하는 S3 API를 제공하는지 확인하세요.
2. 버킷을 만들고 CORS를 변경할 수 있는 키를 만드세요.
3. 엔드포인트 URL과 리전을 메모하세요. 서버에 리전이 없다면 us-east-1을 사용하세요.

2단계: Nubbo에서 버킷 연결하기

1. Nubbo에서 버킷을 열고 버킷 연결을 누르세요. 커스텀 S3 / 자체 호스팅을 선택하고 계속을 누르세요.

   

2. 자동을 선택하고 계속을 누르세요.

   

3. 키 단계에서 액세스 키, 시크릿 키, 엔드포인트 URL, 리전을 붙여넣으세요. 키 확인을 누르세요. Nubbo가 키가 작동하는지, 계정 전체에 액세스할 수 있는지 확인해요.

   

4. 버킷 중 하나를 고르고 이 버킷 사용을 누르거나, 새로 만들기를 선택해 이름을 입력하고(요청하면 리전도 선택하고) 만들고 준비하기를 누르세요. Nubbo가 앱에서의 업로드와 다운로드만 허용하는 CORS 규칙을 버킷에 추가하며, 기존 규칙은 그대로 유지해요.

   

5. 세 가지 확인 항목을 검토하고, 원하면 Nubbo에서 표시할 이름을 바꾼 뒤 완료를 누르세요. 버킷이 버킷 페이지에 표시되고 탐색기에서 열 수 있어요.

   

Nubbo가 사용 중인 키로 CORS 규칙을 추가할 수 없으면 마법사가 CORS 단계로 안내해요. 그다음 CORS 규칙 추가하기를 따라 하세요.

제한된 키로 연결하기

1단계: 서버에서 버킷과 키 준비하기

1. 서버에서 버킷을 만드세요(예: MinIO에서는 mc mb로 만들어요).
2. 그 버킷에 대한 읽기 및 쓰기 권한이 있는 키를 만드세요.
3. 엔드포인트 URL과 리전을 메모하세요.

2단계: Nubbo에서 버킷 연결하기

1. 버킷 페이지에서 버킷 연결을 누르고 커스텀 S3 / 자체 호스팅을 선택한 뒤 제한된 키 사용을 선택하세요.
2. 액세스 키, 시크릿 키, 엔드포인트, 리전을 붙여넣으세요. 키 확인을 누르세요.
3. 정확한 버킷 이름을 입력하고 액세스 확인을 누르세요.
4. 마법사가 추가해야 할 규칙과 함께 CORS 단계로 넘어가요.

CORS 규칙 추가하기

CORS 규칙은 브라우저가 https://nubbo.app에서 버킷으로 파일을 업로드하고 다운로드할 수 있게 해 줘요. 마법사의 CORS 단계에 표시되는 규칙과 같아요.

CORS 설정 방법은 소프트웨어에 따라 달라요:

• MinIO (community edition) 는 버킷별 CORS를 지원하지 않아요: 기본적으로 모든 오리진을 허용하는 전역 설정(MINIO_API_CORS_ALLOW_ORIGIN)을 사용해요. 이 설정을 바꾸지 않았다면 할 일이 없어요: 추가했어요, 확인을 누르면 확인을 통과해요. 바꿨다면 https://nubbo.app을 포함하세요.
• Ceph와 SeaweedFS는 S3 API로 버킷별 CORS를 지원해요. 평소 사용하는 도구(예: 엔드포인트를 지정한 aws s3api put-bucket-cors)로 이 규칙을 적용하거나, 자동 방식에서 Nubbo가 적용하게 하세요.

[
  {
    "AllowedHeaders": ["*"],
    "AllowedMethods": ["GET", "PUT", "POST", "DELETE", "HEAD"],
    "AllowedOrigins": ["https://nubbo.app"],
    "ExposeHeaders": ["ETag"],
    "MaxAgeSeconds": 3600
  }
]

규칙이 준비되면 Nubbo로 돌아가 추가했어요, 확인을 누르세요. Ceph와 SeaweedFS에서는 키에 CORS 변경 권한이 있다면 자동 설정 시도로 Nubbo가 대신 설정해 줘요.

문제가 생겼을 때

비용

자체 스토리지와 프로바이더를 비교하고 있다면 S3 vs R2 vs Spaces vs Wasabi vs Backblaze B2에서 요금과 제한을 비교해 보세요.