最新 OpenWebRX 安装指南:3 种方法快速部署 SDR 接收机

OpenWebRX 是一款开源、多用户、带 Web 界面的 SDR 接收机软件,无需专业客户端,浏览器即可接收、解调、分析无线电信号,支持 RTL‑SDR、HackRF、Airspy 等主流设备,是无线电入门与搭建公共 SDR 接收站的首选工具。
本文基于 2026 年最新环境,整理Docker 容器、Debian/Ubuntu 软件包、手动源码三种部署方式,新手与进阶用户均可快速上手。

一、准备工作

  1. 一台 Linux 主机(Ubuntu/Debian 推荐)
  2. SDR 设备(RTL‑SDR、HackRF One、Airspy、SDRplay、LimeSDR、PlutoSDR 等)
  3. 已接入互联网
  4. 设备已连接 USB,权限正常

二、方法一:Docker 部署(新手首选,10 分钟完成)

Docker 封装所有依赖,一键运行,无需处理环境冲突,官方维护镜像最稳定。

  1. 安装 Docker Engine

    sudo apt update
    sudo apt install docker.io docker-compose -y
    sudo systemctl enable --now docker

  2. 拉取并启动容器(以 RTL‑SDR 为例)

    docker run -d \
    --name openwebrx-rtlsdr \
    -p 8073:8073 \
    --device /dev/bus/usb \
    jketterl/openwebrx-rtlsdr:latest

  3. 访问使用

浏览器打开:http://localhost:8073
支持设备替换
HackRF:jketterl/openwebrx-hackrf
SDRplay:jketterl/openwebrx-sdrplay
Airspy:jketterl/openwebrx-airspy

三、方法二:Debian/Ubuntu 软件包安装(官方源,自动更新)

适合长期使用、希望系统级管理、自动更新的用户。

  1. 添加官方 PPA 源

    sudo add-apt-repository ppa:openwebrx/ppa
    sudo apt update

  2. 安装主程序 + 设备驱动

    安装主程序

    sudo apt install openwebrx -y

    安装 RTL‑SDR 驱动(按你的设备替换)

    sudo apt install openwebrx-rtlsdr -y

  3. 启动并开机自启

    sudo systemctl start openwebrx
    sudo systemctl enable openwebrx

  4. 访问使用
http://localhost:8073

四、方法三:手动源码安装(进阶自定义)

适合需要修改源码、定制功能、深度优化的用户。

  1. 安装系统依赖

    sudo apt update
    sudo apt install git build-essential cmake libfftw3-dev libcsdr-dev \
    libsndfile1-dev python3 python3-pip python3-setuptools \
    python3-cffi libsoapysdr-dev soapysdr-tools -y

  2. 拉取源码

    git clone https://gitcode.com/gh_mirrors/ope/openwebrx
    cd openwebrx

  3. 安装 Python 依赖

    pip3 install -r requirements.txt

  4. 配置并启动

    cp openwebrx.conf.example openwebrx.conf

    编辑配置文件指定 SDR 设备、增益、频率等

    nano openwebrx.conf

    启动

    python3 openwebrx.py

五、配置与优化(所有安装方式通用)

  1. 管理后台:http://localhost:8073/settings
  2. 常用配置项
  • 设置采样率、增益、校正参数
  • 预设常用频段(FM 广播、航空、对讲机等)
  • 配置多用户权限、公网访问
  1. 性能优化
  • 降低采样率减少 CPU 占用
  • 关闭不必要的解调模块
  • 使用有线网络提升稳定性

六、支持设备列表

RTL‑SDR Blog V3/V4
HackRF One
Airspy R2/Mini
SDRplay RSP1/RSP2
LimeSDR
PlutoSDR
完整支持列表见源码:owrx/source/

七、常见问题排查

无法访问 Web 界面
检查 8073 端口是否开放:sudo ufw allow 8073
确认 Docker / 服务正常运行:docker ps 或 systemctl status openwebrx
无信号 / 找不到设备
USB 重新插拔
确认驱动 / 镜像与设备匹配
检查权限:lsusb 能看到设备
卡顿 / 瀑布图延迟高
降低采样率
关闭浏览器多余标签页
使用更高效的解调模式

相关文章

发表新评论