Files
docu/shared/tmux-windows-terminal-fix.md
T
root 92148f41a7 Doku: tmux OSC-11-Leak (Windows Terminal) + pve2 SSH auf Horus.
Issue und Shared-Config für escape-time/O11-Fix; pve2-Keys in horus-root.pub.

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-06-28 18:38:02 +02:00

76 lines
2.1 KiB
Markdown

# tmux — OSC-11-Leak in Windows Terminal (SSH)
**Stand:** 2026-06-28 · **Status:** gelöst (verifiziert)
**Issue:** [../issues/2026-06-28-tmux-osc11-windows-terminal-leak.md](../issues/2026-06-28-tmux-osc11-windows-terminal-leak.md)
---
## Symptom
Beim Start von `tmux` oder nach SSH erscheint Text im Prompt, z. B.:
```
11;rgb:0c0c/0c0c/0c0c
```
**Keine Schadsoftware** — das ist eine **Terminal-Kontrollsequenz**, die fälschlich als Tastatureingabe landet.
---
## Ursache
| Teil | Was passiert |
|------|----------------|
| **OSC 11** | tmux fragt die Hintergrundfarbe des Terminals ab |
| **Antwort** | Terminal antwortet z. B. `rgb:0c0c/0c0c/0c0c` (dunkles Grau) |
| **Leak** | Bei SSH-Latenz + zu kurzem `escape-time` bricht tmux die Sequenz ab → Rest landet in `stdin`/Prompt |
Häufig bei: **Windows Terminal****SSH****tmux** auf Linux-Hosts.
---
## Fix (`~/.tmux.conf`)
Zwei Maßnahmen (beide auf **pve1**, **pve2**, **Horus** deployed):
```bash
# Ansatz 1: tmux mehr Zeit für Escape-Sequenzen (war auf pve2 nur 10 ms)
set -sg escape-time 50
# Ansatz 2: OSC-11-Hintergrundabfrage deaktivieren (Fallback)
set -as terminal-overrides ',*:O11=@'
```
Referenz-Config im Repo: [tmux.conf](tmux.conf)
**Nach Änderung tmux neu laden:**
```bash
tmux kill-server # alle Sessions beenden
# oder in laufender Session:
tmux source-file ~/.tmux.conf
```
Falls Leak bleibt: `escape-time` schrittweise auf **100** erhöhen (nicht >500 — spürbarer ESC-Lag in vim).
---
## Deploy-Stand
| Host | Pfad | Anmerkung |
|------|------|----------|
| pve1 `192.168.10.5` | `/root/.tmux.conf` | identisch mit Referenz |
| pve2 `192.168.10.4` | `/root/.tmux.conf` | `escape-time` von 10→50 |
| Horus `10.1.1.1` | `/root/.tmux.conf` | neu angelegt |
---
## Referenzen
| Thema | Doc |
|-------|-----|
| pve1 Host | [../pve1/infrastructure-host.md](../pve1/infrastructure-host.md) |
| pve2 Host | [../pve2/infrastructure-host.md](../pve2/infrastructure-host.md) |
| Horus | [../horus/README.md](../horus/README.md) |
| Fish (pve1/pve2) | pve1 `fish-setup.yml`, pve2 `/root/.config/fish/` von pve1 |