SELBST GEHOSTET

Folder Guard — Protected By ZeroBot

Ein selbst gehostetes Paket, das den Bot-Schutz von ZeroBot vor jeden beliebigen Ordner auf Ihrem eigenen Server stellt — ohne Proxy, ohne DNS-Änderungen.

Was ist Folder Guard?

Folder Guard ist ein kleines PHP-Paket, das Sie auf Ihren eigenen Server legen.
Sobald ein Ordner geschützt ist, wird jede Anfrage an ihn gegen Ihr ZeroBot-Konto geprüft, bevor die Seite lädt — so werden Bots gestoppt, während echte Besucher unbehelligt durchgelassen werden.

Es verbindet sich über Ihren Lizenzschlüssel mit Ihrem bestehenden ZeroBot-Konto, sodass Ihre Whitelist, Blacklist, Traffic-Protokolle und Einstellungen mit Ihrem Haupt-Dashboard synchron bleiben.
Nichts wird bei Dritten gespeichert.

SO FUNKTIONIERT ES

So funktioniert der Schutz

Wenn ein Besucher einen geschützten Ordner öffnet, läuft der Guard vor Ihrer Seite und fragt ZeroBot, ob die Anfrage von einem Bot oder einem Menschen stammt, und wendet dann Ihre gewählte Regel an:

Er wird bei jeder Anfrage innerhalb eines geschützten Ordners automatisch geladen (über .user.ini oder .htaccess).
Jede Anfrage wird live gegen Ihr ZeroBot-Konto entschieden — kein veraltetes Caching.
Er ist von Grund auf fail-open konzipiert: Sollte ZeroBot einmal nicht erreichbar sein, funktioniert Ihre Website weiterhin normal.
Jeder Besuch wird in Ihrem Konto protokolliert, sodass er sowohl im Paket als auch in Ihrem Haupt-Dashboard von ZeroBot erscheint.

Voraussetzungen

PHP 8.1 oder neuer.
Apache (mod_php) oder PHP-FPM / FastCGI / LiteSpeed — das Paket konfiguriert beides automatisch.
Ein aktiver ZeroBot-Lizenzschlüssel (in Ihrem Dashboard unter Profil zu finden).
Ein freier Domain-Slot in Ihrem Tarif.
Folder Guard autorisiert Ihre Domain automatisch, was einen der Domain-Slots Ihres Tarifs belegt.

Domain-Autorisierung

Wenn Sie sich anmelden, autorisiert Folder Guard Ihre Domain automatisch.
Es fügt die Domain zu Ihrem ZeroBot-Konto hinzu, damit der Schutz Ihrer Ordner erkannt wird und jeder Besuch in beiden Dashboards protokolliert wird.

Das Autorisieren einer Domain belegt einen der Domain-Slots Ihres Tarifs.
Wenn kein Slot frei ist, kann die Domain nicht autorisiert werden — und bis dahin kann Folder Guard Ihre Ordner nicht schützen und Besucher werden einfach durchgelassen.
Geben Sie einen Slot frei, indem Sie eine nicht genutzte Domain in Ihrem Dashboard entfernen, oder erweitern Sie Ihren Tarif, um weitere hinzuzufügen.

Folder Guard prüft das für Sie.
Wenn Ihre Domain nicht autorisiert ist, erscheint oben im Dashboard des Pakets ein deutlicher Hinweis mit einem Link zur Verwaltung Ihrer Domains.

INSTALLATION

Installation in 4 Schritten

Kein Code und keine Kommandozeile erforderlich — einfach hochladen und im Browser öffnen.

Paket herunterladen

Laden Sie das Protected By ZeroBot ZIP über den Link am Ende dieser Seite herunter.

Hochladen & entpacken

Entpacken Sie es und laden Sie den Ordner protected-by-zerobot an einer beliebigen Stelle innerhalb Ihrer Website hoch (zum Beispiel in Ihr public_html).

Die Setup-Seite öffnen

