본문 바로가기
내가만드는것_만든것/프로그램-공개

BackupGate: HTTP와 S3 API로 받는 백업 게이트웨이

by Joseph.Lee 2026. 5. 6.

서버 백업은 생각보다 신경 쓸 것이 많습니다.

  • 무한정 저장할 수 없기에 오래되면 지워야 하고 (rotation)
  • 랜섬웨어 등 공격에 대비하기 위해서는 upload-only 로 백업해서 백업 계정으로 백업본을 훼손시키지 못하게 해  합니다.

그래서 만든 것이 BackupGate입니다.

 

BackupGate는 대용량 백업 파일을 HTTP 또는 S3 호환 API로 받아, NAS 같은 원격 스토리지에 저장하는 백업 게이트웨이입니다. 현재 저장소 백엔드는 SFTP를 중심으로 동작하며, 업로드 경로인 key 단위로 인증, 버퍼링, 무결성 검증, rotation 정책을 분리해서 운영할 수 있습니다.

 

가장 기본적인 사용 방식은 간단합니다. 백업 에이전트나 스크립트에서 POST /{key}로 파일을 올리거나, S3 호환 클라이언트에서 PUT /{key} 형태로 업로드하면 됩니다. S3 multipart upload도 지원하며, 인증은 Basic Auth와 AWS Signature V4를 사용할 수 있습니다.

 

 

설정은 YAML 기반입니다. 예를 들어 database라는 key에 대해 FULLY_COMPLETE 버퍼 모드, 검증 활성화, 최근 7개 또는 168시간 기준 보관 정책을 적용할 수 있습니다. 인증 정보는 inline, file, htpasswd, external provider 방식으로 분리할 수 있어 단순한 개인 서버부터 별도 인증 시스템이 있는 환경까지 대응할 수 있습니다.

 

BackupGate는 “백업을 받는 작은 관문”에 가깝다고 생각합니다. 백업을 만드는 쪽은 기존 스크립트나 도구를 그대로 두고, 받는 쪽에서 인증·검증·저장·정리를 일관되게 처리하는 구조입니다. 덕분에 여러 서버에서 같은 방식으로 백업을 밀어 넣고, NAS나 원격 스토리지 쪽에는 정리된 형태로 보관할 수 있습니다.

 

Go 기반으로 작성되어 있으며, 현재 GitHub에 오픈소스로 공개되어 있습니다.

 

https://github.com/jc-lab/backupgate

 

GitHub - jc-lab/backupgate

Contribute to jc-lab/backupgate development by creating an account on GitHub.

github.com

 

Release 에서 다운받을 수 있고, docker 이미지 또한 배포되어 있으며, helm 설치도 가능합니다.

반응형

'내가만드는것_만든것 > 프로그램-공개' 카테고리의 다른 글

test-foundry: 드라이버/UEFI 테스트 자동화  (0) 2026.04.25
Online Utils  (0) 2025.10.22
Har to markdown  (0) 2025.09.22
G2B 입찰 공고 검색/알림 서비스  (0) 2025.01.28
ping-watcher  (0) 2024.09.15

댓글