docs: add Plesk admin notes and GoAccess web stats

Document Git/Composer capabilities, hosting settings, and backlog todo 10;
record switch from AWStats to GoAccess.

Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
Frank Schwenk
2026-06-11 22:44:38 +02:00
parent 5683aef943
commit 04e1455d9f
5 changed files with 138 additions and 1 deletions
+2
View File
@@ -95,6 +95,8 @@ Plesk: **Websites & Domains → Geplante Aufgaben → Aufgabe planen**
Screenshot-Referenz: Plesk „Aufgabe planen“ (PHP-Skript, Cron-Stil, PHP-Version).
Weitere Plesk-Funktionen (Git, Composer, Hosting-Einstellungen): [`PLESK.md`](PLESK.md)
## Beziehung zu boka
```
+94
View File
@@ -0,0 +1,94 @@
# Plesk — Admin-Notizen
Entdeckte Funktionen und Einstellungen im Plesk-Adminbereich für `0012.de`.
Stand: 2026-06-11. Kein unmittelbarer Umsetzungsbedarf — Referenz für spätere Entscheidungen.
Siehe auch: [`HOSTING.md`](HOSTING.md)
---
## Git-Repositorys
Plesk: **Websites & Domains → 0012.de → Git-Repositorys**
Zwei Modelle:
| Modell | Ablauf | Wann sinnvoll |
|--------|--------|---------------|
| **Remote-Repository** | Code bei GitHub/GitLab/Bitbucket oder eigenem Git-Server; Plesk **pullt** | CI/CD-light: Push ins Remote → Plesk holt bei Deploy |
| **Lokales Repository** | Code auf Laptop o. ä.; du **pushst** auf Plesk-Git-Endpoint | Kein öffentliches Remote nötig; Plesk als Git-Remote |
### Aktueller Stand im Projekt
Deploy läuft über **`scripts/deploy.sh`** (FTPS):
- `public/` → `httpdocs/`
- `config/` + `.env` → `private/` (manuell mit deploy.py, `.env` nie im Git)
### Wenn Git in Plesk genutzt wird (später)
- Repo-Root in Plesk ≠ Document Root — **Deploy-Aktion** oder Post-Receive-Hook nötig, um nur `public/` nach `httpdocs/` zu spiegeln
- `.env` bleibt **außerhalb Git** (Plesk-Geheimnisse oder weiter manuell nach `private/.env`)
- Remote-Variante passt gut zu **GitLab** (dieses Repo), wenn Remote-URL + Deploy-Key/Token in Plesk hinterlegt werden
- Entscheidung offen: FTPS beibehalten (einfach, funktioniert) vs. Plesk-Git (weniger manuell, mehr Plesk-Konfiguration)
---
## PHP Composer
Plesk: **Websites & Domains → 0012.de → PHP Composer**
- Sucht `composer.json` im **Stammverzeichnis des Abonnements** (`/`, nicht nur `httpdocs/`)
- Button „Suchen“ findet Anwendung und erlaubt `composer install` aus dem Panel
### Aktueller Stand
- **Keine** `composer.json` im Projekt — bewusst schlanke Plain-PHP-Lösung (Monitoring, Landing)
- Sinnvoll erst bei echten Abhängigkeiten, z. B.:
- PHPMailer für SMTP
- HTTP-Client-Bibliothek
- Dann: `composer.json` im Repo-Root, `vendor/` in `.gitignore`, nach Deploy `composer install` (lokal, per SSH falls verfügbar, oder Plesk Composer UI)
---
## Hosting-Einstellungen (Screenshot)
Plesk: **Hosting-Einstellungen** (bzw. Hosting & DNS → Hosting-Einstellungen)
### Webstatistiken
| Einstellung | Aktuell | Optionen |
|-------------|---------|----------|
| Tool | **GoAccess** | Deaktiviert, AWStats (Veraltet), Webalizer |
| Zugriffsschutz | **an** — FTP-User/Passwort | — |
Stand 2026-06-11: von AWStats auf GoAccess umgestellt.
**Notiz:** GoAccess liefert moderne Traffic-Auswertung im Panel. Für Monitoring der *eigenen* Dienste (boka, schwenk.online, …) irrelevant — das macht `monitor.php`.
### Web-Scripting
| Feature | Aktuell | Relevanz für 0012.de |
|---------|---------|----------------------|
| FastCGI | aus | PHP läuft über Plesk-PHP-Handler (FPM); Toggle meist legacy |
| CGI | aus | nicht benötigt |
| SSI | **an** | nicht nötig für reines PHP; harmlos |
| Benutzerdefinierte Fehlerdokumente | **an** | später eigene 404/50x in `httpdocs/error_docs/` möglich |
Keine Änderung empfohlen, solange PHP-Seiten normal laufen.
---
## Plesk-Pfade (Referenz)
| Pfad | Inhalt |
|------|--------|
| `httpdocs/` | Document Root (öffentlich) |
| `private/` | Nicht öffentlich — `.env`, `config/`, `data/` |
| `/` (Abonnement-Root) | Root für Composer-Suche, Git-Checkout je nach Konfiguration |
---
## Backlog
Optionale spätere Aufgabe: [`todo/10-optional-plesk-git-composer.md`](todo/10-optional-plesk-git-composer.md)
+1 -1
View File
@@ -19,7 +19,7 @@ Dieser Webspace ist bewusst **unabhängig vom vServer `boka`** (Webtropia Cloud
- **Paket:** Classic 1.0 / 15 GB, Traffic unlimitiert ([Produktseite](https://wint.global/linux-hosting-pakete-plesk/))
- **Domain:** `0012.de`
- **Panel:** Plesk auf `ha01s019.org-dns.com`
- **Details:** [`HOSTING.md`](HOSTING.md)
- **Details:** [`HOSTING.md`](HOSTING.md), Plesk-Notizen: [`PLESK.md`](PLESK.md)
Zugangsdaten gehören in `.env` (Vorlage: [`.env.example`](.env.example)). **Niemals committen.**
+36
View File
@@ -0,0 +1,36 @@
# 10 — Optional: Plesk Git & Composer
**Priorität:** backlog (optional)
**Status:** notiert, nicht geplant
**Abhängigkeiten:** keiner
**Referenz:** [`../PLESK.md`](../PLESK.md)
## Ziel
Evaluieren, ob FTPS-Deploy durch Plesk-Git oder Composer im Panel ergänzt/ersetzt werden soll.
## Auslöser
Im Plesk-Admin entdeckt:
- **Git-Repositorys** — Remote-Pull (GitLab/GitHub) oder Local-Push auf Plesk
- **PHP Composer** — sucht `composer.json` im Abonnement-Root
Aktuell ausreichend: `scripts/deploy.sh` (FTPS).
## Entscheidungspunkte
- [ ] Remote-GitLab in Plesk verknüpfen vs. FTPS beibehalten?
- [ ] Post-Deploy-Hook: `public/` → `httpdocs/`, Secrets nach `private/`?
- [ ] `composer.json` einführen (z. B. PHPMailer) — ja/nein?
- [x] Webstatistiken: AWStats → GoAccess (2026-06-11)
## Akzeptanzkriterien (falls umgesetzt)
- Deploy ohne manuelles FTPS nach `git push`
- `.env` weiterhin nicht im Repository
- Dokumentation in README/PLESK.md aktualisiert
## Nicht jetzt
Kein Blocker für Todo 02–09. Erst prüfen, wenn Monitoring stabil läuft oder Composer-Deps anstehen.
+5
View File
@@ -13,6 +13,11 @@ Nummerierte Todos für den 0012.de-Webspace. Abhängigkeiten beachten.
| 07 | [07-mail-domains-external.md](07-mail-domains-external.md) | **medium** | MX für Domains ohne Mailserver |
| 08 | [08-monitoring-phase2.md](08-monitoring-phase2.md) | **medium** | API-Health, Latenz, Backup-Heartbeat |
| 09 | [09-monitoring-phase3.md](09-monitoring-phase3.md) | **low** | Rest-Domains, Dashboard, Header-Checks |
| 10 | [10-optional-plesk-git-composer.md](10-optional-plesk-git-composer.md) | backlog | Plesk Git / Composer evaluieren |
## Backlog (ohne Priorität)
Todo **10** — Plesk Git-Deploy und Composer; dokumentiert in [`../PLESK.md`](../PLESK.md), kein Blocker für 02–09.
## Empfohlene Reihenfolge