S3V: AWS S3, R2, MinIO 버킷을 하나의 GUI로 통합 관리하는 오픈소스 도구

서론

새벽 2시, 프로덕션 장애 대응 중이다. 장애 복구를 위해 로그 파일을 다운로드해야 하는데, 해당 파일이 Cloudflare R2에 있다. 평소 주로 다루는 AWS S3가 아니라 R2라서 CLI 프로필 설정부터 다시 해야 한다. 명령어가 기억나지 않아 매뉴얼을 뒤지고, 30분 만에 파일을 다운로드한다.

이런 경험이 한두 번이 아니다. 서비스가 성장하면서 스토리지도 다양해진다. AWS S3, Cloudflare R2, MinIO, 심지어 NAS까지. 각각 콘솔도 다르고, CLI 명령어도 다르고, 접근 방식도 다르다. 이 다중 스토리지 관리의 피로감은 DevOps 엔지니어라면 누구나 겪는 문제다.

S3V는 바로 이 문제를 해결한다. 흩어진 S3 호환 버킷들을 하나의 GUI에서 통합 관리할 수 있게 해주는 오픈소스 도구다. 더 이상 터미널과 웹 콘솔을 오가며 반복적인 작업을 할 필요가 없다.

S3V의 등장 배경과 필요성

다중 스토리지 환경의 현실

현대의 인프라는 단일 클라우드 벤더에 종속되지 않는다. 비용 최적화, 데이터 주권, 레이턴시 요구사항 등 다양한 이유로 멀티 클라우드 전략을 채택한다. 그 결과 스토리지도 분산된다.

각 스토리지마다 웹 콘솔에 로그인하고, CLI 프로필을 설정하고, 권한을 관리해야 한다. 파일 하나 확인하는 데도 5분이 걸린다.

기존 도구의 한계

Cyberduck이나 Transmit 같은 GUI 클라이언트가 있지만, 이들은 범용 도구다. S3 API에 특화되어 있지 않고, 멀티 클라우드 워크플로우에 최적화되지 않았다. AWS CLI나 rclone 같은 CLI 도구는 강력하지만, 파일 탐색이나 대량 작업 시 직관성이 떨어진다.

S3V 아키텍처와 작동 원리

전체 아키텍처

S3V는 로컬 데스크톱 애플리케이션으로, S3 호환 API를 표준 인터페이스로 사용하여 다양한 백엔드 스토리지에 연결한다.

1
2
3
4
5
6
7
8
graph LR
    A[S3V GUI Client] --> B[Connection Profile 1]
    A --> C[Connection Profile 2]
    A --> D[Connection Profile 3]
    B --> E[AWS S3]
    C --> F[Cloudflare R2]
    D --> G[MinIO]
    A --> H[Local File System]

S3 호환 API의 힘

S3V가 다양한 스토리지를 하나의 인터페이스로 관리할 수 있는 이유는 S3 호환 API 때문이다. AWS S3의 API가 사실상 오브젝트 스토리지의 표준이 되면서, 대부분의 스토리지 서비스가 이 API를 지원한다.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
# S3V 연결 설정 예시 - config.yaml
connections:
  - name: "Production AWS S3"
    endpoint: "https://s3.ap-northeast-2.amazonaws.com"
    region: "ap-northeast-2"
    access_key: "${AWS_ACCESS_KEY_ID}"
    secret_key: "${AWS_SECRET_ACCESS_KEY}"
    
  - name: "CDN Assets - Cloudflare R2"
    endpoint: "https://<account_id>.r2.cloudflarestorage.com"
    region: "auto"
    access_key: "${R2_ACCESS_KEY_ID}"
    secret_key: "${R2_SECRET_ACCESS_KEY}"
    
  - name: "Dev Environment - MinIO"
    endpoint: "http://minio.internal.dev:9000"
    region: "us-east-1"
    access_key: "minioadmin"
    secret_key: "minioadmin"
    tls_skip_verify: true

