Files
ClaudeProjectManager/WEBSOCKET_TROUBLESHOOTING.md
Claude Project Manager 4dab418f2f Initial commit
2025-07-09 22:10:42 +02:00

1.7 KiB

WebSocket Verbindungsprobleme - Lösungen

Problem

WebSocket-Verbindungen (ws:// oder wss://) werden oft von Unternehmensnetzwerken blockiert:

  • Firewalls blockieren WebSocket-Protokoll
  • Proxies unterstützen kein WebSocket-Upgrade
  • Nur HTTP/HTTPS Ports (80/443) sind erlaubt

Implementierte Lösung

Der Activity Service verwendet jetzt HTTP Long-Polling statt WebSockets:

  • Funktioniert über Standard HTTP
  • Umgeht WebSocket-Blockierungen
  • Etwas höhere Latenz, aber zuverlässiger in restriktiven Netzwerken

Weitere Lösungsansätze

1. Proxy-Konfiguration

Wenn Ihr Netzwerk einen HTTP-Proxy verwendet:

# In services/activity_sync.py
import os
os.environ['HTTP_PROXY'] = 'http://proxy.company.com:8080'
os.environ['HTTPS_PROXY'] = 'http://proxy.company.com:8080'

2. Alternative Ports

Fragen Sie Ihren Admin, ob der Activity Server auch auf Port 80 oder 443 laufen kann.

3. VPN verwenden

Wenn verfügbar, kann eine VPN-Verbindung die Netzwerkbeschränkungen umgehen.

4. Lokaler Activity Server

Für Entwicklung/Test einen lokalen Server verwenden:

  • Server URL: http://localhost:3001
  • Keine Netzwerkbeschränkungen

Test der Verbindung

  1. Browser-Test: http://91.99.192.14:3001/health
  2. Curl-Test: curl http://91.99.192.14:3001/health
  3. Python-Test-Skript: python test_activity_connection.py

Firewall-Regeln

Falls Sie Admin-Rechte haben, erlauben Sie:

  • Ausgehende TCP-Verbindungen zu 91.99.192.14:3001
  • HTTP/HTTPS Traffic zu diesem Server

Status in CPM

  • Grüner Punkt: Verbindung aktiv
  • Meldung "Nicht verbunden": Server nicht erreichbar
  • Die Aktivitätsfunktion ist optional - CPM funktioniert vollständig ohne sie