RustFS

🚀2.3x faster than MinIO for 4KB object payloads. RustFS is an open-source, S3-compatible high-performance object storage system supporting migration and coexistence with other S3-compatible platforms such as MinIO and Ceph.

Installing RustFS with Docker

• Installing RustFS with Docker | RustFS Documentation

RustFS는 고성능의 100% S3 호환 오픈 소스 분산 객체 스토리지 시스템입니다.

단일 노드 단일 디스크(SNSD) 배포 모드에서 백엔드는 추가적인 데이터 중복 없이 제로 이레이저 코딩을 사용하므로 로컬 테스트 및 소규모 시나리오에 적합합니다.

이 문서에서는 RustFS 공식 Linux 바이너리 패키지를 기반으로, 사용자 정의 Dockerfile을 통해 RustFS와 런타임 환경을 컨테이너로 패키징하고, 원클릭 서비스 시작을 위해 데이터 볼륨 및 환경 변수를 구성하는 방법을 설명합니다.

필수 조건

1. 호스트 요구 사항
   • Docker가 설치되어 있고(20.10 이상) 이미지를 다운로드하고 컨테이너를 정상적으로 실행할 수 있습니다.
   • /mnt/rustfs/data 객체 데이터를 마운트하기 위한 로컬 경로 (또는 사용자 지정 경로)
2. 네트워크 및 방화벽

• 호스트 포트 9000이 외부에서 접근 가능하도록 열려 있는지 확인하십시오 (또는 사용자 지정 포트와 일치하는지 확인하십시오).

1. 구성 파일 준비
   • 호스트에서 수신 포트, 관리자 계정, 데이터 경로 등을 정의하십시오 /etc/rustfs/config.toml
2. RustFS 컨테이너는 루트가 아닌 rustfs 사용자 ID (10001) 로 실행됩니다. Docker를 실행하여 호스트 디렉토리를 Docker 컨테이너에 마운트하는 경우 -v, 호스트 디렉토리의 소유자가 10001로 변경되었는지 확인하십시오. 그렇지 않으면 권한 거부 오류가 발생합니다.

전체 매개변수 구성 예시

docker run -d \
  --name rustfs_container \
  -p 9000:9000 \
  -p 9001:9001 \
  -v /mnt/rustfs/data:/data \
  -e RUSTFS_ACCESS_KEY=rustfsadmin \
  -e RUSTFS_SECRET_KEY=rustfsadmin \
  -e RUSTFS_CONSOLE_ENABLE=true \
  -e RUSTFS_SERVER_DOMAINS=example.com \
  rustfs/rustfs:latest \
  --address :9000 \
  --console-enable \
  --server-domains example.com \
  --access-key rustfsadmin \
  --secret-key rustfsadmin \
  /data

Caddy 사용시 /health 접근 금지

Caddyfile 을 다음과 같이 적용:

rustfs.you.domain.com {
    @health path /health
    respond @health 404
    reverse_proxy 127.0.0.1:9000
}

docker compose 에서 버킷 생성하는 방법

docker compose run --rm --entrypoint sh createbucket -c "
  aws --endpoint-url http://rustfs:9000 s3 mb s3://datasets;
  aws --endpoint-url http://rustfs:9000 s3 mb s3://registry"

Troubleshooting

RequestTimeTooSkewed

{"ok":false,"code":"INVALID_CREDENTIALS","message":"S3 list failed: 403 <?xml version=\"1.0\" encoding=\"UTF-8\"?><Error><Code>RequestTimeTooSkewed</Code><Message>request time is too far from server time</Message></Error>"}

자격 증명 문제가 아니라 시계 문제입니다.

<Code>RequestTimeTooSkewed</Code><Message>request time is too far from server time</Message>

SigV4는 서명에 들어간 X-Amz-Date와 서버 시각의 차이가 ±15분을 넘으면 요청을 403으로 거부합니다. 즉, 현재 시간을 모두 정상으로 만들면 된다.

List of Object Storage Softwares

• Cloud Service
  • Amazon Simple Storage Service (S3)
  • Cloudflare R2
• Self Hosted
  • minio
  • SeaweedFS
  • Ceph
  • Zenko
  • Riak S2
  • Triton Object Storage
  • LeoFS
  • HyperStore
  • RustFS
• Utilities
  • Mountpoint
  • Cyberduck

Favorite site

• Github - rustfs/rustfs
• RustFS | The High-Performance, Apache 2.0 Alternative to MinIO
• rustfs 101