SatDump 完整指南：3 步搭建免费的卫星数据解码环境-育师

SatDump 完整指南：3 步搭建免费的卫星数据解码环境

【免费下载链接】SatDumpA generic satellite data processing software.项目地址: https://gitcode.com/GitHub_Trending/sa/SatDump

SatDump 是一款通用的卫星数据处理软件，帮你把 SDR 录制的基带文件或实时信号解码成卫星图像、遥测数据和科学产品，支持 NOAA、MetOp、风云等百余条卫星管线，图形界面与命令行两种形态。

它能帮你做什么

实时解码：SDR 过顶信号直接进管线，边接收边出图
离线批处理：已录制的基带、wav、帧文件用一条命令批量解码
图像产品生成：解码后自动投影、套 LUT 配色、叠加国界城市，保存 PNG
多设备录制：内置 Recorder 支持 RTL-SDR、HackRF 等 30 余种 SDR，可配 ZIQ 压缩
DVB-S2 解调：内置完整 DVB-S/S2 解调链路，处理 GOES-R 等数据率高的下行

安装与首次配置（从零到第一次输出）

1. 安装依赖

Linux 用户一条命令装齐：

sudo apt install git build-essential cmake g++ pkgconf libfftw3-dev libpng-dev \ libtiff-dev libjemalloc-dev libcurl4-openssl-dev libsqlite3-dev libvolk-dev libnng-dev

macOS 用户改用brew install cmake volk fftw ...（完整列表见 README.md）。

2. 克隆并编译

git clone https://gitcode.com/GitHub_Trending/sa/SatDump cd SatDump mkdir build && cd build cmake -DCMAKE_BUILD_TYPE=Release .. # 只要 CLI 加 -DBUILD_GUI=OFF make -j$(nproc)

Windows 用户直接下载预编译安装包解压即可，无需编译。Raspberry Pi 3 及更早机型请用make -j1。

3. 准备 SDR 设备

一根 RTL-SDR 加 VHF/UHF 天线即可入门。NOAA 气象卫星 APT 信号在 137 MHz 频段；MetOp X 波段 AHRPT 需要 1699.36 MHz 附近的接收链。执行satdump sdr_probe确认设备被识别。

4. 启动

GUI 版执行./satdump-ui，CLI 版执行satdump，首次会生成satdump_cfg.json配置文件。

选一个任务跑通

任务一：离线解码 NOAA APT 录音

目标：把一段 137 MHz 录制的 wav 解码成卫星云图。关键操作：

./satdump pipeline noaa_apt wav /home/user/noaa15.wav ./out \ --satellite_number 15 --start_timestamp 1726800000

参数说明：satellite_number取 15/18/19，投影和叠加依赖它；start_timestamp是文件开头的 UTC Unix 秒，align_timestamps默认开启，靠 APT 时标自动对齐。预期输出：./out目录出现 AVHRR 校准图与投影产品，界面侧会自动挂到 Products 下。完整管线与参数清单见 docs/pages/Pipelines.md。

任务二：实时解码并录制

目标：卫星过顶时边收边解。执行：

./satdump legacy live noaa_apt ./out --source airspy \ --samplerate 2e6 --frequency 137.1e6 --general_gain 42 --timeout 780

--samplerate必须与录制设备一致，--timeout 780控制最长接收秒数。过顶期间图像自动写入./out。只收不解码则改用satdump legacy record 文件名 --source airspy ...，输出基带供日后回放。

任务三：生成投影图

目标：把解码出的原始扫描图投到全球底图。在 QuickStart 指引的操作下：选中 Instruments 里的 AVHRR 221 通道，套 Preset 后点Add To Proj，选 Equirectangular 并勾选Auto Mode与Auto Scale Mode，点Project。多通道叠加：Current -> Image to Handler后把图像拖到同一 Projection 上再次 Project。

让效率翻倍的设置

采样率对齐：--samplerate必须和 SDR 实际采样一致，错一拍整条管线作废
OpenCL 加速：装ocl-icd-opencl-dev（macOS 用 Homebrew 装对应包），重算速度明显提升
ZI 压缩录制：编入libzstd-dev后录制可选 ZIQ 格式，体积显著缩小
批量离线：satdump pipeline可串多条命令处理历史过顶数据，无需盯屏
时标对齐：APT 的start_timestamp与真实时间差要在 15 秒内，align_timestamps才能生效

生态与兼容

SDR 设备：RTL-SDR、HackRF、Airspy/HF、LimeSDR、BladeRF、Pluto、SDRPlay、USRP 等 30 余种，源码在 plugins/sdr_sources/
卫星管线：NOAA、MetOp、Meteor-M、风云 3/4、GOES-R、Himawari、SpaceX 遥测等，清单见 docs/pages/Pipelines.md
解调链路：DVB-S/S2 全套、卷积编码、LDPC，见 plugins/dvb_support/
平台：Windows、macOS、Linux、Android（F-Droid）、Docker