[{"data":1,"prerenderedAt":212},["ShallowReactive",2],{"seo-verification":3,"blog-alojar-mapas-protomaps-pmtiles-vps-ma-es":6,"promo-bar-likely":161},{"google":4,"bing":5},"EycwPY2XMyTkVzas3n1ygeNJFGAH513qrMjfDljzsMQ","",{"key":7,"data":8},"blog-alojar-mapas-protomaps-pmtiles-vps-ma-es",{"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,"alojar-mapas-protomaps-pmtiles-vps",{"fr":12,"en":13,"ar":14,"es":10},"heberger-cartes-protomaps-pmtiles-vps","host-your-own-protomaps-pmtiles-maps-vps","استضافة-خرائط-pmtiles-على-vps","Aloja tus propios mapas Protomaps (PMTiles) en un VPS","Sirve mapas vectoriales desde tu VPS: un archivo PMTiles, nginx con peticiones por rango de bytes, MapLibre GL JS. Tamaño real, CORS y solución de errores.",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,"Desarrollo","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","Tu cliente quiere un mapa en su página de contacto y lo conectas a una API comercial. Unos meses después, la factura sigue el tráfico del sitio, y la clave, visible en el código de la página, la puede copiar cualquiera. Hay una vía más sobria: un archivo PMTiles en un VPS, servido por nginx con peticiones por rango de bytes y mostrado con MapLibre GL JS. Sin servidor de mapas que administrar. Esta guía da los comandos, el tamaño real de los archivos, los errores que aparecen y sus mensajes exactos.",[],[36,40,50,53,92,95,120,123,126,136,139,143],{"type":37,"title":38,"body":39},"h2","Por qué servir tus propios mapas en lugar de alquilar teselas","Una página de contacto con un plano, un localizador de tiendas, un mapa de entregas: casi todos los sitios de clientes llevan uno. El reflejo habitual es integrar una API de mapas comercial, con una clave. Con el tiempo aparecen dos problemas. Primero la factura: sigue el número de cargas de mapa, es decir, el tráfico del sitio, que la agencia no controla. Después la clave: colocada en el código de la página, la lee cualquier visitante. Restringirla a los dominios autorizados limita el abuso sin eliminarlo, porque la cabecera que identifica el sitio de origen se falsifica desde un simple script. La salida es dejar de depender de una clave: alojas tú mismo las teselas, en un único archivo, en el servidor que ya aloja el sitio.",{"type":41,"title":42,"items":43},"ul","Lo que cambia un archivo PMTiles",[44,45,46,47,48,49],"**Un único archivo** — todas las teselas vectoriales de una zona caben en un solo fichero, sin una carpeta con millones de imágenes pequeñas que sincronizar.","**Ningún servidor de mapas** — el navegador lee el archivo con peticiones HTTP Range, es decir, por trozos de bytes. Un servidor web corriente basta.","**Sin clave en la página** — no hay secreto que robar ni cuota que agotar: el mapa es un recurso estático de tu propio dominio.","**Una factura que ya no sigue las visitas** — el coste pasa a ser el del VPS y su ancho de banda, dos partidas que ya conoces.","**Un archivo por zona, compartido entre clientes** — una extracción regional puede servir a todos los sitios de tus clientes situados en esa zona.","**Un estilo libre** — MapLibre GL JS es de código abierto, y los colores, las etiquetas y las capas se ajustan en el cliente.",{"type":37,"title":51,"body":52},"Cuánto pesa de verdad: planeta, región, satélite","La objeción habitual cabe en una palabra: el peso. El mapa base completo del planeta ronda los 120 GB según la documentación de Protomaps, y la build que consultamos anunciaba unos 140 GB. No es lo que se pone en el sitio de un cliente, y no hace falta. La herramienta `pmtiles extract` recorta una zona del archivo remoto sin descargarlo entero. Sobre un encuadre de unos 22 km por 17 km alrededor de París, con todos los niveles de zoom, el archivo resultante pesa 49 MB, y la extracción tardó unos quince segundos. Cada nivel de zoom adicional duplica aproximadamente el tamaño: la opción `--maxzoom` es la palanca si el plano de una tienda no necesita el detalle máximo.\n\nUn límite que hay que decir con franqueza. Este archivo es un mapa base vectorial: dibuja el mapa, no geocodifica ni calcula rutas. En cuanto a las imágenes de satélite de alta resolución, siguen siendo muy costosas en almacenamiento y quedan fuera de esta guía.",{"type":54,"title":55,"headers":56,"rows":61},"comparison","Elegir entre una API con clave, OpenFreeMap y PMTiles en tu VPS",[57,58,59,60],"Criterio","API comercial con clave","OpenFreeMap (instancia pública)","PMTiles en tu VPS",[62,67,72,77,82,87],[63,64,65,66],"Coste","Por uso, sigue las cargas de mapa","Sin tarifa ni clave; el proyecto cubre sus costes con donaciones","El de tu VPS y su ancho de banda",[68,69,70,71],"Clave en la página","Sí, legible por cualquier visitante","Sin clave ni cuenta","Sin clave",[73,74,75,76],"Dependencia","Un proveedor y sus condiciones","Un servicio público mantenido por un proyecto externo","Tu servidor, tus reglas",[78,79,80,81],"Puesta en marcha","Una clave y unas líneas","Una URL de estilo","Una extracción, un bloque nginx, una página",[83,84,85,86],"Imágenes de satélite","Según el proveedor","No: mapa base vectorial de OpenStreetMap","No: almacenamiento muy pesado a tu cargo",[88,89,90,91],"Elígelo cuando","Necesitas imágenes, geocodificación o rutas","Un prototipo o un sitio de poca importancia, sin infraestructura que mantener","Una cartera de sitios de clientes cuya factura y disponibilidad quieres controlar",{"type":37,"title":93,"body":94},"Requisitos que reunir antes de empezar","Un VPS con un disco dimensionado según tus archivos, más un margen para reemplazar un fichero sin interrupción: cuenta el doble del archivo más grande. Un nginx actualizado, o Caddy si prefieres que gestione solo el HTTPS; la comparación está en el artículo \u003Ca href=\"\u002Fes\u002Fblog\u002Fcaddy-vs-nginx-servidor-web-reverse-proxy-vps\">Caddy o Nginx en un VPS\u003C\u002Fa>. Un subdominio dedicado a las teselas, con certificado TLS: una página HTTPS que cargara teselas por HTTP quedaría bloqueada como contenido mixto. Por último, un equipo con acceso SSH para lanzar la línea de comandos `pmtiles`. Servir un archivo estático por rangos de bytes consume poco procesador: el disco y el ancho de banda dimensionan la máquina.",{"type":96,"title":97,"steps":98},"steps","Puesta en marcha en siete pasos",[99,102,105,108,111,114,117],{"title":100,"body":101},"Instalar la línea de comandos pmtiles","Es un binario único, sin dependencias, publicado en la página de versiones del repositorio `protomaps\u002Fgo-pmtiles` en GitHub. En Linux:\n\n`tar -xzf go-pmtiles_*_Linux_x86_64.tar.gz`\n`sudo mv pmtiles \u002Fusr\u002Flocal\u002Fbin\u002F`",{"title":103,"body":104},"Extraer tu región","Elige una build listada en `maps.protomaps.com\u002Fbuilds` e indica el encuadre con el formato `MIN_LON,MIN_LAT,MAX_LON,MAX_LAT`, longitud antes que latitud:\n\n`pmtiles extract https:\u002F\u002Fbuild.protomaps.com\u002FAAAAMMDD.pmtiles paris.pmtiles --bbox=2.2,48.8,2.5,48.95`\n\nProtomaps desaconseja apuntar tu sitio directamente a sus descargas: el extracto, en cambio, es tuyo. El archivo de origen debe estar «clustered», como lo están las builds oficiales.",{"title":106,"body":107},"Comprobar el archivo obtenido","`pmtiles show paris.pmtiles` muestra los límites, los niveles de zoom y la compresión interna; `pmtiles verify paris.pmtiles` comprueba el orden y la cabecera. Fíjate en la compresión interna gzip: es la razón del `gzip off` más abajo.",{"title":109,"body":110},"Copiar el archivo al VPS","`rsync -avP paris.pmtiles deploy@your-vps:\u002Fvar\u002Fwww\u002Ftuiles\u002F`\n\nPara una actualización posterior, envía el nuevo archivo con otro nombre a la misma carpeta y renómbralo después con `mv`.",{"title":112,"body":113},"Declarar el servidor nginx","Añade este bloque para el subdominio, con tus líneas `ssl_certificate` habituales:\n\n`server {`\n`listen 443 ssl;`\n`server_name tiles.your-domain.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\u002Fyour-domain.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\u002Fyour-domain.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},"Recargar nginx y comprobar el 206","`sudo nginx -t && sudo systemctl reload nginx`\n\nPide después los primeros 16 384 bytes, los que lee el cliente antes de cualquier tesela:\n\n`curl -s -o \u002Fdev\u002Fnull -D - -H \"Origin: https:\u002F\u002Fyour-domain.com\" -r 0-16383 https:\u002F\u002Ftiles.your-domain.com\u002Fparis.pmtiles`\n\nSe espera `HTTP\u002F2 206`, `content-range: bytes 0-16383\u002F` seguido del tamaño total del archivo, `content-length: 16384`, `accept-ranges: bytes` y la cabecera `access-control-allow-origin`. Un `200` indica que se ignoró el rango: pasa a la lista de solución de errores más abajo.",{"title":118,"body":119},"Mostrar el mapa con MapLibre GL JS","`npm install maplibre-gl pmtiles @protomaps\u002Fbasemaps`\n\nDespués, en el script de la página, con un elemento `\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\u002Ftiles.your-domain.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\nEl prefijo `pmtiles:\u002F\u002F` va delante de la URL HTTPS completa del archivo. Las fuentes y los iconos apuntan aquí a los recursos publicados por Protomaps; para no depender de nadie, copia el repositorio `protomaps\u002Fbasemaps-assets` a tu servidor y cambia las dos URL.",{"type":37,"title":121,"body":122},"Leer el bloque nginx línea por línea","No existe una directiva para activar los rangos de bytes: nginx los gestiona por sí mismo en un archivo estático, y la documentación solo menciona `max_ranges`, cuyo valor `0` los desactiva. El `gzip off` protege esos rangos: los bytes pedidos son los del archivo tal como está almacenado, y una respuesta recomprimida por el camino los falsearía; la compresión ya está dentro del archivo. La cabecera `Access-Control-Allow-Headers` contiene `Range` porque el navegador envía primero una petición de preflight `OPTIONS` antes de una lectura parcial, de ahí el bloque `if` que responde `204`. `Access-Control-Expose-Headers: ETag` permite a la biblioteca detectar que un archivo fue reemplazado. Por último, nginx solo hereda los `add_header` de un nivel superior si el nivel actual no define ninguno: el bloque `if` repite por eso los suyos, y `always` los envía también en las respuestas de error.",{"type":37,"title":124,"body":125},"Detrás de Cloudflare: lo que la documentación permite afirmar","Un archivo de mapas detrás de un proxy se comporta mal si se ignoran tres reglas, todas sacadas de la documentación de Cloudflare. La extensión `.pmtiles` no figura en la lista de extensiones que se guardan en caché por defecto: sin una regla de caché, el archivo se lee cada vez desde tu origen. El tamaño máximo de un archivo en caché es de 512 MB en los planes Free, Pro y Business: un extracto regional cabe, un archivo del planeta no. Y una respuesta 206 solo se guarda en caché si no está codificada, con un `Content-Range` coherente. Comprueba el resultado con la cabecera `cf-cache-status`. Los ajustes de zona de este tipo se detallan en \u003Ca href=\"\u002Fes\u002Fblog\u002Fcloudflare-sitio-cliente-agencia-cache-ssl-ajustes\">Cloudflare para el sitio de un cliente\u003C\u002Fa>. Un subdominio solo con DNS evita la cuestión, al precio de una IP de origen expuesta: decídelo con el resto de tu cartera.",{"type":41,"title":127,"items":128},"Solución de errores: los que realmente aparecen",[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`** — falta la cabecera o el origen no coincide exactamente: `http` en lugar de `https`, o un `www` de más. Corrige el valor de `Access-Control-Allow-Origin`, sin olvidar `always`.","**`Request header field range is not allowed by Access-Control-Allow-Headers in preflight response`** — el preflight no cita `Range`. Añádelo a `Access-Control-Allow-Headers` y responde `204` a las peticiones `OPTIONS`.","**`Server returned no content-length header or content-length exceeding request. Check that your storage backend supports HTTP Byte Serving.`** — el servidor devolvió el archivo entero con un `200` en lugar de un `206`. Repite el `curl`: un proxy, un `max_ranges 0` o una compresión por el camino son las causas.","**`Wrong magic number for PMTiles archive`** — lo que recibe el cliente no es un archivo PMTiles: una página de error HTML, una ruta equivocada o un archivo truncado por una subida interrumpida. Compara el tamaño en el servidor y en tu equipo.","**`Server returned non-matching ETag … after one retry`** — el archivo cambió durante la lectura, o dos versiones se mezclan en una caché. Reemplaza el archivo con `mv`, nunca con una copia en el mismo sitio.","**Mapa en blanco, fondo sin etiquetas ni carreteras** — las fuentes o los iconos no se cargan: abre la pestaña de red y busca respuestas `404` en `glyphs` y `sprite`.","**Ninguna mención de OpenStreetMap en pantalla** — el mapa se muestra, pero no se respeta la licencia. Mira la sección siguiente.",{"type":37,"title":137,"body":138},"Atribución a OpenStreetMap: la obligación de la licencia","Los datos proceden de OpenStreetMap, publicados bajo la licencia ODbL. El mapa base de Protomaps se distribuye como obra producida bajo esa licencia, con atribución a OpenStreetMap obligatoria. OpenStreetMap pide acreditar el proyecto e indicar que los datos están bajo la ODbL, por ejemplo con un enlace a \u003Ca href=\"https:\u002F\u002Fwww.openstreetmap.org\u002Fcopyright\">openstreetmap.org\u002Fcopyright\u003C\u002Fa>. En MapLibre, el campo `attribution` de la fuente aparece en la esquina del mapa: mantenlo visible, y no ocultes este control en la hoja de estilos de un cliente. Ningún error señala el olvido, lo que facilita entregarlo sin darse cuenta.",{"type":140,"title":141,"body":142},"tip","Reforzar y mantener el servidor de teselas","Autoriza un origen exacto, nunca `*`: Protomaps recomienda indicar tu propio dominio. Para varios sitios de clientes, sustituye el valor fijo por un `map $http_origin` que solo devuelva los dominios de una lista. Vigila el ancho de banda del subdominio en tus registros de nginx: ahora es tu partida de coste. Programa la extracción a intervalos regulares, hacia un archivo temporal, y después `mv`.",{"type":37,"title":144,"body":145},"Conectar este servidor de mapas a tu cartera de sitios","Como el archivo es estático, un único subdominio de teselas puede servir los mapas de todos los sitios de clientes de una misma zona: un archivo, un certificado, una copia de seguridad. Vive de forma natural en el VPS que ya aloja tus sitios, lo que evita un proveedor más que seguir; la elección entre VPS y hosting compartido se trata en \u003Ca href=\"\u002Fes\u002Fblog\u002Fhosting-compartido-o-vps-para-sitio-de-cliente-agencia\">Hosting compartido o VPS para el sitio de un cliente\u003C\u002Fa>. Si un cliente pide imágenes de satélite o rutas, conserva una API comercial solo para ese sitio y deja los demás en tu archivo.","Una cartera de sitios de clientes, un solo lugar","Dominios, hosting y VPS reunidos en un espacio de agencia: tú conservas la relación con el cliente, nosotros llevamos la infraestructura, incluido el servidor de mapas de tus sitios.","Descubrir la oferta para agencias","\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-sitio-cliente-agencia-cache-ssl-ajustes",{"fr":155,"en":156,"ar":157,"es":153},"cloudflare-site-client-agence-cache-ssl-reglages","cloudflare-client-site-agency-cache-ssl-settings","إعدادات-cloudflare-موقع-العميل-الكاش-ssl","Cloudflare en el sitio de un cliente: SSL Full (strict) y caché","Ponga el sitio de un cliente tras Cloudflare sin bucles de redirección ni páginas privadas en caché: modo Full (strict), reglas de caché y verificaciones.",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,"Seguridad y monitorización","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-servidor-web-reverse-proxy-vps",{"fr":177,"en":178,"ar":179,"es":175},"caddy-vs-nginx","caddy-vs-nginx-which-web-server-reverse-proxy-for-your-vps","caddy-مقابل-nginx-أي-خادم-ويب-ووكيل-عكسي-لـ-vps","Caddy vs Nginx: ¿qué servidor web\u002Freverse proxy para su VPS?","Caddy vs Nginx en un VPS: comparación completa — HTTPS automático, configuración, HTTP\u002F3, rate limiting, resolución de problemas y cuándo elegir 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,"Comparativas","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},"despliegue-de-aplicaciones-devops","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,"hosting-compartido-o-vps-para-sitio-de-cliente-agencia",{"fr":201,"en":202,"ar":203,"es":199},"choisir-vps-ou-mutualise-site-client-agence","shared-hosting-or-vps-for-agency-client-site","استضافة-مشتركة-أم-vps-لموقع-عميل-الوكالة","VPS o hosting compartido para el sitio de un cliente","Hosting compartido o VPS para el sitio de un cliente: tabla comparativa, horas de mantenimiento al mes, cinco preguntas de decisión y señales para migrar.","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",1795186211066]