cx-nexredirect/README.md
Hendrik Garske b81d7c1c12
Some checks failed
CI / build (push) Has been cancelled
Fix install URL: use correct raw/branch/main path for Forgejo
2026-06-04 22:25:29 +02:00

3.4 KiB

CoreX NexRedirect

Self-hosted Domain-Redirect-Server mit Web-Admin-UI und Per-Domain-Analytics. Viele Domains zeigen via DNS auf einen einzigen Server, der jede Domain auf das jeweilige Ziel weiterleitet und protokolliert, welche Domains tatsächlich noch genutzt werden — ideal um tote Domains zu identifizieren.

Features

  • One-Line Install auf Debian/Ubuntu (Caddy + Node + systemd)
  • Web-Admin-UI mit Setup-Wizard, Domain-Verwaltung, Analytics
  • Auto-HTTPS via Caddy (Let's Encrypt automatisch)
  • DNS-Validierung + Live-Übersicht aller Records (A, AAAA, MX, TXT, NS, CNAME, SOA, CAA)
  • Domain-Gruppen für gleiches Ziel über mehrere Domains
  • Sunset-Notice-Pages vor Redirect (per Domain oder Bulk)
  • Per-Domain-Analytics (Hits, eindeutige Besucher, Geo, "Tote Domains")
  • Bot-Filter mit Browser-Signal-Heuristik (Sec-Fetch, Accept-Language) + persistenter IP-Blocklist
  • PDF-Export (Gesamt + Per-Domain) via headless Chromium
  • CSV-Import + Export für Domains und Hits
  • Audit-Log aller administrativen Aktionen
  • Public REST-API mit Token-Auth und Scopes
  • Multi-User mit Rollen (admin / user)
  • Self-Update via Forgejo-Releases (UI-Banner + Auto-Update opt-in)
  • Webhook-Notifications bei Events (Domain-Verify-Fail etc.)
  • DSGVO-freundlich: IP-Hash mit täglich rotierendem Salt, kein Klartext

Installation

curl -sSL https://forgejo.mgmt.corexmanagement.de/admin_hg/cx-nexredirect/raw/branch/main/scripts/install.sh | sudo bash

Anschließend Setup unter http://<server-ip>/setup aufrufen.

→ Vollständige Anleitung im Wiki.

Dokumentation

Komplette Doku ist im GitHub Wiki:

Stack

  • Next.js 15 + TypeScript + TailwindCSS + Radix UI + Recharts
  • better-sqlite3 (eine Datei in /var/lib/corex-nexredirect/nexredirect.db)
  • Caddy (Auto-HTTPS, Reverse-Proxy)
  • MaxMind GeoLite2-Country (lokal, optional)
  • NextAuth Credentials + bcryptjs
  • puppeteer-core + Chromium (PDF-Export)

Lokale Entwicklung

git clone https://forgejo.mgmt.corexmanagement.de/admin_hg/cx-nexredirect
cd CoreX-NexRedirect
npm install
npm run dev

Setup unter http://localhost:3000/setup.

Lizenz

MIT — viel Spaß damit.