Ein schneller universeller Code-Sicherheitsscanner, geschrieben in Rust. Inklusive aller Werkzeuge: Unterstützt 14 Sprachen, TUI für Triage, Geheimnisse, Post-Quanten-Audits, diff-bewusste Scans und mehr 𓃥
<p align="center">
<a href="https://0.security">
<picture>
<source media="(prefers-color-scheme: dark)" srcset="www/public/foxguard-lockup-dark.png" />
<img src="https://assets.kitploit.com/production/public/readmes/13909/3f66c74029caa7a2efde8f7a9482abef5e1c55facd78b73398dc5278f0434a39/4950de8de858d12778f4b297af5760c2b1a48ed4fc04db20e24367b174a1c21b-display-v1.webp" width="460" alt="foxguard by 0security" />
</picture>
</a>
</p>
<h1 align="center">foxguard</h1>
<p align="center">
<strong>Schnelles lokales Sicherheitsscanning für Code, Secrets, Abhängigkeiten und Krypto-Risiken.</strong>
<br />
<sub>Integriert in <a href="https://github.com/0sec-labs/0sec">0sec</a>, den offenen Cybersecurity-Harness.</sub>
</p>
<p align="center">
<a href="https://github.com/0sec-labs/foxguard/actions/workflows/ci.yml"><img src="https://github.com/0sec-labs/foxguard/actions/workflows/ci.yml/badge.svg" alt="CI" /></a>
<a href="https://github.com/0sec-labs/foxguard"><img src="https://img.shields.io/badge/foxguard-clean-3fb950" alt="foxguard: clean" /></a>
<a href="https://crates.io/crates/foxguard"><img src="https://img.shields.io/crates/v/foxguard?color=d97706&label=crates.io" alt="crates.io" /></a>
<a href="https://www.npmjs.com/package/foxguard"><img src="https://img.shields.io/npm/v/foxguard?color=d97706&label=npm" alt="npm" /></a>
<a href="https://pypi.org/project/foxguard/"><img src="https://img.shields.io/pypi/v/foxguard?color=d97706&label=PyPI" alt="PyPI" /></a>
<a href="https://github.com/apps/foxguard-app/installations/new"><img src="https://img.shields.io/badge/GitHub_App-Install-2ea44f?logo=github" alt="Install GitHub App" /></a>
</p>
```sh
npx foxguard .
```
<p align="center">
<img src="https://assets.kitploit.com/production/public/readmes/13909/2ce579a58299a47cd3e965f13b97bf1c5dcaf020496d4a4eb2141d414ff7bd0c.gif" alt="foxguard scan demo" width="640" />
</p>
## Warum
- <img height="14" src="https://assets.kitploit.com/production/public/readmes/13909/2f74ecece5385bc98563839387fc2cc007c6ec3fe2818ba49df610dfcb0d6873/1b55ff58c9c0484fa5c54437e97d01092e3c2e94391642b49d9b8d714d76d891-display-v1.webp" alt=""> Über 200 integrierte Regeln für 12 Quellsprachen, plus Konfigurations- und Manifest-Prüfungen
- <img height="14" src="https://assets.kitploit.com/production/public/readmes/13909/3a4cd9b7803d825b45adaa38e01636f9a7d36d3b0803a6465fc08cc21c17614f/a1fc0ee6309d094c6019c10ecbc279df5071df641cd5e7f00d75c7bf83b89ceb-display-v1.webp" alt=""> Taint-Tracking für 14 Sprachen, mit dateiübergreifender Analyse für Python, JavaScript, Go, Java, Ruby, PHP, C# und Kotlin
- <img height="14" src="https://assets.kitploit.com/production/public/readmes/13909/d25483b85f41bce1890cee6119a3efae621f86cfb979425ff6af3f12065bd801/f5b34ed29e4a7fe413e269293e0518488d27decb4110c8ebc34b12d0bb0d2783-display-v1.webp" alt=""> Schnelle lokale und CI-Scans, mit Diff-Modus für „Was hat dieser Branch hinzugefügt?“
- <img height="14" src="https://assets.kitploit.com/production/public/readmes/13909/e6dfbb684eb09e9e54aa16991becf71604a394b8b2283abf831d2f5d69f445b9/c23135d81f4b5a044749a2b59c5c221cd03441e9bfc29f30a6f299f0711384d3-display-v1.webp" alt=""> Secrets-Scanning, OSV-gestütztes Dependency-Scanning und Post-Quanten-Krypto-Audit
- <img height="14" src="https://assets.kitploit.com/production/public/readmes/13909/7acd6ee45c06a20346672e4176a9e781d5c8a26f538e2b215b8742bf49daf75b/10d05ad06116cc455d9a363e5552332d006cb703f0b1bcc24bcc51f2310c046d-display-v1.webp" alt=""> Semgrep/OpenGrep-kompatible YAML-Bridge, die ~98 % der öffentlichen Registry lädt ([Abdeckungsbericht](https://github.com/0sec-labs/foxguard/blob/main/docs/parity/registry-coverage.md))
- <img height="14" src="https://assets.kitploit.com/production/public/readmes/13909/d83dd1d52375e4c855d852c7156a668807d90eeafb4867400d4c78bee7884044/8e75dffc14273864f84471e6a8e8af393ad64c64bffcc6f70df0e45c1e4dce54-display-v1.webp" alt=""> Terminal-, JSON-, SARIF-, CycloneDX 1.6 CBOM- und Semgrep-kompatible JSON-Ausgabe
## Installation
```sh
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
```
Standalone-Binary-Installer verifizieren GitHub-Release-Binaries gegen `checksums.txt`. Release-Binaries veröffentlichen außerdem GitHub-Artefakt-Attestierungen; verwenden Sie `gh attestation verify` für die manuelle Verifikation, oder siehe [Release-Provenienz](https://github.com/0sec-labs/foxguard/blob/main/docs/release-provenance.md).
PyPI-Wheels unterstützen Python 3.9+ auf Linux glibc 2.28+ (x86_64/ARM64), macOS
(Intel/Apple Silicon) und Windows x86_64. Verwenden Sie in einer bestehenden Python-virtuellen
Umgebung stattdessen `python -m pip install foxguard`. Diese installieren die native
CLI ohne Rust-Compiler oder einen Laufzeit-Binary-Download; es wird keine Python-API
bereitgestellt. Alpine/musl-Nutzer sollten die eigenständigen Linux-Release-Binaries verwenden.
**GitHub Action:**
```yaml
- uses: 0sec-labs/foxguard/[email protected]
with:
path: .
severity: medium
fail-on-findings: "true"
upload-sarif: "true"
```
**pre-commit:**
```yaml
repos:
- repo: https://github.com/0sec-labs/foxguard
rev: v0.14.2
hooks:
- id: foxguard
```
Integrationen: [GitHub App](https://github.com/apps/foxguard-app/installations/new), [VS Code](https://marketplace.visualstudio.com/items?itemName=peaktwilight.foxguard), [Claude Code-Plugin](https://github.com/0sec-labs/foxguard/blob/main/docs/claude-code-integration.md) und [MCP-Server](https://github.com/0sec-labs/foxguard/blob/main/docs/mcp-server.md).
### Betrieb der gehosteten GitHub App
`foxguard-github-app` schreibt durch Zeilenumbrüche getrennte JSON-Logs. Abgeschlossene und fehlgeschlagene Scans verwenden `event=foxguard.scan.completed` und `event=foxguard.scan.failed`, mit Feldern für Delivery, Installation, Repository, PR, Commit, Dauer und `usage_scope` zur Korrelation. Behalten Sie Identifikatoren als Log-Felder bei, nicht als Metrik-Labels.
Setzen Sie `FOXGUARD_INTERNAL_ACCOUNTS` auf eine kommagetrennte Liste Ihrer eigenen GitHub-Konten und -Organisationen. Die Übereinstimmung ist unabhängig von Groß- und Kleinschreibung. Andere Inhaber werden als `external` klassifiziert; eine nicht gesetzte Liste oder ein fehlender Inhaber ergibt `unknown`. Externe Aktivität ist kein Beweis für einen zahlenden Kunden, und Scans sind keine Personen.
Das Installationsregister wird beim Start und stündlich mit allen Seiten der GitHub-App-Installations-API abgeglichen. Fehlgeschlagene Aktualisierungen behalten den bestehenden Zustand bei; gleichzeitige Webhooks haben Vorrang. Spärliche Webhook-Metadaten bewahren bekannte Kontodetails und beobachtete Repository-Namen. Diese Namen sind kein vollständiges Inventar der zugänglichen Repositories einer Installation.
Persistieren Sie `FOXGUARD_INSTALLATIONS_PATH` und `FOXGUARD_PULL_REQUEST_JOBS_PATH` auf dauerhaftem Speicher. Überwachen Sie `foxguard.installations.reconcile_failed` zusammen mit Scan-Fehlern; `foxguard.installations.reconciled` meldet die Gesamtzahl sowie die Anzahl interner/externer/unbekannter Installationen nach einer erfolgreichen Aktualisierung. Dimensionieren Sie `FOXGUARD_PR_WORKERS` anhand des gemessenen Spitzen-Speicherverbrauchs des Scanners und des Speicherlimits des Containers: OOM-Kills von Kindprozessen können auftreten, ohne dass die gehostete Anwendung neu gestartet wird.
## Schnellstart
```sh
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
```
Verwende `foxguard --fix src/` oder `foxguard --fix src/app.py`, um unterstützte Taint-Korrekturen direkt anzuwenden. Ziele werden gegen das kanonische Scan-Verzeichnis oder die ausgewählte Datei geprüft; Funde außerhalb dieses Bereichs werden übersprungen. Python-Command-Injection-Korrekturen fügen bei Bedarf `import subprocess` hinzu und bewahren dabei Modul-Docstrings und zukünftige Imports. Überprüfe die generierten Änderungen, bevor du sie committest.
Fehler beim Dateilesen, bei Metadaten und bei der Verzeichnisdurchquerung im nativen Code-Scanner beenden den Prozess mit `2`, anstatt einen erfolgreichen Bericht zu erzeugen oder eine Baseline zu überschreiben. Beabsichtigte Ausschlüsse sowie nicht unterstützte, binäre oder übergroße Dateien bleiben Überspringungen; prüfe die Hinweise zu übersprungenen Dateien, wenn du die Scan-Abdeckung kontrollierst.
## Terminal-Überprüfung
Führe `foxguard tui .` aus und wähle **Scan**, **Diff**, **Secrets** oder **PQC** mit den Pfeiltasten oder Tab. Im Diff-Modus gib den Zielbranch ein, bevor du Enter drückst. Breite Terminals zeigen Funde neben ihren Details; kleinere Terminals verwenden eine Liste mit einer erweiterbaren Detailansicht. Quellkontext, Datenfluss und Korrekturen bleiben scrollbar, wann immer der Fund sie bereitstellt.
Der Header trennt Scan-Statistiken von Baseline-Kategorien. Ausgewählte Quellbereiche werden inline hervorgehoben, ohne zusätzliche Anmerkungszeilen. Öffnungssteuerelemente bleiben unterhalb des Live-Detailbereichs, während dessen Inhalt scrollt, und verkürzte Dateipfade behalten ihre Zeilen- und Spaltensuffixe. Suche und Dialoge besitzen ihre Tastenkürzel, solange sie aktiv sind.
Wenn der Quellkontext nicht geladen werden kann, bleibt das gespeicherte Fund-Snippet verfügbar. Secrets verwenden redigierte Snippets, anstatt rohen Quellcode in den Detailbereich zu laden.
Die Ladekarte zeigt unbestimmte Aktivität und die tatsächlich verstrichene Zeit an, nicht eine prozentuale Schätzung. Ctrl+C beendet den Vorgang während des Scannens.
| Taste | Aktion |
|-----|--------|
| `j` / `k`, Pfeiltasten, Home / End | Zwischen Funden wechseln |
| `v` | Detail erweitern oder zur Listen-/Split-Ansicht zurückkehren |
| PageUp / PageDown | Die Liste seitenweise durchblättern oder sichtbare Details scrollen |
| `/`, Enter | Eine Suche bearbeiten und anwenden |
| Ctrl+U | Die gerade bearbeitete Suche löschen |
| Esc | Ein Modal schließen, Suchbearbeitungen abbrechen, erweiterte Details verlassen oder angewendete Filter löschen |
| `0`–`4`, `c`, Shift+C | Mindestschweregrad, Konfidenzschwelle und Sortierreihenfolge |
| `f` | Alle → Unreviewed → Todo → Reviewed → Ignore durchlaufen |
| `i` | Triage-Aktionen in der Vorschau anzeigen und anwenden |
| Space, `a`, `x` | Einen Fund markieren, sichtbare Auswahlen umschalten und eine Batch-Aktion in der Vorschau anzeigen |
| Shift+F | Benannte Filter speichern, laden, ersetzen oder löschen; Review-Speicher wiederherstellen |
| `b` | Baseline-Kategorien durchlaufen, wenn ein Vergleich verfügbar ist |
| Tab, Enter / `o` | Finding/Source/Sink auswählen und im Editor öffnen |
| `w`, `[` / `]` | Hinweise anzeigen und durch ihren Verlauf scrollen; neueste Hinweise erscheinen zuerst |
| `e` | CBOM, JSON oder SARIF exportieren |
| `?`, `q` / Ctrl+C | Hilfe und Beenden; Ctrl+C funktioniert auch in jedem Modal |
Enter und `o` verwenden ein nicht leeres `$VISUAL`, dann `$EDITOR`. Ohne eine dieser Einstellungen sucht foxguard nach `nvim`, `vim`, `nano` oder `vi` im `PATH`, bevor ein verfügbarer Desktop-Öffner in Betracht gezogen wird. Headless-Terminals benötigen kein `xdg-open`.
Führe beispielsweise `VISUAL="nvim" foxguard tui .` aus oder setze
`EDITOR='code --wait'`. Eine fehlerhafte explizite Editor-Einstellung wird gemeldet, anstatt stillschweigend ersetzt zu werden; wenn kein Editor verfügbar ist, bleibt die TUI mit Einrichtungshinweisen geöffnet. Unterstützte Editoren springen zur ausgewählten Finding/Source/Sink-Zeile.
Review-Markierungen werden automatisch im benutzerspezifischen Speicher persistiert, begrenzt auf das kanonische Projektstammverzeichnis und den Scan-Modus (einschließlich des Ziels im Diff-Modus). Benannte Filter stellen Suche, Schweregrad, Konfidenz, Review-Status, Sortierung und Baseline-Kategorie wieder her, wenn sie mit Shift+F geladen werden. Sie ändern nicht die Repository-Scan-Konfiguration.
Die Liste zeigt sichtbare/gesamte Funde und den Review-Fortschritt; beim Ändern von Filtern oder Sortierung bleibt derselbe Fund ausgewählt, solange er sichtbar bleibt. Das Abbrechen von Suchbearbeitungen stellt die zuvor angewendete Abfrage wieder her.
Geprüfte Befunde überleben Filteränderungen. `x` öffnet Batch-Aktionen; Enter zeigt die
exakten Ziele, die Anzahl versteckter Auswahlen, das Ziel und den Wirkungsbereich. Nur `y`
wendet die Vorschau an; erneutes Enter bestätigt sie nicht, und Esc bricht ab, ohne
zu schreiben. Baseline-Aktionen fügen exakte Fingerabdrücke hinzu. Regel-/Datei- und projektweite
Konfigurationsaktionen können auch nicht ausgewählte Befunde betreffen, wie die Vorschau warnt.
Wenn ein Konfigurationsziel fehlschlägt, bleiben erfolgreiche Schreibvorgänge erhalten und die Ergebnisse werden
gemeldet; der Batch ist keine Transaktion.
Die Speicherung verwendet `$XDG_STATE_HOME/foxguard/tui` (oder
`~/.local/state/foxguard/tui`) unter Linux, Application Support unter macOS und
`%LOCALAPPDATA%` unter Windows. Atomare Schreibvorgänge und Revisionsprüfungen verhindern, dass ein Terminal
ein anderes stillschweigend überschreibt. Speicherfehler hinterlassen lokale Änderungen sichtbar
**UNSAVED**. In Shift+F versucht `w` das Speichern erneut, `r` lädt explizit von der Festplatte neu, und
Shift+R bestätigt ein Backup-und-Reset des aktuellen Projekts/Modus. Neu laden/zurücksetzen kann
ungespeicherte Änderungen verwerfen; das Zurücksetzen bewahrt die vorherigen Bytes auf der Festplatte, nicht ungespeicherte
Markierungen. Der Review-Speicher enthält Fingerabdrücke und Filtereinstellungen, nicht den Quellcode.
Exporte enthalten die Ergebnisse des aktuellen Scans, nicht nur die sichtbaren gefilterten Zeilen,
und werden in das aktuelle Arbeitsverzeichnis geschrieben. Vorhandene reguläre Dateien erfordern
eine explizite `y`-Bestätigung; Esc bricht ab. Schreibvorgänge sind atomar und Ziel-
Symlinks, einschließlich hängender Links, werden abgelehnt.
Verwenden Sie `foxguard tui --baseline .foxguard/baseline.json .`, um einen gespeicherten
Baseline-Vergleich zu überprüfen. Anders als die CLI-Unterdrückung behält die Terminal-Überprüfung aktuelle
Befunde bei und trennt **introduced**, **recurring** und **resolved** Einträge.
Resolved bedeutet, dass sie in der Ausgabe des aktuellen Scans fehlen, nicht verifizierte Behebung:
Vergleichen Sie äquivalenten Umfang, Regeln und Schwellenwerte. Die Baseline-Identität umfasst die
Datei und den Quellort, sodass das Verschieben eines Befunds als introduced plus
resolved erscheinen kann. Resolved-Zeilen sind schreibgeschützte historische Metadaten; nur die Suche gilt,
und `v` erweitert ihre scrollbaren Details. Wechseln Sie zurück zu einer Kategorie aktueller Befunde,
um den aktuellen Scan zu triagieren oder zu exportieren.
Git Diff bleibt ein separater Vergleich gegen einen Branch.
## Sprachabdeckung
| Sprache | Integrierte Regeln | Taint-Tracking | Framework-bewusste Regeln |
|----------|:-:|:-:|---|
| JavaScript / TypeScript | Ja | Ja | Express, Next.js |
| Python | Ja | Ja | Django, Flask, FastAPI |
| Go | Ja | Ja | Gin |
| Kotlin | Ja | Ja | Spring |
| Java | Ja | Ja | Spring |
| Ruby | Ja | Ja | Rails |
| PHP | Ja | Ja | Laravel |
| Rust | Ja | -- | -- |
| C# | Ja | Ja | .NET |
| Swift | Ja | Ja | iOS |
| Haskell | Ja | -- | Cardano seed rules |
Taint-Tracking deckt auch C, Bash und Solidity ab. Konfigurations-, Manifest- und externe Regel-Scans decken Dockerfile, Nginx, Apache, HAProxy, HCL/Terraform, YAML/JSON/XML/HTML, C über Semgrep YAML/Coccinelle und mehr ab.
## Sicherheitsmodi
```sh
foxguard sca .
foxguard pqc .
foxguard --rules ./semgrep-rules .
```
SCA unterstützt `Cargo.lock`, `package-lock.json`, `pnpm-lock.yaml`, `requirements.txt`, `poetry.lock` und `Pipfile.lock`. Das PQC-Audit ist eine zweiseitige Scorecard: Es kennzeichnet quantenanfällige Primitive (RSA, ECDSA/DSA, ECDH/DH) mit CNSA 2.0-Migrationsfristen und erkennt auch bereits verwendete Post-Quanten-Algorithmen (ML-KEM, ML-DSA, SLH-DSA, FN-DSA, HQC und Hybride wie X25519MLKEM768) als informatives, quantenresistentes Inventar – und meldet einen Migrationsbereitschaftsprozentsatz. Beide Seiten exportieren in ein CycloneDX 1.6 CBOM, in dem Post-Quanten-Algorithmen als quantenresistente Assets statt als Schwachstellen erscheinen.
## Konfiguration
foxguard entdeckt `.foxguard.yml` automatisch vom Scan-Pfad aufwärts.
```yaml
scan:
baseline: .foxguard/baseline.json
disable_rules: [py/no-eval]
secrets:
exclude_paths: [fixtures, testdata]
```
Unterdrücke einen akzeptierten Befund inline mit `// foxguard: ignore[rule-id]`.
## Dokumentation
Beginne mit dem [Dokumentationsindex](https://github.com/0sec-labs/foxguard/blob/main/docs/README.md). Wichtige Referenzen: [Architektur](https://github.com/0sec-labs/foxguard/blob/main/docs/architecture.md), [Semgrep/OpenGrep-Kompatibilität](https://github.com/0sec-labs/foxguard/blob/main/docs/compatibility.md) und das [Release-Runbook](https://github.com/0sec-labs/foxguard/blob/main/docs/releasing.md).
## Benchmarks
| Repo | LoC | foxguard | Semgrep | Beschleunigung |
|------|-----|----------|---------|---------|
| express | 15K JS | 0.28s | 6.09s | **22x** |
| flask | 14K Py | 0.33s | 6.51s | **20x** |
| gin | 18K Go | 0.50s | 4.95s | **10x** |
| sentry | 1.3M Py | 35s | 194s | **5x** |
Reproduzierbar mit `./benchmarks/run.sh`; die Ergebnisse variieren je nach Maschine. Siehe [`benchmarks/README.md`](https://github.com/0sec-labs/foxguard/blob/main/benchmarks/README.md).
## Mitwirken
Siehe [`CONTRIBUTING.md`](https://github.com/0sec-labs/foxguard/blob/main/CONTRIBUTING.md) für das Verfassen von Regeln, Tests und die Entwicklungsumgebung.
## Lizenz
MIT OR Apache-2.0 -- [0sec Labs](https://0.security)Entdecken Sie die meistgenutzten Tools unserer Community.
Noch keine Beliebtheitsdaten.