38 KiB
Betrieb: Umgebungen, Zugänge, Einrichtung
Stand: 27.10.2026. Aktuell bestätigt: Test unter www.stommer.info und stommer.info, SSH-Serverpfad test.fewo-stommer.de/. dev.fewo-stommer.de/ existiert nicht. Produktion ist noch nicht eingerichtet: ein vorhandener leerer Ordner ist keine fertige Umgebung; eigene MariaDB, .env, persistente Daten und Domainzuordnung fehlen. Produktion bleibt in pipeline.toml gesperrt. Entwicklung und Testdeploy laufen über develop und PipelineManager; die manuellen Skripte unten sind Wartungswerkzeuge. Weitere Abläufe: DEPLOYMENT.md.
Geheimnisse stehen nie im Repository und nie im Chat. Passwörter (Datenbank, E-Mail),
APP_KEY, Tokens und private SSH-Schlüssel liegen nur inshared/.envauf dem Server bzw. im Vaultwarden von Lars. Hier ist nur dokumentiert, wo sie liegen.
1. Überblick
| Testbetrieb (staging) | Produktion | |
|---|---|---|
| Adresse | https://stommer.info | später https://www.fewo-stommer.de (heute noch WordPress) |
| Ordner auf dem Webspace | test.fewo-stommer.de/ |
prod.fewo-stommer.de/ angelegt; .env/Datenbank und Freigabe noch offen |
| Deploy-Konfiguration (lokal, nicht committet) | scripts/deploy.staging.env |
scripts/deploy.production.env (anlegen aus deploy.example.env) |
| Datenbank | MariaDB 11.8, siehe §3 | eigene Datenbank anlegen |
MAIL_MAILER=log – verschickt nichts |
Strato-SMTP | |
| Postfach-Abruf (Portal-Mails) | aus (FEWO_MAILBOX_HOST leer) |
imap.strato.de |
| Suchmaschinen | noindex (alles außer APP_ENV=production) |
indexiert |
| Scheduler-Auslöser | n8n veröffentlicht und aktiv, automatische Kalenderimporte im Fünf-Minuten-Abstand nachgewiesen (§6) | einrichten |
Git: https://gitea.stommer.de/Lars/fewo-stommer.git. Automatischer Testdeploy nach Push auf develop; Produktion über Merge-Commit von develop nach main, derzeit gesperrt. Gebaut wird der exakte Workflow-Commit mit PipelineManager; Details in DEPLOYMENT.md.
2. Strato-Paket (Hosting Pro)
- SSH/SFTP-Server:
51539426.ssh.w1.strato.hosting(paketspezifisch, nichtssh.strato.de– der lehnt ab). Port 22. - SSH-Benutzer:
stu100093250(Kundenlogin › Datenbanken und Webspace › SFTP & SSH › Details). Startverzeichnis/= Webspace-Wurzel. - Absoluter Pfad des Webspace:
/mnt/web508/e3/26/51539426/htdocs/(für Cronjobs). - PHP-CLI:
/opt/RZphp84/bin/php-cli(8.4). Die Web-PHP-Version des Pakets ist eine andere (8.3); die.htaccessim Deploy-Ordner setzt perAddType application/x-httpd-php84 .php8.4 nur für diesen Ordner. - Andere Inhalte im Webspace nicht anfassen: u. a.
www.fewo-stommer.de/(bestehendes WordPress),fewo, Karate-Wiki, Moodle. Das Deploy-Skript arbeitet ausschließlich unterhalb vonDEPLOY_PATH. - Domains: SSL-Zertifikate gibt es im Paket nur für Hauptdomains, nicht für Subdomains. Deshalb läuft der Test unter
stommer.info(Ziel: Ordnertest.fewo-stommer.de, SSL aktiv,www.stommer.infoebenso). Die Subdomaintest.fewo-stommer.dewird nicht mehr gebraucht. - Domain-Ziel = Deploy-Ordner selbst (Strato kann kein Symlink-Ziel wählen). Die dort vom Skript geschriebene
.htaccessleitet aufreleases/<aktive Version>/publicund sperrt alles Interne mit 403.
3. Datenbank (staging)
- Host
database-5021719836.webspace-host.com, Port 3306, Datenbankdbs16257975, Benutzerdbu2231025,DB_CONNECTION=mariadb. - Passwort: nur in
test.fewo-stommer.de/shared/.env(und Vaultwarden).
4. SSH-Zugang einrichten (neuer Rechner, z. B. privater PC)
- Schlüssel erzeugen:
ssh-keygen -t ed25519 -f ~/.ssh/strato_fewo -C "fewo-deploy <rechner>". - Öffentlichen Schlüssel beim Server eintragen (fragt einmal das SSH-Passwort des Strato-Benutzers ab):
ssh-copy-id -i ~/.ssh/strato_fewo.pub stu100093250@51539426.ssh.w1.strato.hosting(Windows ohnessh-copy-id: Inhalt vonstrato_fewo.pubper SSH an~/.ssh/authorized_keysanhängen.) - Test:
ssh -i ~/.ssh/strato_fewo stu100093250@51539426.ssh.w1.strato.hosting "ls". - Den privaten Schlüssel nur im Vaultwarden sichern, nie committen oder weitergeben.
- Aufräumen: Der Schlüssel des Firmen-Laptops (Kommentar in
~/.ssh/authorized_keysauf dem Server) wird entfernt, sobald der private PC eingerichtet ist.
Lokale Werkzeuge: PHP 8.4 CLI, Composer, Node/npm, Git, Bash (Windows: Git Bash). Danach scripts/deploy.example.env nach scripts/deploy.staging.env kopieren und mit den Werten aus §2 füllen (DEPLOY_PATH=test.fewo-stommer.de, DEPLOY_URL=https://stommer.info, DEPLOY_SSH_KEY=~/.ssh/strato_fewo; unter Windows ggf. COMPOSER_BIN="php /c/…/composer.phar").
5. Konfiguration auf dem Server (shared/.env)
Vorlage: .env.production.example. Bearbeiten nur direkt auf dem Server, damit Passwörter nicht durch Chat oder Repository laufen:
ssh -t -i ~/.ssh/strato_fewo stu100093250@51539426.ssh.w1.strato.hosting "nano test.fewo-stommer.de/shared/.env"
bash scripts/deploy.sh staging artisan optimize # danach Konfiguration neu einlesen
Gesetzte Werte im Testbetrieb (Geheimnisse ausgelassen):
| Schlüssel | Wert | Bemerkung |
|---|---|---|
APP_ENV |
staging |
nicht production → noindex |
APP_DEBUG |
false |
|
APP_URL |
https://stommer.info |
alle erzeugten Links bauen darauf auf (URL::forceRootUrl) |
APP_KEY |
gesetzt | nie ändern – sonst sind 2FA-Schlüssel und Sitzungen unlesbar |
DB_* |
siehe §3 | |
SESSION_DRIVER / CACHE_STORE |
database |
|
SESSION_SECURE_COOKIE |
true |
Anmeldung nur über HTTPS |
QUEUE_CONNECTION |
sync |
keine Worker auf Shared Hosting |
MAIL_MAILER |
log |
Testbetrieb verschickt keine E-Mails (landen in shared/storage/logs) |
FEWO_MAILBOX_HOST |
leer | Testbetrieb liest kein echtes Postfach |
FEWO_BANK_* |
leer | für Verträge/Angebote noch einzutragen |
FEWO_HEALTH_TOKEN, FEWO_SCHEDULER_TOKEN, FEWO_AUTOMATION_SECRET |
gesetzt | für n8n (Überwachung, Scheduler-Ersatz, Webhooks) |
5a. E-Mail: Testbetrieb und scharf schalten
- Betriebsart in der Verwaltung: System › Betrieb (nur Administratoren). Jede Installation beginnt im Testbetrieb: alle E-Mails (an Gäste, Vermieterin, Benachrichtigungen) gehen ausschließlich an die dort eingetragene Testadresse (ohne Eintrag:
FEWO_NOTIFICATION_EMAIL), egal was auf der Webseite eingetragen wurde. Ein gelber Hinweis oben in der Verwaltung zeigt das an. Erst „Scharf geschaltet“ liefert an die echten Empfänger. Technisch prüft eine einzige Schranke jede ausgehende Mail unmittelbar vor dem Versand (App\Listeners\EnforceMailTestMode, EreignisMessageSending, für jeden Mailer): Im Testbetrieb ersetzt sie An/Cc/Bcc durch die Testadresse (Original im KopfX-Fewo-Testbetrieb-Original); ohne jede Testadresse wird gar nichts versendet (Warnung im Log). Der Modus wird für jede Mail frisch aus der Datenbank gelesen. - Adressen der internen Kommunikation ebenfalls unter System › Betrieb: Benachrichtigungen an (mehrere Adressen: neue Anfragen, Angebotsantworten, Fristabläufe, Bewertungen, Portal-Mails/-Aufgaben, Kopie der Zahlungserinnerungen), Kontakt- und Antwortadresse (Webseite, Mietvertrag, Antwortadresse der Gäste-Mails), Absendername/-adresse (muss zum SMTP-Postfach
MAIL_USERNAMEpassen – das Formular warnt). Ohne Eintrag geltenFEWO_NOTIFICATION_EMAIL,FEWO_OWNER_EMAIL,MAIL_FROM_*ausshared/.env. FEWO_MAIL_REDIRECT_TOinshared/.envist eine harte Überschreibung für Testserver (gilt auch bei „scharf“); normalerweise leer lassen.- Versandweg: Standard
MAIL_MAILER=log– dann wird gar nichts zugestellt (auch nicht im Protokoll gespeichert). Für echten Versand inshared/.envMAIL_MAILER=smtpundMAIL_PASSWORD=<Passwort des Postfachs info@fewo-stommer.de>(nur selbst eintragen; Absender und SMTP-Anmeldung:info@fewo-stommer.de, Antwortadresse und Benachrichtigungen weiterFEWO_OWNER_EMAIL/FEWO_NOTIFICATION_EMAIL= fewo@stommer.de), dannbash scripts/deploy.sh staging artisan optimize. - Versand prüfen:
bash scripts/deploy.sh staging artisan mail:test– zeigt Versandweg, Umleitung und Fehler (z. B. SMTP-Anmeldung) und schickt eine Testmail. - Dass jede Mail-Vorlage fehlerfrei aufgebaut wird (17 Mail-Typen, in ihrem echten Zustand), prüft
tests/Feature/MailRenderingTest.php.
6. Erledigt / offen im Testbetrieb
Erledigt (22.10.2026): Ordnerstruktur, shared/.env, Migrationen, Grunddaten (ProductionSeeder: Wohnung, Saisons 2026, Inhalte, Seiten, Erscheinungsbilder), HTTPS unter stommer.info, Gesundheitscheck mit automatischem Rollback, Admin-Konto lars@stommer.com mit 2FA, 39 Fotos importiert und von Metadaten bereinigt, Ende-zu-Ende-Durchlauf Anfrage → Angebot → Annahme (Testbuchung 2026-0002, darf gelöscht werden).
Offen:
- Konto für Brigitte anlegen: System › Benutzer, Rolle Administrator, Ansicht Einfach (§7).
- E-Mail im Testbetrieb einschalten (§5a): Versandweg SMTP + Passwort; Betriebsart steht auf Testbetrieb mit Testadresse lars@stommer.com.
- Bankdaten, Vertrags- und AGB-Texte, Rechtstexte prüfen.
Automatische Zeitsteuerung (n8n)
Lars hat am 27.10.2026 im Strato-Kundenbereich als kleinstes Intervall stündliche Ausführung festgestellt. Das genügt nicht für den vorgesehenen Kalenderimport alle fünf Minuten. Deshalb ist ein externer minütlicher Aufruf über n8n eingerichtet; kein zusätzlicher stündlicher Strato-Scheduler für dieselbe Instanz.
Auf dem bestehenden Pi läuft n8n 2.7.5. Vor der Einrichtung wurden die 29 vorhandenen Workflows auf einen bereits vorhandenen FewoPortal-/stommer.info-Aufruf geprüft; keiner gefunden. Die tokenfreie Vorlage scripts/n8n-fewo-scheduler.json ist gegen die installierten Schedule- und HTTP-Node-Schemata geprüft. Sie ruft jede volle Minute https://stommer.info/automation/scheduler auf. Laravel führt die jeweils fälligen Aufgaben aus, einschließlich aktiver Kalenderimporte alle fünf Minuten; auch die anderen in routes/console.php definierten Aufgaben werden dadurch zeitgesteuert ausgeführt.
Der Header Authorization: Bearer <FEWO_SCHEDULER_TOKEN> liegt nach ausdrücklicher Freigabe in der verschlüsselten n8n-Zugangsdatenverbindung FewoPortal Scheduler (stommer.info) vom Typ Header Auth, Feldname Authorization. Der veröffentlichte Workflow ist angelegt; die gespeicherte verschlüsselte Form und die korrekte Zuordnung wurden lesend bestätigt. Die Repository-Vorlage enthält nur eine Platzhalterreferenz. Token weder in die Workflow-Datei noch in eine URL oder das Repository schreiben. Erfolgreiche Ausführungsdaten werden nicht dauerhaft gespeichert; HTTP-Fehler bleiben Fehler.
Der separat freigegebene einmalige manuelle Workflow-Test hat am 27.10.2026 um 20:42:47 Uhr MEZ eine gültige authentifizierte JSON-Antwort des Schedulers erhalten. Für den parallelen CLI-Test wurde ausschließlich im Testprozess ein anderer lokaler Task-Broker-Port verwendet; die laufende n8n-Instanz wurde nicht neu gestartet. Der Test lag außerhalb einer Fünf-Minuten-Marke und führte deshalb keinen Kalenderimport aus. Lesend um 20:43 bestätigt: Kanal 1 importfähig, letzter erfolgreicher Import weiterhin 19:21:17 Uhr; Kanal 2 Import ausgeschaltet. Dieser einmalige Verbindungstest ist vom nachfolgenden Nachweis automatischer Kalenderimporte zu unterscheiden.
Betriebsnachweis vom 27.10.2026: Lars hat den Workflow in der Oberfläche veröffentlicht. Aktive Version und registrierter Zeitplan lesend bestätigt. Anschließend zwei automatische Importe des FeWo-direkt-Kanals 1 um 20:55:03 und 21:00:03 Uhr MEZ, Protokolle 5 und 6, erfolgreich nachgewiesen: exakt 300 Sekunden Abstand; jeweils 11 Ereignisse, keine neuen, geänderten oder entfernten Belegungen, keine Konflikte. last_success_at am Kanal ist 21:00:03 Uhr, kein aktueller Importfehler. Die Beobachtung hat keinen manuellen Abgleich ausgelöst. Der Ostseeklar-Kanal 2 bleibt ein reiner Exportkanal mit ausgeschaltetem Import.
Die Automatik läuft unabhängig vom Browser und dem lokalen SSH-Tunnel auf dem Pi. Pi, n8n und dessen Internetverbindung müssen verfügbar bleiben. Die Kanalübersicht zeigt den letzten erfolgreichen Import und auftretende Fehler; zwei erfolgreiche Läufe belegen diesen konkreten Betriebsbeginn, keine dauerhafte Verfügbarkeitsgarantie. Die n8n-CLI-Dokumentation verlangt nach CLI-Veröffentlichung einen Neustart; Veröffentlichung in der Oberfläche vermeidet diesen zusätzlichen Neustart. Tokenfreier lokaler Nachweis: storage/app/private/n8n-scheduler/setup-result.json (Git-ignoriert).
Zugang zur n8n-Oberfläche (27.10.2026)
Nutzungsentscheidung vom 28.10.2026: Aktuell benötigt Lars keinen externen Zugriff. Vorgesehener Betrieb: Verwaltung ausschließlich im Heimnetz über das bereits geprüfte NAS-HTTPS auf Port 5678. Die Zertifikatsadresse privat.stommer.com soll dafür intern direkt auf NAS 192.168.2.63 auflösen; damit ist kein dauerhafter lokaler SSH-Tunnel erforderlich. Öffentliche n8n-Portfreigabe wieder schließen, Heimnetzfreigabe für 192.168.2.0/24 erhalten. Dies ist die vereinbarte Zielrichtung; DNS-, Router- und Firewalländerungen wurden durch den Agenten noch nicht umgesetzt. Der ausgehende Fewo-Scheduler benötigt diese öffentliche Freigabe nicht. Die kostenpflichtige zentrale MFA-Erzwingung und persönliche Konto-2FA unter Settings → Personal sind unterschiedliche Funktionen; ein kostenpflichtiges Upgrade ist für den internen Betrieb nicht erforderlich. Aktualisierungen und Sicherungen bleiben erforderlich.
Öffentlicher Zugriff wiederhergestellt und Sicherheitskurzprüfung (28.10.2026): Lars bestätigt, dass die Freigabe des Ports in der NAS-Firewall den externen Zugriff wiederhergestellt hat. Anschließender HTTPS-Prüfabruf gegen privat.stommer.com:5678: Startseite und /healthz HTTP 200, /rest/workflows, /rest/credentials und /api/v1/workflows jeweils unangemeldet HTTP 401. Damit ist die zuvor vermutete Firewallblockade durch die Nutzeränderung und den erneuten Abruf nachvollzogen. Die früheren Zeitüberschreitungen unten beschreiben den Zustand vor dieser Freigabe.
Installiert ist weiterhin n8n 2.7.5, lesend über die Container-CLI geprüft. Container läuft als node, nicht privilegiert, ohne eingebundenen Docker-Socket; diese Isolation ersetzt keine aktuellen Anwendungspatches. Version 2.7.5 liegt beispielsweise im vom Hersteller angegebenen betroffenen Bereich der Form-Expression-Sicherheitslücke GHSA-75g8-rv7v-32f7. Deren praktische Ausnutzbarkeit hängt von einer bestimmten Form-Workflow-Konfiguration ab und wurde hier nicht geprüft. Kein Exploitversuch und kein vollständiger Sicherheits- oder Kompromittierungsaudit. 2FA laut Lars nicht aktiviert beziehungsweise unklar; bisher benötigt nur er die Verwaltung, später möglicherweise weitere Personen.
Empfohlene nächste Schritte, noch nicht umgesetzt: Öffentliche Verwaltung vorerst wieder beschränken und über vorhandenen lokalen Tunnel beziehungsweise einen einzurichtenden Heimnetz-VPN-Zugang verwenden; n8n nach Sicherung und Kompatibilitätsprüfung auf einen aktuell gepflegten Patchstand aktualisieren; persönliche 2FA unter Settings → Personal aktivieren und Wiederherstellungscodes sicher aufbewahren; Sicherung und Updatebetrieb für Pi, NAS und FRITZ!Box sicherstellen. Spätere öffentliche Webhooks getrennt von der Verwaltung planen. Der Fewo-Scheduler sendet ausgehend Anfragen an stommer.info und benötigt selbst keinen öffentlich erreichbaren n8n-Eingang. Während dieser Prüfung keine Firewallregel, Kontoeinstellung oder Serverkonfiguration geändert und keinen Workflow ausgeführt.
Ergänzung und Korrektur vom 28.10.2026: HTTPS wird auf dem Synology-NAS bereitgestellt, nicht auf dem Pi. Lars bestätigt die Weiterleitung der öffentlichen Adresse durch die FRITZ!Box zum NAS. Direkte Prüfung aus dem Heimnetz gegen NAS 192.168.2.63:5678 mit TLS-Servername privat.stommer.com: TLS 1.3, Zertifikat von der lokalen Vertrauenskette akzeptiert und für diesen Hostnamen passend, gültig bis 11.12.2026, HTTP 200 und n8n-Seitentitel. Der Pi selbst bleibt unter HTTP 192.168.2.49:5678 erreichbar. Die vorherige Aussage über einen ungeklärten HTTPS-Aufbau bezog sich auf den direkten Pi-Zugang und war für den gesamten Zugriffsweg unvollständig.
Öffentliches DNS liefert IPv4 5.63.35.136 und IPv6 2a01:41e3:0:1::3387; Verbindungsprüfung von diesem Arbeitsplatz auf Port 5678: IPv4-Zeitüberschreitung und IPv6-Verbindung abgewiesen. Auch vom Pi ist der öffentliche Aufruf nicht erreichbar. Das vom Nutzer gezeigte NAS-Firewallprofil erlaubt das Heimnetz 192.168.2.0/24 vollständig und verweigert übrige Verbindungen nach den vorherigen Dienstfreigaben; eine eigene Freigabe für TCP 5678 ist nicht erkennbar. Wenn die Routerweiterleitung auf NAS-Port 5678 zeigt, ist dessen Freigabe für die gewünschten externen Quelladressen vor der abschließenden Verweigern-Regel zu prüfen. Die vollständigen Ports der ersten Dienstregel sowie der genaue Zielport der Routerfreigabe wurden noch nicht eingesehen; die Firewall ist ein begründeter Verdacht, keine abschließend bestätigte Ursache. Eine erfolgreiche externe Abnahme steht aus. Keine Router-, NAS-, Zertifikats- oder n8n-Konfiguration geändert.
Der beendete lokale SSH-Tunnel wurde am 28.10. erneut ausschließlich an 127.0.0.1:15678 gestartet, mit SSH-Verbindungserhaltung. Startseite und n8n-Gesundheitsprüfung HTTP 200; direkte Pfade /signin und /workflow/23581e4b70324812 liefern bei unangemeldeten HTTP-Prüfabrufen aktuell 404. Für den provisorischen Zugang die Startseite http://localhost:15678/ verwenden. Eine erneute Anmeldung wurde noch nicht durch den Nutzer bestätigt. Der lokale Tunnel verändert den öffentlichen NAS-Zugang nicht. Die folgenden Absätze beschreiben den früheren Befund vom 27.10.
n8n läuft auf dem Pi unter http://192.168.2.49:5678; Container und Oberfläche wurden mit HTTP 200 geprüft. Auf diesem Port ist kein TLS eingerichtet: Ein HTTPS-Verbindungsversuch an den internen n8n-Port scheitert mit WRONG_VERSION_NUMBER. Die in n8n hinterlegte N8N_EDITOR_BASE_URL=https://privat.stommer.com:5678 wurde zunächst als Workflowlink übernommen, ist jedoch kein nachgewiesen funktionierender HTTPS-Zugang. Die Einstellung einer Editoradresse richtet selbst kein TLS ein. Der öffentliche Aufruf auf Port 5678 lief bei der Prüfung in eine Zeitüberschreitung.
Für den aktuellen Arbeitsplatz wurde ein nur an 127.0.0.1:15678 gebundener SSH-Tunnel zum Pi eingerichtet. Zugang: http://localhost:15678, Scheduler-Workflow. HTTP-Antworten für Oberfläche, Anmeldung und Workflowroute geprüft; Lars hat die erfolgreiche Anmeldung mit seinem bestehenden Konto bestätigt. Die Verbindung vom Rechner zum Pi wird durch SSH verschlüsselt. Die Secure-Cookie-Einstellung bleibt eingeschaltet, Serverkonfiguration und n8n-Container wurden für diese Zugangslösung nicht verändert oder neu gestartet.
Die lokalen Links gelten nur auf dem Rechner mit laufendem Tunnel. Nach dessen Beendigung beziehungsweise einem Rechnerneustart lässt sich der Zugang in einer lokalen SSH-Sitzung wiederherstellen:
ssh -N -L 127.0.0.1:15678:127.0.0.1:5678 -o ExitOnForwardFailure=yes pi
Ein dauerhafter öffentlicher HTTPS-Zugang ist damit nicht repariert. Dafür sind die tatsächlich verwendete öffentliche Adresse, deren Weiterleitung und TLS-Terminierung zu klären. n8n beschreibt dafür TLS am Reverse Proxy oder Zertifikate direkt an n8n. Durch diese Diagnose wurden keine Zertifikate, Weiterleitungen oder n8n-Anmeldedaten geändert.
n8n-Upgradeversuch und Wiederherstellung (28.10.2026)
Wiederherstellung nach dem folgenden Vorfall: Lars konnte den Testcontainer schließlich in Portainer stoppen. Danach antworteten SSH sowie n8n-Gesundheit/Bereitschaft und Portainer mit HTTP 200. 58 Container laufen, keiner der vorhandenen Healthchecks meldet „unhealthy“; keine vollständige fachliche Prüfung aller Anwendungen. Originalcontainer n8n und portainer mit Neustartzähler 0 vorgefunden; kein Hostneustart vorgenommen. Gestoppten Testcontainer gezielt entfernt; separates Testvolume und Sicherung erhalten. Privater Nachweis recovery-result.json im Sicherungsverzeichnis. Ein erneut erfolgreicher automatischer Fewo-Kalenderimport wurde auf stommer.info am 28.10. um 09:55:04 MEZ lesend bestätigt; Kanal ohne aktuellen Importfehler.
Ressourcenbefund nach Wiederherstellung: Pi hat rund 8 GB RAM; rund 2 GB Swap fast vollständig belegt. In der anschließenden vmstat-Stichprobe keine aktive Auslagerung und CPU überwiegend frei. Docker meldet MemoryLimit=false, SwapLimit=false und entsprechende Warnungen. Container-Speicheranzeigen 0B / 0B sind deshalb keine brauchbare Verbrauchsmessung. Ein bloßes --memory wäre auf diesem unveränderten Host keine verlässliche Absicherung. Keine Kernel-OOM-Kill- oder I/O-Fehlermeldung im geprüften Zweistundenfenster. Der Zusammenhang zwischen zusätzlichem parallelem n8n und der Überlastung ist plausibel und durch Erholung nach dessen Stopp gestützt; ein eindeutiger OOM-Kill ist nicht nachgewiesen. Ressourcen-/Kernelunterstützung hätte der Agent vor dem Test prüfen müssen. Keine Kernel-, Boot- oder Swapkonfiguration geändert, kein weiterer Test gestartet.
Weiterer Upgradebedarf: Das produktive n8n ist noch nicht aktualisiert. Image 2.45.5 ist bereits geladen; ein Pull allein verändert einen laufenden Container nicht. Nach stabilisiertem Betrieb wäre der reguläre Weg: aktuelle Sicherung, Compose-Image auf einen geprüften festen Zielstand setzen und ausschließlich Dienst n8n mit dem neuen Image neu erstellen. Datenbankmigrationen können einen Rückbau zusammen mit dem passenden Datenbackup erfordern. Kein weiterer unbeschränkter Parallelbetrieb auf diesem gemeinsam genutzten Pi. Die folgenden Absätze protokollieren Vorbereitung und Störung vor der Wiederherstellung.
n8n läuft auf Raspberry Pi raspberrypi5 (192.168.2.49), Debian GNU/Linux 12 (bookworm), aarch64; Docker Engine 28.3.1 und Docker Compose 2.38.1. Produktiver Container n8n, bisher Version 2.7.5 aus Image n8nio/n8n, Compose-Projekt /home/lars/n8n/docker-compose.yml, Dienst n8n. Persistente Daten im Docker-Volume n8n_n8n_data unter /home/node/.n8n; zusätzliche Bind-Einhängung /mindnet → /data/mindnet. Das NAS ist HTTPS-Proxy, kein n8n-Containerhost.
Am 28.10. wurde 2.45.5 als offizieller stabiler Stand über npm-Dist-Tags und Herstellerrelease bestätigt. Image n8nio/n8n:2.45.5 geladen, Registry-Digest sha256:9f6d0a5987ab5a297c4b0b38fbf1a22285dd1364551478e93f03d506908fa74c. Ursprüngliches Image lokal weiter vorhanden: sha256:e5438c4c4cd05211840006910ca860ab962280a0c41f4a526b1643b2aab08e6a.
Sicherung: /home/lars/n8n-backups/upgrade-20261028T080618Z, nur für den Eigentümer zugänglich. Enthält ursprüngliche Compose-Datei, Containerkonfiguration, konsistenten SQLite-Snapshot über VACUUM INTO, übrige Datenvolume-Dateien einschließlich Schlüsselkonfiguration und Community-Paket n8n-nodes-imap 2.14.1 sowie tokenfreie Bestandszahlen/Prüffingerprints. Geheimnisse verbleiben in dieser privaten Sicherung auf demselben Pi. Bestand: 30 Workflows, 3 aktiv, 9 Credentials; SQLite-Schnellprüfung ok. Datenbank-Snapshot ist durch freigegebene SQLite-Seiten wesentlich kleiner als die laufende Datei, kein Hinweis auf fehlende Datensätze.
Testlauf: Container n8n-upgrade-test-20261028t080618z, separates Volume n8n_upgrade_test_20261028t080618z; Netzwerk none, keine veröffentlichten Ports, kein produktiver Dateimount. Nur in der Kopie wurden aktive Workflows deaktiviert und wartende Ausführungen auf abgebrochen gesetzt. Migration startete, /healthz und /healthz/readiness lieferten HTTP 200. Weitere Fingerprint-/Entschlüsselungs- und Knotentyp-Prüfungen konnten nicht abgeschlossen werden. Der Testcontainer hatte kein festes Speicherlimit; bei einem erneuten Test Ressourcen vorher begrenzen und die vorhandene Systemauslastung prüfen.
Aktuelle Störung: Während der Zusatzprüfungen reagiert der Pi weiterhin auf Ping, neue SSH-Verbindungen hängen jedoch beim Banner-Austausch. Auch n8n- und Portainer-HTTP-Prüfungen laufen in Zeitüberschreitungen. Speicher-/Ressourcenengpass ist ein Verdacht, kein belegter Befund; Systemprotokolle noch nicht lesbar. Produktives Compose und produktives Volume wurden nicht auf die neue Version umgestellt. Die gezielten Stoppversuche über SSH konnten noch nicht ausgeführt werden. Kein Neustart des gesamten Pi oder anderer Dienste durch den Agenten.
Nächster Schritt über lokale Pi-Konsole oder erreichbare Containerverwaltung: ausschließlich den Testcontainer stoppen:
docker stop -t 3 n8n-upgrade-test-20261028t080618z
Danach freien Speicher, Last und OOM-/Kernelmeldungen prüfen; Gesundheit und Version des ursprünglichen Containers n8n kontrollieren. Erst anschließend über Fortsetzung entscheiden. Ein Downgrade nach späterer produktiver Datenbankmigration würde neben dem alten Image auch eine passende vollständige Datensicherung benötigen; kein down -v, keine pauschale Container-/Volume-Bereinigung. Die Zugangsnotizen im vorherigen Abschnitt beschreiben die Befunde vor diesem Upgradeversuch.
Fotos aus dem alten WordPress übernehmen
Die Auswahl (39 aktuelle Fotos: Wohnung, Garten/Terrasse/Luftbilder, Umgebung – ohne Theme-Platzhalter, Logos, Vorschaugrößen und veraltete Einrichtung) mit Kategorie und Bildbeschreibung steht in database/data/wordpress-photos.csv. Der Import liest die Dateien nur aus dem WordPress-Ordner (dort wird nichts verändert), legt Original + WebP-Größen in shared/storage/app/public ab und überspringt bereits importierte Fotos (wiederholbar):
bash scripts/deploy.sh staging artisan photos:import /mnt/web508/e3/26/51539426/htdocs/www.fewo-stommer.de/wp-content/uploads --manifest=database/data/wordpress-photos.csv
Danach in der Verwaltung (Webseite › Fotos) Reihenfolge, Sichtbarkeit und Texte prüfen.
- Gitea-Runner für automatisches Deployment (DEPLOYMENT.md §5).
7. Zugang zur Verwaltung (/admin)
Benutzer anlegen – der erste Administrator per Befehl (das Passwort wird verdeckt im eigenen Terminal eingegeben, nie als Argument):
ssh -t -i ~/.ssh/strato_fewo stu100093250@51539426.ssh.w1.strato.hosting \
"cd test.fewo-stommer.de/current && /opt/RZphp84/bin/php-cli artisan users:create lars@stommer.com --name='Lars Stommer' --role=admin"
Weitere Benutzer legt ein Administrator in der Verwaltung an (System › Benutzer): Name, E-Mail, Rolle (was die Person darf) und Ansicht (was das Menü zeigt), Passwort. Rollen: admin (alles inkl. Benutzer), rentals (Vermietung), content (Inhalte); ohne Rolle kein Zugang. Festlegung 22.10.2026: Lars und Brigitte beide admin (dürfen alles); Brigitte mit einfacher Ansicht (beim Anlegen „Ansicht: Einfach“ wählen, sonst erhalten Administratoren die Expertenansicht).
Ansichten: Einfache Ansicht – Anfragen & Buchungen (Angebot senden, Mietvertrag, Zahlungen), Sperrzeiten, Preise & Angebote (Saisons, Sonderangebote/Rabattcodes, Extras), Gäste, Portal-Aufgaben, Bewertungen, Bilder. Expertenansicht – alle Einstellungen, die die Rolle erlaubt (Preise, Angebote, Portale, Webseite, System). Ohne Auswahl: Administratoren Experten-, alle anderen einfache Ansicht. Umschalten jederzeit über das Benutzermenü oben rechts („Zur … Ansicht wechseln“). Die Ansicht blendet nur Menüpunkte aus; Rechte regelt allein die Rolle.
Passwort vergessen: Ein Administrator vergibt unter System › Benutzer › Bearbeiten ein neues Passwort (eine Selbst-Zurücksetzung per E-Mail gibt es bewusst nicht). Handy verloren: dort Aktion „2FA zurücksetzen“ – die Person richtet die 2FA bei der nächsten Anmeldung neu ein.
Zwei-Faktor-Anmeldung (2FA): Filament-eigene Lösung mit Authenticator-App (TOTP, z. B. Bitwarden/Vaultwarden, Google oder Microsoft Authenticator) und Wiederherstellungscodes.
- Pflicht für alle Konten (Entscheidung 22.10.2026): Nach der ersten Anmeldung wird man auf die Einrichtungsseite geleitet (QR-Code scannen, Code bestätigen, Wiederherstellungscodes sichern). Filament-Standard (
multiFactorAuthentication(isRequired: true)). - Schlüssel und Codes liegen verschlüsselt (mit
APP_KEY) inusers.app_authentication_secret/app_authentication_recovery_codes. - Handy verloren: Anmeldung mit einem Wiederherstellungscode. Sind auch die weg, setzt ein Administrator mit Serverzugang die 2FA zurück:
Danach bei der nächsten Anmeldung neu einrichten.
bash scripts/deploy.sh staging artisan tinker --execute='App\Models\User::where("email", "lars@stommer.com")->update(["app_authentication_secret" => null, "app_authentication_recovery_codes" => null]);'
Lokal (nur Entwicklung, php artisan migrate:fresh --seed): admin@example.com / password, 2FA wird bei der ersten Anmeldung eingerichtet.
7a. Datensicherung, Löschfristen, Automationen
- Datenbank-Backup: täglich 02:30 per Scheduler (
php artisan backup:database) alsshared/storage/app/private/backups/fewo-<datum>.sql.gz; es bleiben die neuesten 14 (FEWO_BACKUP_KEEP). Wiederherstellen: Datei entpacken und mitmysqlbzw. phpMyAdmin (Strato) einspielen. - Sicherung aufs NAS / einen Rechner (holt eine frische Datenbank-Sicherung plus Fotos und Verträge; auf dem Server wird nichts verändert):
Regelmäßig z. B. per Aufgabenplanung des NAS/PC ausführen (braucht den SSH-Schlüssel aus §4).
bash scripts/backup-pull.sh staging /pfad/zum/nas/fewo-backup - Löschfristen (Vorschläge, rechtlich zu bestätigen –
config/fewo.phpbzw..env): Gästedaten 10 Jahre nach letztem Aufenthalt (FEWO_GUEST_RETENTION_YEARS), nie verbindlich gewordene Anfragen/Angebote 6 Monate (FEWO_RETENTION_INQUIRY_MONTHS), Textauszüge von Portal-Mails 90 Tage (FEWO_RETENTION_PORTAL_EMAIL_EXCERPT_DAYS), Herkunftsangaben/UTM 24 Monate (FEWO_RETENTION_ATTRIBUTION_MONTHS). Läuft täglich 03:00. Anonymisierung ersetzt Name, Kontaktdaten, Nachrichten, Notizen, Herkunft und Bewertungs-Anzeigenamen; Buchung, Preise und Zahlungen bleiben als Beleg. - Testberichte des Prozess-Testers: 30 Tage (
FEWO_RETENTION_PROCESS_TEST_RUN_DAYS, Entscheidung O3; System › Einstellungen › Löschfristen), gelöscht vom selben täglichen Lauf. Sie enthalten nur synthetische Testdaten. - Bot-Schutz der Buchungsanfrage (ohne externen Captcha-Dienst,
config/fewo.php › spam): verstecktes Köderfeld, Zeitsperre (Absenden schneller als 4 s nach dem Öffnen = Bot, wird still ignoriert), höchstens 5 Anfragen/Stunde je IP, 3/Tag je E-Mail-Adresse, 30/Stunde insgesamt, höchstens 2 gleichzeitig vorgemerkte Anfragen je E-Mail-Adresse (sonst könnten Bots den Kalender blockieren), keine Links in Namen und höchstens 1 Link in der Nachricht. - Automationen (n8n): Token bitte als Header
Authorization: Bearer <token>senden (landet nicht in Server-Logs);?token=funktioniert übergangsweise weiter. - HTTPS:
App\Http\Middleware\ForceHttpsleitet HTTP-Aufrufe (GET/HEAD 301, sonst 308) auf HTTPS um, in der Anwendung statt in der.htaccess– diese wird bei jedem Deployment neu geschrieben. Abschaltbar mitFEWO_FORCE_HTTPS=false. Zusätzlich sollte in Strato „SSL erzwingen“ aktiv sein, falls das Paket die Option anbietet. - Restore-Test (30.10.2026, lokal, SQLite): Dump mit
backup:databaseaus einer frisch migrierten und gesäten Datenbank, in eine leere Datei zurückgespielt: 42 von 42 Tabellen, alle Zeilenzahlen gleich, 66 Migrationen „Ran“, keine ausstehend. Für MariaDB (Strato) steht der Nachweis noch aus: Dump mitbackup:databaseerzeugen, in eine zweite, leere Strato-Datenbank per phpMyAdmin/mysqleinspielen und Zeilenzahlen vonbookings,guests,pages,channelsvergleichen. Die Produktionsdatenbank wird dabei nicht verändert. - Fotos: Beim Hochladen werden Metadaten (GPS, Kamera) aus dem Original entfernt; bestehende Fotos einmalig:
php artisan photos:strip-metadata(--forcebearbeitet auch bereits markierte erneut). Hinweis: bewusst mit GD – Imagick (auf Strato installiert) behält EXIF beim Speichern.
7b. Prozess-Tester und Prozesskern (Architektur V2)
- Was er ist: Kanal › Ablauf › „Ablauf testen“ spielt ausgedachte Vorgänge mit der (auch ungespeicherten) Einstellung durch – in einem eigenen PHP-Prozess (
php artisan process:sandbox-run), der nur eine eigene SQLite-Datei je Lauf (shared/storage/app/sandbox/runs/<lauf>/), den Mailerarray, den Cachearrayund Netzantworten des Szenarios kennt. Details:docs/Prozessarchitektur/Architektur/04_PROZESS_TESTER.md. - Voraussetzungen auf dem Server (sonst ist der Tester gesperrt und sagt warum): PHP-Erweiterung
pdo_sqlite(CLI: vorhanden, 04.11.2026), erlaubtesproc_openim Web-PHP, PHP-CLI unter/opt/RZphp84/bin/php-cli(abweichend:FEWO_SANDBOX_PHPinshared/.env), Vorlageshared/storage/app/sandbox/template.sqlite– sie entsteht bei jedem Deployment (php artisan process:sandbox-templatenachmigrate,pipeline.toml). - Grenzen (Restrisiko, dokumentiert): Shared Hosting bietet keine Trennung auf Betriebssystemebene. Der Testprozess läuft unter demselben Systembenutzer; nativer PHP-Code könnte
shared/.envlesen. Die Anwendung verhindert das über die ersetzte Konfiguration, entzogene Umgebungsvariablen und den statischenSideEffectPathsTest, der native Netz-, Mail-, Datenbank- und Dateizugriffe inapp/verbietet. - Grenzen der Last: höchstens 1 Lauf je Mandant, 3 gleichzeitig, 20 s und 60 Ereignisse je Lauf, Abbruch nach 30 s. Abgebrochene Laufverzeichnisse räumt der nächste Lauf (älter als 1 h).
- Prüfbefehle:
bash scripts/deploy.sh staging artisan process:check --cases(Katalog und eingefrorene Pläne aller Vorgänge),… artisan process:fingerprint(Prüfsummen von Vorgängen, Kanalkonfiguration und Sperren; vor und nach einem Deployment vergleichen),… artisan process:impact <modul>.
8. Bekannte Eigenheiten und Lösungen
| Problem | Ursache | Lösung (umgesetzt) |
|---|---|---|
| Nach dem Umschalten lief die alte Version weiter | Strato-OPcache speichert Skripte unter dem Symlink-Pfad current/… |
.htaccess zeigt auf den konkreten Ordner releases/<version>/public und wird bei jedem Umschalten neu geschrieben |
Links mit /current/public (z. B. Sitemap) |
Laravel leitet den Basis-Pfad aus dem Skript-Pfad ab | URL::forceRootUrl(APP_URL) außerhalb von local/testing (AppServiceProvider) |
| HTTP 500 „Composer platform“ | Web-PHP des Pakets ist 8.3 | AddType application/x-httpd-php84 .php in der Ordner-.htaccess |
| Im Admin hochgeladenes Foto erscheint in der Fotoliste, auf der Website/im Grundriss-Editor aber als leeres Bild (HTTP 403) | Upload-Feld nahm Filaments Standard-Speicher FILESYSTEM_DISK=local (privat, storage/app/private/<media-id>); Import und Website nutzen public |
Seit 23.10.2026 (1871c04): Fotos immer auf public (Photo-Sammlung useDisk('public'), Upload-Feld ->disk('public')); Migration 2026_10_23_171001_move_photo_media_to_the_public_disk hat vorhandene private Fotos verschoben (stommer.info: Foto 41). Direkt nach dem Verschieben kann Strato die Adresse kurz noch mit 403 beantworten |
| SSH „connection closed“ | falscher Server ssh.strato.de |
paketspezifischer Server (§2) |
Domain-Ziel current/public nicht wählbar |
Strato erlaubt kein Symlink-Ziel | Domain auf den Deploy-Ordner, .htaccess leitet weiter |
| Ersteinrichtung mit Factories schlägt fehl | Produktion ohne Dev-Pakete | ProductionSeeder |
| Kein SSL für Subdomain | Paket erlaubt SSL nur für Hauptdomains | Testbetrieb auf stommer.info |
Disk quota exceeded beim Hochladen / Hinweis „zu viele Dateien“ |
Webspace-Kontingent voll (geteilt mit allen anderen Seiten/Backups im Paket); jede Version belegt ~136 MB | Es ist die Anzahl der Dateien (Inode-Limit), nicht der Platz. Der Server behält nur die aktive Version (Geschichte als Git-Tags in Gitea), vendor wird beim Build ausgedünnt (~15.000 statt ~19.500 Dateien je Version); Reste abgebrochener Läufe räumt das nächste Deployment selbst weg. Ordner außerhalb des Deploy-Ordners entscheidet nur Lars (teils produktiv). |
| Signierte Links (Angebot, Bewertung, Newsletter, Vorschau) mit 403 | Strato meldet nach der .htaccess-Weiterleitung den internen Pfad /releases/<version>/public/… in REQUEST_URI |
public/index.php entfernt dieses Präfix vor dem Start von Laravel |
| Keine E-Mails im Testbetrieb, auch nicht im Protokoll | MAIL_MAILER=log schreibt auf Stufe debug, LOG_LEVEL=info verwirft das |
Zum Testen SMTP einschalten; FEWO_MAIL_REDIRECT_TO leitet dann alle Mails an eine Adresse (gesetzt: lars@stommer.com) |
| Foto-Metadaten (GPS) blieben erhalten | Spatie Image nutzt Imagick, wenn installiert (Strato), und Imagick behält EXIF | StripImageMetadata erzwingt GD |
Windows: Symlinks, php nicht im PATH |
Git Bash | Deploy nur gegen Strato testen; export PATH="<php-ordner>:$PATH" |
9. Nützliche Befehle
bash scripts/deploy.sh staging deploy # ausliefern (letzter Commit)
bash scripts/deploy.sh staging releases # aktive Version + Deploy-Tags in Git
bash scripts/deploy.sh staging deploy deploy/staging/<zeitstempel> # frühere Version erneut ausliefern
bash scripts/deploy.sh staging artisan about # Zustand der Installation
bash scripts/deploy.sh staging artisan migrate:status
ssh -i ~/.ssh/strato_fewo stu100093250@51539426.ssh.w1.strato.hosting \
"tail -n 50 test.fewo-stommer.de/shared/storage/logs/laravel-$(date +%F).log" # Fehlerprotokoll