← Bauphysik

Quelle: docs/server/OFFICE_SERVER_SETUP.md

Hetzner-Server – kompletter Einrichtungs-Guide

Ziel: Den externen Ubuntu-Hetzner-Server sicher einrichten und als Claude-Code-/Automationsserver betreiben. Projektdateien werden vom Bürorechner über Total Commander per SFTP auf den Server übertragen.

Abgrenzung: Dieser Guide gilt ausschließlich für den Hetzner-Server. Auf dem Hetzner-Server wird kein GitHub-Zugang eingerichtet: keine GitHub-Keys, keine GitHub CLI und kein Klonen/Pullen aus GitHub. Projekte gelangen per Total Commander/SFTP nach /opt/office. Das lokale Bürogerät für Open WebUI und das lokale LLM wird separat in LOCAL_AI_OFFICE_SERVER.md eingerichtet.

Der Guide ist bewusst in einer sicheren Reihenfolge aufgebaut. Einige Schritte hängen voneinander ab: SSH-Zugang mit dem normalen Benutzer muss funktionieren, bevor Root- und Passwort-Login abgeschaltet werden. Genau an diesen Stellen gibt es Kontrollpunkte.

Ausgangslage

Der Guide geht von Folgendem aus:

Grundprinzip: Root nur für die anfängliche Einrichtung und Systemadministration verwenden. Die tägliche Arbeit läuft später unter kai mit gezieltem sudo.


1. Zum ersten Mal auf dem Server anmelden

Nach dem Anlegen eines Hetzner-Servers bekommst du eine öffentliche IP-Adresse und zunächst einen Root-Zugang.

Auf deinem eigenen Rechner:

ssh root@SERVER_IP

SERVER_IP durch die echte IPv4-Adresse des Servers ersetzen.

Beim ersten Verbindungsaufbau fragt SSH normalerweise, ob der Fingerprint des Servers akzeptiert werden soll. Wenn die IP stimmt, mit yes bestätigen.

Prüfen, worauf wir arbeiten

Direkt nach der Anmeldung erst einmal System und Netzwerk ansehen:

cat /etc/os-release
uname -a
hostnamectl
ip addr

Damit prüfen wir:

Einen eindeutigen Hostnamen setzen

Ein sinnvoller Hostname hilft später besonders dann, wenn mehrere Server existieren:

hostnamectl set-hostname bauphysik-hetzner

Danach prüfen:

hostnamectl

Zeitzone setzen

Für Logdateien, Cronjobs und spätere Fehlersuche ist es angenehm, wenn der Server dieselbe lokale Zeit verwendet:

timedatectl set-timezone Europe/Berlin
timedatectl

Kontrollpunkt: Bei Time zone sollte anschließend Europe/Berlin stehen.


2. Ubuntu vollständig aktualisieren

Ein frischer Server kann bereits beim Erstellen einige ältere Pakete enthalten. Deshalb wird das System aktualisiert, bevor weitere Software installiert oder Sicherheitsregeln verändert werden.

Zuerst die Paketlisten aktualisieren:

apt update

Dann alle installierten Pakete auf den aktuellen Stand bringen:

apt full-upgrade -y

Nicht mehr benötigte Pakete entfernen:

apt autoremove --purge -y
apt autoclean

Prüfen, ob ein Neustart nötig ist

Kernel- oder zentrale Systemupdates können einen Neustart erforderlich machen:

if [ -f /var/run/reboot-required ]; then cat /var/run/reboot-required; fi

Wenn eine entsprechende Meldung erscheint:

reboot

Die SSH-Verbindung wird dabei beendet. Danach kurz warten und erneut anmelden:

ssh root@SERVER_IP

Kontrollpunkt: Erst weitermachen, wenn die erneute Root-Anmeldung funktioniert.


3. Grundwerkzeuge installieren

Jetzt installieren wir die Werkzeuge, die für Administration, Sicherheit und Entwicklung benötigt werden:

apt update
apt install -y \
  sudo \
  curl \
  wget \
  ca-certificates \
  gnupg \
  openssh-server \
  ufw \
  fail2ban \
  unattended-upgrades \
  needrestart \
  tmux \
  htop \
  rsync \
  unzip

Kurz wofür sie gebraucht werden:

SSH-Dienst prüfen

systemctl enable --now ssh
systemctl status ssh --no-pager

Bei Active: sollte active (running) stehen.


4. Normalen Admin-Benutzer anlegen