실전 설정 가이드

Step 1: S3V 설치

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
# macOS
brew install s3v

# Linux (AppImage)
wget https://github.com/nicepkg/s3v/releases/latest/download/s3v-linux.AppImage
chmod +x s3v-linux.AppImage
./s3v-linux.AppImage

# Windows (Scoop)
scoop install s3v

Step 2: 연결 프로필 구성

각 스토리지 백엔드에 대한 연결 설정을 한다. 민감 정보는 환경변수로 관리한다.

1
2
3
4
5
# 환경변수 설정
export AWS_ACCESS_KEY_ID="AKIA..."
export AWS_SECRET_ACCESS_KEY="wJalrXU..."
export R2_ACCESS_KEY_ID="a1b2c3..."
export R2_SECRET_ACCESS_KEY="x7y8z9..."

Step 3: 기본 사용법

S3V를 실행하면 모든 연결된 스토리지가 좌측 패널에 나타난다. 버킷을 클릭하면 파일 브라우저가 열리고, 드래그 앤 드롭으로 파일을 업로드할 수 있다.

핵심 기능과 활용 시나리오

주요 기능 비교

| 기능 | AWS CLI | rclone | S3V | | :— | :— | :— | :— | | GUI 파일 탐색 | ❌ | ❌ | ✅ | | 멀티 스토리지 동시 관리 | ❌ | ✅ | ✅ | | 드래그 앤 드롭 업로드 | ❌ | ❌ | ✅ | | 파일 미리보기 | ❌ | ❌ | ✅ | | 버킷 간 파일 복사 | 복잡함 | CLI 명령 | 클릭 몇 번 | | 학습 곡선 | 높음 | 중간 | 낮음 |

시나리오 1: 로그 파일 긴급 다운로드

장애 대응 중 Cloudflare R2에 있는 로그 파일이 필요하다면:

1
2
3
4
5
6
7
8
# 기존 방식 (AWS CLI로는 접근 불가, 별도 도구 필요)
# 프로필 설정 -> 명령어 확인 -> 경로 확인 -> 다운로드

# S3V 방식
# 1. S3V 실행
# 2. R2 버킷 클릭
# 3. 파일 우클릭 -> 다운로드
# 완료. 30초면 충분하다.

시나리오 2: 스테이징 환경 파일 동기화

MinIO 개발 환경의 파일을 AWS S3 프로덕션으로 복사해야 할 때:

1
2
3
4
5
6
7
8
# 기존 rclone 방식
rclone copy minio:dev-bucket/assets s3:prod-bucket/assets --progress

# S3V 방식
# 1. 소스 버킷(MinIO)에서 파일 선택
# 2. 우클릭 -> "Copy to..."
# 3. 대상 버킷(AWS S3) 선택
# 4. 확인

시나리오 3: 대량 파일 삭제

오래된 로그 파일을 정리할 때:

1
2
3
4
5
# AWS CLI로 날짜별 삭제
aws s3 rm s3://logs-bucket/ --recursive --exclude "*" --include "2023-*.log"

# S3V
# 필터로 "2023-" 검색 -> 전체 선택 -> 삭제

프로덕션 환경에서의 고려사항

보안

S3V는 로컬 애플리케이션이므로, 인증 정보가 로컬에 저장된다. 다음 사항에 주의해야 한다.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
# 보안 강화를 위한 설정 예시
security:
  # 자격 증명을 OS 키체인에 저장
  credential_store: "keychain"  # macOS Keychain, Windows Credential Manager
  
  # 세션 타임아웃
  session_timeout: "30m"
  
  # 로깅 비활성화 (민감 정보 유출 방지)
  log_level: "error"

성능 최적화

대량의 파일을 다룰 때의 팁이다.

페이지네이션: 버킷 내 파일이 10,000개 이상일 경우 자동으로 페이지네이션 처리
병렬 업로드: 대용량 파일은 멀티파트 업로드로 자동 처리
캐싱: 메타데이터 캐싱으로 반복 탐색 속도 향상

