openstreetmap-tile-server

镜像概述和主要用途

该容器允许您使用.osm.pbf文件轻松搭建OpenStreetMap PNG瓦片服务器。它基于switch2osm.org的最新Ubuntu 18.04 LTS指南，因此使用默认的OpenStreetMap样式，适用于需要自定义地图瓦片服务的场景，如地理信息系统、地图应用开发等。

核心功能和特性

• 基于OpenStreetMap官方样式，提供标准地图瓦片服务
• 支持通过.osm.pbf文件导入地理数据
• 数据持久化存储，支持容器重启后数据不丢失
• 可配置性能参数，优化瓦片渲染效率
• 提供调试模式，便于服务问题排查

服务器设置

创建Docker卷

首先创建Docker卷以存储PostgreSQL数据库（包含OpenStreetMap数据）：

docker volume create openstreetmap-data

已渲染的瓦片将存储在/var/lib/mod_tile目录。为确保容器重启后瓦片数据不丢失，需创建另一个卷：

docker volume create openstreetmap-rendered-tiles

下载并导入数据

从geofabrik.de下载目标区域的.osm.pbf数据文件。通过运行容器并将该文件挂载为/data.osm.pbf，将数据导入PostgreSQL：

docker run -v /绝对路径/至/目标文件.osm.pbf:/data.osm.pbf -v openstreetmap-data:/var/lib/postgresql/10/main cogitoweb/openstreetmap-tile-server import

若容器无错误退出，则数据导入成功，可准备运行瓦片服务器。

运行服务器（含性能调优和瓦片保存）

运行服务器命令如下：

docker run --shm-size 8g -e THREADS=8 -p 80:80 -p 443:443 -v openstreetmap-data:/var/lib/postgresql/10/main -v /etc/ssl/cogito:/etc/ssl/cogito -v openstreetmap-rendered-tiles:/var/lib/mod_tile cogitoweb/openstreetmap-tile-server:latest run

瓦片可通过http://localhost:80/tile/{z}/{x}/{y}.png访问。首次访问时，较大瓦片的渲染可能需要一定时间。

性能调优

导入和瓦片服务进程默认使用4个线程，可通过THREADS环境变量调整线程数。示例（使用24线程）：

docker run -p 80:80 -e THREADS=24 -v openstreetmap-data:/var/lib/postgresql/10/main -d cogitoweb/openstreetmap-tile-server run

保留已渲染瓦片

已渲染瓦片存储在/var/lib/mod_tile目录，通过挂载之前创建的openstreetmap-rendered-tiles卷可实现数据持久化：

docker run -p 80:80 -v openstreetmap-data:/var/lib/postgresql/10/main -v openstreetmap-rendered-tiles:/var/lib/mod_tile -d cogitoweb/openstreetmap-tile-server run

调试服务模式

将run命令替换为debug即可启用调试模式：

docker run --shm-size 14g -p 80:80 -v osm-europe-data:/var/lib/postgresql/10/main -v /home/ubuntu/osm:/etc/postgresql/10/main/conf.d cogitoweb/openstreetmap-tile-server:latest debug

许可证

Copyright 2018 Cogito

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

    [***]

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.