Direkt dauerhaft als root zu arbeiten ist unnötig riskant. Deshalb legen wir einen normalen Benutzer an, der nur bei Bedarf über sudo administrative Rechte bekommt.

adduser kai

Währenddessen wird ein Passwort für den Benutzer abgefragt. Die weiteren Angaben wie vollständiger Name können leer bleiben.

Anschließend den Benutzer zur Gruppe sudo hinzufügen:

usermod -aG sudo kai

Kontrolle:

id kai

In der Ausgabe sollte unter anderem die Gruppe sudo auftauchen.

Gemeinsames Projektverzeichnis vorbereiten

install -d -o kai -g kai -m 0750 /opt/office

Bedeutung:

Prüfen:

ls -ld /opt/office

Ab hier soll normale Arbeit unter kai erfolgen.


5. SSH-Key für den Benutzer kai einrichten

Passwort-Login über das Internet ist unnötig angreifbar. Wir stellen deshalb auf SSH-Key-Authentifizierung um.

Dabei gibt es zwei Schlüssel:

Den privaten Schlüssel niemals auf einen anderen Server, in Projektordner oder in eine Cloud-Datei kopieren.

5.1 Auf dem Windows-PC einen SSH-Key erzeugen

In PowerShell:

ssh-keygen -t ed25519 -a 100

Wenn nach dem Speicherort gefragt wird, kannst du den Standard übernehmen:

C:\Users\DEINNAME\.ssh\id_ed25519

Empfehlung: Eine Passphrase vergeben. Dann ist der private Key auch geschützt, falls jemand Zugriff auf die Datei bekommt.

Erzeugt werden normalerweise:

id_ed25519
id_ed25519.pub

id_ed25519 ist privat. id_ed25519.pub ist der öffentliche Schlüssel.

5.2 Public Key auf den Server kopieren

Vom Windows-PC aus:

Get-Content "$env:USERPROFILE\.ssh\id_ed25519.pub" | ssh root@SERVER_IP 'install -d -m 700 -o kai -g kai /home/kai/.ssh; cat >> /home/kai/.ssh/authorized_keys; chown kai:kai /home/kai/.ssh/authorized_keys; chmod 600 /home/kai/.ssh/authorized_keys'

Dieser Befehl:

  1. legt /home/kai/.ssh an,
  2. setzt sichere Rechte,
  3. hängt deinen Public Key an authorized_keys,
  4. setzt kai als Eigentümer.

5.3 Anmeldung als kai testen

Die bestehende Root-Sitzung jetzt noch nicht schließen.

Öffne ein zweites Terminal und teste:

ssh kai@SERVER_IP

Danach:

whoami
sudo whoami

Erwartete Ausgabe:

kai
root

Das bedeutet:

STOPP, wenn dieser Test fehlschlägt. Root- und Passwort-Login dürfen erst deaktiviert werden, wenn eine neue SSH-Sitzung als kai zuverlässig funktioniert.


6. SSH absichern

Jetzt kann der SSH-Server gehärtet werden. Ziel ist:

Wir legen dafür bewusst eine separate Konfigurationsdatei an. So bleibt die Ubuntu-Standardkonfiguration unangetastet:

sudo tee /etc/ssh/sshd_config.d/00-office-hardening.conf >/dev/null <<'EOF'
PermitRootLogin no
PasswordAuthentication no
KbdInteractiveAuthentication no
PubkeyAuthentication yes
X11Forwarding no
AllowUsers kai
EOF

Konfiguration prüfen, bevor sie aktiv wird

Dieser Befehl prüft nur die Syntax:

sudo sshd -t

Wenn keine Ausgabe erscheint, ist die Syntax gültig.

Danach prüfen, welche Einstellungen SSH tatsächlich verwenden würde:

sudo sshd -T | grep -E 'permitrootlogin|passwordauthentication|kbdinteractiveauthentication|pubkeyauthentication|x11forwarding|allowusers'

Erwartet werden sinngemäß:

permitrootlogin no
passwordauthentication no
kbdinteractiveauthentication no
pubkeyauthentication yes
x11forwarding no
allowusers kai

Neue Konfiguration laden

sudo systemctl reload ssh

reload ist hier sinnvoller als ein harter Neustart des SSH-Dienstes, weil bestehende Verbindungen erhalten bleiben.

Unbedingt erneut testen

In einem dritten oder neuen Terminal:

ssh kai@SERVER_IP

Dann:

