Move 05-ct103-vaultwarden.md to wiki
This commit is contained in:
parent
0b4f3d5a6c
commit
0aaef5b265
1 changed files with 0 additions and 116 deletions
|
|
@ -1,116 +0,0 @@
|
|||
# CT 103 — Vaultwarden (Passwortmanager) — Rebuild-Runbook
|
||||
|
||||
Sensibelster Dienst im gesamten Setup — bewusst **nur über Tailscale** erreichbar, nie öffentlich.
|
||||
|
||||
## 1. Container erstellen
|
||||
|
||||
```bash
|
||||
pct create 103 local:vztmpl/debian-13-standard_13.6-1_amd64.tar.zst \
|
||||
--hostname vaultwarden \
|
||||
--unprivileged 1 \
|
||||
--cores 1 \
|
||||
--memory 512 \
|
||||
--swap 512 \
|
||||
--rootfs local-lvm:4 \
|
||||
--net0 name=eth0,bridge=vmbr0,ip=<LAN_IP_VAULTWARDEN>/24,gw=<LAN_IP_ROUTER> \
|
||||
--features nesting=1 \
|
||||
--timezone Europe/Berlin \
|
||||
--onboot 1 \
|
||||
--nameserver <LAN_IP_ADGUARD>
|
||||
pct start 103
|
||||
```
|
||||
|
||||
## 2. TUN-Device für Tailscale (siehe `01-pve-host.md`, Abschnitt 8)
|
||||
|
||||
```bash
|
||||
pct stop 103
|
||||
cat >> /etc/pve/lxc/103.conf <<'EOF'
|
||||
lxc.cgroup2.devices.allow: c 10:200 rwm
|
||||
lxc.mount.entry: /dev/net/tun dev/net/tun none bind,create=file 0 0
|
||||
EOF
|
||||
pct start 103
|
||||
```
|
||||
|
||||
## 3. Docker
|
||||
|
||||
```bash
|
||||
pct exec 103 -- apt-get update
|
||||
pct exec 103 -- apt-get install -y curl ca-certificates
|
||||
pct exec 103 -- bash -c "curl -fsSL https://get.docker.com | sh"
|
||||
```
|
||||
|
||||
## 4. Tailscale-Mitgliedschaft + HTTPS-Zertifikat
|
||||
|
||||
```bash
|
||||
pct exec 103 -- bash -c "curl -fsSL https://tailscale.com/install.sh | sh"
|
||||
pct exec 103 -- tailscale up --authkey=<AUTH_KEY> --hostname=vaultwarden
|
||||
```
|
||||
|
||||
Kein `--accept-routes` nötig — anders als CT 102 sitzt dieser Container nicht zusätzlich im `<LAN_SUBNET>`-LAN in einer Weise, die einen Routing-Konflikt erzeugen würde (Netz-Interface ist zwar auf dem LAN, aber der Dienst wird ausschließlich über die Tailscale-IP angesprochen).
|
||||
|
||||
Voraussetzung in der Tailscale-Admin-Konsole: **Settings → DNS → „HTTPS Certificates"** muss aktiviert sein (einmalig für den ganzen Tailnet, siehe `01-pve-host.md`).
|
||||
|
||||
## 5. Vaultwarden via Docker Compose
|
||||
|
||||
```bash
|
||||
mkdir -p /opt/vaultwarden/data
|
||||
ADMIN_TOKEN=$(openssl rand -base64 48 | tr -d '\n')
|
||||
|
||||
cat > /opt/vaultwarden/docker-compose.yml <<EOF
|
||||
services:
|
||||
vaultwarden:
|
||||
image: vaultwarden/server:latest
|
||||
container_name: vaultwarden
|
||||
restart: unless-stopped
|
||||
logging:
|
||||
driver: json-file
|
||||
options:
|
||||
max-size: "10m"
|
||||
max-file: "3"
|
||||
environment:
|
||||
DOMAIN: "https://vaultwarden.<TAILNET>"
|
||||
ADMIN_TOKEN: "$ADMIN_TOKEN"
|
||||
SIGNUPS_ALLOWED: "true"
|
||||
WEBSOCKET_ENABLED: "true"
|
||||
volumes:
|
||||
- ./data:/data
|
||||
ports:
|
||||
- "127.0.0.1:8080:80"
|
||||
EOF
|
||||
|
||||
cd /opt/vaultwarden && docker compose up -d
|
||||
```
|
||||
|
||||
`SIGNUPS_ALLOWED` bewusst zuerst `true`, um das/die Konto(s) anzulegen. **Nach der Konto-Anlage zwingend zurückstellen:**
|
||||
```bash
|
||||
sed -i 's/SIGNUPS_ALLOWED: "true"/SIGNUPS_ALLOWED: "false"/' /opt/vaultwarden/docker-compose.yml
|
||||
cd /opt/vaultwarden && docker compose up -d
|
||||
```
|
||||
|
||||
## 6. HTTPS-Exposition via `tailscale serve` (kein Caddy, kein manuelles Zertifikat)
|
||||
|
||||
```bash
|
||||
tailscale serve --bg http://127.0.0.1:8080
|
||||
```
|
||||
|
||||
Erreichbar unter `https://vaultwarden.<TAILNET>`, automatisch gültiges Let's-Encrypt-Zertifikat, automatische Erneuerung, **nicht öffentlich** (nur Tailnet-Mitglieder).
|
||||
|
||||
⚠️ **NICHT TUN:** `tailscale serve --bg https / http://...` (alte Syntax). Neuere Tailscale-CLI-Versionen erwarten nur noch `tailscale serve --bg http://127.0.0.1:8080` (HTTPS wird automatisch angenommen).
|
||||
|
||||
⚠️ **NICHT TUN:** Vaultwarden zusätzlich über Caddy auf dem VPS öffentlich exponieren (wie bei Guacamole). Bewusste Entscheidung: der Passwort-Tresor ist der sensibelste Dienst im gesamten Setup, öffentliche Erreichbarkeit erhöht die Angriffsfläche unnötig — der Internetcafé-Fall wird stattdessen über Guacamole selbst abgedeckt (SFTP/RDP-Zugriff auf andere Dienste, nicht direkt auf den Tresor).
|
||||
|
||||
## 7. Konto-Anlage (manueller Web-Schritt, nicht per CLI)
|
||||
|
||||
Über `https://vaultwarden.<TAILNET>` (nur von einem Tailnet-Mitglied aus erreichbar) im Browser ein Konto mit **selbst gewähltem Master-Passwort** anlegen. Das Master-Passwort wird bewusst **nie** programmatisch gesetzt oder irgendwo notiert — es ist der einzige Schlüssel zum gesamten Tresor.
|
||||
|
||||
## Bekannte Stolpersteine (bereits behoben, hier nur als Hinweis)
|
||||
|
||||
* Beim Passwort-Import versehentlich Duplikate erzeugt (zweimal importiert) → behoben durch: alle Einträge auswählen → löschen → Papierkorb leeren → sauber neu importieren.
|
||||
|
||||
## Verifikation
|
||||
|
||||
```bash
|
||||
curl -s -o /dev/null -w "%{http_code}\n" http://127.0.0.1:8080/ # lokal, im Container
|
||||
curl -s -o /dev/null -w "%{http_code}\n" https://vaultwarden.<TAILNET>/ # von einem Tailnet-Mitglied
|
||||
tailscale serve status
|
||||
```
|
||||
Loading…
Reference in a new issue