오픈소스 · Apache 2.0 · 실운영 환경 검증 완료

Tomcat 서비스를
안전하게 지키는 자동 백업

root 권한 없이, 외부 라이브러리 없이. 운영 중인 WAS를 10분 안에 자동 백업 체계로 전환합니다.

GitHub에서 시작하기 →설치 방법 보기
9개
소스 파일
10분
설치 시간
0개
외부 의존성
AES-256
암호화 강도
실운영 환경 검증 완료

v1.0 핵심 기능

실제 장애 경험에서 시작된, 실운영 환경에서 검증된 기능만 담았습니다

🔒검증됨

AES-256-CBC 암호화

DB 패스워드를 군사급 암호화로 보호합니다. 환경 변수 키 분리로 설정 파일이 노출되더라도 패스워드는 안전합니다.

검증됨

FULL + 증분 백업 자동 전환

요일 기반으로 자동 전환합니다. 주말엔 전체 백업, 평일엔 변경분만 백업하여 디스크 낭비 없이 데이터를 보호합니다.

📦검증됨

제로 의존성

Java 표준 API만 사용합니다. 외부 라이브러리 없이 클래스 파일 복사만으로 어느 Tomcat 환경에서나 즉시 동작합니다.

검증됨

cron 방식 스케줄링

backup.time=02:00 한 줄 설정으로 매일 정확한 시각에 실행됩니다. 재기동 시에도 다음 지정 시각까지 자동으로 대기합니다.

📋검증됨

백업 히스토리 로그

모든 백업 결과를 누적 기록합니다. 증분 기준 시각 자동 산출, 중복 실행 방지, 실패 시 이전 성공 시점부터 연속 백업을 보장합니다.

🛡검증됨

무결성 자동 검증

백업 완료 즉시 pg_restore -l, gunzip -t, tar -tzf로 파일 유효성을 확인합니다. 복구 시점이 아닌 백업 시점에 손상을 감지합니다.


저장소 구조

기능별 모듈로 확장되는 오픈소스 생태계

현재 버전
tcatvault/core
핵심 백업 엔진
공개
tcatvault/dashboard
웹 기반 현황 대시보드
v1.1 예정
tcatvault/cli
백업 복구 CLI 도구
v1.2 예정
tcatvault/enterprise
소산 저장 · 다중 서버 관리
v2.0 예정

로드맵

검증 완료된 기능부터 순서대로 추가합니다

v1.0
출시 완료
✓ 현재 버전 — 실운영 검증 완료
AES-256 암호화FULL+증분PostgreSQLcron 스케줄히스토리 로그무결성 검증ArchiveEngine
v1.1
다음 단계
백업 현황 대시보드 → tcatvault/dashboard
Slack · 이메일 실패 알림
MySQL · MariaDB 실환경 검증
v1.2
예정
S3 · NFS · SMB 소산 저장 → tcatvault/enterprise
백업 복구 CLI → tcatvault/cli
JUnit 전체 테스트 자동화
v2.0
로드맵
Enterprise 다중 서버 중앙 관리
Maven Central 배포
Spring Boot Starter 지원
기능 제안 · 버그 리포트 →GitHub Issues

4단계 설치

Maven도 Gradle도 필요 없습니다

01
클래스 파일 복사
WEB-INF/classes/ 에 .class 파일 9개 복사
02
config.properties 설정
DB 접속 정보, 백업 경로, 실행 시각 입력
03
패스워드 암호화
SecureTool로 DB 패스워드 ENC(...) 형식 변환
04
Tomcat 재기동
재기동 즉시 백업 엔진 자동 시작
지원 환경
RedHat 계열
RHELCentOSRocky LinuxAlmaLinuxFedora
Debian 계열
UbuntuDebian
기타
Windows (jar 엔진)Tomcat 8.5+Java 8+
config.properties
# 핵심 설정만 입력하면 됩니다
backup.time=02:00
backup.full.days=SAT,SUN
db.type=postgresql
db.password=ENC(...)
backup.target.dir=/backup
backup.archive.engine=auto
재기동 후 확인
grep TCATVAULT catalina.out
→ [TCATVAULT] 백업 엔진 시작 완료
→ [TCATVAULT] 다음 실행: 02:00
PostgreSQL 유닉스 소켓 연결
db.sock=/db_data/sock

🗄

지금 바로 시작하세요

서비스용 파일이 디렉터리에 존재하는 것을 인식하지 못한 상태에서 데이터를 날려버린 경험 — 그 경험이 TcatVault를 만들었습니다.

GitHub에서 다운로드hello@tcatvault.com