vikiboss/r2-web

어떤 프로젝트인가요?

핵심 기능

• 01중간 서버 없이 브라우저에서 R2 S3 API에 직접 연결
• 02일시 중지·재개와 진행률 표시를 지원하는 청크 단위 동시 업로드
• 03일괄 복사, 이동, 이름 변경 및 재귀 삭제
• 04해시, 날짜, 타임스탬프, UUID 자리표시자를 사용하는 파일명 템플릿
• 05로컬 WebAssembly 이미지 압축 및 선택적 Tinify 지원
• 06직접 URL, QR 코드, Markdown 또는 HTML 형식의 미리보기 및 공유 링크

활용 사례

• 데스크톱 클라이언트를 설치하지 않고 R2 버킷의 대량 파일 관리
• 자동 압축과 Markdown 링크를 지원하는 개인 이미지 호스팅으로 R2 활용
• 단일 R2 버킷용 비공개 자체 호스팅 파일 관리자 배포

빠른 시작

1. 1

   Cloudflare 대시보드에서 R2 버킷의 CORS 정책을 구성합니다

2. 2

   대상 버킷으로 범위가 제한된 R2 API Token을 만들고 r2.viki.moe에 인증 정보를 입력합니다

3. 3

   저장소를 클론합니다

   git clone https://github.com/vikiboss/r2-web.git
4. 4

   의존성을 설치하고 src 디렉터리를 로컬에서 제공합니다

   pnpm install && npx serve src

사용 전 알아둘 점

• !작동하려면 먼저 R2 버킷의 CORS를 구성하고 R2 API Token을 만들어야 합니다.
• !Tinify를 통한 이미지 압축 시 이미지가 타사 서비스로 전송됩니다.
• !단일 파일 크기는 최대 1 TiB로 제한되며 IE와 같은 구형 브라우저는 지원되지 않습니다.

토픽

자주 묻는 질문

r2-web은(는) 무엇인가요?

청크 업로드, 미리보기, 이미지 호스팅 기능을 제공하는 가벼운 순수 브라우저 기반 Cloudflare R2 버킷 파일 관리자입니다. R2 Web은 Cloudflare R2 객체 스토리지를 위한 웹 기반 파일 관리자입니다. 브라우저에서만 실행되며, 페이지가 R2 S3 API를 직접 호출하므로 파일과 인증 정보가 타사 백엔드를 거치지 않습니다. 인증 정보는 브라우저의 localStorage에 저장됩니다.

r2-web은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

r2-web은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

r2-web은(는) 아직 유지보수되고 있나요?

6개월 이내 업데이트. r2-web의 마지막 커밋은 2026년 9월 15일입니다.

r2-web은(는) 어디에 사용할 수 있나요?

데스크톱 클라이언트를 설치하지 않고 R2 버킷의 대량 파일 관리 자동 압축과 Markdown 링크를 지원하는 개인 이미지 호스팅으로 R2 활용 단일 R2 버킷용 비공개 자체 호스팅 파일 관리자 배포

r2-web는 어떻게 설치하나요?

Cloudflare 대시보드에서 R2 버킷의 CORS 정책을 구성합니다 대상 버킷으로 범위가 제한된 R2 API Token을 만들고 r2.viki.moe에 인증 정보를 입력합니다 저장소를 클론합니다: git clone https://github.com/vikiboss/r2-web.git 의존성을 설치하고 src 디렉터리를 로컬에서 제공합니다: pnpm install && npx serve src

r2-web은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/vikiboss/r2-web