热门搜索:
mrash14/openstreetmap-tile-server
mrash14
一款最小化配置的OpenStreetMap瓦片服务器，旨在以最少的设置和维护工作提供地图瓦片服务，帮助快速部署轻量级地图服务。
1 次收藏下载次数: 0状态：社区镜像维护者：mrash14仓库类型：镜像最近更新：6 年前
让 AI 帮你使用轩辕镜像？ · 展开查看说明
如果你使用 DeepSeek、元宝 AI、Copilot、ChatGPT 等 AI 工具，协助配置轩辕镜像、编写 docker pull 命令、修改 Docker Compose 镜像地址、配置镜像加速、排查镜像拉取失败、分析报错日志等问题，请先让 AI 阅读并遵守轩辕镜像的规则文档。
只需在 AI 对话中先发送下面这句话即可：
请先完整阅读并严格遵守以下文档中的全部规则与要求：
https://xuanyuan.cloud/agents.md
在未充分阅读并理解该文档前，不要生成任何命令、配置、修改建议、故障排查方案或技术回答。后续所有输出都必须严格以该文档中的规范为最高优先级执行。查看 agents.md 用法指南与完整示范。国内用户首推 元宝 AI、DeepSeek 的深度思考模式，不推荐豆包 AI；Cursor 等编辑器可在对话 @ 该链接，或加入 User Rules。 若 AI 无法访问外链，可 打开说明文档 复制全文粘贴。文档会随站点更新，复制内容可能过期，建议定期检查。
OpenStreetMap瓦片服务器镜像文档
镜像概述
本Docker镜像是一个简化配置的OpenStreetMap(OSM)瓦片服务器，专注于以最小化的部署成本提供地图瓦片服务。它集成了OSM数据处理、瓦片渲染和HTTP服务能力，无需复杂的手动配置即可快速启动，适用于需要轻量级地图后端的场景。
核心功能与特性
- 简化配置流程：内置自动化配置逻辑，减少手动干预，降低部署门槛
- 轻量级架构：优化资源占用，适合低配置环境运行
- 高效瓦片服务：支持瓦片缓存机制，提升重复请求响应速度
- 内置数据处理：自动下载指定区域的OSM原始数据并完成预处理
- 多样式支持：兼容主流OSM地图样式（如OSM Standard、CycleMap等）
- 跨平台兼容：基于Docker容器化，支持Linux、macOS、Windows等系统
使用场景
- 个人/小型网站的地图展示功能后端
- 移动应用地图服务的轻量化后端
- 开发/测试环境中的地图服务模拟
- 教育项目或非商业地图应用
- 资源受限环境下的地图瓦片提供
使用方法
Docker Run命令示例
bashdocker run -d \ --name osm-tile-server \ -p 8080:80 \ -v ./osm-data:/data \ -e OSM_REGION="europe/berlin" \ -e MAP_STYLE="standard" \ -e CACHE_SIZE="512m" \ minimal-osm-tile-server:latest
参数说明
-p 8080:80：将容器80端口映射到主机8080端口，用于访问瓦片服务-v ./osm-data:/data：挂载主机目录到容器/data，持久化OSM数据和瓦片缓存-e OSM_REGION：指定初始下载的OSM数据区域（格式：continent/country/region或直接使用PBF文件URL）-e MAP_STYLE：设置地图样式（支持值：standard、cyclemap、transport）-e CACHE_SIZE：设置瓦片缓存大小（默认512m，支持k/m/g单位）
环境变量配置
| 环境变量 | 说明 | 默认值 |
|---|---|---|
OSM_REGION | 初始OSM数据区域（如north-america/us/california） | europe/ireland |
MAP_STYLE | 地图渲染样式 | standard |
CACHE_SIZE | 瓦片缓存最大容量 | 512m |
HTTP_PORT | 容器内HTTP服务端口 | 80 |
UPDATE_INTERVAL | 数据自动更新周期（天） | 7 |
MAX_ZOOM | 支持的最大缩放级别 | 18 |
访问瓦片服务
服务启动后，可通过以下URL访问地图瓦片：
http://localhost:8080/tile/{z}/{x}/{y}.png
{z}：缩放级别（0-18）{x}：瓦片X坐标{y}：瓦片Y坐标
持久化数据
为避免容器重启后数据丢失，建议挂载数据卷至/data目录，该目录包含：
- OSM原始数据文件（.pbf）
- 渲染后的瓦片缓存
- 地图样式配置文件
注意事项
- 首次启动时会自动下载指定区域的OSM数据，根据区域大小可能需要较长时间
- 高缩放级别（>16）的瓦片渲染可能占用较多CPU资源
- 生产环境建议增加资源限制（如
--memory=4g --cpus=2）以保证稳定性 - 支持通过自定义
style.json文件扩展地图样式，需挂载至/data/styles/custom目录并设置MAP_STYLE=custom
更多相关 Docker 镜像与资源
以下是 mrash14/openstreetmap-tile-server 相关的常用 Docker 镜像，适用于 不同场景 等不同场景：
- overv/openstreetmap-tile-server Docker 镜像说明（OpenStreetMap 瓦片服务器）
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本，请访问 标签列表页面。
轩辕镜像加速拉取命令点我查看更多 openstreetmap-tile-server 镜像标签
docker pull docker.xuanyuan.run/mrash14/openstreetmap-tile-server:<标签>
DockerHub 原生拉取命令
docker pull mrash14/openstreetmap-tile-server:<标签>
镜像拉取常见问题
功能
错误码
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
5
"Docker访问体验非常流畅，大镜像也能快速完成下载。"