Schnellstart
Auf einem frischen Debian- oder Ubuntu-Server mit einer Domain, die per DNS auf den Server zeigt:
curl -fsSL https://unser-geheimnis.de/install.sh -o install.sh
less install.sh # Script vor dem Ausführen lesen
sudo bash install.sh --domain secrets.example.de --proxy caddyNach drei bis fünf Minuten läuft deine Instanz unter https://secrets.example.de, mit automatischem HTTPS-Zertifikat von Let's Encrypt. Ohne Optionen fragt das Script alle Angaben interaktiv ab.
Script vorher lesen
public/install.sh.Voraussetzungen
| Minimum | Empfohlen | |
|---|---|---|
| Betriebssystem | Debian 12, Ubuntu 22.04 | Debian 12 / Ubuntu 24.04 LTS |
| CPU / RAM | 1 vCPU, 1 GB RAM + 2 GB Swap | 2 vCPU, 2 GB RAM |
| Speicher | 2 GB frei | 10 GB (Dateien bis 16 MB je Geheimnis) |
| Netzwerk | Domain mit A/AAAA-Record, Ports 80 + 443 | eigene Subdomain, z. B. secrets.firma.de |
| Zugang | root bzw. sudo |
Node.js 22 installiert das Script bei Bedarf selbst. Als Datenbank dient SQLite, ein separater Datenbankserver ist nicht nötig.
Was das Script macht
- Prüft System, Arbeitsspeicher und Rechte.
- Installiert
git,curl,opensslund Node.js 22 (NodeSource), falls nötig. - Legt den Systembenutzer
geheimnisohne Login-Shell an. - Klont das Repository nach
/opt/unser-geheimnis. - Fragt die Angaben fürs Impressum ab und erzeugt
.envmit zufälligemAPP_SECRET(nur für den Dienst lesbar, Rechte 600). - Installiert Abhängigkeiten, legt die SQLite-Datenbank an und baut die App.
- Richtet einen gehärteten systemd-Dienst ein, der nur auf
127.0.0.1lauscht. - Optional: installiert Caddy als Reverse-Proxy mit automatischem HTTPS.
- Prüft, ob die App antwortet, und zeigt eine Zusammenfassung.
Bereits vorhandene .env-Dateien und Daten werden nie überschrieben.
Script-Optionen
| Option | Bedeutung | Standard |
|---|---|---|
--domain | Öffentliche Domain der Instanz | fragt nach |
--proxy caddy|none | Caddy mit HTTPS einrichten oder eigenen Proxy nutzen | fragt nach |
--dir | Installationsverzeichnis | /opt/unser-geheimnis |
--port | Interner Port (nur localhost) | 3000 |
--branch | Git-Branch | main |
--smtp-host | SMTP-Server für E-Mail-Versand | – |
--smtp-user / --smtp-pass | SMTP-Zugangsdaten | – |
--mail-from | Absender der E-Mails | Domain + SMTP-Benutzer |
--legal-name / --legal-email | Impressum: Betreiber und Kontakt-E-Mail | fragt nach |
--legal-address | Impressum: Anschrift, Zeilen mit | getrennt | fragt nach |
--legal-phone | Impressum: Telefon | optional |
-y | Ohne Rückfragen (z. B. für Ansible / cloud-init) | – |
Jede Option gibt es auch als Umgebungsvariable mit Präfix UG_, zum Beispiel für eine automatisierte Installation:
sudo UG_DOMAIN=secrets.example.de UG_PROXY=caddy bash install.sh -yReverse-Proxy & HTTPS
HTTPS ist Pflicht: Browser stellen die Web Crypto API zum Verschlüsseln nur auf sicheren Seiten (HTTPS) bereit. Mit --proxy caddy passiert alles automatisch. Läuft auf dem Server schon nginx oder Apache, nutze --proxy none und eine der folgenden Konfigurationen.
Wichtig: X-Forwarded-For setzen, nicht anhängen
X-Forwarded-For. Der Proxy muss den Header mit der echten IP überschreiben. Wird er nur ergänzt, könnte ein Angreifer eine falsche IP mitschicken und die Limits umgehen. Caddy macht das standardmäßig richtig.server {
listen 443 ssl http2;
server_name secrets.example.de;
# ssl_certificate … (z. B. via certbot --nginx)
client_max_body_size 30m;
location / {
proxy_pass http://127.0.0.1:3000;
proxy_set_header Host $host;
proxy_set_header X-Forwarded-For $remote_addr; # überschreiben!
proxy_set_header X-Forwarded-Proto https;
access_log off; # keine IP-Logs
}
}<VirtualHost *:443>
ServerName secrets.example.de
# SSLEngine on … (z. B. via certbot --apache)
ProxyPreserveHost On
ProxyRequests Off
# Vom Client gesendetes X-Forwarded-For verwerfen — mod_proxy setzt die echte IP
RequestHeader unset X-Forwarded-For
RequestHeader set X-Forwarded-Proto "https"
LimitRequestBody 31457280
ProxyPass / http://127.0.0.1:3000/
ProxyPassReverse / http://127.0.0.1:3000/
</VirtualHost>E-Mail (Daten anfordern)
Teilen und Anfordern per Link funktionieren ohne E-Mail. Für den Versand von Anfragen per E-Mail (mit Bestätigungscode für den Absender) brauchst du einen SMTP-Zugang. Ohne SMTP lehnt der Server den E-Mail-Versand mit einem Hinweis ab; alles andere funktioniert normal.
SMTP_HOST=smtp.example.de
SMTP_PORT=587 # 587 = STARTTLS (erzwungen), 465 = TLS
SMTP_USER=noreply@example.de
SMTP_PASS="dein-passwort"
MAIL_FROM="Secrets <noreply@example.de>"
MAIL_DAILY_LIMIT=300 # globale Obergrenze Einladungen/Tagsudo systemctl restart unser-geheimnisZustellbarkeit
Konfiguration (.env)
Alle Einstellungen liegen in /opt/unser-geheimnis/.env. Nach Änderungen: sudo systemctl restart unser-geheimnis.
| Variable | Beschreibung |
|---|---|
NEXT_PUBLIC_SITE_URL | Öffentliche Adresse inkl. https://. Wird beim Build eingebaut; nach Änderung install.sh update ausführen. |
APP_SECRET | Zufälliger Schlüssel (mind. 32 Zeichen) für Codes, Proof-of-Work und E-Mail-Hashes. Nicht ändern, solange Anfragen offen sind. |
DATABASE_URL | Pfad zur SQLite-Datenbank |
UPLOAD_DIR | Ablage für verschlüsselte Dateien |
MAX_FILE_SIZE_MB | Maximale Dateigröße (Standard 16) |
RATE_LIMIT_MAX | Geheimnisse pro IP und Stunde (Standard 10) |
SMTP_* / MAIL_FROM | E-Mail-Versand, siehe oben |
LEGAL_* | Angaben fürs Impressum, siehe unten |
Updates & Backups
sudo bash install.sh updateDas Update sichert vorher die Datenbank (die letzten fünf Sicherungen bleiben in data/), übernimmt eigene Anpassungen am Code (z. B. Impressum), baut neu und startet den Dienst. Kollidieren Anpassungen mit dem Update, bricht es ab und legt einen Patch in data/ ab.
tar -czf /root/ug-backup-$(date +%F).tar.gz -C /opt/unser-geheimnis .env dataBackups enthalten nur verschlüsselte Daten. Ohne die Links der Nutzer sind sie nicht lesbar. Da Geheimnisse nach maximal 48 Stunden ablaufen, ist vor allem die .env wichtig.
Impressum, Datenschutz & Branding
Die Angaben im Impressum stehen nicht im Code, sondern in der .env. Das Installscript fragt sie ab, ändern kannst du sie jederzeit. Danach genügt ein Neustart:
LEGAL_NAME='Muster GmbH'
LEGAL_ADDRESS='Musterstraße 1|12345 Musterstadt|Deutschland' # Zeilen mit | trennen
LEGAL_EMAIL='impressum@example.de'
LEGAL_PHONE='+49 123 456789' # optional
LEGAL_REPRESENTATIVE='Max Mustermann' # optional, z. B. Geschäftsführer
LEGAL_REGISTER='Amtsgericht München, HRB 12345' # optional
LEGAL_VAT_ID='DE123456789' # optionalsudo systemctl restart unser-geheimnisDatenschutzerklärung prüfen
| Datei | Inhalt |
|---|---|
src/app/datenschutz/page.tsx | Datenschutzerklärung |
src/app/layout.tsx | Seitentitel, Beschreibung, Open-Graph-Daten |
src/components/ui/Icons.tsx | Logo / Wortmarke |
src/app/globals.css | Farben (Design-Tokens) |
Nach Änderungen an diesen Dateien sudo bash install.sh update ausführen. Deine Änderungen bleiben auch bei künftigen Updates erhalten.
Manuelle Installation
Ohne Script, z. B. für andere Distributionen oder Container. Du brauchst Node.js ≥ 20 und git:
git clone https://github.com/LeonMTN05/unser-geheimnis.git /opt/unser-geheimnis
cd /opt/unser-geheimnis
cat > .env <<EOF
DATABASE_URL="file:/opt/unser-geheimnis/data/prod.db"
NEXT_PUBLIC_SITE_URL="https://secrets.example.de"
UPLOAD_DIR="/opt/unser-geheimnis/data/secrets"
APP_SECRET=$(openssl rand -hex 32)
LEGAL_NAME='Muster GmbH'
LEGAL_ADDRESS='Musterstraße 1|12345 Musterstadt|Deutschland'
LEGAL_EMAIL='impressum@example.de'
EOF
chmod 600 .env && mkdir -p data/secrets
npm ci
set -a && . ./.env && set +a
npx prisma generate && npx prisma db push
NODE_ENV=production npx next build
# Start (dauerhaft per systemd, siehe install.sh → write_service)
NODE_ENV=production npx next start -H 127.0.0.1 -p 3000Sicherheitshinweise
- Firewall: nur 22, 80 und 443 öffnen. Der App-Port bleibt auf localhost.
- Keine Zugriffs-Logs mit IP-Adressen im Reverse-Proxy (DSGVO). Die Pfade enthalten zwar nie Schlüssel (die stehen nur im #-Fragment), trotzdem gilt: so wenig wie möglich protokollieren.
- Updates regelmäßig einspielen, auch für das Betriebssystem (
unattended-upgrades). - APP_SECRET geheim halten. Wer es kennt, kann Proof-of-Work-Aufgaben fälschen und die Pseudonymisierung von IPs und E-Mail-Adressen aufheben. Verschlüsselte Inhalte bleiben trotzdem unlesbar.
- Der Server sieht nie Klartext oder Schlüssel. Ein kompromittierter Server könnte allerdings manipulierten JavaScript-Code ausliefern. Schütze ihn deshalb wie jede andere sicherheitskritische Anwendung.
Deinstallation
sudo systemctl disable --now unser-geheimnis
sudo rm /etc/systemd/system/unser-geheimnis.service && sudo systemctl daemon-reload
sudo rm -rf /opt/unser-geheimnis # löscht auch alle Daten!
sudo userdel geheimnis
# Optional: Block für die Domain aus /etc/caddy/Caddyfile entfernenLieber nichts selbst betreiben?
Nutze einfach die gehostete Version: kostenlos, ohne Account, in Deutschland gehostet.
Zu unser-geheimnis.de