appRobotHoming

Eine kleine Node.js-App mit HTTPS-Frontend (einige Buttons + Textfeld) und Backend, das sich mit einem konfigurierbaren WSS (WebSocket Secure) verbindet. Die Buttons senden Befehle an den WSS, und das Textfeld zeigt eingehende Nachrichten/Logs an.

Features

• HTTPS-Server wird automatisch mit selbstsignierten Zertifikaten betrieben.
• Postinstall-Task erstellt bei npm install die Zertifikate unter ./certs.
• WSS-Client mit Auto-Reconnect und optionaler TLS-Validierung (in .env steuerbar).
• SSE (Server-Sent Events) für Live-Logs im Browser.

Schnellstart

# 1) Abhängigkeiten installieren und Zertifikate erzeugen
npm install

# 2) (Optional) .env anlegen, basierend auf .env.sample
cp .env.sample .env
# Werte nach Bedarf anpassen

# 3) Starten
npm run dev     # mit Nodemon
# oder
npm start       # ohne Nodemon

Öffne danach: https://localhost:8443 (Da selbstsigniert, musst du dem Zertifikat im Browser einmalig vertrauen.)

Konfiguration (.env)

Siehe .env.sample für alle verfügbaren Variablen:

• HTTPS_PORT (Standard: 8443)
• WSS_URL (z. B. wss://localhost:9001)
• WSS_INSECURE_TLS (true|false) – bei selbstsignierten Upstream-Zertifikaten oft true
• HTTPS_HOST (CN für das Zertifikat, Standard: localhost)
• HTTPS_CERT_DAYS (Gültigkeitsdauer des selbstsignierten Zertifikats in Tagen)
• ALLOWED_COMMANDS (kommasepariert; nur diese Kommandos akzeptiert das Backend)

Sicherheitshinweise

• Die Inhalte des Verzeichnisses certs/ sowie .env sind absichtlich in .gitignore eingetragen und werden nicht in Gitea eingecheckt.
• In Entwicklungsumgebungen kann WSS_INSECURE_TLS=true nötig sein. In Produktion deaktivieren und echte Zertifikate verwenden.

Ordnerstruktur

appRobotHoming/
├─ public/           # Statisches Frontend (HTML/JS/CSS)
├─ src/              # Backend-Quellcode
├─ scripts/          # Utility-Skripte (z. B. Zertifikatserzeugung)
├─ certs/            # (auto-generiert) selbstsignierte Zertifikate
├─ .gitignore
├─ .env.sample
├─ package.json
└─ README.md

Gitea-Upload

• Committe den Code ohne certs/ und ohne .env.
• Nach dem Klonen auf einem anderen System einfach npm install ausführen – die Zertifikate werden wieder neu erzeugt.