whoami

Erwartet:

kai

Optional zusätzlich testen, dass Root jetzt wirklich gesperrt ist:

ssh root@SERVER_IP

Diese Anmeldung sollte scheitern.

Kontrollpunkt: Erst wenn kai weiterhin funktioniert, die ursprüngliche Root-Sitzung schließen.


7. Firewall mit UFW aktivieren

Bisher entscheidet im Wesentlichen jeder einzelne Dienst selbst, ob er auf einem Port lauscht. Mit UFW setzen wir zusätzlich eine zentrale Regel:

Eingehend ist grundsätzlich alles gesperrt, außer ausdrücklich freigegebenen Diensten.

Zuerst Standardregeln setzen:

sudo ufw default deny incoming
sudo ufw default allow outgoing

SSH vor dem Aktivieren der Firewall freigeben:

sudo ufw allow OpenSSH

Prüfen:

sudo ufw status

Dann Firewall aktivieren:

sudo ufw enable

Und anschließend ausführlich kontrollieren:

sudo ufw status verbose

Mindestens Port 22 bzw. OpenSSH muss als erlaubt erscheinen.

Wieder einen neuen SSH-Test machen

ssh kai@SERVER_IP

Wenn das funktioniert, blockiert die Firewall den SSH-Zugang nicht.

Später bei einem Webserver

Wenn dieser Server später HTTP/HTTPS direkt annimmt:

sudo ufw allow 80/tcp
sudo ufw allow 443/tcp

Ports immer erst freigeben, wenn sie wirklich benötigt werden.

Zusätzlich ist eine Hetzner-Cloud-Firewall sinnvoll. Sie filtert Pakete bereits vor dem Server und bildet damit eine zweite Schutzebene.


8. Fail2ban für SSH aktivieren

SSH-Key-Login ist bereits sehr robust. Trotzdem erzeugen öffentlich erreichbare Server meist ständig automatisierte Login-Versuche.

Fail2ban beobachtet die Systemlogs und sperrt IP-Adressen vorübergehend, wenn sie wiederholt fehlerhafte Logins versuchen.

Konfiguration anlegen:

sudo tee /etc/fail2ban/jail.d/sshd.local >/dev/null <<'EOF'
[sshd]
enabled = true
backend = systemd
bantime = 1h
findtime = 10m
maxretry = 5
EOF

Bedeutung:

Dienst aktivieren:

sudo systemctl enable --now fail2ban
sudo systemctl restart fail2ban

Status prüfen:

sudo fail2ban-client status
sudo fail2ban-client status sshd

Bei Jail list sollte sshd auftauchen.


9. Automatische Sicherheitsupdates aktivieren

Ein Server bleibt nicht dadurch sicher, dass er einmal sauber eingerichtet wurde. Sicherheitslücken werden regelmäßig entdeckt. Deshalb sollen relevante Ubuntu-Sicherheitsupdates automatisch installiert werden.

Automatische Paketlisten-Updates und unattended upgrades aktivieren:

sudo tee /etc/apt/apt.conf.d/20auto-upgrades >/dev/null <<'EOF'
APT::Periodic::Update-Package-Lists "1";
APT::Periodic::Unattended-Upgrade "1";
EOF

Automatische Neustarts deaktivieren:

sudo tee /etc/apt/apt.conf.d/52unattended-upgrades-local >/dev/null <<'EOF'
Unattended-Upgrade::Automatic-Reboot "false";
EOF

Damit werden Sicherheitsupdates installiert, der Server startet aber nicht unerwartet mitten in einer Arbeitssitzung neu.

Timer prüfen

systemctl status apt-daily.timer --no-pager
systemctl status apt-daily-upgrade.timer --no-pager

Beide Timer sollten geladen und aktiv sein.

Testlauf ohne Änderungen

sudo unattended-upgrade --dry-run --debug

Der Dry-Run zeigt, was passieren würde, ohne tatsächlich Pakete zu verändern.

Neustartbedarf später prüfen

if [ -f /var/run/reboot-required ]; then cat /var/run/reboot-required; fi

So bleibt der Neustart bewusst unter eigener Kontrolle.


10. Grundlegenden Sicherheitszustand prüfen

Bevor jetzt Entwicklungswerkzeuge eingerichtet werden, einmal den Sicherheitszustand kontrollieren:

sudo ufw status verbose
sudo fail2ban-client status sshd
sudo sshd -T | grep -E 'permitrootlogin|passwordauthentication|pubkeyauthentication|allowusers'
systemctl --failed

