Add Windows client installation guide
This commit is contained in:
74
README.md
74
README.md
@ -185,3 +185,77 @@ ssh -o ProxyCommand='upterm proxy wss://TOKEN@upterm.ebesch.de' \
|
|||||||
|
|
||||||
- [GitHub – owenthereal/upterm](https://github.com/owenthereal/upterm)
|
- [GitHub – owenthereal/upterm](https://github.com/owenthereal/upterm)
|
||||||
- [upterm.dev](https://upterm.dev)
|
- [upterm.dev](https://upterm.dev)
|
||||||
|
---
|
||||||
|
|
||||||
|
## Windows Client
|
||||||
|
|
||||||
|
### Installation via Scoop (empfohlen)
|
||||||
|
|
||||||
|
**Scoop installieren** (PowerShell als Administrator):
|
||||||
|
|
||||||
|
```powershell
|
||||||
|
Invoke-RestMethod -Uri https://get.scoop.sh | Invoke-Expression
|
||||||
|
```
|
||||||
|
|
||||||
|
**Bekanntes Problem: 7zip-Extraktion schlägt fehl (Exit code 1640)**
|
||||||
|
|
||||||
|
7zip installiert sich via MSI und schlägt auf manchen Windows-Systemen mit folgendem Fehler fehl:
|
||||||
|
|
||||||
|
```
|
||||||
|
ERROR Exit code was 1640!
|
||||||
|
Failed to extract files from ...\7z2601-x64.msi.
|
||||||
|
```
|
||||||
|
|
||||||
|
**Workaround:** `lessmsi` als alternativen MSI-Extraktor verwenden:
|
||||||
|
|
||||||
|
```powershell
|
||||||
|
# Fehlgeschlagene Installation bereinigen
|
||||||
|
scoop uninstall 7zip
|
||||||
|
scoop cache rm 7zip
|
||||||
|
|
||||||
|
# lessmsi als MSI-Extraktor aktivieren
|
||||||
|
scoop config use_lessmsi true
|
||||||
|
|
||||||
|
# 7zip erneut installieren – diesmal via lessmsi
|
||||||
|
scoop install 7zip
|
||||||
|
```
|
||||||
|
|
||||||
|
**upterm installieren:**
|
||||||
|
|
||||||
|
```powershell
|
||||||
|
scoop bucket add upterm https://github.com/owenthereal/scoop-upterm
|
||||||
|
scoop install upterm
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
### Nutzung unter Windows
|
||||||
|
|
||||||
|
**Session starten (PowerShell):**
|
||||||
|
|
||||||
|
```powershell
|
||||||
|
# Eigener Server, automatisch akzeptieren
|
||||||
|
upterm host --server ssh://upterm.ebesch.de:2222 --accept
|
||||||
|
|
||||||
|
# Beim ersten Verbinden: Host-Key bestätigen mit "yes"
|
||||||
|
# Danach erscheint der Token direkt:
|
||||||
|
# ➤ SSH: ssh TOKEN:HASH@upterm.ebesch.de -p 2222
|
||||||
|
```
|
||||||
|
|
||||||
|
> Unter Windows startet upterm standardmäßig eine `powershell -NoLogo` Session statt `bash`.
|
||||||
|
|
||||||
|
**Client verbindet sich (nur SSH nötig):**
|
||||||
|
|
||||||
|
```powershell
|
||||||
|
ssh TOKEN:HASH@upterm.ebesch.de -p 2222
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
### Troubleshooting
|
||||||
|
|
||||||
|
| Problem | Lösung |
|
||||||
|
|---------|--------|
|
||||||
|
| 7zip Exit code 1640 | `scoop config use_lessmsi true`, dann `scoop install 7zip` neu |
|
||||||
|
| Host-Key Warnung | Einmalig mit `yes` bestätigen; Fingerprint: `SHA256:nOHK++kJYUJz1bqUY1AM6defn36vTXsgWuSEhr3ltLk` |
|
||||||
|
| `upterm` nicht gefunden | PowerShell neu starten (PATH wird erst nach Neustart übernommen) |
|
||||||
|
|||||||
Reference in New Issue
Block a user