1a91f2304442197bbc293a77fbe0896d2cbd3d35
- Add Wiki home page with navigation - Add Installation guide with all parameters - Add Credentials-Management documentation - Add Testing guide with all test suites - Add Architecture documentation with diagrams - Add Troubleshooting guide with solutions - Add FAQ with common questions Wiki includes: - Complete installation instructions - Credentials management workflows - Testing procedures (40+ tests) - System architecture diagrams - Troubleshooting for common issues - FAQ covering all aspects - Cross-referenced documentation
Customer Installer – Proxmox LXC n8n Stack
Überblick
Dieses Projekt automatisiert die Bereitstellung DSGVO‑konformer Kunden‑LXCs auf einem Proxmox‑Cluster. Pro Kunde wird eine eigene LXC erstellt, inklusive:
- Debian 12
- Docker + Docker Compose Plugin
- PostgreSQL + pgvector
- n8n
- Vorbereitung für Reverse Proxy (OPNsense / NGINX)
- VLAN‑Anbindung
- APT‑ & Docker‑Proxy (Apt‑Cacher NG)
Ziel: reproduzierbare, schnelle und saubere Kunden‑Setups, 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:
pctpvesmpveam
- Storage für LXCs (z. B.
local-zfs) - Bridge (z. B.
vmbr0) - VLAN‑fähiges Netzwerk
Netzwerk / Infrastruktur
- OPNsense Firewall
- VLAN (Standard: VLAN 90)
- Wildcard‑Zertifikat auf OPNsense
- os‑nginx Plugin aktiv
- Apt‑Cacher NG:
- HTTP:
http://192.168.45.2:3142
- HTTP:
- 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 install.sh --storage local-zfs --bridge vmbr0 --ip dhcp --vlan 90
Automatisierte Schritte
- Template-Download (Debian 12)
- CTID-Generierung (Unix-Zeit - 1.000.000.000)
- LXC-Erstellung + VLAN
- Docker + Compose Installation
- APT & Docker Proxy Konfiguration
- n8n + PostgreSQL Stack
- Ausgabe aller Zugangsdaten als JSON
Status
✅ produktiv einsetzbar
🟡 Reverse Proxy Automatisierung ausgelagert
🟡 Workflow & Credential Import separat
Lizenz / Hinweis
Internes Projekt – kein Public Release.
Description
Languages
Shell
77%
PLpgSQL
23%