Nirodan
98bb34f094
- Fix AttributeError crash on empty request body in md5, hasher, textdiff,
jwtdecoder, timestamp, passwordgen (get_json without silent=True / or {})
- Fix memory exhaustion in ipcalc: replace list(network.hosts()) with direct
arithmetic — safe for /8 and larger networks
- Fix O(1M) loop in cronexplainer.get_next_runs: rewrite to skip by
month/day/hour instead of iterating every minute
- Fix connection leak in notes.ensure_table: add try/finally around conn.close
- Fix admin._ensure_tables / notes._ensure_table running DDL on every request:
guard with module-level flags (_tables_initialized, _table_ready)
- Fix update_website returning 200 when no row matched; delete_website returning
success when nothing was deleted; add rowcount checks for both
- Add role validation in admin create_user / update_user (_VALID_ROLES guard)
- Add delimiter length guard in csvviewer (csv.reader requires single char)
- Fix loremipsum: wrap int(count) in try/except ValueError → 400 response
- Fix auth/token: use auth_header[7:] instead of fragile .replace()
- Fix app.py: remove duplicate import sys; cache DB liveness check with 30s TTL
to avoid a new TCP connection on every frontend page load; move api/setup
path guard before DB check
- Replace FileHandler with RotatingFileHandler (5 MB / 3 backups) in logger;
fix relative log paths to absolute paths anchored to __file__
- Wrap all DB connections in try/finally conn.close() throughout admin and notes
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Docker-Webplattform: React + Flask + externe MariaDB
Vollständig dockerisierte Webanwendung mit React-Frontend und Flask-Backend in einem einzigen Container. Verbindet sich mit einer externen MariaDB-Datenbank und bietet Setup-System, Login, Rollenverwaltung und modulare Tools.
Screenshot
Setup-Anleitung
Voraussetzungen
- Docker & Docker Compose installiert
- Externe MariaDB/MySQL-Datenbank erreichbar (z.B. auf Unraid, NAS oder anderem Server)
1. Repository klonen
git clone https://github.com/Nirodan/Tools.git
cd Tools
2. Umgebungsvariablen konfigurieren
cp .env.example .env
Dann .env öffnen und SECRET_KEY durch einen sicheren zufälligen Wert ersetzen:
# Sicheren Key generieren:
python -c "import secrets; print(secrets.token_hex(32))"
3. Container starten
docker compose -f docker-compose.dev.yml up -d
4. Datenbank einrichten (Erststart)
Beim ersten Start öffnet sich automatisch die Setup-Seite unter http://localhost:5050/setup.
Dort die MariaDB-Verbindungsdaten eintragen:
| Feld | Beispiel |
|---|---|
| Host | 192.168.1.100 |
| Port | 3306 |
| User | tools_user |
| Password | geheimes_pw |
| Database | tools_db |
Nach dem Speichern wird automatisch ein Admin-Account angelegt:
- Benutzername:
admin - Passwort:
admin(bitte sofort im Admin-Dashboard ändern)
5. Anwendung aufrufen
http://localhost:5050
Was der Container macht
- Startet automatisch Flask + React in einer Umgebung
- Bei Erststart: Setup-Webseite zum Eintragen der DB-Verbindung
- Speichert die Konfiguration in einem Docker-Volume (
config/db_config.json) - Verbindet sich mit der externen MariaDB-Datenbank
- Erstellt automatisch ein
admin-Benutzerkonto - Liefert das React-Frontend direkt über Flask aus (keine extra Node-Instanz)
Projektstruktur
Tools/
├── backend/
│ ├── app.py # Flask-Einstiegspunkt
│ ├── admin.py # Admin-API (Nutzer- und Websitenverwaltung)
│ ├── auth/ # Login, Logout, Token-Verifikation
│ ├── tools/ # Modulare Tools (MD5 etc.)
│ └── util/ # DB-Pool, Konfiguration, Logger, Rate-Limiter
├── frontend/
│ └── src/
│ ├── App.jsx
│ ├── components/ # React-Komponenten
│ └── services/api.js # Axios-Instanz mit Auth-Interceptor
├── docker-compose.dev.yml
├── Dockerfile
├── .env.example # Vorlage für Umgebungsvariablen
└── README.md
Sicherheitshinweise
SECRET_KEYniemals im Klartext in der Versionskontrolle speichern – immer.envverwenden- Standard-Admin-Passwort (
admin) nach dem Erststart sofort ändern - MD5 ist kryptografisch unsicher – nicht für Passwort-Hashing verwenden
Lizenz
Dieses Projekt steht unter der Creative Commons BY-NC 4.0 Lizenz. Du darfst es verwenden, verändern und teilen – aber nicht kommerziell nutzen. Volltext: https://creativecommons.org/licenses/by-nc/4.0
Author: Nirodan – https://github.com/Nirodan