Déployer Astro sur Cloudflare Pages ou Coolify : guide 2026

Une fois votre site Astro construit, le déploiement est l’étape critique : il doit être rapide, automatisé via Git, sécurisé en HTTPS, et idéalement servi depuis un edge proche de vos visiteurs africains. Deux options dominent en 2026 : Cloudflare Pages (managé, edge mondial, gratuit jusqu’à un seuil élevé) et Coolify (auto-hébergé sur VPS Hetzner). Voici comment configurer chacune.

Voir notre guide complet Astro 5 et le guide Coolify.

Option A — Cloudflare Pages

Cloudflare Pages est l’option recommandée pour la majorité des sites Astro statiques visant l’Afrique. Avantages :

• Gratuit : 500 builds/mois, 100k requêtes/jour, bandwidth illimitée
• Edge mondial : datacenters Lagos, Casablanca, Le Caire pour latence Afrique < 50 ms
• HTTPS automatique
• Preview déploiements à chaque PR
• Cache CDN intelligent + Workers à la demande

Étape 1 — Pousser sur GitHub

git init
git add .
git commit -m "init"
git remote add origin git@github.com:username/mon-site.git
git push -u origin main

Étape 2 — Connecter Cloudflare Pages

1. Cloudflare dashboard → Workers & Pages → Create → Pages → Connect to Git
2. Autoriser GitHub, choisir le repo
3. Build settings : framework preset « Astro », build command npm run build, output dir dist
4. Environment variables si besoin (NODE_VERSION=20, etc.)
5. Save and Deploy

Premier build en 1-3 minutes. URL your-project.pages.dev. Connectez votre domaine custom dans Custom domains.

Étape 3 — SSR/Server Islands

bun add @astrojs/cloudflare

// astro.config.mjs
import cloudflare from "@astrojs/cloudflare";
export default defineConfig({
  output: "server",
  adapter: cloudflare(),
});

Option B — Coolify sur Hetzner

Cloudflare Pages couvre 95 % des cas. Si vous voulez la souveraineté complète, du SSR custom, ou de la perf cumulée avec d’autres apps, Coolify sur Hetzner est l’option auto-hébergée. Voir notre guide Coolify.

Setup Coolify

1. Coolify → New Resource → Application → Public/Private Repository
2. Build pack : Nixpacks (auto-détecte Astro)
3. Build command : npm run build
4. Start command : node dist/server/entry.mjs (si SSR) ou serveur statique
5. Port : 4321 ou 8080 selon adapter
6. Domaine, HTTPS, déployer

Caddy pour servir le statique

Pour un site purement statique sur VPS, vous pouvez aussi le servir via Caddy directement, sans framework runtime :

# /etc/caddy/Caddyfile
exemple.sn {
  root * /var/www/mon-site/dist
  file_server
  encode gzip zstd
  
  # Cache assets longue durée
  @assets path *.js *.css *.woff2 *.png *.jpg *.svg
  header @assets Cache-Control "public, max-age=31536000, immutable"
}

Cloudflare devant Coolify

Combinaison gagnante pour l’Afrique : Coolify sur Hetzner Helsinki + Cloudflare Free devant. Vos visiteurs africains accèdent au cache edge Cloudflare proche, le serveur Hetzner reçoit moins de requêtes, et vous gardez le contrôle complet.

1. Domain → Cloudflare DNS
2. Activer « Proxied » (orange)
3. SSL/TLS mode : « Full (strict) » — Coolify a déjà un cert valide
4. Cache Rules : agressif sur les assets, normal sur les HTML

Comparaison rapide

Recommandation

Site statique simple ou blog → Cloudflare Pages, point. Site avec backend custom, SaaS, e-commerce → Coolify + Cloudflare devant.

Erreurs fréquentes

Pour aller plus loin

• Guide complet Astro 5
• Guide Coolify
• Cloudflare gratuit pour PME africaines