Rufen Sie den Ordner in Ihrem Browser auf (z.
B. https://yoursite.com/protected-by-zerobot/).
Der Setup-Bildschirm erscheint automatisch.

Ihre Lizenz verbinden

Fügen Sie Ihren ZeroBot-Lizenzschlüssel ein und klicken Sie auf Überprüfen & verbinden.
Ihre Domain wird automatisch registriert und Sie landen im Dashboard.

Das Setup fragt nur nach Ihrem Lizenzschlüssel — was mit Bots und Menschen geschehen soll, legen Sie anschließend in den Einstellungen fest.

Einen Ordner schützen

Öffnen Sie den Tab Geschützte Ordner, geben Sie den absoluten Pfad des Ordners ein, den Sie schützen möchten (das Feld ist mit Ihrem Web-Root vorausgefüllt), und klicken Sie auf Ordner schützen.
Der Guard wird auf Apache sofort und auf PHP-FPM innerhalb von etwa fünf Minuten aktiv.

Das Schützen eines Ordners beschädigt Ihre Website nie — falls etwas schiefgeht, lässt der Guard die Anfrage einfach durch.
Sie können den Schutz eines Ordners jederzeit über denselben Tab wieder aufheben.

REGELN

Schutzregeln

In den Einstellungen entscheiden Sie getrennt, was mit Bots und was mit echten Menschen geschieht:

Wenn ein Bot erkannt wird

Blockieren — eine schlichte "Zugriff verweigert"-Seite anzeigen.
Challenge — das ZeroBot-Slider-Captcha anzeigen; wer es löst, wird durchgelassen.
Weiterleiten — den Besucher an eine URL Ihrer Wahl senden.
Nur protokollieren — den Besuch aufzeichnen, aber nicht blockieren (ideal zum Testen).

Wenn ein echter Mensch besucht

Nichts tun — direkt durchlassen (Standard).
Challenge — auch Menschen das Captcha lösen lassen.
Blockieren — alle abweisen (nützlich, um einen Ordner vollständig zu schließen).
Weiterleiten — Menschen an eine andere URL senden.

Das ZeroBot-Captcha

Wenn die Challenge-Regel aktiv ist, sehen verdächtige Bots das echte ZeroBot-Slider-Captcha.
Sobald ein Besucher es löst, erhält er einen kurzlebigen Freipass und wird nicht erneut zur Challenge aufgefordert — genau dasselbe Captcha, das auf der gesamten ZeroBot-Plattform verwendet wird.

Geräte-Fingerprint (optional)

Sie können das Geräte-Fingerprint-Skript von ZeroBot in den Einstellungen aktivieren.
Es erfasst auf geschützten Seiten über 40 Browser-Signale (Canvas, WebGL, Audio, Zeitzone und mehr), um die Bot-Erkennung mit der Zeit zu verfeinern.

Whitelist & Blacklist

Erlauben oder blockieren Sie bestimmte IPs direkt aus dem Paket heraus.
Da es mit Ihrem ZeroBot-Konto synchronisiert ist, gilt jede Änderung überall dort, wo Ihr Konto schützt — und erscheint auch in Ihrem Haupt-Dashboard.

Mit einem Klick auf "Bekannte Crawler" können Sie die offiziellen IP-Bereiche von Google, Bing, Facebook und anderen legitimen Bots auf die Whitelist setzen, damit Sie nie versehentlich Suchmaschinen oder Link-Vorschauen blockieren.

Traffic & Protokolle

Der Tab Traffic zeigt für jede Anfrage live die Entscheidungen an, genau wie Ihr Haupt-Dashboard:

IP, Status (Bot oder Mensch), die besuchte Seite, Browser, Betriebssystem und Land.
Nach Seite filtern, durch die Historie blättern und das Protokoll bei Bedarf leeren.
Ein Aktivitätsprotokoll zeichnet jede von Ihnen vorgenommene Whitelist- und Blacklist-Änderung auf.

Schutz ein- & ausschalten

Ein einzelner Schalter in den Einstellungen pausiert oder reaktiviert den Schutz für alle Ordner auf einmal, ohne Ihre Konfiguration zu entfernen.
Im ausgeschalteten Zustand wird jeder Besucher einfach durchgelassen — praktisch für Wartungsarbeiten.

Fehlerbehebung

Wenn ein geschützter Ordner trotzdem Besucher durchlässt, prüfen Sie diese vier Punkte.
Sie decken die wenigen Konfigurationen ab, bei denen die Aktivierung einen kleinen Anstoß braucht.

Es schützt nur PHP-Anfragen

Folder Guard läuft über PHPs auto_prepend_file und wird daher nur bei Anfragen aktiv, die PHP verarbeitet.
Statische .html-Seiten, Bilder oder ein ohne PHP ausgelieferter Ordner sind nicht geschützt.
Richten Sie es auf den Ordner, der Ihre PHP-Anwendung ausführt, oder fügen Sie es am Einstiegspunkt dieser Anwendung hinzu.

Aktivierung unter cPanel / LiteSpeed

Unter LiteSpeed steht die Einstellung in der .user.ini und wird etwa 5 Minuten zwischengespeichert, also nicht sofort wirksam.
Ein Wechsel Ihrer PHP-Version unter PHP-Version auswählen erzwingt ein erneutes Einlesen.
Wenn es immer noch nicht aktiviert wird, beachtet Ihr Host möglicherweise weder .user.ini noch php_value in der .htaccess.
Aktivieren Sie die PHP-Erweiterung htscanner unter PHP-Version auswählen und Erweiterungen, damit es funktioniert.
Lassen Sie auch die curl-Erweiterung aktiviert, da Folder Guard sie nutzt, um die API zu erreichen.

Bots kommen durch, erscheinen aber in den Protokollen

Das bedeutet, dass die Bot-Aktion auf Protokollieren steht, was Bots aufzeichnet, ohne sie zu stoppen.
Öffnen Sie die Einstellungen und setzen Sie die Bot-Aktion auf Blockieren oder Challenge, um sie wirklich zu stoppen.

Im Dashboard verbunden, aber es wird nichts protokolliert

Der Schutz liest Ihre Lizenz aus einer Datei namens .env.php im Installationsordner, nicht aus .env.example, die nur ein Beispiel ist und niemals bearbeitet werden sollte.
Das Dashboard kann durch Ihre Browser-Sitzung verbunden wirken, selbst wenn diese Datei fehlt.
Wenn Sie den Installationsordner verschoben oder umbenannt haben, öffnen Sie einfach einmal die Einstellungen und Folder Guard speichert die Lizenz automatisch erneut.

Immer noch festgefahren?
Nennen Sie dem Support Ihren Servertyp und was Sie sehen, dann helfen wir.
Fast jeder Fall ist einer der vier Punkte oben.

Folder Guard herunterladen

Holen Sie sich das neueste Paket und schützen Sie Ihren ersten Ordner in wenigen Minuten.

Paket herunterladen

Vielen Dank

Brauchen Sie Hilfe?
Erreichen Sie uns über unseren Telegram-Kanal oder unter support@zerobot.info — wir helfen Ihnen gerne bei der Einrichtung.