cx-nexredirect/wiki/CLI.md

CLI

Auf dem Server: nexredirect <command> (Symlink in /usr/local/bin/).

Subcommands

status            Service-Status (systemctl status)
start             Service starten
stop              Service stoppen
restart           Service neu starten
logs [-n N]       Logs streamen (default: -f live tail)
update [tag]      Auf neueste Version (oder bestimmten Tag); skip wenn schon aktuell
update -f [tag]   Update erzwingen auch wenn Version gleich
version           Aktuelle + neueste Version (von GitHub)
caddy reload      Caddyfile reload via Admin-API
caddy regen       Caddyfile aus DB neu generieren + reloaden
caddy fix-perms   /etc/caddy/Caddyfile dem Service-User übertragen
caddy show        Aktuellen Caddyfile anzeigen
db                SQLite-Shell auf der Datenbank öffnen
domains           Aktive Domains listen
hits [N]          Letzte N Hits (default 20)
tokens            API-Tokens auflisten
backup [PATH]     DB + Caddyfile sichern (default: /tmp/...)
uninstall         Service + Files entfernen (DB bleibt)
help              Hilfe

Beispiele

# Status checken
nexredirect status

# Live-Logs
nexredirect logs

# Letzte 50 Hits
sudo nexredirect hits 50

# Update auf neueste Version
sudo nexredirect update

# Update auf bestimmten Tag (auch downgrade)
sudo nexredirect update v0.1.10

# Force-Update (gleiche Version neu installieren)
sudo nexredirect update -f

# DB anschauen
sudo nexredirect db
sqlite> SELECT id, domain, status FROM domains;
sqlite> .quit

# Caddyfile anzeigen
nexredirect caddy show

# Backup
sudo nexredirect backup
sudo nexredirect backup /backup/nexredirect-$(date +%F).tgz

Service-User-Konzept

Service läuft als unprivileged user nexredirect (UID via useradd --system). Die meisten Commands brauchen sudo weil sie systemctl / DB-Schreibzugriff benötigen.

sudo update.sh ist über /etc/sudoers.d/corex-nexredirect als einzige Privileg-Eskalation erlaubt — vom Service-Process selbst aufrufbar wenn das UI "Update installieren" triggert.

→ Weiter mit API