Erwarteter Zustand:

Wenn das stimmt, ist die Basishärtung abgeschlossen.


11. Projektdateien mit Total Commander per SFTP übertragen

Der Hetzner-Server bekommt keinen GitHub-Zugang. Projektdateien werden vom Bürorechner direkt über die bereits abgesicherte SSH-Verbindung übertragen.

Für Total Commander muss kein FTP-Server installiert werden. Verwendet wird das SFTP-Dateisystem-Plugin.

Verbindungsdaten:

Server/Host:     SERVER_IP
Port:            22
Benutzer:        kai
Authentifizierung: SSH-Key
Zielordner:      /opt/office

Als privater Schlüssel dient der Key auf dem Windows-Rechner, beispielsweise:

C:\Users\DEINNAME\.ssh\id_ed25519

Empfohlener Ablauf

  1. Projektordner auf dem Bürorechner vorbereiten.
  2. In Total Commander die SFTP-Verbindung zum Hetzner öffnen.
  3. Projektordner nach /opt/office/PROJEKTNAME kopieren.
  4. Auf dem Server Eigentümer und Rechte prüfen.
  5. Claude Code direkt in diesem Projektordner starten.

Auf dem Server:

cd /opt/office/PROJEKTNAME
pwd
ls -la

Falls Dateien versehentlich einem falschen Benutzer gehören:

sudo chown -R kai:kai /opt/office/PROJEKTNAME

Wichtig: Änderungen, die Claude Code auf dem Hetzner-Server erzeugt, liegen zunächst nur dort. Wenn sie wieder auf den Bürorechner sollen, werden sie ebenfalls per Total Commander/SFTP zurückkopiert.

Es wird kein GitHub-Key, keine GitHub CLI und kein GitHub-Remote auf dem Hetzner-Server eingerichtet.


12. Claude Code installieren

Claude Code wird als Benutzer kai installiert. Dadurch gehören Konfiguration, Sessions und lokale Dateien dem normalen Arbeitsbenutzer und nicht Root.

Vorher prüfen:

whoami

Erwartet:

kai

Dann installieren:

curl -fsSL https://claude.ai/install.sh | bash -s stable

Neue Shell starten oder gegebenenfalls den vom Installer genannten PATH-Schritt ausführen.

Danach:

claude --version
claude doctor

claude doctor prüft die lokale Installation und meldet typische Konfigurationsprobleme.

Claude Code zum ersten Mal starten

claude

Beim ersten Start erfolgt gegebenenfalls die Anmeldung bzw. Autorisierung.

Im Projektordner arbeiten

cd /opt/office/PROJEKTNAME
claude

Damit startet Claude Code direkt mit dem übertragenen Projektordner als Arbeitskontext.

Updates

claude update
claude doctor

Nicht verwenden:

sudo claude

Claude soll keine unnötigen Root-Rechte bekommen.


13. Claude-Code-Sitzungen mit tmux absichern

Eine SSH-Verbindung kann abbrechen: WLAN-Wechsel, Laptop zugeklappt, Mobilfunkwechsel oder Timeout.

Ohne tmux endet dabei oft auch das laufende Terminalprogramm. Mit tmux läuft die Sitzung auf dem Server weiter.

Neue Sitzung starten:

tmux new -s claude

Dann im tmux:

cd /opt/office/PROJEKTNAME
claude

Sitzung verlassen, ohne sie zu beenden

Tastenkombination:

Ctrl+B
danach D

Du landest wieder in der normalen Shell, Claude läuft aber im tmux weiter.

Später erneut verbinden

tmux attach -t claude

Vorhandene Sessions anzeigen:

tmux ls

Das ist besonders nützlich für längere Claude-Code-Arbeiten auf dem Server.


14. Total Commander für den laufenden Dateiaustausch

Für Total Commander muss kein FTP-Server installiert werden.

SFTP ist ein Dateitransfer-Protokoll über die bestehende SSH-Verbindung. Damit verwendet Total Commander dieselbe abgesicherte Infrastruktur wie die normale SSH-Anmeldung.

Das ist wesentlich sinnvoller als zusätzlich FTP/FTPS einzurichten.

Verbindung in Total Commander

Das SFTP-Dateisystem-Plugin verwenden und ein neues Profil anlegen:

Als privater Key dient der Key auf deinem Windows-Rechner, also beispielsweise:

