약 5분

MinIO에 파일을 업로드하고 링크를 공유하는 방법

MinIO를 쓰면 내 서버에서 S3 호환 스토리지를 운영할 수 있습니다. Aktar의 MinIO 프리셋은 대부분의 자체 호스팅 환경이 기대하는 경로 스타일 주소 지정(https://server/bucket/file)을 사용합니다.

준비물

  • Mac에서 접근할 수 있는 MinIO 서버(가능하면 HTTPS)
  • MinIO Client(mc) 또는 MinIO Console 접근 권한
  • Mac에 설치된 Aktar

단계별 안내

  1. 1

    버킷 만들기

    서버 별칭을 설정한 MinIO Client로:

    mc mb myminio/screenshots
  2. 2

    익명 다운로드 허용하기

    공유한 링크를 누구나 열 수 있도록 버킷에 공개 읽기 정책을 부여합니다.

    mc anonymous set download myminio/screenshots
  3. 3

    액세스 키 만들기

    MinIO Console에서 액세스 키(또는 버킷에 읽기·쓰기 권한이 있는 전용 사용자)를 만들고 Access Key와 Secret Key를 복사합니다.

  4. 4

    Aktar에 대상 추가하기

    설정 → 대상 → 대상 추가에서 MinIO를 고르고 아래 값을 입력합니다. MinIO는 경로 스타일 URL을 쓰므로 공개 기본 URL에 버킷 이름이 들어갑니다.

  5. 5

    테스트하고 저장하기

    연결 테스트를 클릭한 다음 저장을 클릭합니다.

Aktar 설정 값

설정 → 대상 → 대상 추가에서 다음 값을 입력하세요. 항목 이름은 앱과 같습니다.

항목예시 값
제공업체MinIO
엔드포인트https://minio.example.comMinIO API 주소(보통 9000번 포트).
리전us-east-1서버에 설정된 리전. 따로 설정한 적이 없다면 us-east-1.
액세스 키 IDaktar
비밀 액세스 키••••••••
버킷screenshots
공개 기본 URLhttps://minio.example.com/screenshots버킷 이름을 포함합니다.

팁

  • MinIO를 HTTPS 리버스 프록시 뒤에 두면 모든 브라우저와 채팅 앱에서 링크가 작동합니다.
  • 업로드는 Mac에서 서버에 닿기만 하면 되지만(VPN이나 LAN도 괜찮습니다), 공유한 링크는 여는 사람이 공개 URL에 접근할 수 있어야 합니다.

문제 해결

연결 테스트에서 리전이나 서명 오류가 나와요

리전을 MinIO 서버에 설정된 리전으로 맞추세요. 따로 설정한 적이 없다면 us-east-1을 쓰세요.

링크를 열면 403이 나와요

버킷에 익명 읽기 정책이 없거나, 공개 기본 URL에 버킷 이름이 빠져 있습니다. Access Denied 오류를 참고하세요.

아직 해결되지 않았나요?FAQ를 살펴보거나 GitHub에서 물어보세요.