本文档由 Claude AI 从英文自动翻译。 WMO/气象领域术语在正式使用前应由母语人士审阅。 请参阅 英文原版 以获取权威版本。

只需几分钟，即可启动 WIS2 Downloader 并开始下载数据。

前提条件

1. 下载并解压

下载 最新版本 的压缩包并解压：

tar -xzf wis2downloader-*.tar.gz
cd wis2downloader-*
若要使用最新开发版本，请克隆代码仓库：git clone https://github.com/World-Meteorological-Organization/wis2downloader.git

2. 配置

运行安装脚本，生成包含随机密钥的 .env 文件：

bash setup.sh

该脚本会将 default.env 复制为 .env，并为 FLASK_SECRET_KEY 和 REDIS_PASSWORD 生成随机值。请检查 .env 文件并根据需要调整配置——默认值适用于单机部署。

请妥善保管 .env 文件。该文件包含敏感凭据，不得提交到版本控制系统。

3. 设置下载目录

容器以非 root 用户身份运行（UID 10001，GID 988）。在 Linux 上，启动前必须配置下载目录权限：

sudo groupadd -g 988 wis2
sudo useradd -u 10001 -g wis2 -M -s /usr/sbin/nologin wis2
mkdir -p downloads
sudo chown wis2:wis2 downloads
在 macOS 和 Windows（Docker Desktop）上无需此步骤——Docker Desktop 会自动处理卷权限。

如果无法创建匹配的用户，请参阅管理指南中的 卷权限 章节，了解基于 ACL 的替代方案。

4. 启动服务

docker compose up -d

此命令将启动所有服务：订阅管理器、MQTT 订阅者（法国和巴西 Global Broker）、Celery 下载工作进程、Redis、Prometheus、Grafana 和 Loki。

检查所有服务是否正常运行：

docker compose ps

等待 subscription-manager 健康检查通过（约 30 秒），然后确认其已就绪：

curl http://localhost:5002/health

5. 创建订阅

通过 Web 界面（推荐）

在浏览器中打开 http://localhost:8080。

使用 目录视图 或 树形视图 浏览可用的 WIS2 数据集，选择一个主题，指定保存目录，然后点击 订阅。

通过 API

curl -X POST http://localhost:5002/subscriptions \
  -H "Content-Type: application/json" \
  -d '{
    "topic": "cache/a/wis2/+/data/core/weather/surface-based-observations/#",
    "target": "surface-obs"
  }'

此操作将订阅来自任意数据中心的所有地面观测数据，并将文件保存到 downloads/surface-obs/。

6. 查看下载内容

文件按日期组织，存放在 downloads/ 目录下：

ls -la downloads/surface-obs/

通过 Grafana 监控下载活动，访问地址：http://localhost:3000（默认登录凭据：admin / admin）。

首次登录后请立即修改 Grafana 的默认密码。

后续步骤

指南 内容

用户指南

Web 界面使用方法、创建和管理订阅、数据过滤

管理指南

安全加固、扩展部署、环境变量、监控、维护

API 参考

完整的 REST API 文档；交互式 Swagger 界面：http://localhost:5002/swagger

开发者指南

系统架构、模块内部结构、系统扩展