C:\Users\DEINNAME\.ssh\id_ed25519

Wenn Total Commander nach einem Passwort fragt

Bei korrekt konfiguriertem Key-Login brauchst du kein Serverpasswort. Falls dein privater SSH-Key mit einer Passphrase geschützt ist, kann Total Commander diese Passphrase abfragen.

Kontrolle

Nach dem Verbinden solltest du mindestens folgende Verzeichnisse sehen können:

/home/kai
/opt/office

Keinen klassischen FTP-Server installieren und Port 21 nicht freigeben.


15. Dateirechte kontrollieren

Ein häufiger Fehler entsteht, wenn Dateien einmal mit sudo oder als Root erzeugt werden. Danach kann kai sie nicht mehr bearbeiten.

Projektverzeichnis prüfen:

ls -ld /opt/office
ls -la /opt/office

Eigentümer sollte normalerweise kai sein.

Wenn versehentlich Root Dateien im Arbeitsverzeichnis erzeugt hat:

sudo chown -R kai:kai /opt/office

Danach erneut prüfen:

find /opt/office -maxdepth 2 ! -user kai -ls

Wenn keine Ausgabe erscheint, gehören die geprüften Dateien kai.

Was nicht tun

Nicht pauschal:

chmod -R 777 /opt/office

777 gibt jedem Benutzer vollständige Rechte und löst Berechtigungsprobleme auf unsaubere Weise.


16. Laufende Dienste und offene Ports prüfen

Jetzt prüfen wir, was tatsächlich über das Netzwerk erreichbar ist:

sudo ss -tulpn

Bei einem ganz frischen Server sollte insbesondere SSH auf Port 22 sichtbar sein. Später können je nach Anwendung weitere lokale oder öffentliche Ports hinzukommen.

Firewallstatus:

sudo ufw status verbose

Fehlgeschlagene Systemdienste:

systemctl --failed

Schwere Fehler seit dem letzten Boot:

sudo journalctl -p 3 -xb --no-pager

Dabei nicht jede einzelne Meldung automatisch als Problem interpretieren. Wichtig sind wiederkehrende oder klar relevante Fehler.


17. Systemressourcen prüfen

Festplattenspeicher:

df -h

Arbeitsspeicher:

free -h

Laufzeit und Load Average:

uptime

Interaktive Prozessübersicht:

htop

Damit hast du für spätere Fehlersuche bereits die wichtigsten Standardwerkzeuge zur Hand.


18. Backup- und Wiederherstellungsstrategie

Ein Server sollte so behandelt werden, als könnte er jederzeit ausfallen oder versehentlich falsch konfiguriert werden.

Mindestens folgende Ebenen sind sinnvoll:

Wichtig:

Der Hetzner-Server ist nicht die einzige Kopie der Projektdateien. Arbeitsstände, die erhalten bleiben sollen, müssen regelmäßig auf die Büroablage zurückgesichert werden.

Vor größeren Änderungen am System ist ein Hetzner-Snapshot besonders praktisch, weil sich der komplette Serverzustand zurücksetzen lässt.


19. Abschlussprüfung der Sicherheit

Diese Befehle kannst du am Ende als Gesamtcheck ausführen:

sudo ss -tulpn
sudo ufw status verbose
systemctl --failed
sudo sshd -T | grep -E 'permitrootlogin|passwordauthentication|kbdinteractiveauthentication|pubkeyauthentication|allowusers'
sudo fail2ban-client status sshd
if [ -f /var/run/reboot-required ]; then cat /var/run/reboot-required; fi

Für Claude Code:

claude --version
claude doctor

Für Systemressourcen:

uptime
free -h
df -h

Wenn diese Prüfungen plausibel aussehen, ist der Server für den normalen Arbeitsbetrieb vorbereitet.


20. Abschluss-Checkliste


21. Schnellreferenz für später

System aktualisieren:

sudo apt update
sudo apt upgrade

Sicherheitsstatus:

sudo ufw status verbose
sudo systemctl status ssh --no-pager
sudo fail2ban-client status sshd

Systemstatus:

uptime
free -h
df -h
systemctl --failed

Claude Code:

cd /opt/office/PROJEKTNAME
claude

Claude in tmux:

tmux new -s claude
cd /opt/office/PROJEKTNAME
claude

Bestehende tmux-Sitzung wieder öffnen:

tmux attach -t claude

Offizielle Referenzen

Stand: 29.09.2026