Tool Python per analizzare le porte aperte di un server Minecraft. Identifica automaticamente i servizi attivi (Java Edition, Bedrock, RCON, Dynmap, BungeeCord e altri) e supporta il ping handshake nativo per ottenere versione e numero di giocatori online.
- Python 3.10 o superiore
- Nessuna dipendenza esterna — usa solo la libreria standard
git clone https://github.com/tuo-utente/minecraft-port-scanner.git
cd minecraft-port-scannerNessun pip install necessario.
python minecraft_port_scanner.py <host> [opzioni]Scansione base — controlla tutte le porte Minecraft note:
python minecraft_port_scanner.py play.mioserver.comScan profondo — include versione del server e giocatori online:
python minecraft_port_scanner.py play.mioserver.com --deepRange personalizzato — utile per porte non standard:
python minecraft_port_scanner.py 192.168.1.10 --range 25560 25600Porte specifiche:
python minecraft_port_scanner.py play.mioserver.com --ports 25565 25575 8123Timeout aumentato (server lenti o connessioni instabili):
python minecraft_port_scanner.py play.mioserver.com --timeout 5.0| Opzione | Breve | Tipo | Default | Descrizione |
|---|---|---|---|---|
--ports |
-p |
int... | tutte | Porte specifiche da scansionare |
--range |
-r |
int int | — | Range TCP da scansionare (es. 25560 25600) |
--timeout |
-t |
float | 2.0 |
Timeout per connessione, in secondi |
--threads |
-T |
int | 50 |
Numero di thread paralleli |
--deep |
-d |
flag | off | Ping handshake completo sulle porte Java aperte |
| Porta | Protocollo | Servizio |
|---|---|---|
| 25565 | TCP | Minecraft Java Edition (default) |
| 25566–25567 | TCP | Minecraft Java Edition (alternative) |
| 19132 | UDP | Minecraft Bedrock Edition (default) |
| 19133 | UDP | Minecraft Bedrock Edition (alternativa) |
| 25575 | TCP | RCON — remote console |
| 8123 | TCP | Dynmap — mappa web |
| 4242 | TCP | BlueMap — mappa web 3D |
| 25580–25582 | TCP | BungeeCord / Velocity — proxy |
| 9000 | TCP | CoreProtect / plugin web |
Le porte TCP vengono testate con una vera connessione socket. Le porte UDP Bedrock vengono testate inviando un pacchetto Unconnected Ping del protocollo RakNet e verificando la risposta.
Con il flag --deep, sulle porte TCP aperte viene eseguito un handshake completo secondo il protocollo di status di Minecraft 1.7+. L'output include:
- Versione del server (es.
Paper 1.21.1) - Giocatori online e massimo (es.
12/100)
La scansione avviene in parallelo tramite ThreadPoolExecutor. Il numero di thread è configurabile con --threads; il default di 50 è adatto alla maggior parte dei casi.
Il terminale mostra i risultati con colori ANSI:
- 🟢 Verde — porta aperta
- 🔴 Rosso — porta chiusa
- 🟡 Giallo — informazioni aggiuntive (versione, players)
════════════════════════════════════════════════════════════
⛏ Minecraft Port Scanner
Target: play.mioserver.com
Data: 2026-03-15 14:30:00
════════════════════════════════════════════════════════════
Scansione porte Minecraft note...
────────────────────────────────────────────────────────
PROT PORTA STATO SERVIZIO
────────────────────────────────────────────────────────
TCP 25565 APERTA ✓ Minecraft Java Edition v1.21.1 | 8/100 players
TCP 25566 chiusa ✗ Minecraft Java (alt)
UDP 19132 chiusa ✗ Minecraft Bedrock
TCP 25575 APERTA ✓ RCON (remote console)
TCP 8123 APERTA ✓ Dynmap web
════════════════════════════════════════════════════════════
RISULTATO: 3 porta/e aperta/e
→ 25565 Minecraft Java Edition
→ 25575 RCON (remote console)
→ 8123 Dynmap web
════════════════════════════════════════════════════════════
Questo tool è pensato per uso diagnostico e amministrativo sui server di cui si è proprietari o per cui si ha esplicita autorizzazione. Scansionare server di terze parti senza permesso può violare i termini di servizio del server e, in alcuni contesti, le leggi locali sulla sicurezza informatica. Usalo responsabilmente.
MIT — libero per uso personale e commerciale.