====== RTSPtoWeb – Streaming-Server ======

===== Allgemein =====

GitHub: [[https://github.com/deepch/RTSPtoWeb|deepch/RTSPtoWeb]]

===== Wichtige Pfade =====

^ Pfad ^ Funktion ^
| ''/home/RTSPtoWeb/'' | Installationsverzeichnis und Git-Repository |
| ''/home/RTSPtoWeb/config.json'' | Server- und Kamerakonfiguration |
| ''/usr/local/bin/rtsptoweb'' | Kompilierte ausführbare Datei |
| ''/etc/systemd/system/rtsptoweb.service'' | systemd-Dienst und Autostart |
| ''/root/rtsptoweb-sicherung/'' | Sicherungen der Konfiguration, Startdateien und Binärdateien |

**Hinweis:** Die ''config.json'' enthält Kamera-Zugangsdaten und sollte vertraulich behandelt werden.

===== Dienststeuerung =====

Alle Befehle im LXC als ''root'' ausführen.

^ Aktion ^ Befehl ^
| Status | ''systemctl status rtsptoweb'' |
| Starten | ''systemctl start rtsptoweb'' |
| Stoppen | ''systemctl stop rtsptoweb'' |
| Neustarten | ''systemctl restart rtsptoweb'' |
| Autostart aktivieren | ''systemctl enable rtsptoweb'' |
| Autostart deaktivieren | ''systemctl disable rtsptoweb'' |
| Dienstkonfiguration anzeigen | ''systemctl cat rtsptoweb'' |

Der Dienst startet beim LXC-Start automatisch und wird bei einem Programmabsturz nach 5 Sekunden neu gestartet.

===== Logs und Fehlerdiagnose =====

Live-Logs:

<code bash>
journalctl -u rtsptoweb -f
</code>

Letzte 100 Logeinträge:

<code bash>
journalctl -u rtsptoweb -n 100 --no-pager
</code>

Warnungen und Fehler seit dem letzten Start:

<code bash>
journalctl -u rtsptoweb -b -p warning --no-pager
</code>

Ports überprüfen:

<code bash>
ss -ltnp | grep -E ':(8083|5541)\b'
</code>

===== Kamerakonfiguration =====

Konfigurationsdatei:

<code bash>
nano /home/RTSPtoWeb/config.json
</code>

Alle Streams sind mit ''on_demand: true'' konfiguriert. Die Verbindung zur Kamera wird nur bei Bedarf aufgebaut.

Nach Änderungen an der ''config.json'':

<code bash>
systemctl restart rtsptoweb
</code>

===== RTSPtoWeb aktualisieren =====

**1. Aktuellen Stand prüfen**

<code bash>
cd /home/RTSPtoWeb
git status --short
git fetch origin master
git rev-list --left-right --count HEAD...FETCH_HEAD
</code>

**2. Vor dem Update sichern**

Idealerweise einen Proxmox-Snapshot oder ein LXC-Backup erstellen.

<code bash>
cp -a /home/RTSPtoWeb/config.json \
  /root/rtsptoweb-sicherung/config.json

chmod 600 /root/rtsptoweb-sicherung/config.json

cp -a /usr/local/bin/rtsptoweb 
  /root/rtsptoweb-sicherung/RTSPtoWeb-alt
</code>

**3. Quellcode aktualisieren und kompilieren**

<code bash>
cd /home/RTSPtoWeb

git pull --ff-only origin master

GOTOOLCHAIN=auto go build -o /tmp/RTSPtoWeb-neu .
</code>

Nur wenn der Build erfolgreich ist:

<code bash>
systemctl stop rtsptoweb

install -m 755 /tmp/RTSPtoWeb-neu 
  /usr/local/bin/rtsptoweb

systemctl start rtsptoweb

systemctl status rtsptoweb
</code>

Abschließend die Weboberfläche und alle Kamerastreams überprüfen.

===== Konfiguration sichern =====

Manuelles Backup:

<code bash>
mkdir -p /root/rtsptoweb-sicherung

install -m 600 /home/RTSPtoWeb/config.json 
  /root/rtsptoweb-sicherung/config.json
</code>

Zusätzlich sollte RTSPtoWeb über das reguläre Proxmox-LXC-Backup gesichert werden.


===== Sicherheit =====

  * RTSPtoWeb wird ausschließlich im internen LAN verwendet.
  * Keine Freigabe der Ports 8083 und 5541 ins Internet.
  * HTTP-Authentifizierung ist derzeit deaktiviert.
  * Die Verwaltungszugangsdaten stehen derzeit auf ''demo:demo''.
  * Kamera-Zugangsdaten werden in der ''config.json'' gespeichert.