🌐 MADACUP sur Cloudflare Pages — Documentation

Dernière MAJ : 16 Juin 2026 Auteur : Fefe (via ZCode) Statut : ✅ Opérationnel — sites servis à 100 % par Cloudflare

1. Vue d’ensemble

Le site MADACUP est entièrement servi par Cloudflare Pages (CDN global + SSL + edge cache). Le VPS ne sert plus madacup.online ni dev.madacup.online — uniquement les sous-domaines shop., oauth., media..

                    ┌──────────────────────────┐
   madacup.online   │   Cloudflare Pages       │
   dev.madacup.online│   (CDN edge, SSL auto)  │
         ──────────►│   madacup.pages.dev      │
                      madacup-dev.pages.dev     │
                    └──────────────────────────┘
                              ▲
                              │ déploiement
                              │
                    ┌─────────┴────────────────┐
                    │   VPS Ubuntu 24.04       │
                    │   /var/www/madacup-website    │  ← source prod
                    │   /var/www/dev.madacup.online-nexus │  ← source dev
                    │   /root/deploy-madacup.sh      │  ← script de déploiement
                    └──────────────────────────┘

2. Architecture & URLs

Projets Cloudflare Pages

Account Cloudflare

DNS madacup.online

3. Déploiement — /root/deploy-madacup.sh

Usage

./deploy-madacup.sh              # déploie prod + dev (défaut)
./deploy-madacup.sh prod         # déploie seulement la prod
./deploy-madacup.sh dev          # déploie seulement le dev
./deploy-madacup.sh --check      # vérifie l'état HTTP sans déployer

Ce que fait le script

1. Préflight — vérifie le token Cloudflare (/root/.secrets/cf-api-token-full.txt) et wrangler
2. Staging propre — copie la source vers /tmp/deploy-madacup-<env>/ en excluant :
   • .env (clé Stripe) 🔒
   • .git, .gitignore, .wrangler, .agents, .github
   • node_modules, .DS_Store
3. Garde-fou sécurité — si un .env est détecté dans le staging → déploiement annulé
4. Upload — wrangler pages deploy vers le projet cible
5. Vérification HTTP — teste madacup.online, dev.madacup.online, /impressum, /datenschutz
6. Statut API — vérifie que les custom domains sont active

Workflow type (modification du site)

# 1. Modifier les fichiers source
vim /var/www/madacup-website/index.html

# 2. Déployer
/root/deploy-madacup.sh prod

# 3. Le script vérifie le HTTP automatiquement après coup

4. Fichiers de configuration Cloudflare Pages

Ces fichiers vivent à la racine de chaque site (/var/www/madacup-website/ et /var/www/dev.madacup.online-nexus/).

_headers — Sécurité & cache

/*
  X-Frame-Options: SAMEORIGIN
  X-Content-Type-Options: nosniff
  Referrer-Policy: strict-origin-when-cross-origin
  Permissions-Policy: geolocation=(), microphone=(), camera=()
  Cache-Control: public, max-age=3600

/assets/*    → Cache-Control: public, max-age=31536000, immutable
/css/*       → idem
/js/*        → idem
/fonts/*     → idem
/*.html      → Cache-Control: public, max-age=0, must-revalidate

_redirects — Routing

# Cloudflare Pages gère nativement les "pretty URLs"
# (/impressum → impressum.html) — ne PAS les redéfinir (boucle 308).

/*    /index.html    200      # Fallback 404 → page d'accueil

⚠️ Leçon apprise : ne jamais redéfinir /impressum → /impressum.html dans _redirects. Pages le fait déjà nativement → ça crée une boucle 308 infinie.

5. Nginx — état après migration

Vhosts désactivés (plus servis par le VPS)

Les liens symboliques ont été retirés de /etc/nginx/sites-enabled/. Les fichiers de config sont conservés dans /etc/nginx/sites-available/ (réactivables).

Réactivation éventuelle (si retour VPS nécessaire) :

ln -s /etc/nginx/sites-available/madacup.online /etc/nginx/sites-enabled/
ln -s /etc/nginx/sites-available/dev.madacup.online /etc/nginx/sites-enabled/
nginx -t && systemctl reload nginx

Vhosts toujours actifs sur le VPS

6. Credentials & secrets

🔴 Les tokens Cloudflare proviennent de vps-tailscale (144.91.96.120) via le script /root/pull-okf.sh. La source de vérité est sur ce VPS principal.

Récupérer le token Cloudflare si absent du VPS

mkdir -p /root/.secrets
scp root@144.91.96.120:/root/.secrets/cf-api-token-full.txt /root/.secrets/
chmod 600 /root/.secrets/cf-api-token-full.txt

7. Stack technique

• Hébergement : Cloudflare Pages (gratuit, CDN global 300+ edge locations)
• Build : aucun (site statique HTML/CSS/JS prêt à servir)
• SSL : Cloudflare Universal SSL (automatique, renouvelé par CF)
• HTTP/3 (QUIC) : activé par défaut sur le proxy Cloudflare
• DNS : Cloudflare (nameservers blakely.ns.cloudflare.com + kianchau.ns.cloudflare.com)
• Registrar : Namecheap (⚠️ bien maintenir le WHOIS vérifié)

8. Dépannage

ERR_QUIC_PROTOCOL_ERROR sur madacup.online

Cause probable : le WHOIS du domaine est en vérification chez Namecheap → les NS basculent vers failed-whois-verification.namecheap.com → le DNS Cloudflare n’est plus consulté.

Diagnostic :

dig NS madacup.online +short
# Si on voit "failed-whois-verification.namecheap.com" → aller valider le WHOIS chez Namecheap

Fix : Dashboard Namecheap → valider les infos de contact WHOIS du domaine.

Boucle de redirection 308 sur /impressum

Cause : règle _redirects redondante avec les pretty URLs natifs de Pages.

Fix : s’assurer que _redirects ne contient que le fallback :

/*    /index.html    200

Custom domain stuck en pending

Cause : DNS pas encore propagé, ou certificat SSL en cours d’émission.

Diagnostic :

/root/deploy-madacup.sh --check

Fix : attendre 2-15 min (propagation + SSL). Vérifier sur le dashboard Cloudflare → Pages → Custom domains.

Vérifier qui sert le site

curl -sI https://madacup.online | grep -iE 'server|cf-ray'
# Doit renvoyer : server: cloudflare + cf-ray: xxx-XXX

9. Historique

• 16/06/2026 — Migration complète vers Cloudflare Pages :
  • Création des projets madacup + madacup-dev via API
  • Déploiement direct (176 fichiers × 2)
  • Attach des custom domains madacup.online + dev.madacup.online
  • Bascule DNS : A → CNAME vers *.pages.dev
  • Déblocage WHOIS Namecheap (a fait passer les NS vers Cloudflare)
  • Correction boucle 308 (_redirects)
  • Désactivation vhosts Nginx madacup.online + dev.madacup.online
  • Création du script /root/deploy-madacup.sh
  • Création de cette documentation