Guida Introduttiva | ZeroBot Docs

Introduzione

ZeroBot è una soluzione anti-bot avanzata che protegge i siti web dal traffico automatizzato indesiderato, offrendo funzionalità di rilevamento e prevenzione in tempo reale, potenziate dal fingerprinting basato su intelligenza artificiale.

La sua integrazione flessibile lo rende ideale per siti web, piattaforme SaaS e sistemi di marketing che necessitano di una protezione affidabile e di analisi del traffico accurate.

Informazioni

Progettato per semplicità ed efficienza, ZeroBot utilizza il rilevamento comportamentale, il filtraggio ASN e il fingerprinting dei dispositivi per bloccare i bot, consentendo al contempo ai visitatori umani reali di accedere senza interruzioni.

Grazie alla sua configurazione semplice e al solido livello di sicurezza, ZeroBot ti aiuta a mantenere analisi del traffico valide, proteggere i tuoi budget pubblicitari e ottimizzare le prestazioni del sito.

Come funziona ZeroBot — un solo motore, ruoli diversi

ZeroBot è costruito attorno a un unico motore anti-bot.
Lo stesso motore di rilevamento alimenta quattro strumenti diversi, e ciascuno strumento lo applica in un ruolo diverso.
Prima di iniziare, è importante capire quali strumenti vengono eseguiti sul tuo hosting e quali sull'infrastruttura di ZeroBot.

Il piano Antibot non include l'hosting.
Il tuo abbonamento ti fornisce lo script ZeroBot, l'accesso all'API e la dashboard — sei tu a caricare lo script sul tuo hosting (cPanel, Plesk, VPS o qualsiasi hosting PHP).
ZeroBot non ospita il tuo sito web né conserva lo script al posto tuo.
Se preferisci che siamo noi a ospitare lo script per te, si tratta di un servizio separato — vedi Hosting privato qui sotto.

Strumento	Dove viene eseguito	Cosa fai tu
Lo ospiti tu — viene eseguito sul tuo hosting
`Antibot`	Il tuo hosting	Carichi `ZeroBot.php` nella root del tuo sito e vi associ una regola personalizzata.
`Link Shortener`	Il tuo hosting	Carichi il pacchetto dell'accorciatore sul tuo server, poi generi le chiavi dalla dashboard.
Lo ospita ZeroBot — viene eseguito sul nostro cloud
`Redirect Generator`	Il cloud di ZeroBot (Cloudflare)	Niente da caricare — generi il link protetto dalla dashboard e lo usi direttamente.
`Private Hosting`	Il cloud di ZeroBot	Niente da caricare sul tuo server — ospiti la tua landing page con noi, con la protezione già integrata.

Perché questa distinzione?
Il motore è lo stesso ovunque — la differenza sta in dove viene eseguita la protezione.
Antibot e l'Accorciatore di Link vengono eseguiti sul tuo hosting, dandoti il pieno controllo sui tuoi file e sulla tua infrastruttura.
Il Generatore di Reindirizzamento e l'Hosting Privato vengono eseguiti sul cloud di ZeroBot, per quando non vuoi gestire alcun server.
Scegli lo strumento in base a quanto vuoi ospitare da solo — il rilevamento dei bot è identico in ogni caso.

Guida all'Installazione

Installazione Rapida in 3 Minuti

1

Scarica il tuo file ZeroBot

Dalla tua dashboard, scarica ZeroBot.php sul tuo computer.

2

Apri il file

Fai clic destro sul file e apri con Notepad o VS Code.

3

Inserisci la tua chiave di licenza

Trova questa riga e sostituisci con la chiave dalla tua dashboard:

$license_key = "YOUR_LICENSE_KEY";

4

Salva il file

Premi Ctrl + S e chiudi l'editor.

5

Autorizza il tuo dominio

Prima di caricare, vai su Dashboard → I Miei Domini e aggiungi il dominio in cui distribuirai lo script:

example.com

Questo è obbligatorio — l'API rifiuterà le richieste da domini non autorizzati. Scopri di più →

6

Carica sul tuo sito web

Carica ZeroBot.php sul tuo hosting — può trovarsi nella root del tuo sito o in qualsiasi sottocartella tu voglia. Imposta semplicemente il Link Antibot della tua regola dove l'hai caricato:

cPanel: public_html Plesk: httpdocs …or any subfolder you choose

7

Apri il file nel browser

Visita il tuo file per verificare che sia attivo:

https://yourdomain.com/ZeroBot.php

8

Crea la tua prima regola

Apri Dashboard ZeroBot → Regole Personalizzate e imposta:

Link Antibot → ZeroBot.php
Link di Reindirizzamento → la tua pagina di destinazione

9

Attiva la protezione

Attiva le protezioni di cui hai bisogno:

VPN Block Datacenter Block Fingerprint

Sei protetto! Da questo momento, tutti i visitatori passano automaticamente attraverso ZeroBot.

Non dovrai più modificare il file. Tutte le modifiche vengono effettuate dalla dashboard.

Una volta caricato, tutte le impostazioni di protezione come blocco VPN, cloaking, paesi, dispositivi, captcha e reindirizzamenti vengono gestite da Dashboard ZeroBot → Regole Personalizzate.

Assicurati di non avere sia index.html che index.php nella stessa directory — il file HTML sovrascriverà lo script ZeroBot.

Prossimo Passo: Configura le Regole Personalizzate

Dopo aver caricato lo script ZeroBot, devi creare una Regola Personalizzata dalla dashboard per attivare la protezione. Le Regole Personalizzate definiscono come viene filtrato il traffico, cosa viene bloccato e dove vengono reindirizzati i visitatori.

Per il riferimento completo della configurazione, incluse tutte le impostazioni (blocco VPN, fingerprinting, cloaking, captcha, restrizioni per paese/dispositivo e altro), consulta la guida dedicata:

Visualizza la Guida alle Regole Personalizzate

Importante

Una volta completata l'installazione, assicurati che le tue Regole Personalizzate siano configurate correttamente nella dashboard ZeroBot. Tutte le impostazioni di protezione, inclusi captcha, blocco, cloaking e branding, vengono gestite direttamente dalla pagina delle Regole Personalizzate.

Grazie

Grazie per aver scelto ZeroBot — apprezziamo la tua fiducia e il tuo impegno per una gestione del traffico web sicura, intelligente e ottimizzata.

Hai bisogno di aiuto? Il nostro team di supporto è sempre pronto ad assisterti tramite Telegram o la chat della dashboard ZeroBot.

Documentazione ZeroBot