Hacker News Best

Protomaps: Self-hosting map tiles has gotten cheap and easy

8.5内容质量

TL;DR · AI 摘要

使用 Protomaps 的 PMTiles 格式,可以低成本、易部署地实现地图瓦片的自托管。

核心要点

  • PMTiles 可通过 HTTP Range 请求部署为单个文件,极大简化了地图瓦片的托管。
  • Bunny.net 提供支持 Range 请求的 CDN,存储和带宽成本约为 $0.01/GB。
  • 与 Mapbox 相比,使用 PMTiles 可能便宜 100 倍,具体取决于使用情况。

结构提纲

按章节快速跳转。

  1. 介绍 Protomaps 和 PMTiles 的背景及其在地图托管中的优势。

  2. 通过 Protomaps 的构建页面或 CLI 工具获取地图数据。

  3. 介绍 Bunny.net 的 CDN 服务及其对 PMTiles 的支持。

  4. 使用 rclone 工具上传 PMTiles 文件到 Bunny.net 的存储区。

  5. 介绍如何在网页中嵌入 PMTiles 地图。

思维导图

用一张图看清主题之间的关系。

查看大纲文本(无障碍 / 无 JS 友好)
  • Protomaps 和 PMTiles
    • PMTiles 格式
      • 单文件部署
      • HTTP Range 请求
    • 部署方案
      • Bunny.net CDN
      • rclone 工具上传
    • 成本优势
      • 存储费用 $0.01/GB
      • 带宽费用 $0.01/GB
      • 比 Mapbox 便宜 100 倍

金句 / Highlights

值得收藏与分享的关键句。

#地图瓦片#PMTiles#CDN#Protomaps#自托管
打开原文

Protomaps:自托管地图瓦片变得更便宜且更容易 —— Bruce Röttgers

blog

//

dev

projects

Protomaps:自托管地图瓦片变得更便宜且更容易

PMTiles 是一种通过 HTTP Range 请求工作的瓦片格式,可以作为单个文件部署到存储桶中。

2026-11-15

4 分钟阅读

内容

  • 1 获取一些地图
  • 2 部署到 Bunny.net
  • 3 嵌入地图
  • · 备注

我在为我最新的项目 Mapboard 进行研究时发现了 Protomaps。1 对于大多数非商业项目,如果项目变得流行,商业 API 的费用会变得难以承受(例如,Mapbox 在免费层级用尽后,每 1k 次地图加载收费 5 美元)。

PMTiles 是 Protomaps 生态系统的一部分,是一种以单个文件形式提供、可通过 Range 请求访问的瓦片格式,因此具有极高的可移植性和易于部署的特点。对于支持缓存大文件 Range 请求的 CDN,除了上传和下载文件到存储之外无需任何其他操作。对于其他 CDN,如 Cloudflare,你可以使用边缘函数来在传统的 x/y/z URL 路径和 Range 请求之间进行转换。

获取一些地图

如果你只需要世界地图,获取它就像去构建页面并下载最新的每日构建一样简单。

然而,使用 CLI 可以带来更多的乐趣。例如,你可以只提取特定的边界框或特定缩放级别的数据,从而获得一个显著更小的文件。

部署到 Bunny.net

一个非常适合部署此功能的 CDN 是 Bunny.net(附属链接)。他们支持 HTTP Range 请求,默认情况下不收集个人数据,2 公司总部位于欧盟,并提供低成本访问全球 CDN 和边缘存储服务器网络。

价格根据区域和边缘存储的复制因子而有所不同。但总体而言,欧洲和北美地区的带宽费用为每 GB 0.01 美元(小容量网络为每 GB 0.005 美元),存储费用为每月每 GB 0.01 美元(无复制)至每月每 GB 0.055 美元(最大复制)。高复制度在缓存未命中时对延迟影响较大(因为数据在 CDN PoPs 缓存时会被进一步复制)。

实际上,将 139GB 的世界地图复制到大多数大陆(5 倍复制)的存储费用每月约为 5 美元。在笔记本电脑上加载欧洲地图并放大到城市,大约传输 5MB 的数据,费用约为 0.00005 美元 —— 进一步的导航和重新加载会更便宜,因为地图的更多部分会被本地缓存。以每 1k 次地图加载 0.05 美元计算,这可能比 Mapbox 便宜 100 倍。然而,实际带宽当然会有所不同(对于立即跳转的用户较少,重用户可能高达几十 MB)。对于 Mapbox,你只需按访问次数支付固定费用。

上传文件

创建一个启用 S3 兼容性的存储区是个好主意,因为通过 HTTP API 上传时,我的连接在 15 分钟后超时了。

然后,安装 rclone 后,你可以下载并流式传输文件到 Bunny 存储区。如果连接不好,最好在 tmux 或临时 VPS 上进行。

code
rclone
config
create
bunnycdn
s3
\
provider=Other
\
access_key_id="<zone-name>"
\
secret_access_key="<storage-key>"
\
endpoint="https://<primary-region>-s3.storage.bunnycdn.com"
rclone
copyurl
"<build-url>"
"bunnycdn:<zone-name>/<filename>.pmtiles"
\
--s3-chunk-size
256M
\
--progress

配置拉取区域

理论上,此时你只需创建一个拉取区域,选择存储区域作为源,就完成了。但实际上,调整一些设置会更合理。

允许的 CORS 原始地址可以在“安全” > “常规” > “允许的来源”下进行配置,以防止其他网站嵌入你的瓦片。

你还应检查缓存设置,确保启用了“优化大对象传输”选项,这样就可以缓存范围请求了。

你可能还想阻止用户下载整个文件,从而避免产生高额的 CDN 费用。我找到的最实用的方法是,在单个请求中传输 10MB 后,将下载速度限制为 10KB/s(使用“网络限制”下的“下载速度限制”和“限制后”设置)。常规使用应该不会达到这个数量。你还可以进一步引入每秒请求数限制(请注意,合法使用也可能迅速达到很高的数值)或为拉取区域设置每月带宽限制。

嵌入地图

在瓦片部署完成后,剩下的唯一事情就是通过 MapLibre GL 等方式将它们嵌入到你的网站中。为此,你需要安装 pmtiles npm 包,并按照官方安装指南中所述,向 MapLibre 添加协议和样式。

恭喜,你现在拥有自己的成本效益高且高可用的世界地图!

注释(2)

  • 基本上是 Excalidraw,但用于旅行规划的地图上。发布文章即将推出。↑
  • IP 地址的最后一个八位字节被丢弃。如果你通过 CDN 传输个人数据,当然仍然会进行处理。↑

// 邮件订阅

通过订阅我的新博客文章和项目,保持更新;每周发送次数少于一次。

订阅 →

// 作者信息

你好,我是 Bruce,苏黎世联邦理工学院计算机科学专业的学生。我开发移动应用、网站和其他产品,并撰写关于我在过程中遇到的有趣事情的文章。了解更多关于我 →

github

email

rss

// 信件

通过电子邮件回复 →

如果你想对这篇文章发表评论,请发送电子邮件。我将在获得作者许可后在此处分享精选的回复。