Home - CyberMind-FR/secubox-deb GitHub Wiki

SecuBox-Deb

Appliance cybersécurité libre, basée Debian

CyberMind · Notre-Dame-du-Cruet, Savoie | FR | DE | 中文


SecuBox-Deb est une plateforme de sécurité réseau complète, installable en trois profils (lite, isp, full) selon la mémoire de la machine. La base est bookworm (12), et les images Trixie (13) sont désormais publiées pour la VM et le Raspberry Pi. Le projet vise la certification ANSSI CSPN à horizon 2027. Toute la stack est libre, auditable, et conçue pour fonctionner sur du matériel que vous possédez déjà — c'est le principe BYOH (Bring Your Own Hardware).

L'architecture repose sur six modules canoniques organisés en chemin hamiltonien : AUTH → WALL → BOOT → MIND → ROOT → MESH. Chaque module expose une API REST FastAPI, le tout orchestré par un profile-generator hiérarchique YAML. La cryptographie s'appuie sur le framework GK·HAM-HASH ZKP à trois niveaux.


🔴 Démarrage rapide — Alpha 8

Tester, installer ou booter la release v3.0.0-alpha.12 — en machine virtuelle ou sur matériel réel arm64. Toutes les commandes se lancent depuis un clone du dépôt (git clone puis cd secubox-deb).

🖥️ A. En VM — le plus rapide (une commande)

VirtualBox amd64, image téléchargée depuis les releases GitHub, VM créée automatiquement :

bash image/create-vbox-vm.sh --download
# ou une release précise :  bash image/create-vbox-vm.sh --download v3.0.0-alpha.12

La VM redirige les ports invité 22/80/443 vers l'hôte. Accès :

ssh -p 2222 root@localhost           # console
# portail :  https://localhost:9443/

→ Détails, options (--headless, RAM/CPU, ports) : Live-USB-VirtualBox

🧪 B. En VM ARM64 émulée (QEMU — dev arm64)

# récupérer/construire une image arm64, puis :
bash image/create-qemu-arm64-vm.sh output/secubox-*-mochabin-trixie.img --convert

Nécessite qemu-system-aarch64 + qemu-efi-aarch64 (apt install qemu-system-arm qemu-efi-aarch64 ovmf). → QEMU-ARM64

🔌 C. Sur matériel réel arm64 (MOCHAbin / ESPRESSObin)

# 1) Construire l'image (defaut : mochabin) :
sudo bash image/build-image.sh --board mochabin --out ./output
#    cibles : mochabin | espressobin-v7 | espressobin-ultra | vm-x64

# 2) Flasher sur SD/eMMC — VÉRIFIEZ le device (lsblk) avant dd :
sudo dd if=output/secubox-*-mochabin-trixie.img of=/dev/sdX bs=4M status=progress conv=fsync

Ou netboot U-Boot (images secubox-mochabin-trixie.img.gz) — voir ARM-Installation / ESPRESSObin.

Premier boot : firstboot.sh génère le secret JWT, importe la clé SSH depuis /boot/authorized_keys et applique le hostname depuis /boot/hostname.

📦 D. Par APT (sur une Debian 13 trixie arm64 existante)

curl -fsSL https://apt.secubox.in/install.sh | sudo bash
sudo apt update && sudo apt install secubox-hub   # + les modules voulus

✅ Vérifier que ça tourne

ssh root@<ip-secubox>
systemctl status 'secubox-*' --no-pager | head

Portail de services : https://<ip>/ (ou all.gk2.net sur le LAN). Comptes maîtres : gk2 (hôte) / admin (gestion). → Installation · Hardware-Matrix


Démarrer

La documentation technique couvre l'installation sur différentes cibles matérielles et virtuelles.

  • Trixie — Debian 13 : profils, zram, plafond mémoire, cycle de vie, moteur DPI
  • Architecture — Vue d'ensemble des six modules et de la stack technique
  • Hardware-Matrix — Matrice de compatibilité BYOH par carte et SoC
  • Installation — Guide d'installation complet (APT, Live USB, ARM)
  • Live-USB-VirtualBox — Test rapide en machine virtuelle
  • QEMU-ARM64 — Émulation ARM sur x86 pour développement
  • Modules — Documentation des 128 modules

Soutenir le projet

SecuBox-Deb est un projet libre sans campagne de financement participatif, sans deadline, sans tier de récompense. Le modèle repose sur trois piliers indépendants.


Statut

Élément Valeur
Release courante v3.0.0-alpha.12
Base Debian trixie (13)
Kernel 6.12
Paquets environ 190
Endpoints API 2000+
Profils d'image isp (passerelle) · full (suite complète)
Moteur DPI nDPI 6.x statique, construit en CI pour amd64 et arm64
Dernière mise à jour 2026-09-20
Dernier port livré Raspberry Pi 400 (trixie, kiosk)

Cibles matérielles principales

Carte SoC Profil Usage
MOCHAbin Armada 7040 Full Gateway entreprise
ESPRESSObin v7 Armada 3720 Lite Routeur PME/domicile
ESPRESSObin Ultra Armada 3720 Lite+ Routeur avec Wi-Fi
VM x86_64 — Full Test/développement
QEMU ARM64 Émulé Full Test ARM sur x86

Voir Hardware-Matrix pour la matrice complète avec statuts de support.


Modules par stack

Stack Fonction Modules principaux
🟠 AUTH Authentification, ZeroTrust, MFA auth, portal, users, nac
🟡 WALL Firewall, WAF, IDS/IPS, auth watch waf, authwatch, threats, ipblock
🔴 BOOT Déploiement, provisioning cloner, vault, vm
🟢 ROOT Système, CLI, hardening core, hub, system, console
🔵 MESH Réseau, WireGuard, QoS wireguard, haproxy, netmodes, turn

Liens



Licence

CMSD-1.0 (CyberMind Source-Disclosed License) — Code source lisible, droits réservés.

✅ Autorisé ❌ Interdit
Lire et étudier le code Utiliser en production
Compiler pour test/audit Redistribuer ou créer des dérivés
Publier résultats de recherche sécurité Intégrer dans d'autres produits
Citer en contexte académique/journalistique Proposer en SaaS

ANSSI CSPN Ready : Audits par laboratoires accrédités (CESTI, CC) autorisés sans autorisation préalable.

Voir LICENCE-CMSD-1.0.md (FR, référence) ou LICENSE-CMSD-1.0.en.md (EN).


© 2024-2026 CyberMind · Gérald Kerma · Notre-Dame-du-Cruet, Savoie Voir Acknowledgments pour les crédits contributeurs

⚠️ **GitHub.com Fallback** ⚠️