matank001/asclepiusAsclepius는 파일을 복원하고 복구 가능성을 적극적으로 테스트하여 백업 무결성을 검증합니다. 메타데이터를 신뢰하는 대신 문서, 이미지, 아카이브, 구성 파일 등 실제 파일 형식을 구문 분석하여 백업을 실제로 읽을 수 있는지 확인합니다.
Asclepius는 파일을 복원하고 복구 가능성을 능동적으로 테스트하여 백업 무결성을 검증합니다. 메타데이터를 신뢰하는 대신 실제 파일 형식(문서, 이미지, 비디오, 아카이브, 이메일)의 파싱을 시도하여 백업을 실제로 읽을 수 있고 사용해도 안전한지 확인합니다.
git clone https://github.com/matank001/asclepius
cd asclepius
uv sync
# macOS
brew install ffmpeg
# Ubuntu/Debian
sudo apt install ffmpeg
# Arch Linux
sudo pacman -S ffmpeg
uv run asclepius -f /path/to/file.pdf
# 디렉터리의 모든 파일 검증
uv run asclepius -d /path/to/backups
# 디렉터리에서 N개 파일 무작위 샘플링
uv run asclepius -d /path/to/backups --rand-sample 100
restic check가 저장소 구조와 데이터 무결성을 검증하는 반면, Asclepius는 스냅샷을 복원하고 파일이 실제로 읽히고 파싱 가능한지 테스트하여 기능 검증을 수행합니다.
저장소 무결성을 확인하는 메타데이터 검사를 실행합니다:
uv run asclepius --restic-repo /path/to/repo --restic-passwd your-password
각 스냅샷을 임시 디렉터리에 복원하고 모든 파일을 검증합니다:
# 모든 스냅샷의 모든 파일 검증
uv run asclepius --restic-repo /path/to/repo --restic-passwd your-password --recover
# 각 스냅샷에서 무작위 100개 파일 검증 (대용량 백업에 더 빠름)
uv run asclepius --restic-repo /path/to/repo --restic-passwd your-password --recover --rand-sample 100
ID로 단일 스냅샷을 복원하고 검증합니다:
# 특정 스냅샷의 모든 파일 검증
uv run asclepius --restic-repo /path/to/repo --restic-passwd your-password --recover --snapshot ab4eb95a
# 특정 스냅샷에서 무작위 50개 파일 검증
uv run asclepius --restic-repo /path/to/repo --restic-passwd your-password --recover --snapshot ab4eb95a --rand-sample 50
검증기는 validators.yaml에 구성됩니다. 각 검증기는 지원되는 MIME 유형, 파일 확장자 및 검증 설정을 지정합니다.
YARA 검증기는 모든 파일에서 악성코드 시그니처를 스캔합니다. 활성화하려면:
git clone [email protected]:embee-research/Yara-detection-rules.git
validators.yaml에서 경로를 구성합니다:settings:
yara_rules_path: "Yara-detection-rules"
YARA 규칙을 찾지 못하거나 컴파일에 실패하면 검증기는 시작 시 경고 한 번만 출력하고 스캔을 건너뜁니다.
MIT 라이선스 - 자세한 내용은 LICENSE를 참조하세요.