Expand local_machine docs and automation for connectivity, games, and ops.

Add proxy/VPN/telegram launchd and emergency runbooks; reorganize apps docs; document JA3 CrossOver runbook and Wine troubleshooting; add GOG/HoMM game scripts, disk cleanup guides, and gitea push-via-proxy helper. Ignore temp/. Co-authored-by: Cursor <cursoragent@cursor.com>
2026-06-01 08:12:19 +03:00
parent a39ef89125
commit 1938b7c743
135 changed files with 9933 additions and 388 deletions
--- a/docs/apps/cursor/scripts/cursor-socks-tunnel.ps1
+++ b/docs/apps/cursor/scripts/cursor-socks-tunnel.ps1
@@ -0,0 +1,107 @@
+# SOCKS5-туннель для Cursor (обход PING timeout из РФ).
+# Использование: .\cursor-socks-tunnel.ps1 [start|stop|status]
+# См. docs/cursor/README.md и docs/connectivity/WINDOWS_CURSOR_TUNNEL.md
+
+param(
+    [Parameter(Position = 0)]
+    [ValidateSet("start", "stop", "status")]
+    [string]$Command = "start"
+)
+
+$CURSOR_SOCKS_PORT = if ($env:CURSOR_SOCKS_PORT) { $env:CURSOR_SOCKS_PORT } else { "10809" }
+$SSH_HOST = if ($env:CURSOR_TUNNEL_HOST) { $env:CURSOR_TUNNEL_HOST } else { "ahau@149.154.64.19" }
+$CursorViaDo = ($env:CURSOR_SOCKS_VIA_DO -ne "0")
+
+function Test-PortListening {
+    $conn = Get-NetTCPConnection -LocalPort $CURSOR_SOCKS_PORT -State Listen -ErrorAction SilentlyContinue
+    return $null -ne $conn
+}
+
+function Get-SshTunnelPids {
+    # Найти процессы ssh.exe, у которых в командной строке есть -D и наш порт
+    Get-CimInstance Win32_Process -Filter "Name = 'ssh.exe'" -ErrorAction SilentlyContinue |
+        Where-Object { $_.CommandLine -match "-D\s+$CURSOR_SOCKS_PORT" } |
+        ForEach-Object { $_.ProcessId }
+}
+
+function Start-Tunnel {
+    if (Test-PortListening) {
+        Write-Host "SOCKS already listening on 127.0.0.1:$CURSOR_SOCKS_PORT"
+        return
+    }
+    $targetHost = $SSH_HOST
+    $stableOpts = @(
+        "-o", "TCPKeepAlive=yes",
+        "-o", "IPQoS=throughput",
+        "-o", "ServerAliveInterval=60",
+        "-o", "ServerAliveCountMax=4"
+    )
+    $ruOpts = @(
+        "-o", "ServerAliveInterval=30",
+        "-o", "ServerAliveCountMax=6"
+    )
+    if ($CursorViaDo) {
+        & ssh -o BatchMode=yes -o ConnectTimeout=6 -o ConnectionAttempts=1 hsites-ahau "exit 0" 2>$null
+        if ($LASTEXITCODE -ne 0) {
+            Write-Error "hsites-ahau недоступен: SOCKS только по цепочке Mac→RU→DO (без прямого Mac→DO). Восстановите SSH до RU или задайте CURSOR_SOCKS_VIA_DO=0."
+            exit 1
+        }
+        $targetHost = "telegram-socks-via-do"
+    }
+    $sshArgs = @(
+        "-D", $CURSOR_SOCKS_PORT,
+        "-f", "-N"
+    )
+    if ($CursorViaDo) {
+        $sshArgs += $stableOpts
+    } else {
+        $sshArgs += $ruOpts
+    }
+    $sshArgs += $targetHost
+    & ssh @sshArgs
+    if ($LASTEXITCODE -eq 0) {
+        if ($CursorViaDo) {
+            Write-Host "SOCKS tunnel started: 127.0.0.1:$CURSOR_SOCKS_PORT -> $targetHost (DO exit)"
+        } else {
+            Write-Host "SOCKS tunnel started: 127.0.0.1:$CURSOR_SOCKS_PORT -> $targetHost (RU exit, CURSOR_SOCKS_VIA_DO=0)"
+        }
+    } else {
+        Write-Error "Failed to start tunnel (exit code $LASTEXITCODE). Check SSH config (telegram-socks-via-do) or host: $targetHost"
+        exit $LASTEXITCODE
+    }
+}
+
+function Stop-Tunnel {
+    $pids = Get-SshTunnelPids
+    if ($pids) {
+        foreach ($pid in $pids) {
+            Stop-Process -Id $pid -Force -ErrorAction SilentlyContinue
+        }
+        Write-Host "Tunnel stopped (killed SSH process(es): $($pids -join ', '))."
+    } else {
+        # Fallback: убить процесс, занимающий порт 10809
+        $conn = Get-NetTCPConnection -LocalPort $CURSOR_SOCKS_PORT -State Listen -ErrorAction SilentlyContinue
+        if ($conn) {
+            $conn | ForEach-Object { Stop-Process -Id $_.OwningProcess -Force -ErrorAction SilentlyContinue }
+            Write-Host "Tunnel stopped (killed process on port $CURSOR_SOCKS_PORT)."
+        } else {
+            Write-Host "No SOCKS tunnel found on port $CURSOR_SOCKS_PORT."
+        }
+    }
+}
+
+function Get-Status {
+    if (Test-PortListening) {
+        Write-Host "SOCKS listening on 127.0.0.1:$CURSOR_SOCKS_PORT"
+        Get-NetTCPConnection -LocalPort $CURSOR_SOCKS_PORT -State Listen -ErrorAction SilentlyContinue |
+            Format-Table LocalAddress, LocalPort, State, OwningProcess -AutoSize
+    } else {
+        Write-Host "No SOCKS listener on port $CURSOR_SOCKS_PORT"
+    }
+}
+
+switch ($Command) {
+    "start"  { Start-Tunnel }
+    "stop"   { Stop-Tunnel }
+    "status" { Get-Status }
+}
--- a/docs/apps/cursor/scripts/cursor-socks-tunnel.sh
+++ b/docs/apps/cursor/scripts/cursor-socks-tunnel.sh
@@ -0,0 +1,45 @@
+#!/usr/bin/env bash
+# Поднимает SOCKS5-туннель для Cursor (обход PING timeout из РФ).
+# Использование: ./cursor-socks-tunnel.sh [start|stop|status]
+# См. docs/cursor/README.md
+
+set -e
+CURSOR_SOCKS_PORT="${CURSOR_SOCKS_PORT:-10809}"
+SSH_HOST="${CURSOR_TUNNEL_HOST:-hsites-ahau}"
+
+start() {
+  if lsof -i :"$CURSOR_SOCKS_PORT" -sTCP:LISTEN -t >/dev/null 2>&1; then
+    echo "SOCKS already listening on 127.0.0.1:$CURSOR_SOCKS_PORT"
+    return 0
+  fi
+  ssh -D "$CURSOR_SOCKS_PORT" -f -N \
+    -o ServerAliveInterval=30 \
+    -o ServerAliveCountMax=6 \
+    "$SSH_HOST"
+  echo "SOCKS tunnel started: 127.0.0.1:$CURSOR_SOCKS_PORT -> $SSH_HOST"
+}
+
+stop() {
+  pkill -f "ssh.*-D $CURSOR_SOCKS_PORT.*$SSH_HOST" 2>/dev/null || true
+  echo "Tunnel stopped (if it was running)."
+}
+
+status() {
+  if lsof -i :"$CURSOR_SOCKS_PORT" -sTCP:LISTEN -t >/dev/null 2>&1; then
+    echo "SOCKS listening on 127.0.0.1:$CURSOR_SOCKS_PORT"
+    lsof -i :"$CURSOR_SOCKS_PORT" -sTCP:LISTEN
+  else
+    echo "No SOCKS listener on port $CURSOR_SOCKS_PORT"
+  fi
+}
+
+case "${1:-start}" in
+  start) start ;;
+  stop)  stop ;;
+  status) status ;;
+  *)
+    echo "Usage: $0 {start|stop|status}"
+    echo "Env: CURSOR_SOCKS_PORT=$CURSOR_SOCKS_PORT, CURSOR_TUNNEL_HOST=$SSH_HOST"
+    exit 1
+    ;;
+esac