Files
fewo-stommer/docs/BETRIEB.md

240 lines
35 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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](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 in `shared/.env` auf 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 |
| E-Mail | `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](DEPLOYMENT.md).
## 2. Strato-Paket (Hosting Pro)
- **SSH/SFTP-Server:** `51539426.ssh.w1.strato.hosting` (paketspezifisch, *nicht* `ssh.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 `.htaccess` im Deploy-Ordner setzt per `AddType application/x-httpd-php84 .php` 8.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 von `DEPLOY_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: Ordner `test.fewo-stommer.de`, SSL aktiv, `www.stommer.info` ebenso). Die Subdomain `test.fewo-stommer.de` wird nicht mehr gebraucht.
- **Domain-Ziel = Deploy-Ordner selbst** (Strato kann kein Symlink-Ziel wählen). Die dort vom Skript geschriebene `.htaccess` leitet auf `releases/<aktive Version>/public` und sperrt alles Interne mit 403.
## 3. Datenbank (staging)
- Host `database-5021719836.webspace-host.com`, Port 3306, Datenbank `dbs16257975`, Benutzer `dbu2231025`, `DB_CONNECTION=mariadb`.
- Passwort: nur in `test.fewo-stommer.de/shared/.env` (und Vaultwarden).
## 4. SSH-Zugang einrichten (neuer Rechner, z. B. privater PC)
1. Schlüssel erzeugen: `ssh-keygen -t ed25519 -f ~/.ssh/strato_fewo -C "fewo-deploy <rechner>"`.
2. Ö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 ohne `ssh-copy-id`: Inhalt von `strato_fewo.pub` per SSH an `~/.ssh/authorized_keys` anhängen.)
3. Test: `ssh -i ~/.ssh/strato_fewo stu100093250@51539426.ssh.w1.strato.hosting "ls"`.
4. Den privaten Schlüssel nur im Vaultwarden sichern, nie committen oder weitergeben.
5. **Aufräumen:** Der Schlüssel des Firmen-Laptops (Kommentar in `~/.ssh/authorized_keys` auf 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](../.env.production.example). Bearbeiten nur direkt auf dem Server, damit Passwörter nicht durch Chat oder Repository laufen:
```bash
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.
- **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_USERNAME` passen – das Formular warnt). Ohne Eintrag gelten `FEWO_NOTIFICATION_EMAIL`, `FEWO_OWNER_EMAIL`, `MAIL_FROM_*` aus `shared/.env`.
- `FEWO_MAIL_REDIRECT_TO` in `shared/.env` ist 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 in `shared/.env` `MAIL_MAILER=smtp` und `MAIL_PASSWORD=<Passwort des Postfachs info@fewo-stommer.de>` (nur selbst eintragen; Absender und SMTP-Anmeldung: `info@fewo-stommer.de`, Antwortadresse und Benachrichtigungen weiter `FEWO_OWNER_EMAIL`/`FEWO_NOTIFICATION_EMAIL` = fewo@stommer.de), dann `bash 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](../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](http://localhost:15678/workflow/23581e4b70324812) 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](https://github.com/n8n-io/n8n-docs/blob/main/docs/deploy/host-n8n/configure-n8n/use-the-command-line.md) 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](https://github.com/n8n-io/n8n/security/advisories/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://localhost:15678/workflow/23581e4b70324812). 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:
```sh
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](https://github.com/n8n-io/n8n-docs/blob/main/docs/deploy/host-n8n/configure-n8n/security/set-up-ssl.md). 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](https://github.com/n8n-io/n8n/releases/tag/n8n%402.45.5) 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:
```sh
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](../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
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):
```bash
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`) in `users.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:
```bash
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]);'
```
Danach bei der nächsten Anmeldung neu einrichten.
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`) als `shared/storage/app/private/backups/fewo-<datum>.sql.gz`; es bleiben die neuesten 14 (`FEWO_BACKUP_KEEP`). Wiederherstellen: Datei entpacken und mit `mysql` bzw. 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):
```bash
bash scripts/backup-pull.sh staging /pfad/zum/nas/fewo-backup
```
Regelmäßig z. B. per Aufgabenplanung des NAS/PC ausführen (braucht den SSH-Schlüssel aus §4).
- **Löschfristen** (Vorschläge, rechtlich zu bestätigen – `config/fewo.php` bzw. `.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.
- **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.
- **Fotos:** Beim Hochladen werden Metadaten (GPS, Kamera) aus dem Original entfernt; bestehende Fotos einmalig: `php artisan photos:strip-metadata` (`--force` bearbeitet auch bereits markierte erneut). Hinweis: bewusst mit GD – Imagick (auf Strato installiert) behält EXIF beim Speichern.
## 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
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
```