Flight-Readsb 离线地图部署指南
Flight-Readsb 离线地图部署指南
概述
当服务器无法访问外网时，页面上的地图瓦片无法加载。本文档介绍如何配置离线地图。
网络架构
┌─────────────────────────────────────────────────────────────┐ │ 离线地图部署架构 │ ├─────────────────────────────────────────────────────────────┤ │ │ │ [开发者PC] ──下载瓦片──> [Windows/Linux] │ │ │ │ │ │ │ scp/rsync ▼ │ │ └──────────────> /opt/flight-readsb/web/tiles/ │ │ │ │ │ ▼ │ │ ┌──────────────────┐ │ │ │ Ubuntu 22.04 │ │ │ │ readsb 服务 │ │ │ │ nginx/apache │ │ │ └────────┬─────────┘ │ │ │ │ │ ▼ │ │ ┌──────────────────┐ │ │ │ 局域网浏览器 │ │ │ │ http://IP:8080 │ │ │ └──────────────────┘ │ │ │ └─────────────────────────────────────────────────────────────┘一、地图源选择
1.1 支持的地图源
| 地图源 | 代码 | 瓦片格式 | 国内覆盖 | 推荐度 |
|---|---|---|---|---|
| 高德地图 | gaode | PNG | ⭐⭐⭐⭐⭐ | 🥇 推荐 |
| 腾讯地图 | tencent | JPG | ⭐⭐⭐⭐ | 🥈 |
| OpenStreetMap | osm | PNG | ⭐⭐⭐ | 🥉 |
| 必应地图 | bing | JPEG | ⭐⭐⭐ | - |
1.2 坐标系说明
| 地图源 | 坐标系 | Y轴方向 | 脚本处理 |
|---|---|---|---|
| 高德 (gaode) | 标准 XYZ | 向上 | ✅ 自动处理 |
| 腾讯 (tencent) | TMS 标准 | 向上 | ✅ 自动转换 |
| OSM | 标准 XYZ | 向上 | ✅ 无需处理 |
| 必应 (bing) | QuadKey | 特殊 | ✅ 自动转换 |
1.3 选择建议
国内 ADS-B 监控 → 高德地图 (gaode) # 覆盖最全，加载快 国外 ADS-B 监控 → OpenStreetMap (osm) # 全球免费 需要备选方案 → 腾讯地图 (tencent) # 国内覆盖好二、脚本配置说明
2.1 主要配置参数
编辑download-tiles.sh或download-tiles.ps1：
# ============ 核心配置 ============TILE_DIR="/opt/flight-readsb/web/tiles"# 瓦片存储目录MIN_ZOOM=3# 最小缩放级别（查看全国）MAX_ZOOM=12# 最大缩放级别（查看街道）THREADS=8# 并发下载线程数MAX_RETRIES=3# 单个瓦片最大重试次数MIN_FILE_SIZE=100# 有效文件最小字节数# ============ 地图源配置 ============TILE_SOURCE="gaode"# 可选: gaode/tencent/osm/bing2.2 缩放级别说明
| 级别 | 瓦片数量（中国） | 覆盖范围 | 适用场景 | 磁盘占用 |
|---|---|---|---|---|
| 3-4 | ~数百个 | 国家级 | 查看全国 | < 1 MB |
| 5-6 | ~数千个 | 省级 | 查看省市 | ~10 MB |
| 7-9 | ~数万 | 市级 | 查看市区 | ~100 MB |
| 10-12 | ~数十万 | 区县级 | 查看街道 | ~1 GB |
| 13+ | ~数百万+ | 建筑级 | 极高精度 | 10+ GB |
数据量增长规律：每升一级，瓦片数量约为上一级的4 倍
2.3 常用预设级别
脚本提供交互式选择：
1. 3-12级 (当前默认) ← 推荐大多数场景 2. 4-12级 (跳过低级别) 3. 3-10级 (较低精度) ← 节省空间 4. 3-14级 (更高精度) ← 需要更多空间 5. 自定义级别三、快速开始
3.1 Windows 系统
# 1. 进入脚本目录cd d:\phpstudy_pro\W