China-Modus: Pragma läuft jetzt ohne VPN hinter der Great Firewall
Pragma kann ab sofort für chinesische Teams ohne VPN betrieben werden. Ein einzelner Umgebungsvariablen-Schalter macht die gesamte Plattform GFW-kompatibel.
Das Problem
Die Great Firewall of China (GFW) blockiert mehrere externe Dienste, die Standard-SaaS-Plattformen nutzen:
- Cloudflare Turnstile — Login-CAPTCHA, das auf
challenges.cloudflare.comlädt - PayPal SDK — wird für den Checkout auf
www.paypal.com/sdk/jsgeladen
Wenn diese Skripte nicht laden, bleibt der Login hängen (Turnstile-Widget blockiert das Formular) und die Bezahlseite ist leer (PayPal-Button erscheint nie). Beides macht die Plattform für chinesische Nutzer unbenutzbar — ohne dass eine Fehlermeldung erscheint.
Die Lösung
CHINA_MODE=1 — ein Schalter, alles geregelt
Setzt man CHINA_MODE=1 (oder true) in der Server-Umgebung, gilt:
- Turnstile wird komplett deaktiviert — das CAPTCHA-Widget wird serverseitig übersprungen. Der serverseitige Brute-Force-Schutz (
login_throttle.py) bleibt aktiv, sodass keine Sicherheitslücke entsteht. - Kein externer Skript-Load — der Browser lädt nichts von Cloudflare oder PayPal.
Timeout-Fallback (ohne CHINA_MODE)
Für Teams, die keine eigene China-Instanz betreiben, aber einzelne Nutzer hinter der GFW haben:
- Login/Signup: Nach 5 Sekunden ohne Turnstile-Load wird das Widget automatisch ausgeblendet — das Formular bleibt voll funktionsfähig.
- Bezahlseite: Nach 8 Sekunden ohne PayPal-SDK erscheint eine freundliche Nachricht mit direktem Kontakt-Link statt einer leeren Seite.
Deployment
Für dedizierte China-Instanzen: einfach CHINA_MODE=1 als Umgebungsvariable setzen — kein Code-Update, kein Redeployment der App nötig.
CHINA_MODE=1