Container Spawner

Ein Flask-basierter Service zur automatischen Bereitstellung von isolierten Docker-Containern pro Benutzer mit Traefik-Integration. Benutzer registrieren sich, erhalten einen eigenen Container und eine personalisierte Subdomain.

Features

User-Management: Registrierung und Login mit sicherer Passwort-Speicherung
Automatisches Container-Spawning: Jeder User erhaelt einen eigenen Docker-Container
Dynamisches Routing: Traefik routet automatisch zu den User-Containern via Subdomain
Resource-Management: CPU- und RAM-Limits pro Container
Lifecycle-Management: Starten, Stoppen und Neustarten von User-Containern
Template-basiert: Neue User-Container aus vorgefertigten Images

Schnellstart

# Installation mit einem Befehl
curl -sSL https://gitea.iotxs.de/RainerWieland/spawner/raw/branch/main/install.sh | bash

Nach der Installation .env anpassen und erneut ausfuehren:

cp .env.example .env
nano .env  # Werte anpassen
bash install.sh

Voraussetzungen

Docker 20.10+
Docker Compose 2.0+
Traefik 2.x oder 3.x (laufend)
Bestehendes Docker-Netzwerk fuer Traefik

Dokumentation

Dokument	Beschreibung
Installation	Installationsanleitung und Updates
Architektur	Technische Architektur und Komponenten
Sicherheit	Sicherheitsrisiken und Massnahmen
Versionen	Changelog und Versionierung
Bekannte Bugs	Bekannte Probleme und Workarounds
Best Practices	Dos and Don'ts

Projektstruktur

spawner/
├── app.py                 # Flask-Hauptanwendung
├── auth.py                # Authentifizierungs-Blueprint
├── container_manager.py   # Docker-Container-Management
├── models.py              # SQLAlchemy User-Modell
├── config.py              # Konfigurationsklassen
├── templates/             # Jinja2-Templates (Legacy)
├── frontend/              # Next.js Frontend
├── user-template/         # Docker-Template fuer User-Container
└── docs/                  # Dokumentation

Konfiguration

Alle Einstellungen erfolgen ueber Umgebungsvariablen in .env:

Variable	Beschreibung
`SECRET_KEY`	Flask Session Secret (generieren!)
`BASE_DOMAIN`	Haupt-Domain (z.B. example.com)
`SPAWNER_SUBDOMAIN`	Subdomain fuer Spawner-UI
`TRAEFIK_NETWORK`	Docker-Netzwerk fuer Traefik
`USER_TEMPLATE_IMAGE`	Docker-Image fuer User-Container

Siehe .env.example fuer alle Optionen.

Lizenz

MIT License - siehe Dokumentation fuer Details.

Version: 0.1.0 Repository: https://gitea.iotxs.de/RainerWieland/spawner

2.8 KiB Raw Blame History