15分钟部署自己的免费天气API：Open-Meteo 自托管全流程

15分钟部署自己的免费天气APIOpen-Meteo 自托管全流程【免费下载链接】open-meteoFree Weather Forecast API for non-commercial use项目地址: https://gitcode.com/GitHub_Trending/op/open-meteo想在自己的产品里加天气功能却不想被商业接口的密钥和配额绑架开源项目 Open-Meteo 就是为此准备的一个免费、免密钥的自托管天气数据 API几条命令就能在你机器上跑起和官方版同接口的服务。项目定位你能自托管的天气 API 长什么样先说清楚它是什么你会对要维护什么有心理预期。Open-Meteo 由一个 Swift 编写的 API 服务编译后是单一二进制加一套为时间序列优化的自研压缩文件格式组成数据来自各国气象机构发布的免费预报。对新手最有价值的三点免密钥天气接口不用注册无广告无跟踪CORS 开箱即用URL 里写经纬度就能查数据来自 NOAA GFS、DWD ICON、ECMWF IFS、MeteoFrance 等主流模型小时级预报最长 16 天另有 80 年历史天气架构极简一个二进制加一个 data 目录没有数据库要管官方版响应时间在 10ms 内记住你自托管得到的是一个完全可控的天气数据接口别指望单机跑出现官方版那样的流量能力。动手前检查清单机器够不够用这一节的目标确认部署机器不会成为瓶颈两档就够了。够用档支持 SIMD 指令集Intel AVX2 之类的较新 CPUx86-64 和 Arm 都行8GB 内存磁盘留 50GB 以上——只下载少量变量时 32-48GB 也能撑住。性能档16GB 内存加 150GB 起步的 NVMe SSD。天气数据全部存在磁盘上查询时直接读盘磁盘还兼任缓存高 IOPS 就是响应速度。结论够用档就能跑起来但如果磁盘是机械盘后期怎么调都没用先上 SSD。️最快上手路径Docker 三条命令跑通这是最快的路线做完你会得到一个在127.0.0.1:8080上可立即查询的 API。镜像已配置为从公开数据源拉取数据并缓存到本地卷所以起步阶段不需要预先下载任何模型。先创建数据卷再启动服务docker volume create --name open-meteo-data docker run -d --rm --name open-meteo \ -v open-meteo-data:/app/data \ -e REMOTE_DATA_DIRECTORYhttps://openmeteo.s3.amazonaws.com/data/ \ -e CACHE_SIZE8GB \ -p 127.0.0.1:8080:8080 \ ghcr.io/open-meteo/open-meteo这里指定远程数据源而不是把数据打进镜像是因为模型数据量太大运行时按需取更合理CACHE_SIZE则决定本地能缓存多少。发一个请求验证curl http://127.0.0.1:8080/v1/forecast?latitude52.52longitude13.41modelsecmwf_ifs025hourlytemperature_2m返回带逐时温度的 JSON你的天气服务就算跑通了。如果你想在 Ubuntu 22.04 上用 systemd 管生产环境也可以装官方 apt 包仓库里的 docs/getting-started.md 有完整步骤适合追求长期运维的人选。注意此刻服务只监听 127.0.0.1别的机器访问不到这是默认行为不用慌。数据跑起来之后同步、刷新、别断供这一节的目标让自托管天气 API 的数据自动保持新鲜。按操作先后做三件事。第一步手动拉一次数据。sync命令要两个参数模型和变量比如拉 ECMWF IFS 0.25° 的温度docker run --rm -v open-meteo-data:/app/data ghcr.io/open-meteo/open-meteo sync ecmwf_ifs025 temperature_2m只下你真正要用的变量磁盘和时间都能省下一大截。第二步开启定期刷新。Ubuntu 包自带openmeteo-sync服务改/etc/default/openmeteo-api.env即可。把要同步的域和变量显式写出来比用默认行为更可控也方便以后排查SYNC_ENABLEDtrue SYNC_PAST_DAYS3 SYNC_DOMAINSdwd_icon,ecmwf_ifs025 SYNC_VARIABLEStemperature_2m,dew_point_2m SYNC_REPEAT_INTERVAL5改完执行systemctl restart openmeteo-sync每 5 分钟就会自动检查一次更新。Docker 用户则可以让sync命令带上--repeat-interval 5常驻运行。想看实现细节读 Sources/App/Commands/SyncCommand.swift。结论拉取和定时刷新到位后你的服务不会再把昨天的天气当成今天的卖。数据过期了怎么自动清理这一节的目标一次性配好定时清理让磁盘永远不会被撑满。Open-Meteo 的数据文件都以chunk_*命名压力层数据更新频繁、只需保留短周期可以在 crontab 里区别对待0 * * * * find /var/lib/openmeteo-api/data/ -type f -name chunk_* -wholename *hPa* -mtime 10 -delete 5 * * * * find /var/lib/openmeteo-api/data/ -type f -name chunk_* -mtime 90 -delete第一行让压力层数据只留 10 天第二行让表层数据留 90 天天数按你的业务自行调整。结论cron 挂上之后磁盘空间这件事可以从你的待办里划掉了。避坑与进阶你会遇到的问题下面是部署后最容易撞上的坑按问题→对策列。请求慢冷缓存下一次查询可能要读几百个压缩文件耗时数秒重复请求或相近坐标会快很多。用得多就调大CACHE_SIZE它支持到 TB 级。想对外暴露默认不对外。把 env 里改成API_BIND0.0.0.0:8080并重启服务生产环境建议前面加 nginx 提供 TLS 和访问控制别裸奔。比官方免费版慢正常。官方版靠全球多机房分担自托管版靠本地缓存吃重复流量适合自己应用里请求量稳定的场景。服务起不来先看日志。Ubuntu 用journalctl -u openmeteo-api.serviceDocker 用docker logs open-meteo。改了代码要开源吗源码是 AGPLv3修改后以网络服务形式提供就必须公开修改后的源码数据本身是 CC BY 4.0展示数据的位置记得标注来源。部署完之后还能做什么到这里你手上已经有一个免密钥、无配额限制、数据完全归自己管的天气 API。接下来建议做两件事一是git clone https://gitcode.com/GitHub_Trending/op/open-meteo把源码拉下来看看数据同步和缓存的实现调参时心里才有底二是先从一个模型、两三个变量跑通全链路确认无误再逐步扩展变量范围海洋预报、空气质量等 API 也是同一套接口体系按需叠加即可。【免费下载链接】open-meteoFree Weather Forecast API for non-commercial use项目地址: https://gitcode.com/GitHub_Trending/op/open-meteo创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考