[{"data":1,"prerenderedAt":212},["ShallowReactive",2],{"seo-verification":3,"blog-heberger-cartes-protomaps-pmtiles-vps-ma-fr":6,"promo-bar-likely":161},{"google":4,"bing":5},"EycwPY2XMyTkVzas3n1ygeNJFGAH513qrMjfDljzsMQ","",{"key":7,"data":8},"blog-heberger-cartes-protomaps-pmtiles-vps-ma-fr",{"id":9,"slug":10,"slugs":11,"title":15,"excerpt":16,"readTime":17,"views":18,"isPinned":19,"noindex":19,"publishedAt":20,"updatedAt":21,"category":22,"categories":28,"featuredImage":30,"bgImage":31,"posterImage":32,"relatedSolution":30,"intro":33,"keyPoints":34,"sections":35,"ctaTitle":146,"ctaBody":147,"ctaButton":148,"ctaUrl":149,"relatedPosts":150},582,"heberger-cartes-protomaps-pmtiles-vps",{"fr":10,"en":12,"ar":13,"es":14},"host-your-own-protomaps-pmtiles-maps-vps","استضافة-خرائط-pmtiles-على-vps","alojar-mapas-protomaps-pmtiles-vps","Héberger ses propres cartes Protomaps (PMTiles) sur un VPS","Servez vos cartes vectorielles depuis votre VPS : un fichier PMTiles, nginx en requêtes par plage d'octets, MapLibre GL JS. Taille réelle, CORS et dépannage.",11,0,false,"2026-11-16T00:00:00+00:00","2026-11-20T14:16:42+00:00",{"id":23,"name":24,"slug":25,"color":26,"icon":27},4,"Développement","developpement","bg-warning\u002F10 text-warning","dev",[29],{"id":23,"name":24,"slug":25,"color":26,"icon":27},null,"\u002Fblog\u002Fcovers\u002Fbg.svg","\u002Fblog\u002Fcovers\u002Fheberger-cartes-protomaps-pmtiles-vps-poster.svg","Votre client veut une carte sur sa page contact, et vous la branchez sur une API commerciale. Quelques mois plus tard, la facture suit la fréquentation du site, et la clé, visible dans le code de la page, peut être copiée par n'importe qui. Il existe une voie plus sobre : une archive PMTiles posée sur un VPS, servie par nginx en requêtes par plage d'octets, affichée par MapLibre GL JS. Aucun serveur de cartes à administrer. Ce guide donne les commandes, la taille réelle des fichiers, les erreurs rencontrées et leurs messages exacts.",[],[36,40,50,53,92,95,120,123,126,136,139,143],{"type":37,"title":38,"body":39},"h2","Pourquoi servir ses propres cartes plutôt que louer des tuiles","Une page contact avec un plan, un localisateur de magasins, une carte de livraison : presque tous les sites clients en portent une. Le réflexe est d'intégrer une API de cartes commerciale, avec une clé. Deux problèmes apparaissent avec le temps. D'abord la facture : elle suit le nombre de chargements de carte, donc la fréquentation du site, que l'agence ne maîtrise pas. Ensuite la clé : placée dans le code de la page, elle est lisible par n'importe quel visiteur. La restreindre aux domaines autorisés limite l'abus sans le supprimer, car l'en-tête qui identifie le site d'origine se falsifie depuis un simple script. La parade est de ne plus dépendre d'une clé : vous hébergez vous-même les tuiles, dans un seul fichier, sur le serveur qui héberge déjà le site.",{"type":41,"title":42,"items":43},"ul","Ce que change un fichier PMTiles",[44,45,46,47,48,49],"**Une seule archive** — toutes les tuiles vectorielles d'une zone tiennent dans un fichier unique, sans dossier de millions de petites images à synchroniser.","**Aucun serveur de cartes** — le navigateur lit le fichier par requêtes HTTP Range, c'est-à-dire par morceaux d'octets. Un serveur web ordinaire suffit.","**Pas de clé dans la page** — il n'y a plus de secret à voler ni de quota à épuiser : la carte est une ressource statique de votre propre domaine.","**Une facture qui ne suit plus les visites** — le coût devient celui du VPS et de sa bande passante, deux postes que vous connaissez.","**Un fichier par zone, partagé entre clients** — une extraction régionale peut servir tous les sites de vos clients situés dans cette zone.","**Un style libre** — MapLibre GL JS est open source, et les couleurs, les libellés et les couches se règlent côté client.",{"type":37,"title":51,"body":52},"Combien ça pèse vraiment : planète, région, satellite","L'objection habituelle tient en un mot, le poids. Le fond de carte planétaire complet fait de l'ordre de 120 Go selon la documentation de Protomaps, et la build que nous avons interrogée annonçait environ 140 Go. Ce n'est pas ce que l'on pose sur le site d'un client, et ce n'est pas nécessaire. L'outil `pmtiles extract` découpe une zone dans l'archive distante sans la télécharger en entier. Sur un cadre d'environ 22 km sur 17 km autour de Paris, tous niveaux de zoom compris, le fichier obtenu pèse 49 Mo, et l'extraction a pris une quinzaine de secondes. Chaque niveau de zoom supplémentaire double à peu près la taille : l'option `--maxzoom` est le levier si un plan de magasin n'a pas besoin du détail maximal.\n\nUne limite à dire franchement. Ce fichier est un fond vectoriel : il dessine la carte, il ne géocode pas et ne calcule pas d'itinéraire. Quant à l'imagerie satellite haute résolution, elle reste très coûteuse en stockage et sort du périmètre de ce guide.",{"type":54,"title":55,"headers":56,"rows":61},"comparison","Choisir entre API à clé, OpenFreeMap et PMTiles sur votre VPS",[57,58,59,60],"Critère","API commerciale à clé","OpenFreeMap (instance publique)","PMTiles sur votre VPS",[62,67,72,77,82,87],[63,64,65,66],"Coût","À l'usage, il suit les chargements de carte","Aucun frais ni clé ; le projet couvre ses coûts par des dons","Celui de votre VPS et de sa bande passante",[68,69,70,71],"Clé dans la page","Oui, lisible par tout visiteur","Aucune clé, aucun compte","Aucune clé",[73,74,75,76],"Dépendance","Un fournisseur et ses conditions","Un service public tenu par un projet tiers","Votre serveur, vos règles",[78,79,80,81],"Mise en place","Une clé et quelques lignes","Une URL de style","Une extraction, un bloc nginx, une page",[83,84,85,86],"Imagerie satellite","Selon le fournisseur","Non : fond vectoriel OpenStreetMap","Non : stockage très lourd à votre charge",[88,89,90,91],"À choisir quand","Vous avez besoin d'imagerie, de géocodage ou d'itinéraires","Un prototype ou un site à faible enjeu, sans infrastructure à tenir","Un parc de sites clients dont vous voulez maîtriser facture et disponibilité",{"type":37,"title":93,"body":94},"Prérequis à réunir avant de commencer","Un VPS dont le disque est dimensionné sur la taille de vos archives, plus une marge pour remplacer un fichier sans interruption : comptez deux fois la plus grosse archive. Un nginx à jour, ou un Caddy si vous préférez qu'il gère seul le HTTPS ; la comparaison est dans l'article \u003Ca href=\"\u002Fblog\u002Fcaddy-vs-nginx\">Caddy ou Nginx sur un VPS\u003C\u002Fa>. Un sous-domaine dédié aux tuiles, avec un certificat TLS : une page en HTTPS qui chargerait des tuiles en HTTP serait bloquée comme contenu mixte. Enfin un poste avec accès SSH pour lancer la ligne de commande `pmtiles`. Le service d'un fichier statique par plages d'octets est peu gourmand en processeur : ce sont le disque et la bande passante qui dimensionnent la machine.",{"type":96,"title":97,"steps":98},"steps","Mise en place en sept étapes",[99,102,105,108,111,114,117],{"title":100,"body":101},"Installer la ligne de commande pmtiles","C'est un binaire unique, sans dépendance, publié sur la page des versions du dépôt `protomaps\u002Fgo-pmtiles` sur GitHub. Sous Linux :\n\n`tar -xzf go-pmtiles_*_Linux_x86_64.tar.gz`\n`sudo mv pmtiles \u002Fusr\u002Flocal\u002Fbin\u002F`",{"title":103,"body":104},"Extraire votre région","Choisissez une build listée sur `maps.protomaps.com\u002Fbuilds` et indiquez le cadre au format `MIN_LON,MIN_LAT,MAX_LON,MAX_LAT`, longitude avant latitude :\n\n`pmtiles extract https:\u002F\u002Fbuild.protomaps.com\u002FAAAAMMJJ.pmtiles paris.pmtiles --bbox=2.2,48.8,2.5,48.95`\n\nProtomaps déconseille de pointer le site directement vers ses téléchargements : l'extrait, lui, vous appartient. L'archive source doit être « clustered », ce que sont les builds officielles.",{"title":106,"body":107},"Contrôler l'archive obtenue","`pmtiles show paris.pmtiles` affiche les bornes, les niveaux de zoom et la compression interne ; `pmtiles verify paris.pmtiles` vérifie l'ordre et l'en-tête. Notez la compression interne gzip : c'est la raison du `gzip off` plus bas.",{"title":109,"body":110},"Copier le fichier sur le VPS","`rsync -avP paris.pmtiles deploy@votre-vps:\u002Fvar\u002Fwww\u002Ftuiles\u002F`\n\nPour une mise à jour ultérieure, envoyez le nouveau fichier sous un autre nom dans le même dossier, puis renommez-le avec `mv`.",{"title":112,"body":113},"Déclarer le serveur nginx","Ajoutez ce bloc pour le sous-domaine, avec vos lignes `ssl_certificate` habituelles :\n\n`server {`\n`listen 443 ssl;`\n`server_name tuiles.votre-domaine.com;`\n`root \u002Fvar\u002Fwww\u002Ftuiles;`\n`default_type application\u002Foctet-stream;`\n`location \u002F {`\n`gzip off;`\n`add_header Access-Control-Allow-Origin \"https:\u002F\u002Fvotre-domaine.com\" always;`\n`add_header Access-Control-Allow-Methods \"GET, HEAD, OPTIONS\" always;`\n`add_header Access-Control-Allow-Headers \"Range, If-Match\" always;`\n`add_header Access-Control-Expose-Headers \"ETag\" always;`\n`add_header Cache-Control \"public, max-age=86400\" always;`\n`if ($request_method = OPTIONS) {`\n`add_header Access-Control-Allow-Origin \"https:\u002F\u002Fvotre-domaine.com\" always;`\n`add_header Access-Control-Allow-Methods \"GET, HEAD, OPTIONS\" always;`\n`add_header Access-Control-Allow-Headers \"Range, If-Match\" always;`\n`add_header Access-Control-Max-Age 3600 always;`\n`return 204;`\n`}`\n`}`\n`}`",{"title":115,"body":116},"Recharger nginx et vérifier le 206","`sudo nginx -t && sudo systemctl reload nginx`\n\nDemandez ensuite les 16 384 premiers octets, ceux que lit le client avant toute tuile :\n\n`curl -s -o \u002Fdev\u002Fnull -D - -H \"Origin: https:\u002F\u002Fvotre-domaine.com\" -r 0-16383 https:\u002F\u002Ftuiles.votre-domaine.com\u002Fparis.pmtiles`\n\nOn attend `HTTP\u002F2 206`, `content-range: bytes 0-16383\u002F` suivi de la taille totale du fichier, `content-length: 16384`, `accept-ranges: bytes` et l'en-tête `access-control-allow-origin`. Un `200` signifie que la plage a été ignorée : passez au dépannage plus bas.",{"title":118,"body":119},"Afficher la carte avec MapLibre GL JS","`npm install maplibre-gl pmtiles @protomaps\u002Fbasemaps`\n\nPuis, dans le script de la page, avec un élément `\u003Cdiv id=\"map\">` :\n\n`import maplibregl from 'maplibre-gl';`\n`import 'maplibre-gl\u002Fdist\u002Fmaplibre-gl.css';`\n`import { Protocol } from 'pmtiles';`\n`import { layers, namedFlavor } from '@protomaps\u002Fbasemaps';`\n`const protocol = new Protocol();`\n`maplibregl.addProtocol('pmtiles', protocol.tile);`\n`const map = new maplibregl.Map({`\n`container: 'map',`\n`center: [2.35, 48.86],`\n`zoom: 11,`\n`style: {`\n`version: 8,`\n`glyphs: 'https:\u002F\u002Fprotomaps.github.io\u002Fbasemaps-assets\u002Ffonts\u002F{fontstack}\u002F{range}.pbf',`\n`sprite: 'https:\u002F\u002Fprotomaps.github.io\u002Fbasemaps-assets\u002Fsprites\u002Fv4\u002Flight',`\n`sources: {`\n`protomaps: {`\n`type: 'vector',`\n`url: 'pmtiles:\u002F\u002Fhttps:\u002F\u002Ftuiles.votre-domaine.com\u002Fparis.pmtiles',`\n`attribution: '\u003Ca href=\"https:\u002F\u002Fprotomaps.com\">Protomaps\u003C\u002Fa> © \u003Ca href=\"https:\u002F\u002Fopenstreetmap.org\">OpenStreetMap\u003C\u002Fa>'`\n`}`\n`},`\n`layers: layers('protomaps', namedFlavor('light'), { lang: 'en' })`\n`}`\n`});`\n\nLe préfixe `pmtiles:\u002F\u002F` se place devant l'URL HTTPS complète du fichier. Les polices et les pictogrammes pointent ici vers les ressources publiées par Protomaps ; pour ne dépendre de personne, copiez le dépôt `protomaps\u002Fbasemaps-assets` sur votre serveur et changez les deux URL.",{"type":37,"title":121,"body":122},"Lire le bloc nginx ligne par ligne","Il n'existe pas de directive pour activer les plages d'octets : nginx les gère de lui-même sur un fichier statique, et la documentation ne mentionne que `max_ranges`, dont la valeur `0` les désactive. Le `gzip off` protège ces plages : les octets demandés sont ceux du fichier tel qu'il est stocké, et une réponse recompressée en route les fausse ; la compression est déjà dans l'archive. L'en-tête `Access-Control-Allow-Headers` contient `Range` parce que le navigateur envoie d'abord une requête de préflight `OPTIONS` avant une lecture partielle, d'où le bloc `if` qui répond `204`. `Access-Control-Expose-Headers: ETag` laisse la bibliothèque détecter qu'un fichier a été remplacé. Enfin, nginx n'hérite des `add_header` d'un niveau supérieur que si le niveau courant n'en définit aucun : le bloc `if` répète donc les siens, et `always` les envoie aussi sur les réponses d'erreur.",{"type":37,"title":124,"body":125},"Derrière Cloudflare : ce que la documentation permet d'affirmer","Un fichier de cartes derrière un proxy se comporte mal si l'on ignore trois règles, toutes tirées de la documentation de Cloudflare. L'extension `.pmtiles` ne figure pas dans la liste des extensions mises en cache par défaut : sans règle de cache, le fichier est relu à chaque fois sur votre origine. La taille maximale d'un fichier en cache est de 512 Mo sur les offres Free, Pro et Business : un extrait régional passe, une archive planétaire non. Et une réponse 206 n'est mise en cache que si elle n'est pas encodée, avec un `Content-Range` cohérent. Vérifiez le résultat avec l'en-tête `cf-cache-status`. Les réglages de zone de ce type sont détaillés dans \u003Ca href=\"\u002Fblog\u002Fcloudflare-site-client-agence-cache-ssl-reglages\">Cloudflare pour un site client\u003C\u002Fa>. Un sous-domaine en DNS seul évite la question, au prix d'une IP d'origine exposée : à arbitrer avec le reste du parc.",{"type":41,"title":127,"items":128},"Dépannage : les erreurs réellement rencontrées",[129,130,131,132,133,134,135],"**`has been blocked by CORS policy: No 'Access-Control-Allow-Origin' header is present on the requested resource`** — l'en-tête manque ou l'origine ne correspond pas exactement : `http` au lieu de `https`, ou `www` en trop. Corrigez la valeur de `Access-Control-Allow-Origin`, sans oublier `always`.","**`Request header field range is not allowed by Access-Control-Allow-Headers in preflight response`** — le préflight ne cite pas `Range`. Ajoutez-le à `Access-Control-Allow-Headers` et répondez `204` aux requêtes `OPTIONS`.","**`Server returned no content-length header or content-length exceeding request. Check that your storage backend supports HTTP Byte Serving.`** — le serveur a renvoyé le fichier entier avec un `200` au lieu d'un `206`. Rejouez le `curl` : un proxy, un `max_ranges 0` ou une compression en route en sont les causes.","**`Wrong magic number for PMTiles archive`** — ce que reçoit le client n'est pas une archive PMTiles : page d'erreur HTML, mauvais chemin, ou fichier tronqué par un envoi interrompu. Comparez la taille sur le serveur et sur votre poste.","**`Server returned non-matching ETag … after one retry`** — le fichier a changé pendant la lecture, ou deux versions se mélangent dans un cache. Remplacez le fichier par un `mv`, jamais par une copie en place.","**Carte blanche, fond sans libellé ni routes** — les polices ou les pictogrammes ne se chargent pas : ouvrez l'onglet réseau et cherchez les `404` sur `glyphs` et `sprite`.","**Aucune mention OpenStreetMap à l'écran** — la carte s'affiche, mais la licence n'est pas respectée. Voir la section suivante.",{"type":37,"title":137,"body":138},"Attribution OpenStreetMap : l'obligation de licence","Les données viennent d'OpenStreetMap, publiées sous la licence ODbL. Le fond de Protomaps est distribué comme une œuvre produite sous cette licence, avec attribution à OpenStreetMap exigée. OpenStreetMap demande de créditer le projet et de préciser que les données sont sous licence ODbL, par exemple avec un lien vers \u003Ca href=\"https:\u002F\u002Fwww.openstreetmap.org\u002Fcopyright\">openstreetmap.org\u002Fcopyright\u003C\u002Fa>. Dans MapLibre, le champ `attribution` de la source s'affiche dans le coin de la carte : gardez-le visible, et ne masquez pas ce contrôle dans la feuille de style d'un client. Aucune erreur ne signale l'oubli, ce qui le rend facile à livrer sans s'en apercevoir.",{"type":140,"title":141,"body":142},"tip","Durcir et entretenir le serveur de tuiles","Autorisez une origine exacte, jamais `*` : Protomaps recommande d'indiquer votre propre domaine. Pour plusieurs sites clients, remplacez la valeur fixe par un `map $http_origin` qui ne renvoie que les domaines d'une liste. Surveillez la bande passante du sous-domaine dans vos journaux nginx : c'est désormais votre poste de coût. Replanifiez l'extraction à intervalle régulier, vers un fichier temporaire, puis `mv`.",{"type":37,"title":144,"body":145},"Brancher ce serveur de cartes sur votre parc de sites","Comme l'archive est un fichier statique, un seul sous-domaine de tuiles peut servir les cartes de tous les sites clients d'une même zone : un fichier, un certificat, une sauvegarde. Il vit naturellement sur le VPS qui héberge déjà vos sites, ce qui évite un fournisseur de plus à suivre ; le choix entre VPS et mutualisé est traité dans \u003Ca href=\"\u002Fblog\u002Fchoisir-vps-ou-mutualise-site-client-agence\">Hébergement mutualisé ou VPS pour un site client\u003C\u002Fa>. Si un client réclame de l'imagerie satellite ou des itinéraires, gardez une API commerciale pour ce site seul, et laissez les autres sur votre archive.","Un parc de sites clients, un seul endroit","Domaines, hébergements et VPS réunis dans un espace agence : vous gardez la relation client, nous tenons l'infrastructure, y compris le serveur de cartes de vos sites.","Découvrir l'offre agence","\u002Fsolutions\u002Fagences",[151,173,197],{"id":152,"slug":153,"slugs":154,"title":158,"excerpt":159,"readTime":160,"views":18,"isPinned":19,"noindex":161,"publishedAt":162,"updatedAt":163,"category":164,"categories":170,"featuredImage":30,"bgImage":31,"posterImage":172,"relatedSolution":30},549,"cloudflare-site-client-agence-cache-ssl-reglages",{"fr":153,"en":155,"ar":156,"es":157},"cloudflare-client-site-agency-cache-ssl-settings","إعدادات-cloudflare-موقع-العميل-الكاش-ssl","cloudflare-sitio-cliente-agencia-cache-ssl-ajustes","Cloudflare pour un site client : SSL Full (strict) et cache","Placez le site d'un client derrière Cloudflare sans boucle de redirection ni page privée en cache : mode Full (strict), règles de cache, vérifications.",10,true,"2026-10-31T00:00:00+00:00","2026-11-10T14:39:01+00:00",{"id":165,"name":166,"slug":167,"color":168,"icon":169},8,"Sécurité & Monitoring","securite-monitoring","bg-rose-500\u002F10 text-rose-400","security",[171],{"id":165,"name":166,"slug":167,"color":168,"icon":169},"\u002Fblog\u002Fcovers\u002Fcloudflare-site-client-agence-cache-ssl-reglages-poster.svg",{"id":174,"slug":175,"slugs":176,"title":180,"excerpt":181,"readTime":182,"views":183,"isPinned":19,"noindex":19,"publishedAt":184,"updatedAt":185,"category":186,"categories":191,"featuredImage":30,"bgImage":31,"posterImage":193,"relatedSolution":194},103,"caddy-vs-nginx",{"fr":175,"en":177,"ar":178,"es":179},"caddy-vs-nginx-which-web-server-reverse-proxy-for-your-vps","caddy-مقابل-nginx-أي-خادم-ويب-ووكيل-عكسي-لـ-vps","caddy-vs-nginx-servidor-web-reverse-proxy-vps","Caddy vs Nginx : quel serveur web\u002Freverse proxy pour votre VPS ?","Caddy vs Nginx sur VPS : comparaison complète — HTTPS automatique, configuration, HTTP\u002F3, rate limiting, dépannage et quand choisir Traefik.",9,1,"2026-03-09T00:00:00+00:00","2026-11-08T01:13:13+00:00",{"id":187,"name":188,"slug":189,"color":190,"icon":189},5,"Comparatif","comparatif","bg-info\u002F10 text-info",[192],{"id":187,"name":188,"slug":189,"color":190,"icon":189},"\u002Fblog\u002Fcovers\u002Fcaddy-vs-nginx-poster.svg",{"categorySlug":195,"appSlug":196},"deploiement","caddy",{"id":198,"slug":199,"slugs":200,"title":204,"excerpt":205,"readTime":182,"views":18,"isPinned":19,"noindex":161,"publishedAt":206,"updatedAt":207,"category":208,"categories":209,"featuredImage":30,"bgImage":31,"posterImage":211,"relatedSolution":30},528,"choisir-vps-ou-mutualise-site-client-agence",{"fr":199,"en":201,"ar":202,"es":203},"shared-hosting-or-vps-for-agency-client-site","استضافة-مشتركة-أم-vps-لموقع-عميل-الوكالة","hosting-compartido-o-vps-para-sitio-de-cliente-agencia","VPS ou mutualisé pour un site client : la grille de décision","Mutualisé ou VPS pour un site client : tableau comparatif, heures de maintenance par mois, grille en cinq questions et signaux pour migrer.","2026-10-29T00:00:00+00:00","2026-10-29T15:45:55+00:00",{"id":187,"name":188,"slug":189,"color":190,"icon":189},[210],{"id":187,"name":188,"slug":189,"color":190,"icon":189},"\u002Fblog\u002Fcovers\u002Fchoisir-vps-ou-mutualise-site-client-agence-poster.svg",1795186333431]