Skip to main content

China-Modus: Pragma läuft jetzt ohne VPN hinter der Great Firewall

· 2 min read

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.com lädt
  • PayPal SDK — wird für den Checkout auf www.paypal.com/sdk/js geladen

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

Das war es.

Warum das wichtig ist​

Einer der häufigsten Einwände von EU-Teams mit China-Geschäft: „Unsere chinesischen Kollegen können die Plattform nicht nutzen, weil VPN bei uns verboten ist."

Mit CHINA_MODE ist dieser Einwand erledigt. Pragma ist damit eine der wenigen B2B-SaaS-Plattformen, die nativ GFW-kompatibel deploybar sind — ohne Architekturänderungen, ohne separaten Tech-Stack.

Live-Demo starten · App öffnen