M0164 Dateiwächter für Gambio
Handbuch
1. Was der Dateiwächter leistet
Shops werden angegriffen. Nicht spektakulär, sondern still: Irgendwann liegt in einem Bilderordner eine kleine PHP-Datei, die dort nie jemand hingelegt hat, oder in einer Programmdatei steht eine zusätzliche Zeile. Von außen sieht der Shop weiter aus wie immer – und genau deshalb bleibt so etwas oft monatelang unbemerkt.
Das Modul nimmt einmalig den Zustand aller Shopdateien auf und vergleicht ihn danach regelmäßig mit dem, was tatsächlich auf dem Server liegt. Gemeldet wird alles, was dazwischen passiert ist:
- eine Datei, deren Inhalt sich geändert hat
- eine Datei, die neu hinzugekommen ist
- eine Datei, die verschwunden ist
- eine ausführbare Datei in einem Ablageordner – der klassische Einstieg einer Hintertür
- Dateiinhalte mit typischen Merkmalen von Schadcode
- Dateien, die plötzlich für jeden beschreibbar sind
1.1 Was das Modul nicht leistet
Der Dateiwächter ist kein Virenscanner und keine Firewall. Er verhindert keinen Einbruch, sondern bemerkt ihn – und zwar an den Spuren, die jeder Einbruch im Dateisystem hinterlässt. Er ersetzt damit weder regelmäßige Shopupdates noch sichere Passwörter noch ein Backup.
Er kann außerdem nur erkennen, was sich nach der Aufnahme des Grundzustands verändert hat. Nehmen Sie den Grundzustand auf einem bereits befallenen Shop auf, gilt der befallene Zustand als der richtige. Richten Sie das Modul deshalb am besten direkt nach der Shopinstallation oder nach einer gründlichen Prüfung ein.
2. Wo Sie das Modul finden
Das Modul ist an zwei Stellen in der Shopverwaltung zu Hause:
- Das Setup – also alle Einstellungen – erreichen Sie über das Menü „Xycons-Module“ ► „Kundenkonto / Setups“ und dort über den TAB „Dateiwächter“.
- Die Arbeitsoberfläche – Übersicht, Befunde, Quarantäne, Durchläufe und Ausnahmen – finden Sie im Menü „Xycons-Module“ unter dem Eintrag „Dateiwächter“.
Solange der Modulstatus nicht auf „Eingeschaltet“ steht, findet keinerlei Prüfung statt. Das Modul weist Sie darauf auch in seiner Oberfläche deutlich hin.
3. Einrichtung
Nach der Installation genügen drei Handgriffe, um das Modul arbeitsfähig zu machen: Modul einschalten, Empfänger für die Alarm-E-Mail eintragen, Automatik einschalten. Alles Weitere ist bereits sinnvoll vorbelegt.
Die folgenden Abschnitte erklären jede einzelne Einstellung. Sie finden sie alle im Menü „Xycons-Module“ ► „Kundenkonto / Setups“ im TAB „Dateiwächter“.
3.1 Modul ein- und ausschalten
Der Modulstatus - Dateiwächter ist der Hauptschalter. Steht er auf „Ausgeschaltet“, läuft kein einziger Prüfvorgang – auch nicht die Automatik. Das ist der schnellste Weg, das Modul vorübergehend stillzulegen, ohne es zu deinstallieren.
Darunter zeigt Ihre Lizenz: an, welche Lizenz erkannt wurde. Sie müssen dort nichts eintragen.
3.2 Prüfumfang: welches Verzeichnis wird wie behandelt
Hier liegt das Herz des Moduls. Es kennt vier Arten von Verzeichnissen:
| Art | Was dort geprüft wird |
|---|---|
| Programmdateien (alles Übrige) |
Vollständiger Vergleich des Inhalts. Jede Änderung, jede neue und jede entfernte Datei wird gemeldet. |
| Arbeitsverzeichnisse | Kein Inhaltsvergleich – der Shop arbeitet dort ständig. Gemeldet wird aber jede Datei eines ausführbaren Typs, die dort nichts zu suchen hat. |
| Ablageverzeichnisse | Wie Arbeitsverzeichnisse, zusätzlich werden Skript- und Seitendateien gemeldet. |
| Nicht beobachtet | Wird vollständig übergangen – etwa Protokolle und Archive. |
Die vier Eingabefelder Nicht beobachtete Verzeichnisse, Arbeitsverzeichnisse des Shops, Ablageverzeichnisse und Erlaubte Ausnahmen in Arbeits- und Ablageverzeichnissen sind für Ihre eigenen Ergänzungen gedacht und deshalb zunächst leer.
Je Zeile ein Eintrag, angegeben relativ zum Shopverzeichnis. Dabei gilt:
| Schreibweise | Bedeutung |
|---|---|
bilder |
das Verzeichnis und alles darunter |
* |
beliebige Zeichen innerhalb einer Ebene |
? |
ein einzelnes Zeichen |
** |
beliebig viele Ebenen |
-export |
nimmt einen mitgelieferten Eintrag wieder heraus |
3.3 Dateitypen
Unter Ausführbare Dateitypen stehen die Endungen, die der Server ausführen kann – php, phtml, cgi, sh und weitere. Dateien dieser Typen werden immer inhaltlich überwacht, auch in Arbeits- und Ablageverzeichnissen. Das ist die wichtigste Einzelregel des Moduls, denn eine Hintertür muss ausführbar sein, um zu wirken.
Zusätzlich unerwünschte Dateitypen in Ablageverzeichnissen ergänzt das um Typen, die der Server zwar nicht ausführt, die in einem Bilderordner aber trotzdem nichts verloren haben – js, html, svg.
3.4 Automatik und Belastungsgrenzen
Automatik (Cronjob) schaltet die selbsttätige Prüfung ein. Zusätzlich muss der Cronjob in der Shopverwaltung aktiviert sein – wie das geht, steht im Kapitel „Automatik einrichten“.
Dateien je Durchlauf begrenzt, wie viele Dateien pro Lauf höchstens inhaltlich eingelesen werden (Standard: 4000). Laufzeitgrenze je Durchlauf (Sekunden) begrenzt die Zeit (Standard: 120). Was nicht mehr hineinpasst, kommt beim nächsten Lauf an die Reihe – das Modul arbeitet sich blockweise vor und bricht nie mitten in einer Aufgabe ab.
Größte inhaltlich geprüfte Datei (MB) (Standard: 24): Bei größeren Dateien wird nur die Dateigröße verglichen. Das schont den Server bei umfangreichen Sicherungen und Ausgabedateien.
3.5 Inhaltliche Prüfung
Ist die Inhaltliche Prüfung eingeschaltet (Standard: Eingeschaltet), durchsucht das Modul neue und geänderte Dateien zusätzlich nach Konstruktionen, die in regulärem Shopcode praktisch nicht vorkommen: verschleierter Programmcode, Befehle, die aus Formulardaten gebildet werden, Kennzeichen bekannter Hintertüren.
Inhaltliche Prüfung bis (KB) (Standard: 1024) begrenzt, wie große Dateien dabei durchsucht werden.
Findet das Modul etwas, erscheint der Befund als „Verdächtiger Inhalt“ mit einer verständlichen Beschreibung der Auffälligkeit – etwa „Verschleierter, zur Laufzeit entpackter Programmcode“.
3.6 Alarmierung
Alarmierung per E-Mail (Standard: Eingeschaltet) verschickt nach einem Durchlauf mit Befunden eine E-Mail.
Empfänger der Alarm-E-Mail: Bleibt das Feld leer, geht die Nachricht an die im Shop hinterlegte Betreiberadresse.
Kopie der Alarm-E-Mail an: Diese Empfänger erhalten jede Alarm-E-Mail zusätzlich als unsichtbare Kopie – gedacht für den Dienstleister, der Ihren Shop betreut. Mehrere Adressen trennen Sie durch Komma.
Wann soll alarmiert werden? (Standard: Nur schwerwiegende Befunde). Bei „Nur schwerwiegende Befunde“ meldet sich das Modul ausschließlich bei geänderten Programmdateien, fremden Dateien in Ablageordnern und verdächtigem Inhalt. „Alle Befunde“ nimmt auch neue und entfernte Dateien hinzu – das ist deutlich gesprächiger.
Höchstens aufgeführte Befunde je E-Mail (Standard: 50) verhindert, dass nach einem Shopupdate eine Nachricht mit tausenden Zeilen verschickt wird. Die vollständige Liste steht immer im Modul.
Hinweis in der Shopverwaltung (Standard: Eingeschaltet) zeigt bei offenen schwerwiegenden Befunden einen roten Hinweis in der Moduloberfläche. Eine E-Mail wird leicht übersehen – dieser Hinweis nicht.
3.7 Referenzkopien
Von einer Auswahl besonders wichtiger Dateien hält das Modul eine Kopie vor. Nur bei diesen kann es Ihnen später zeigen, was sich geändert hat – bei allen anderen erfahren Sie nur, dass sie sich geändert haben.
Referenzkopien anlegen von enthält die Vorbelegung: die Dateien im Shopverzeichnis selbst, die Zugriffsregeln, die Dateien in admin und includes. Das sind rund 200 Dateien und knapp 2 MB Speicherplatz.
** ein. Der Programmcode eines Shops umfasst mehrere hundert Megabyte – auf einem Hostingpaket mit Platzgrenze ist das ein schlechter Tausch.Referenzkopie höchstens (KB) (Standard: 512): Von größeren Dateien wird keine Kopie angelegt.
3.8 Quarantäne
Niemals in Quarantäne verschieben listet die Dateien und Verzeichnisse auf, ohne die Ihr Shop nicht mehr startet. Sie lassen sich nicht aus dem Shop entfernen, auch nicht versehentlich. Das Modul selbst und Ihre Zugangsdaten sind zusätzlich fest gesperrt und müssen dort nicht stehen.
3.9 Wartungsfenster
Während eines Shop- oder Modulupdates ändern sich sehr viele Dateien völlig regulär. Tragen Sie unter Wartungsfenster bis ein Datum mit Uhrzeit ein (zum Beispiel 2026-10-15 20:00), dann zeichnet das Modul weiterhin alles auf, verschickt aber bis dahin keine Alarm-E-Mail.
3.10 Protokoll
Protokoll führen (Standard: Eingeschaltet) schreibt die Vorgänge des Moduls in die Protokolldateien des Shops. Durchläufe aufbewahren (Tage) (Standard: 365) bestimmt, wie lange die Liste der Durchläufe zurückreicht; die Befunde selbst bleiben davon unberührt.
Letzter Lauf der Automatik zeigt an, wann der Cronjob zuletzt gearbeitet hat. Erweiterte Protokollierung schalten Sie nur für die Fehlersuche ein.
4. Der Grundzustand
Bevor das Modul Veränderungen erkennen kann, muss es wissen, wie der Shop im guten Zustand aussieht. Diese Aufnahme heißt Grundzustand und ist der erste Schritt nach der Einrichtung.
Öffnen Sie dazu „Xycons-Module“ ► „Dateiwächter“, Reiter Übersicht, und klicken Sie auf Grundzustand aufnehmen. Das Modul arbeitet sich dann in Blöcken durch den Shop und zeigt dabei, wie weit es ist.
Die Aufnahme dauert je nach Shopgröße zwischen wenigen Sekunden und einigen Minuten. Sie können die Seite dabei offen lassen; wird sie geschlossen, setzt die Automatik die Aufnahme beim nächsten Lauf fort.
Die Kacheln der Übersicht zeigen danach:
| Kachel | Bedeutung |
|---|---|
| Grundzustand | ob die Aufnahme vollständig ist |
| Beobachtete Dateien | wie viele Dateien überwacht werden |
| Letzter Durchlauf | wann zuletzt geprüft wurde |
| Offene Befunde | wie viele Veränderungen auf Ihre Entscheidung warten |
| Davon schwerwiegend | wie viele davon dringend sind |
| Automatik | ob der Cronjob eingeschaltet ist |
| Dauerhafte Ausnahmen | wie viele Pfade von der Prüfung ausgenommen sind |
Jetzt prüfen stößt einen Durchlauf von Hand an. Das ist nützlich, wenn Sie gerade etwas geändert haben und sofort sehen möchten, was das Modul davon bemerkt.
5. Befunde – die tägliche Arbeit
Jeder Eintrag im Reiter Befunde beschreibt eine Veränderung an den Shopdateien. Hier entscheiden Sie, was damit geschehen soll.
5.1 Die Arten von Befunden
| Art | Was dahintersteckt |
|---|---|
| Inhalt geändert | Eine Programmdatei wurde verändert. Nach einem Update ist das normal – sonst nicht. |
| Neue Datei | Eine Datei ist hinzugekommen, die es vorher nicht gab. |
| Datei entfernt | Eine beobachtete Datei liegt nicht mehr an ihrem Platz. |
| Fremde Datei im Ablageordner | In einem Ordner, in dem der Shop nur ablegt, ist eine ausführbare Datei aufgetaucht. Das ist der ernsteste Befund überhaupt – dort gehört so etwas niemals hin. |
| Verdächtiger Inhalt | Der Dateiinhalt trägt Merkmale von Schadcode. Die Spalte „Auffälligkeit“ sagt, welche. |
| Zugriffsrechte geändert | Eine Datei ist für jeden beschreibbar geworden. |
Die Spalte Gewicht trennt „schwerwiegend“ von „zu prüfen“. Schwerwiegende Befunde sollten Sie sich noch am selben Tag ansehen.
5.2 Was Sie mit einem Befund tun können
Markieren Sie einen oder mehrere Einträge und wählen Sie eine der Schaltflächen:
| Schaltfläche | Wirkung |
|---|---|
| Als bekannt übernehmen | Sie bestätigen, dass die Veränderung in Ordnung ist. Der jetzige Zustand der Datei gilt ab sofort als der richtige, der Eintrag verschwindet aus der Liste. Die Datei bleibt unter Beobachtung – die nächste Veränderung wird wieder gemeldet. |
| Dauerhaft ausnehmen | Die Datei oder ein ganzer Pfad wird künftig überhaupt nicht mehr geprüft. |
| Wieder aufnehmen | Holt einen bereits bearbeiteten Eintrag zurück in die Liste. |
| In Quarantäne verschieben | Entfernt die Datei aus dem Shop und bewahrt sie geschützt auf. |
| Alle als bekannt übernehmen | Übernimmt die gesamte offene Liste auf einmal – die Antwort auf ein Shopupdate. |
5.3 Einzelansicht: was genau sich geändert hat
Die Schaltfläche Ansehen am Ende jeder Zeile öffnet die Einzelansicht.
Bei einer geänderten Datei, von der eine Referenzkopie vorliegt, sehen Sie die Gegenüberstellung: Welche Zeilen sind hinzugekommen, welche verschwunden – mit Zeilennummer und farbig hervorgehoben.
Bei einer neu aufgetauchten Datei zeigt dieselbe Ansicht den Anfang des Dateiinhalts. Gerade bei einer vermuteten Hintertür ist das die Auskunft, auf die es ankommt – Sie sehen sofort, ob es sich um harmlosen oder um gefährlichen Code handelt.
5.4 Die Liste filtern und ausgeben
Über der Liste filtern Sie nach Zustand, Art, Gewicht und einem Teil des Dateipfads. Die Schaltflächen Als Tabelle ausgeben (CSV) und Als PDF ausgeben erzeugen aus der gerade eingestellten Auswahl eine Datei zum Herunterladen – etwa zur Weitergabe an Ihren Dienstleister.
6. Quarantäne
Halten Sie eine Datei für Schadcode, verschieben Sie sie in die Quarantäne. Sie wird damit aus dem Shop entfernt und in einer geschützten Ablage aufbewahrt, die über das Web nicht erreichbar ist. Der Shop kann sie danach nicht mehr verwenden – eine Hintertür ist damit wirkungslos.
Im Reiter Quarantäne stehen alle entfernten Dateien. Zu jeder sehen Sie den ursprünglichen Pfad, die Größe, wann und von wem sie verschoben wurde. Zwei Schaltflächen stehen zur Wahl:
- Zurückholen legt die Datei an ihren ursprünglichen Ort zurück. Sie gilt danach als richtig und löst keinen neuen Befund aus.
- Endgültig löschen entfernt sie unwiderruflich. Der Eintrag in der Liste bleibt als Nachweis stehen, was wann entfernt wurde.
7. Ausnahmen und mitgelieferte Vorgaben
Manche Dateien ändern sich bei Ihnen ständig, ohne dass es Sie interessiert – ein eigenes Skript, das Protokolle schreibt, ein Verzeichnis einer Fremdsoftware. Für diese Fälle gibt es dauerhafte Ausnahmen.
Markieren Sie in der Befundliste die betreffenden Einträge und wählen Sie Dauerhaft ausnehmen. Das Modul fragt dann, wie weit die Ausnahme reichen soll:
Angeboten werden die ausgewählten Dateien selbst und die Verzeichnisebenen darüber. Nach dem Deploy eines Moduls mit dutzenden Dateien genügt so ein Klick auf die passende Ebene, statt jede Datei einzeln wegzuklicken.
Im Reiter Ausnahmen sehen Sie oben Ihre eigenen Ausnahmen – mit der Angabe, ob es sich um eine einzelne Datei oder einen Pfad handelt. Jede lässt sich dort wieder aufheben; die Datei wird dann beim nächsten Durchlauf erneut aufgenommen.
Darunter stehen die mitgelieferten Vorgaben. Das sind die Orte, an denen ein Gambio-Shop und unsere Module im Normalbetrieb selbst Dateien anlegen – Zwischenspeicher, Bilderordner, Archive, Briefkastenausgaben. Diese Liste wird mit jedem Modulupdate aktualisiert und muss von Ihnen nicht gepflegt werden.
export wird dann -export.Ganz oben in der Liste stehen zwei Verzeichnisse mit dem Vermerk „Fest ausgenommen (Wartung)“: MyXyconsDumper und XyCons. Dort liegen unsere Werkzeuge für Datensicherung und Wartung; die Dateien darin wechseln bei jedem unserer Eingriffe. Diese beiden Verzeichnisse sind fest im Modul ausgenommen und lassen sich auch nicht per Minuszeichen zurückholen – sie würden sonst bei jeder Wartung Befunde erzeugen, die Sie nichts angehen.
8. Durchläufe
Der Reiter Durchläufe zeigt, wann das Modul gearbeitet hat und was dabei herauskam: Beginn, Art des Laufs, Dauer, wie viele Dateien gesehen und wie viele davon inhaltlich gelesen wurden, dazu das Ergebnis.
Diese Liste ist Ihr Nachweis, dass die Überwachung tatsächlich läuft. Bleiben die Einträge aus, arbeitet die Automatik nicht – dann lohnt ein Blick ins Kapitel „Automatik einrichten“.
An den Zahlen lässt sich auch die Belastung ablesen: Ein Durchlauf ohne Veränderung liest null Dateien und ist in rund einer Sekunde durch. Erst wenn sich etwas bewegt hat, steigt die Zahl der gelesenen Dateien.
9. Alarmierung per E-Mail
Findet ein Durchlauf etwas, verschickt das Modul eine E-Mail. Sie enthält den Shopnamen, den Zeitpunkt und eine Liste der Befunde mit Art, Gewicht und Dateipfad – so können Sie schon am Telefon oder unterwegs einschätzen, wie dringend die Sache ist.
Wer die Nachricht bekommt und wann sie verschickt wird, stellen Sie im Setup ein. Für betreute Shops tragen Sie zusätzlich unter „Kopie der Alarm-E-Mail an“ die Adresse Ihres Dienstleisters ein.
10. Automatik einrichten
Damit das Modul von selbst prüft, müssen drei Schalter stehen:
| 1. | Im Setup des Moduls steht Automatik (Cronjob) auf „Eingeschaltet“. |
| 2. | In der Shopverwaltung unter „Einstellungen“ ► „Cronjobs“ ist der Eintrag Dateiwächter Cronjob aktiviert und ein Intervall gewählt. |
| 3. | Der Cronjob-Aufruf Ihres Shops wird von Ihrem Server regelmäßig ausgeführt. Den passenden Aufruf finden Sie in der Shopverwaltung auf der Cronjob-Seite; Ihr Anbieter richtet ihn üblicherweise im Hosting-Menü ein. |
Als Intervall empfehlen wir stündlich. Wer es genauer braucht, kann auf alle 15 Minuten gehen – die Belastung ist gering, weil ein Durchlauf ohne Veränderung kaum Arbeit macht.
Ob die Automatik tatsächlich läuft, sehen Sie an zwei Stellen: in der Übersicht an der Kachel „Letzter Durchlauf“ und im Reiter „Durchläufe“ an den regelmäßigen Einträgen.
11. Modultexte ändern
Modultexte können Sie – wie bei allen Modulen von uns – über die Shopfunktion „Texte ändern“ im Admin-Bereich an eigene Bedürfnisse anpassen.
Das betrifft zum Beispiel den Betreff und den Einleitungstext der Alarm-E-Mail, die Beschriftungen in der Befundliste oder die Erklärtexte der Schaltflächen. Suchen Sie dort nach dem Bereich m0164.
12. Shopupdate und Modulpflege
Zwei Dinge sollten Sie vor jedem Shopupdate beachten:
| 1. | Prüfen Sie auf unserer Seite, ob das Modul für die neue Shopversion freigegeben ist. |
| 2. | Installieren Sie beim Shopupdate immer auch die neuesten Versionen des Moduls und der Modulumgebung – nicht nur den Shop aktualisieren. |
Ein altes Modul passt sich nicht von selbst an eine neue Shopversion an. Wer nur den Shop aktualisiert, hat danach möglicherweise ein Modul, das nicht mehr arbeitet – und sucht die Ursache am falschen Ende.
13. Häufige Fragen
Das Modul meldet nach einem Update sehr viele Befunde. Ist etwas passiert?
Nein – bei einem Update werden tatsächlich hunderte Dateien ausgetauscht. Sehen Sie die Liste kurz durch, ob etwas Fremdes darunter ist, und übernehmen Sie sie dann auf einmal.
Ein eigenes Verzeichnis taucht ständig in den Befunden auf.
Nehmen Sie es dauerhaft aus: Befund markieren, „Dauerhaft ausnehmen“, und im Fenster die passende Verzeichnisebene wählen.
Bei einer geänderten Datei sehe ich nicht, was sich geändert hat.
Von dieser Datei wird keine Referenzkopie vorgehalten. Ergänzen Sie den Pfad im Setup unter „Referenzkopien anlegen von“ – ab der nächsten Änderung steht die Gegenüberstellung bereit.
Ich habe eine Datei in Quarantäne verschoben und der Shop zeigt einen Fehler.
Holen Sie die Datei im Reiter „Quarantäne“ mit „Zurückholen“ zurück. Sie landet unverändert an ihrem alten Platz. Ergänzen Sie den Pfad anschließend im Setup unter „Niemals in Quarantäne verschieben“.
Es kommen keine E-Mails.
Prüfen Sie der Reihe nach: Steht „Alarmierung per E-Mail“ auf „Eingeschaltet“? Läuft gerade ein Wartungsfenster? Steht „Wann soll alarmiert werden?“ auf „Nur schwerwiegende Befunde“, obwohl nur leichtere Befunde vorliegen? Und sehen Sie im Spam-Ordner nach.
Die Durchläufe hören auf.
Dann arbeitet der Cronjob nicht mehr. Die drei nötigen Schalter stehen im Kapitel „Automatik einrichten“.
Was mache ich bei einem echten Fund?
Ruhe bewahren und nichts überstürzt löschen. Sehen Sie sich die Datei über „Ansehen“ an, verschieben Sie sie in die Quarantäne – damit ist sie sofort wirkungslos, aber noch vorhanden. Danach den Shop und alle Zugänge prüfen lassen: Ein Fund ist meist die Spur, nicht die Ursache. Sprechen Sie uns oder Ihren Dienstleister an; die Befundliste können Sie über „Als PDF ausgeben“ direkt weitergeben.

