hsldevcom/jore4-mbtiles-server

jore4-mbtiles-server

概述

jore4-mbtiles-server是一个轻量级瓦片服务器，专为提供MBTiles文件服务而设计。该服务器支持TMS和XYZ瓦片格式，具备CORS支持和gzip压缩功能，是地图瓦片服务部署的理想选择。

核心功能和特性

• 支持MBTiles文件服务
• 兼容TMS和XYZ瓦片格式
• 内置CORS支持
• 支持gzip压缩
• 轻量级设计，资源占用低
• 简单易用的配置方式
• 支持多个MBTiles文件

使用场景和适用范围

• 地图瓦片服务部署
• 自定义地图数据发布
• 离线地图服务
• 开发环境地图瓦片测试
• 轻量级地图服务需求场景

使用方法和配置说明

基本使用

Docker Run 命令

bash
docker run -d \
  -p 8080:8080 \
  -v /path/to/your/mbtiles:/tiles \
  hsldevcom/jore4-mbtiles-server

Docker Compose 配置

yaml
version: '3'
services:
  mbtiles-server:
    image: hsldevcom/jore4-mbtiles-server
    ports:
      - "8080:8080"
    volumes:
      - ./mbtiles:/tiles
    restart: always

配置参数

jore4-mbtiles-server通过环境变量进行配置：

• PORT: 服务器监听端口，默认值：8080
• TILES_DIR: MBTiles文件目录，默认值：/tiles
• CORS_ALLOWED_ORIGINS: 允许的CORS源，默认值：*
• GZIP_COMPRESSION: 是否启用gzip压缩，默认值：true
• MAX_AGE: 缓存控制头的max-age值，默认值：86400

示例：自定义配置

bash
docker run -d \
  -p 80:8080 \
  -v /data/mbtiles:/tiles \
  -e PORT=8080 \
  -e CORS_ALLOWED_ORIGINS=https://example.com \
  -e GZIP_COMPRESSION=true \
  hsldevcom/jore4-mbtiles-server

访问瓦片

启动服务器后，可以通过以下URL格式访问瓦片：

XYZ格式

http://localhost:8080/{filename}/{z}/{x}/{y}.png

TMS格式

http://localhost:8080/{filename}/tms/{z}/{x}/{y}.png

其中，{filename}是MBTiles文件的名称（不包含.mbtiles扩展名），{z}、{x}、{y}分别是瓦片的层级、x坐标和y坐标。