# VPN Pink Windows CLI – Anleitung

Öffentlicher Beta-Testbuild 0.1.12, Stand 23.10.2026. Für Windows x64.

## Voraussetzungen

Ein gültiger VPN-Pink-Zugang mit freigeschaltetem Serverzugriff und eine
Internetverbindung. Die CLI funktioniert als einzelne EXE ohne App-MSI,
WSL, Python oder Rust. IPsec/IKEv2 nutzt die Windows-VPN-Dienste.
Für WireGuard ist zusätzlich die offizielle WireGuard-Komponente erforderlich:
https://www.wireguard.com/install/

Die EXE ist nicht digital signiert. Eine Prüfsumme bestätigt die Dateiintegrität,
ersetzt aber keine Herausgebersignatur. Windows-Sicherheitsprüfungen nicht deaktivieren.

## Schnellstart mit PowerShell

vpn-pink-cli.exe herunterladen, PowerShell im Downloadordner öffnen:

```powershell
.\vpn-pink-cli.exe --help
.\vpn-pink-cli.exe doctor
.\vpn-pink-cli.exe login
.\vpn-pink-cli.exe servers
```

`login` fragt E-Mail und Passwort im Terminal ab. Das Passwort wird nicht
angezeigt. Keine Zugangsdaten als Befehlsargumente übergeben.
Die Sitzung wird im Windows-Anmeldeinformationsmanager gespeichert.
`servers` zeigt die tatsächlich für das Konto verfügbaren IDs.

## Verbinden

Beispiele – nur IDs verwenden, die `servers` für das eigene Konto ausgibt:

```powershell
# Deutschland, IPsec/IKEv2
.\vpn-pink-cli.exe connect --server 1 --protocol ikev2

# Deutschland, WireGuard
.\vpn-pink-cli.exe connect --server 1 --protocol wireguard

# Spanien, IPsec/IKEv2
.\vpn-pink-cli.exe connect --server 80 --protocol ikev2

# Interaktive Server- und Protokollwahl
.\vpn-pink-cli.exe connect

# Begrenzter Test: automatische Trennung nach 60 Sekunden
.\vpn-pink-cli.exe connect --server 80 --protocol ikev2 --duration 60
```

Das Connect-Terminal bleibt während der Verbindung geöffnet.
Zum Trennen Strg+C drücken oder ein zweites PowerShell-Fenster im selben
Ordner öffnen und `disconnect` ausführen. Normales Schließen beendet die
CLI-Sitzung; Status und Disconnect in einem zweiten Terminal sind vorzuziehen.
Windows kann für den WireGuard-Helfer Administratorfreigabe verlangen.
Diese Freigabe muss der Benutzer selbst bestätigen.

## Status, Trennen und Abmelden

In einem zweiten Terminal:

```powershell
.\vpn-pink-cli.exe status
.\vpn-pink-cli.exe disconnect
.\vpn-pink-cli.exe logout
```

`logout` trennt eine aktive CLI-Verbindung und löscht die gespeicherte
CLI-Anmeldesitzung. Die grafische App hat eine separate Anmeldung.
Vor einem Server- oder Protokollwechsel zuerst trennen.
Eine andere aktive VPN-Verbindung wird nicht übernommen; sie kann den Aufbau blockieren.

## Befehlsübersicht

| Aufruf | Tätigkeit |
|---|---|
| kein Argument, `help`, `--help`, `-h` | Hilfe anzeigen |
| `login` | Interaktive Anmeldung |
| `servers` | Für das Konto verfügbare Server anzeigen |
| `connect` | Server und Protokoll interaktiv wählen |
| `connect --server ID --protocol ikev2` | IPsec/IKEv2 verbinden |
| `connect --server ID --protocol wireguard` | WireGuard verbinden |
| `connect --server ID --protocol auto` | IKEv2 verwenden |
| `connect ... --duration SEKUNDEN` | Nach Verbindungsprüfung zeitlich begrenzen |
| `status` | Aktuellen CLI-Tunnelstatus anzeigen |
| `disconnect` | CLI-eigenen Tunnel trennen |
| `logout` | CLI-Sitzung abmelden und gespeicherte Anmeldung entfernen |
| `doctor` | Sitzung, Windows-Dienste und WireGuard-Voraussetzungen diagnostizieren |

`doctor` baut keinen VPN-Tunnel auf. Die CLI schreibt Statusdaten als JSON
und Fortschrittsmeldungen ins Terminal. `ipv6_verified` muss ausdrücklich
true sein, damit eine IPv6-Ausgangsadresse als geprüft gilt.

## CLI und grafische App unterscheiden

Der normale eigenständige CLI-Connect lädt benötigte API-Daten und prüft
öffentliche Ausgangsadressen. Die neue MSI-App bereitet ihre Verbindung vor
Connect vor und verwendet einen anderen internen Aufruf ohne eigene
HTTP-Anfragen im vorbereiteten Connect-Ablauf. Dort bestätigen lokale
Tunnelprüfungen die Verbindung; öffentliche IPs werden dabei nicht gemessen.
Die normale CLI erfordert kein installiertes App-MSI.

## Beta-Stand

24 CLI-, 19 native App- und 30 Frontendtests bestanden. Frühere normale
CLI-Live-Tests bestätigten IPsec und WireGuard. Der neue vorbereitete native
App-Adapter wurde mit IPsec verbunden und getrennt. Ein neuer grafischer
Klicktest und der WireGuard-Live-Test des vorbereiteten App-Ablaufs stehen aus.
Eine frische interaktive E-Mail/Passwort-Anmeldung wurde in diesen Live-Tests
nicht separat bestätigt; dafür wurde eine vorhandene Sitzung verwendet.
Die neue Verbindungsgeschwindigkeit und Statusanzeige sind weiter zu prüfen.
Fehlerberichte ohne Passwörter, Zugriffstoken oder private WireGuard-Schlüssel senden.

## SHA-256 prüfen

```powershell
Get-FileHash .\vpn-pink-cli.exe -Algorithm SHA256
Get-FileHash .\VPN-Pink-Setup-0.1.12-x64.msi -Algorithm SHA256
```

Die Ergebnisse mit SHA256SUMS.txt von der Downloadseite vergleichen.