1
2
3
4
5
6
# 성능 설정
performance:
  max_concurrent_uploads: 5
  multipart_threshold: "100MB"
  multipart_chunksize: "10MB"
  cache_ttl: "300s"

CI/CD 통합 참고

S3V는 GUI 도구이므로 CI/CD 파이프라인에는 직접 통합되지 않는다. 하지만 개발 단계에서 파일 구조를 파악하거나, 배포 전 정적 에셋을 수동으로 확인할 때 유용하다.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
# GitHub Actions에서는 여전히 AWS CLI 사용 필요
name: Deploy to S3
on: [push]
jobs:
  deploy:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v3
      - name: Upload to S3
        run: |
          aws s3 sync ./dist s3://my-bucket/ --delete
        env:
          AWS_ACCESS_KEY_ID: ${{ secrets.AWS_ACCESS_KEY_ID }}
          AWS_SECRET_ACCESS_KEY: ${{ secrets.AWS_SECRET_ACCESS_KEY }}

CI/CD 환경에서는 AWS CLI나 rclone을 사용하고, 개발/운영자의 일상적인 파일 관리 작업에는 S3V를 사용하는 식의 분업이 효과적이다.

트러블슈팅

연결 오류 해결

증상: MinIO 연결 시 TLS 인증서 오류

1
Error: self signed certificate in certificate chain

해결: 개발 환경의 자체 서명 인증서 사용 시 설정에서 TLS 검증 비활성화

1
2
3
4
connections:
  - name: "Dev MinIO"
    endpoint: "https://minio.dev.local:9000"
    tls_skip_verify: true  # 프로덕션에서는 절대 사용 금지

권한 오류 해결

증상: 버킷 목록은 보이나 파일 접근 시 403 Forbidden

원인: 해당 버킷에 대한 세부 권한이 없는 경우

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
// 필요한 최소 IAM 권한 (AWS S3)
{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "s3:ListBucket",
        "s3:GetObject",
        "s3:PutObject",
        "s3:DeleteObject"
      ],
      "Resource": [
        "arn:aws:s3:::my-bucket",
        "arn:aws:s3:::my-bucket/*"
      ]
    }
  ]
}

결론

핵심 요약

S3V는 다중 S3 호환 스토리지 환경에서 파일 관리 피로감을 줄여주는 실용적인 GUI 도구다. AWS S3, Cloudflare R2, MinIO 등 다양한 백엔드를 하나의 인터페이스로 통합하여, 반복적인 CLI 작업이나 콘솔 전환의 번거로움을 없앤다.

주요 이점:

단일 인터페이스: 모든 스토리지를 하나의 창에서 관리
직관적 조작: 드래그 앤 드롭, 우클릭 메뉴 등 GUI의 편의성
크로스 플랫폼: S3 API 호환만 되면 어떤 스토리지든 연결 가능
시간 절약: 파일 탐색, 업로드, 복사 작업의 소요 시간 대폭 감소

전문가 인사이트

S3V는 만능 도구가 아니다. CI/CD 파이프라인 자동화나 대규모 데이터 마이그레이션에는 여전히 CLI 도구가 적합하다. S3V의 가치는 운영자의 일상적인 파일 관리 작업에서 발휘된다.

장애 대응 중 급하게 로그를 확인해야 할 때, 새로운 팀원이 스토리지 구조를 파악해야 할 때, QA를 위해 특정 파일을 수동으로 업로드해야 할 때. 이런 순간에 CLI 명령어를 검색하거나 웹 콘솔에 로그인하는 대신, S3V를 열어 몇 번 클릭하면 된다.

도구의 목적은 생산성 향상이다. S3V는 멀티 클라우드 스토리지 관리의 맥락에서 그 목적을 정확히 달성한다.

참고 자료

출처: https://news.hada.io/topic?id=28514