메인 콘텐츠로 건너뛰기
Nami Cloud의 S3 호환 API는 AWS S3 또는 기타 클라우드 제공업체에서 코드 변경 없이 마이그레이션할 수 있도록 하여 Web2의 친숙함을 Web3 인프라에 가져옵니다.

​
S3 호환성이 중요한 이유

조직이 Web2에서 Web3로 이동하는 데 있어 가장 큰 장애물 중 하나는 호환성입니다. Nami Cloud는 완전한 S3 호환 API를 통해 이 장벽을 없애고, 전통적인 클라우드 제공업체와 사용하는 동일한 도구와 워크플로를 사용하여 분산 스토리지에 연결할 수 있게 합니다.

​
S3 호환성의 이점

  • 제로 학습 곡선: 친숙한 AWS SDK, CLI 명령 및 서드파티 도구 사용
  • 즉각적인 마이그레이션: 엔드포인트 구성 변경만으로 AWS S3에서 이동
  • 코드 재작성 없음: 기존 애플리케이션이 수정 없이 작동
  • 업계 표준: 가장 널리 채택된 객체 스토리지 API 활용

​
지원되는 S3 작업

Nami Storage는 기본적으로 모든 표준 S3 작업을 지원합니다:

​
버킷 작업

버킷 생성

PUT /{bucket}

버킷 삭제

DELETE /{bucket}

버킷 목록

GET /

버킷 위치

GET /{bucket}?location

​
객체 작업

객체 업로드

PUT /{bucket}/{key}

객체 가져오기

GET /{bucket}/{key}

객체 삭제

DELETE /{bucket}/{key}

객체 목록

GET /{bucket}

객체 헤드

HEAD /{bucket}/{key}

객체 복사

PUT /{bucket}/{key} 복사 헤더와 함께

​
마이그레이션 가이드

​
AWS S3에서

AWS S3에서 마이그레이션하는 것은 엔드포인트 구성 변경만으로 간단합니다: 
import { S3Client } from "@aws-sdk/client-s3";

const s3Client = new S3Client({
region: "us-east-1",
endpoint: "https://your-bucket.storage.nami.cloud",
credentials: {
accessKeyId: "your-access-key",
secretAccessKey: "your-secret-key"
},
forcePathStyle: false
});

​
마이그레이션 체크리스트

1

엔드포인트 업데이트

S3 엔드포인트를 https://{bucket}.storage.nami.cloud로 변경
2

자격 증명 업데이트

AWS 자격 증명을 Nami Cloud 액세스 키로 교체
3

작업 테스트

목록, 업로드 및 다운로드와 같은 기본 작업이 작동하는지 확인
4

프로덕션 업데이트

엔드포인트 변경 사항을 프로덕션 환경에 배포

​
AWS S3와의 주요 차이점

Nami Storage는 완전한 S3 호환성을 제공하지만, 분산 스토리지에 특정한 몇 가지 향상된 기능이 있습니다:

​
향상된 기능

기능AWS S3Nami Storage
탈중앙화아니오Walrus 네트워크에 데이터 분산
검열 저항아니오단일 제어 지점 없음
자동 암호화수동 설정기본 제공 AES-256 암호화
자동 갱신해당 없음자동화된 스토리지 에포크 관리
가속화CloudFront 필요기본 제공 Railgun 가속화 (베타)

​
성능 최적화

  • 100ms 미만의 대기 시간: Railgun 가속화 (베타)는 전통적인 CDN보다 더 빠른 접근 제공
  • 글로벌 엣지 네트워크: 전 세계 엣지 위치에서 자동으로 캐시됨
  • 스마트 라우팅: 최적화된 데이터 경로로 전송 시간 단축
  • 압축: 지원되는 파일 형식에 대한 자동 압축

​
인증 및 보안

​
접근 제어

Nami Storage는 표준 S3 인증 방법을 지원합니다:
  • 액세스 키 및 비밀 키: 표준 AWS 스타일 자격 증명
  • 서명 버전 4: 업계 표준 요청 서명
  • 버킷 정책: 세분화된 접근 제어 (곧 제공 예정)
  • ACL: 객체 수준 접근 제어 목록 (곧 제공 예정)

​
향상된 보안

표준 S3 보안을 넘어 Nami Storage는 다음을 제공합니다:
  • 종단 간 암호화: 기본적으로 AES-256 암호화
  • 탈중앙화 검증: 데이터 무결성에 대한 암호학적 증명
  • 공급업체 종속 없음: Nami가 오프라인이더라도 데이터에 접근 가능

​
일반적인 사용 사례

정적 웹사이트 호스팅

분산 신뢰성으로 웹사이트 호스팅

백업 및 아카이브

자동 갱신이 포함된 장기 저장

미디어 저장

이미지 및 비디오의 빠른 전달

데이터 레이크

Web3 보장이 포함된 분석 데이터

API 데이터 저장

글로벌 가용성을 갖춘 애플리케이션 데이터

콘텐츠 배포

Railgun (베타)을 통한 글로벌 콘텐츠 전달

​
모범 사례

​
명명 규칙

  • DNS 호환 버킷 이름 사용
  • SSL 호환성을 위해 버킷 이름에 마침표 피하기
  • 객체에 대한 S3 명명 지침 따르기

​
성능 최적화

  • 텍스트 기반 파일에 대한 압축 활성화
  • 대용량 파일 (>100MB)에 대해 멀티파트 업로드 사용
  • 자주 접근하는 콘텐츠에 대해 Railgun (베타) 캐싱 활용
  • 핫스팟팅을 피하기 위해 객체 키 구조화

​
비용 최적화

  • 가능한 경우 작은 파일 묶기 (자동 묶기 곧 제공 예정)
  • 데이터 아카이브를 위한 생애 주기 정책 사용
  • Nami Cloud 대시보드를 통해 사용량 모니터링

​
시작하기

마이그레이션할 준비가 되셨나요? 시작하는 방법은 다음과 같습니다:
  1. 계정 생성 - Nami Cloud에 가입
  2. 자격 증명 생성 - S3 호환 액세스 키 생성
  3. 마이그레이션 테스트 - 먼저 테스트 버킷으로 마이그레이션 시도
  4. 전체 마이그레이션 - 모든 애플리케이션을 Nami Storage를 사용하도록 업데이트

​
도움이 필요하신가요?

S3의 단순함으로 분산 스토리지의 힘을 경험하세요. 귀하의 데이터는 더 안전하고, 더 가용성이 높으며, 진정으로 귀하의 것입니다.