KALI SETUP // weaponizza una Kali pulita

quick_start

root@kali: ~

cos'è

kali-setup automatizza la configurazione e la manutenzione di una Kali da pentest. Invece di configurare ogni macchina a mano, lo dichiari una volta (liste di tool + script): cloni, lanci un comando, e ottieni lo stesso identico ambiente - pulito, con tutti i tool aggiornati.

Invece di ricordarti a mano cosa hai installato, dove e con quale package manager, lo dichiari una volta in questo repo. Da lì, qualsiasi Kali diventa identica con un comando - e resta tale nel tempo.

cloni → setup.sh → attaccante pronto. Ogni settimana update-all e tutto è fresco. Aggiungi un tool una volta, compare su ogni Kali.

il problema

Una Kali usata sul campo degrada in fretta:

kali-decay.log

✗ PATH inquinato dai venv di pipx → comandi sbagliati, import rotti
✗ impacket installato 3 volte (apt + pip + pipx), script duplicati
✗ tool obsoleti da versioni vecchie (crackmapexec, wfuzz…)
✗ binari in /opt scaricati a mano mesi fa, mai aggiornati
✗ 3 Kali diverse (VM, laptop, VPS) configurate in modo diverso
✗ rifare tutto da zero a ogni reinstallazione

Questo repo risolve tutti questi punti in automatico e in modo versionato.

i 3 pilastri

🧹 setup.sh

bonifica + configura una Kali (PATH, duplicati, impacket, deps, tool). Una volta, su macchina nuova.

🔄 update-all

aggiorna tutto (sistema + tool + repo stesso) in un comando. Settimanale / pre-engagement.

📦 tools-sync

gestisce /opt/pentest-tools da manifesti dichiarativi. Dentro update-all, o a mano.

⚙ filosofia

dichiarativo · idempotente · single source of truth · multi-host · non distruttivo di default.

setup.sh --steps

AUDIT - stato iniziale: PATH, pipx, apt pentest tool

FIX PATH - rimuove i venv dal PATH · ~/.local/bin prima di /usr/bin

PURGE - crackmapexec · dirbuster · zenmap · wfuzz (apt obsoleti)

IMPACKET - pulisce gli script reali · reinstalla via pipx da fortra/impacket

LEGACY - rimuove il vecchio bloodhound pipx

DEPS - libyaml-dev (fix gem psych)

TOOLS - crea /opt/pentest-tools · installa i tool dai manifesti · scaffold liste locali

ARM - collega update-all a ~/.zshrc (source-based auto-sync)

update-all()

Un comando. Aggiorna tutto. Si auto-aggiorna anche da solo.

#	target	cosa
1	`kali-setup`	git pull del repo config stesso → auto-sync multi-host
2	`tools-sync`	/opt/pentest-tools dai manifesti (git + release, condivisi + locali)
3	`apt`	pacchetti sistema + full-upgrade · recupera i kept-back · pulisce vecchi kernel · avviso reboot
4	`pipx`	tool Python (impacket, netexec, bloodyad, dploot, git-dumper)
5	`gem`	tool Ruby (evil-winrm)
6	`npm`	tool Node.js globali (da npm.list locale)
7	`pip --user`	librerie Python (da pip.list locale)
8	`/opt`	cloni manuali in /opt/pentest-tools/ (non nei manifesti)

tool manager /opt/pentest-tools

Gestione dichiarativa dei tool esterni: dichiari cosa vuoi in un manifesto, tools-sync.sh lo ricostruisce identico su ogni Kali. Niente scansioni fragili, niente copie a mano.

manifesto	formato	aggiornamento
`tools/git.list`	name \| git_url	git clone → poi git pull
`tools/release.list`	name \| owner/repo \| glob	ultima release GitHub (solo se il tag cambia)

condiviso

tools/*.list nel repo → commit + push. Si propaga su tutte le Kali al prossimo update-all.

locale (solo qui)

~/.config/kali-setup/local.*.list. Resta su questa macchina, fuori dal git.

tools-sync.sh

bin/tools-sync.sh                 # sync completo (git + release)
bin/tools-sync.sh --import        # suggerisce tool trovati (non sposta nulla)
bin/tools-sync.sh --dedup         # copie sparse → keep/backup/trash/delete (chiede)
bin/tools-sync.sh --prune         # rimuove tool non dichiarati (opt-in, chiede conferma)

multi-host sync [strategy B]

   ┌─────────────┐      git push      ┌───────────────────┐
   │   KALI #1   │ ─────────────────▶ │     github.com    │
   │   (edit)    │                    │  SysK69/kali-setup │
   └─────────────┘                    └───────────────────┘
                                               │
                  update-all → git pull        │
         ┌──────────────┬─────────────────────┤
         ▼              ▼                       ▼
    ┌─────────┐    ┌─────────┐            ┌─────────┐
    │ KALI #2 │    │ KALI #3 │    ...     │ KALI #n │
    └─────────┘    └─────────┘            └─────────┘

Modifichi update-all.zsh su una macchina → push → ogni altra Kali la riceve al prossimo update-all. Zero copia manuale.

rules_of_engagement

apt

dipendenze sistema, tool senza alternativa pipx

pipx

tool Python CLI (impacket, netexec, bloodyad, dploot, git-dumper)

gem

tool Ruby (evil-winrm)

npm install -g

tool Node.js globali - --include=optional + --allow-scripts su npm ≥11

/opt/pentest-tools/

tool manuali / git / release, gestiti da tools-sync

canonical PATH

~/.local/bin → ~/.npm-global/bin → /usr/local/bin → /usr/bin
mai venvs/*/bin nel PATH