약 5분
MinIO에 파일을 업로드하고 링크를 공유하는 방법
MinIO를 쓰면 내 서버에서 S3 호환 스토리지를 운영할 수 있습니다. Aktar의 MinIO 프리셋은 대부분의 자체 호스팅 환경이 기대하는 경로 스타일 주소 지정(https://server/bucket/file)을 사용합니다.
준비물
- Mac에서 접근할 수 있는 MinIO 서버(가능하면 HTTPS)
- MinIO Client(mc) 또는 MinIO Console 접근 권한
- Mac에 설치된 Aktar
단계별 안내
- 1
버킷 만들기
서버 별칭을 설정한 MinIO Client로:
mc mb myminio/screenshots - 2
익명 다운로드 허용하기
공유한 링크를 누구나 열 수 있도록 버킷에 공개 읽기 정책을 부여합니다.
mc anonymous set download myminio/screenshots - 3
액세스 키 만들기
MinIO Console에서 액세스 키(또는 버킷에 읽기·쓰기 권한이 있는 전용 사용자)를 만들고 Access Key와 Secret Key를 복사합니다.
- 4
Aktar에 대상 추가하기
설정 → 대상 → 대상 추가에서 MinIO를 고르고 아래 값을 입력합니다. MinIO는 경로 스타일 URL을 쓰므로 공개 기본 URL에 버킷 이름이 들어갑니다.
- 5
테스트하고 저장하기
연결 테스트를 클릭한 다음 저장을 클릭합니다.
Aktar 설정 값
설정 → 대상 → 대상 추가에서 다음 값을 입력하세요. 항목 이름은 앱과 같습니다.
| 항목 | 예시 값 |
|---|---|
| 제공업체 | MinIO |
| 엔드포인트 | https://minio.example.comMinIO API 주소(보통 9000번 포트). |
| 리전 | us-east-1서버에 설정된 리전. 따로 설정한 적이 없다면 us-east-1. |
| 액세스 키 ID | aktar |
| 비밀 액세스 키 | •••••••• |
| 버킷 | screenshots |
| 공개 기본 URL | https://minio.example.com/screenshots버킷 이름을 포함합니다. |
팁
- MinIO를 HTTPS 리버스 프록시 뒤에 두면 모든 브라우저와 채팅 앱에서 링크가 작동합니다.
- 업로드는 Mac에서 서버에 닿기만 하면 되지만(VPN이나 LAN도 괜찮습니다), 공유한 링크는 여는 사람이 공개 URL에 접근할 수 있어야 합니다.
문제 해결
연결 테스트에서 리전이나 서명 오류가 나와요
리전을 MinIO 서버에 설정된 리전으로 맞추세요. 따로 설정한 적이 없다면 us-east-1을 쓰세요.
링크를 열면 403이 나와요
버킷에 익명 읽기 정책이 없거나, 공개 기본 URL에 버킷 이름이 빠져 있습니다. Access Denied 오류를 참고하세요.
아직 해결되지 않았나요?FAQ를 살펴보거나 GitHub에서 물어보세요.