Files
customer-installer/README.md

106 lines
2.0 KiB
Markdown
Raw Blame History

This file contains invisible Unicode characters
This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
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.
# Customer Installer Proxmox LXC n8n Stack
## Überblick
Dieses Projekt automatisiert die Bereitstellung **DSGVOkonformer KundenLXCs** auf einem **ProxmoxCluster**.
Pro Kunde wird **eine eigene LXC** erstellt, inklusive:
- Debian 12
- Docker + Docker Compose Plugin
- PostgreSQL + pgvector
- n8n
- Vorbereitung für Reverse Proxy (OPNsense / NGINX)
- VLANAnbindung
- APT & DockerProxy (AptCacher NG)
Ziel: **reproduzierbare, schnelle und saubere KundenSetups**, vollständig skriptgesteuert.
---
## Architektur
```
Internet
OPNsense (os-nginx, TLS, Wildcard-Zertifikat)
VLAN 90
Proxmox LXC (Debian 12)
├── Docker
│ ├── n8n
│ └── PostgreSQL (pgvector)
└── Kunden-Daten (isoliert)
```
---
## Voraussetzungen
### Proxmox Host
- Proxmox VE (Clusterfähig)
- Zugriff auf:
- `pct`
- `pvesm`
- `pveam`
- Storage für LXCs (z.B. `local-zfs`)
- Bridge (z.B. `vmbr0`)
- VLANfähiges Netzwerk
### Netzwerk / Infrastruktur
- OPNsense Firewall
- VLAN (Standard: **VLAN 90**)
- WildcardZertifikat auf OPNsense
- osnginx Plugin aktiv
- AptCacher NG:
- HTTP: `http://192.168.45.2:3142`
- Docker Registry Mirror:
- `http://192.168.45.2:5000`
---
## Projektstruktur
```
customer-installer/
├── install.sh
├── libsupabase.sh
├── setupowner.sh
├── templates/
│ └── docker-compose.yml
└── README.md
```
---
## Installation
```bash
bash install.sh --storage local-zfs --bridge vmbr0 --ip dhcp --vlan 90
```
---
## Automatisierte Schritte
1. Template-Download (Debian 12)
2. CTID-Generierung (Unix-Zeit - 1.000.000.000)
3. LXC-Erstellung + VLAN
4. Docker + Compose Installation
5. APT & Docker Proxy Konfiguration
6. n8n + PostgreSQL Stack
7. Ausgabe aller Zugangsdaten als JSON
---
## Status
✅ produktiv einsetzbar
🟡 Reverse Proxy Automatisierung ausgelagert
🟡 Workflow & Credential Import separat
---
## Lizenz / Hinweis
Internes Projekt kein Public Release.