أسكليبيوس

يقوم أسكليبيوس بالتحقق من سلامة النسخ الاحتياطية عن طريق استعادة الملفات واختبار قابليتها للاسترداد بشكل فعّال. بدلاً من الثقة في البيانات الوصفية، يحاول تحليل تنسيقات الملفات الحقيقية (المستندات، الصور، مقاطع الفيديو، الأرشيفات، رسائل البريد الإلكتروني) للتأكد من أن النسخ الاحتياطية يمكن قراءتها بالفعل وأنها آمنة للاستخدام.

التثبيت

git clone https://github.com/matank001/asclepius
cd asclepius
uv sync

التبعيات الإضافية

FFmpeg (للتحقق من الفيديو)

# 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

على عكس restic check الذي يتحقق من بنية المستودع وسلامة البيانات، يقوم أسكليبيوس بإجراء التحقق الوظيفي عن طريق استعادة اللقطات واختبار ما إذا كانت الملفات قابلة للقراءة والتحليل بالفعل.

فحص المستودع فقط

يقوم بتشغيل فحوصات البيانات الوصفية للتحقق من سلامة المستودع:

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

استعادة والتحقق من لقطة محددة

يقوم باستعادة لقطة واحدة والتحقق منها بواسطة المعرف:

# التحقق من جميع الملفات في لقطة محددة
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

المدققات

• المستندات (PDF، DOCX، PPTX، إلخ) - تحليل MarkItDown + تحليل الإنتروبيا
• الصور (JPEG، PNG، GIF، إلخ) - التحقق الهيكلي عبر PIL
• الفيديو (MP4، AVI، MKV، إلخ) - كشف التلف عبر FFprobe
• الأرشيفات (ZIP، TAR) - فحص السلامة + التحقق التكراري من المحتوى
• البريد الإلكتروني (EML) - التحقق من الصياغة + فحص الرؤوس
• البرامج الضارة (جميع التنسيقات) - مسح بقواعد YARA

الإعدادات

يتم تكوين المدققات في validators.yaml. يحدد كل مدقق أنواع MIME المدعومة، وامتدادات الملفات، وإعدادات التحقق.

إعداد قواعد YARA

يقوم مدقق YARA بمسح جميع الملفات بحثًا عن توقيعات البرامج الضارة. لتمكينه:

1. قم باستنساخ مستودع قواعد YARA أو أضف قواعدك الخاصة:

git clone [email protected]:embee-research/Yara-detection-rules.git

2. قم بتكوين المسار في validators.yaml:

settings:
  yara_rules_path: "Yara-detection-rules"

إذا لم يتم العثور على قواعد YARA أو فشلت في التجميع، سيتخطى المدقق الفحص مع تحذير واحد عند بدء التشغيل.

الترخيص

رخصة MIT - انظر LICENSE للتفاصيل.