S3 호환 채널 추가

S3 채널은 S3 API를 지원하는 오브젝트 스토리지를 ImgBed 저장 위치로 사용합니다.

Cloudflare R2, Backblaze B2, MinIO, AWS S3, 자체 S3 호환 서비스 등에 사용할 수 있습니다.

준비할 것

준비 항목	용도
S3 Endpoint	오브젝트 스토리지 API 주소
Bucket 이름	파일이 저장될 버킷
Region	스토리지 리전. Cloudflare R2는 보통 auto
Access Key ID	S3 접근 키
Secret Access Key	S3 비밀 키
CDN 도메인	선택 사항. 커스텀 접근 도메인

Cloudflare R2 S3 API 예시:

Endpoint: https://내AccountID.r2.cloudflarestorage.com
Bucket: R2버킷명
Region: auto

설정 위치

1. 시스템 설정을 엽니다.
2. 업로드 설정을 엽니다.
3. 채널 추가를 누릅니다.
4. S3를 선택합니다.

입력 항목

항목	설명
채널 이름	예: R2-S3, MinIO
Endpoint	https://를 포함한 S3 API 주소
커스텀 CDN 도메인	선택 사항. 설정하면 링크 생성 시 우선 사용
Bucket 이름	저장 대상 버킷
Region	R2는 auto, 그 외는 서비스 문서에 맞게 입력
Access Key ID	S3 접근 키
Secret Access Key	S3 비밀 키
Path-style access	MinIO 등 일부 호환 서비스에서 필요할 때만 켬
용량 제한	필요할 때만 켬

R2에서 S3 키 만들기

Cloudflare Dashboard에서 R2 Object Storage를 열고 API Token 관리로 들어갑니다.


대상 버킷에 접근할 수 있는 R2 API Token을 만듭니다.

생성된 Access Key ID와 Secret Access Key를 복사합니다.

ImgBed에 입력하기

1. Endpoint, Bucket, Region을 입력합니다.
2. Access Key ID와 Secret Access Key를 입력합니다.
3. CDN을 사용한다면 커스텀 CDN 도메인을 입력합니다.
4. Path-style access는 필요한 경우에만 켭니다.
5. 저장합니다.

확인 방법

확인 항목	정상 상태
채널 카드	저장 후 표시됨
테스트 업로드	대상 Bucket에 객체 생성
링크	ImgBed가 반환한 URL이 열림
용량 표시	용량 제한을 쓰는 경우 사용량 표시

S3 용량 통계는 저장소 API를 실시간으로 전부 스캔하는 방식이 아니라, ImgBed의 D1 파일 기록을 기준으로 다시 계산합니다.

자주 나는 오류

• Endpoint에 https://가 없음.
• Bucket 이름이나 Region이 틀림.
• Access Key에 쓰기 권한이 없음.
• 서비스가 Path-style access를 요구함.
• CDN 도메인이 Bucket과 제대로 연결되지 않음.