最新 OpenWebRX 安装指南:3 种方法快速部署 SDR 接收机
OpenWebRX 是一款开源、多用户、带 Web 界面的 SDR 接收机软件,无需专业客户端,浏览器即可接收、解调、分析无线电信号,支持 RTL‑SDR、HackRF、Airspy 等主流设备,是无线电入门与搭建公共 SDR 接收站的首选工具。
本文基于 2026 年最新环境,整理Docker 容器、Debian/Ubuntu 软件包、手动源码三种部署方式,新手与进阶用户均可快速上手。
一、准备工作
- 一台 Linux 主机(Ubuntu/Debian 推荐)
- SDR 设备(RTL‑SDR、HackRF One、Airspy、SDRplay、LimeSDR、PlutoSDR 等)
- 已接入互联网
- 设备已连接 USB,权限正常
二、方法一:Docker 部署(新手首选,10 分钟完成)
Docker 封装所有依赖,一键运行,无需处理环境冲突,官方维护镜像最稳定。
安装 Docker Engine
sudo apt update
sudo apt install docker.io docker-compose -y
sudo systemctl enable --now docker拉取并启动容器(以 RTL‑SDR 为例)
docker run -d \
--name openwebrx-rtlsdr \
-p 8073:8073 \
--device /dev/bus/usb \
jketterl/openwebrx-rtlsdr:latest- 访问使用
浏览器打开:http://localhost:8073
支持设备替换
HackRF:jketterl/openwebrx-hackrf
SDRplay:jketterl/openwebrx-sdrplay
Airspy:jketterl/openwebrx-airspy
三、方法二:Debian/Ubuntu 软件包安装(官方源,自动更新)
适合长期使用、希望系统级管理、自动更新的用户。
添加官方 PPA 源
sudo add-apt-repository ppa:openwebrx/ppa
sudo apt update安装主程序 + 设备驱动
安装主程序
sudo apt install openwebrx -y
安装 RTL‑SDR 驱动(按你的设备替换)
sudo apt install openwebrx-rtlsdr -y
启动并开机自启
sudo systemctl start openwebrx
sudo systemctl enable openwebrx- 访问使用
http://localhost:8073
四、方法三:手动源码安装(进阶自定义)
适合需要修改源码、定制功能、深度优化的用户。
安装系统依赖
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拉取源码
git clone https://gitcode.com/gh_mirrors/ope/openwebrx
cd openwebrx安装 Python 依赖
pip3 install -r requirements.txt
配置并启动
cp openwebrx.conf.example openwebrx.conf
编辑配置文件指定 SDR 设备、增益、频率等
nano openwebrx.conf
启动
python3 openwebrx.py
五、配置与优化(所有安装方式通用)
- 管理后台:http://localhost:8073/settings
- 常用配置项
- 设置采样率、增益、校正参数
- 预设常用频段(FM 广播、航空、对讲机等)
- 配置多用户权限、公网访问
- 性能优化
- 降低采样率减少 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 能看到设备
卡顿 / 瀑布图延迟高
降低采样率
关闭浏览器多余标签页
使用更高效的解调模式
最后更新于 2026-04-30 18:38:27 并被添加「sdr rtl-sdr openwebrx」标签,已有 14 位童鞋阅读过。
本站使用「署名 4.0 国际」创作共享协议,可自由转载、引用,但需署名作者且注明文章出处