
foxguard v0.13.0
ماسح أمان شفرة عالمي سريع، مكتوب بلغة Rust. شامل: يدعم 14 لغة، واجهة طرفية للفرز، الأسرار، تدقيقات ما بعد الكم، مسح واعي بالفروقات والمزيد 𓃥
foxguard
فحص أمني محلي سريع للشيفرة والأسرار والاعتماديات ومخاطر التشفير.
مُدمج في 0sec، منصة الأمن السيبراني مفتوحة المصدر.
npx foxguard .
لماذا
أكثر من 200 قاعدة مدمجة عبر 12 لغة مصدرية، بالإضافة إلى فحوصات الإعدادات والملفات التعريفية
تتبع التلوث لـ 14 لغة، مع تحليل عبر الملفات لـ Python وJavaScript وGo وJava وRuby وPHP وC# وKotlin
فحوصات محلية وسريعة في CI، مع وضع الفروقات للإجابة على سؤال "ما الذي أضافه هذا الفرع؟"
فحص الأسرار، وفحص التبعيات المدعوم بـ OSV، وتدقيق التشفير ما بعد الكمي
جسر YAML متوافق مع Semgrep/OpenGrep يحمّل حوالي 98% من السجل العام (تقرير التغطية)
مخرجات Terminal وJSON وSARIF وCycloneDX 1.6 CBOM وJSON متوافق مع Semgrep
التثبيت
npx foxguard . # zero install
pipx install foxguard # prebuilt CLI from PyPI
curl -fsSL https://foxguard.dev/install.sh | sh # prebuilt binary (macOS/Linux)
cargo install foxguard # from source
تُحقّق برامج التثبيت الثنائية المستقلة من ثنائيات إصدار GitHub مقابل checksums.txt. كما تنشر ثنائيات الإصدار شهادات إثبات أصالة (attestations) من GitHub؛ استخدم gh attestation verify للتحقق اليدوي، أو راجع مصدر الإصدار.
تدعم حزم PyPI الإصدار 3.9+ من Python على Linux glibc 2.28+ (x86_64/ARM64)، وmacOS
(Intel/Apple Silicon)، وWindows x86_64. في بيئة Python افتراضية موجودة،
استخدم python -m pip install foxguard بدلاً من ذلك. تُثبّت هذه واجهة
سطر الأوامر الأصلية دون الحاجة إلى مُصرّف Rust أو تنزيل ثنائي وقت التشغيل؛ ولا تُوفَّر
واجهة برمجة تطبيقات Python. يجب على مستخدمي Alpine/musl استخدام ثنائيات إصدار Linux المستقلة.
إجراء GitHub:
- uses: 0sec-labs/foxguard/[email protected]
with:
path: .
severity: medium
fail-on-findings: "true"
upload-sarif: "true"
pre-commit:
repos:
- repo: https://github.com/0sec-labs/foxguard
rev: v0.14.2
hooks:
- id: foxguard
التكاملات: تطبيق GitHub، وVS Code، وإضافة Claude Code، وخادم MCP.
عمليات تطبيق GitHub المستضاف
يكتب foxguard-github-app سجلات JSON مفصولة بأسطر جديدة. تستخدم عمليات الفحص المكتملة والفاشلة event=foxguard.scan.completed وevent=foxguard.scan.failed، مع حقول التسليم، والتثبيت، والمستودع، وPR، والالتزام، والمدة، وusage_scope لأغراض الربط. احتفظ بالمعرّفات كحقول سجل، وليس كتسميات مقاييس.
اضبط FOXGUARD_INTERNAL_ACCOUNTS على قائمة مفصولة بفواصل تحتوي على حساباتك ومنظماتك على GitHub. المطابقة غير حساسة لحالة الأحرف. تُصنَّف المالكين الآخرين كـ external؛ وتؤدي القائمة غير المضبوطة أو المالك المفقود إلى unknown. النشاط الخارجي ليس دليلاً على عميل يدفع، وعمليات الفحص ليست أشخاصاً.
تتم مطابقة سجل التثبيت مقابل جميع صفحات واجهة برمجة تطبيقات تثبيت التطبيق من GitHub عند بدء التشغيل وكل ساعة. تحتفظ عمليات التحديث الفاشلة بالحالة الحالية؛ وللـ webhooks المتزامنة الأولوية. تحافظ بيانات webhook المتناثرة على تفاصيل الحساب المعروفة وأسماء المستودعات المرصودة. هذه الأسماء ليست جرداً كاملاً للمستودعات التي يمكن الوصول إليها في التثبيت.
احتفظ بـ FOXGUARD_INSTALLATIONS_PATH وFOXGUARD_PULL_REQUEST_JOBS_PATH على تخزين دائم. راقب foxguard.installations.reconcile_failed إلى جانب حالات فشل الفحص؛ ويُبلّغ foxguard.installations.reconciled عن الإجمالي وأعداد التثبيتات الداخلية/الخارجية/غير المعروفة بعد تحديث ناجح. اضبط حجم FOXGUARD_PR_WORKERS بناءً على ذروة استهلاك الذاكرة المقاسة للماسح وحد الذاكرة للحاوية: قد تحدث عمليات إيقاف العمليات الفرعية بسبب نفاد الذاكرة (OOM) دون إعادة تشغيل التطبيق المستضاف.
البدء السريع
foxguard . # scan everything
foxguard diff main . # only new findings vs main
foxguard tui . # interactive terminal review
foxguard secrets . # leaked credentials and keys
foxguard sca . # dependency vulnerabilities from OSV
foxguard pqc . # post-quantum crypto audit
foxguard --format sarif . > results.sarif
foxguard --format semgrep-json . # Semgrep CLI-compatible JSON