Skip to content
Projets

shuaiZend/PingWAF has 50 GitHub stars and 7 forks. GitHot measured 0 stars in 24 hours. Last checked 2026-11-15 20:47 UTC. Last push 2026-11-12.

Comment ces chiffres sont mesurés

Progression mesurée des étoiles

in 24h
0
in 7 days
Historique en cours
in 15 days
Historique en cours
in 1 month
Historique en cours

Variations nettes sur des périodes qui se chevauchent, pas des totaux quotidiens. Les mesures absentes restent vides. Les étoiles indiquent l’intérêt, pas la qualité.

À propos

Distributed, centrally-controlled Web Application Firewall built on pingap & Cloudflare Pingora. Semantic attack detection, Cloudflare-style rules, CC & Bot defense, automatic TLS, embedded i18n dashboard.

Auto-hébergement

README_fr.md

Original

🛡️ PingWAF

Un pare-feu d'applications web (WAF) distribué à contrôle centralisé, construit sur pingap et Pingora de Cloudflare.

Détection sémantique des attaques · Règles à la Cloudflare · Défense CC et bots · TLS automatique · Console intégrée multilingue

License Rust CI

English | 简体中文 | Español | Français


📖 Qu'est-ce que PingWAF ?

PingWAF est un WAF (pare-feu d'applications web) open source et performant qui apporte la sécurité de bord de niveau Cloudflare à votre propre infrastructure. Il est construit sur pingap — un reverse proxy de production propulsé par le framework réseau Pingora de Cloudflare — et y ajoute une couche de sécurité distribuée à contrôle centralisé.

Un unique plan de contrôle définit les sites, les règles et les politiques ; un ou plusieurs agents du plan de données les appliquent en périphérie. Les règles, les journaux et les métriques circulent entre les deux via des flux gRPC bidirectionnels persistants : un changement de politique effectué dans la console atteint tous les agents en quelques secondes, sans rechargement ni interruption de service.

  • 🎯 Détection sémantique — SQLi / XSS / RCE / path traversal / injection de commandes via libinjection, correspondance de signatures Aho-Corasick, scoring d'anomalies et règles d'expression à la Cloudflare.
  • 🕸️ Distribué par conception — exécutez tout dans un seul processus (all-in-one) ou passez le plan de données à l'échelle avec des agents indépendants (server + agent).
  • 🧭 Complet, mais désactivé par défaut — chaque protection est livrée désactivée et s'active par site : vous gardez le contrôle total de votre trafic.
  • ⚡ 100 % Rust — sûreté mémoire, E/S asynchrones et un binaire unique autocontenu avec la console embarquée.

PingWAF est un projet indépendant. Il n'est ni affilié à, ni approuvé par Cloudflare ou les mainteneurs de pingap.


✨ Fonctionnalités principales

  • Moteur WAF sémantique — pipeline en quatre phases (normalisation → signatures → expressions → scoring d'anomalies) avec les verdicts Pass, Monitor, Block et Challenge.
  • Protection CC / bouclier de 5 secondes — défis JavaScript, Proof-of-Work et interactifs, avec cookies d'autorisation signés en HMAC.
  • Protection anti-bots — liste blanche des bots vérifiés, passage des navigateurs connus et action configurable pour le reste.
  • Règles d'accès IP — block / allow / challenge / js_challenge, avec plages CIDR, import CSV et groupes IP globaux synchronisés par abonnement (p. ex. les plages Cloudflare).
  • Restriction géographique — autoriser ou bloquer par pays et par numéro de système autonome (ASN).
  • Limitation de débit multidimensionnelle — par IP, hôte, chemin, ASN, pays, ou selon un en-tête, un cookie ou un paramètre de requête.
  • Pools d'origine et routes — équilibrage de charge round-robin, moindres connexions, aléatoire ou par hachage cohérent, avec routage par préfixe, correspondance exacte ou regex.
  • Cache en périphérie — quotas disque par site, stale-while-revalidate et contrôle du TTL navigateur.
  • Réécriture requêtes/réponses et pages d'erreur personnalisées avec des modèles Tera.
  • TLS automatique — émission et renouvellement ACME / Let's Encrypt en périphérie (HTTP-01 et DNS-01 avec Aliyun, Cloudflare, Tencent Cloud DNSPod, Huawei Cloud ou manuel), avec état du certificat par site remonté au plan de contrôle. La vérification du certificat de l'origine HTTPS est un interrupteur explicite (Paramètres → Origine), avec une valeur par défaut globale et une dérogation par pool.
  • Observabilité — journaux complets dans Elasticsearch (optionnel), aperçus des en-têtes et du corps en PostgreSQL, et analytiques du trafic et des attaques.
  • Console intégrée multilingue (English / 简体中文 / 日本語), authentification JWT + bcrypt, isolation multi-locataires et versionnage de la configuration (lister, comparer table par table et revenir en arrière après confirmation).

🚀 Démarrage rapide

Option A — Docker Compose (recommandée)

git clone https://github.com/shuaiZend/PingWAF.git
cd PingWAF

# Démarre le plan de contrôle + le plan de données + PostgreSQL (image préconstruite depuis GHCR)
docker compose up -d

Ouvrez la console :

⚠️ Changez le mot de passe administrateur et PINGWAF_JWT_SECRET avant toute utilisation en production.

Option B — Compiler depuis les sources

Sur macOS (ou si vous préférez compiler), il faut Rust 1.96+, Node.js 26.12.1+, protoc et cmake :

git clone https://github.com/shuaiZend/PingWAF.git
cd PingWAF
cd web && npm ci && npm run build && cd ..
cargo build --release --bin pingwaf --features full
./target/release/pingwaf all-in-one \
  --db-url "postgres://pingwaf:pingwaf@localhost:5432/pingwaf"

Option C — Script d'installation (Linux)

Les binaires préconstruits pour Linux (amd64 / arm64) sont disponibles dans les Releases :

curl -fsSL https://raw.githubusercontent.com/shuaiZend/PingWAF/main/install.sh | sudo bash -s -- --mode all-in-one

Ports par défaut

Port Rôle
9080 API REST + console intégrée en HTTPS (santé : GET /healthz, aussi en HTTP)
9090 Plan de contrôle gRPC (les agents s'y connectent)
80 / 443 Trafic proxifié (liés à la création du premier site ; le 443 ne s'ouvre qu'après l'émission ou le téléversement d'un certificat — jusque-là seul le 80 sert du HTTP)

🧭 Documentation

Document Contenu
docs/quick-start.md De zéro à votre premier site protégé
docs/deployment.md Docker, binaire + systemd, topologies distribuées
docs/user-guide.md Guide de la console, sites, règles et politiques
docs/api.md Référence de l'API REST (https://<host>:9080/api/v1)
docs/README.md Index complet de la documentation
CONTRIBUTING.md Comment contribuer
SECURITY.md Politique de divulgation des vulnérabilités

📄 Licence

PingWAF est distribué sous Apache License 2.0. Il s'agit d'une œuvre dérivée de pingap / Pingora qui conserve leurs mentions de copyright d'origine ; il n'est ni affilié à, ni approuvé par Cloudflare ou le projet pingap.