wfweb：Icom 电台浏览器控制台

项目简介

wfweb 是 wfview 的一个分支（fork）。它保留 wfview 的电台引擎（CI-V 与 LAN 控制、瀑布图、局域网音频），把原本的桌面 Qt 界面替换为内置的 HTTP/WebSocket 服务器，从而让你用手机、平板或电脑的浏览器就能操作 Icom 收发信机，客户端不需要安装任何软件。

主要功能

• 浏览器远程控制：频谱图与瀑布、频率/模式/滤波调节，内置 HTTP/WebSocket 服务。
• 浏览器音频：接收音频流式播放，也可用浏览器麦克风向电台发射（SSB 等）。
• CW：内置解码器（DeepCW 神经网络模型，ggmorse 作为回退）与自动键控，支持可编辑宏、break-in、通过 MIDI 控制器或 USB 键盘适配器接 paddle、一键记录 QSO。
• RTTY：神经解码器 + 通带瀑布与一键自动调谐，通过电台数据口进行 AFSK 发射，支持宏。
• SSTV：18 种模式收发图片，可用摄像头或文件作为图像源，支持文字叠加，各设备共享同一个图片画廊。
• FT8 / FT4：在页面内完成解码、呼叫与记录，每次解码都会标在瀑布上并标注 DXCC 实体，新实体以星标提示。
• JS8：键盘对键盘的消息通信，显示听到的电台及信号报告，每个 QSO 一个标签页，支持从 Slow 到 JS8 60 的多种子模式。
• 数字语音：服务端处理 FreeDV（700D/700E/1600）与 RADE，浏览器端只收发普通语音音频。
• AX.25 分组通信：300、1200、9600 波特，支持 BBS 会话、帧监视与 YAPP 文件传输；APRS 信标实时标注在地图上，并使用真实的 APRS 符号集。
• 日志与记录：服务端 ADIF 日志簿，可向 GridTracker、JTAlert、Log4OM 等远程记录软件提供日志；支持录制 MP3 音频或带频率与设置信息的瀑布视频。
• 移动端适配：响应式界面、触摸按键锁定与自锁 PTT，支持无显示（headless）运行。

安装与使用

wfweb 有两种形态，都由浏览器操作，区别在于驱动电台的方式。

Standalone：无需安装、无需服务器

1. 用 USB 线把 Icom 电台连到电脑。
2. 在 Chrome、Edge 或其他 Chromium 系浏览器中打开 https://wfweb.k1fm.us。
3. 点击右上角的连接圆点，选择 Connect rig，在系统弹窗中选择电台的 USB 串口。wfweb 会自动探测波特率，并通过 CI-V 地址识别机型。

也可自行构建静态包，托管在任意 HTTPS 站点上。

Server：原生二进制

从 GitHub Releases 下载对应平台的预编译包，插好电台后运行：

./wfweb

AppImage 需要先赋予执行权限：

chmod +x wfweb_*.AppImage
./wfweb_*.AppImage

使用 LAN 电台（如 IC-7300 Mk2、IC-9700）时指定 IP 与凭据：

./wfweb --lan 192.168.1.100 --lan-user admin --lan-pass secret

若电台的 CI-V 地址不是默认值，可显式指定：./wfweb --civ 0x94。

Docker

镜像 k1fm/wfweb 为多架构（linux/amd64、linux/arm64）：

docker run --rm -it -v wfweb-data:/data -p 8080:8080 -p 8081:8081 k1fm/wfweb --lan 192.168.1.100 --lan-user admin --lan-pass secret

启动后在浏览器打开 https://<host>:8080，接受自签名证书警告即可。

注意事项

• Standalone 限制：仅支持 USB 连接的 Icom 电台，且仅限 Chromium 系浏览器（不支持 Firefox、Safari）。LAN 电台、经典 FreeDV、PSK Reporter / FreeDV Reporter spotting 等功能需要 Server 版本。
• Docker 必须挂载卷：请始终把卷挂到 /data，设置、TLS 证书与 QSO 日志都存在这里，否则容器删除后全部丢失。
• 从 v0.9.0 或更早版本升级：配置原先位于 /root/.config/wfweb/wfweb.conf，需要复制到 /data/wfweb/wfweb.conf，或在网页界面中重新填写一次设置。
• 使用 -e WFWEB_NO_AUTOCONNECT=1（或 --no-autoconnect）可让 wfweb 启动时不自动连接电台，改由界面上的 Reconnect 按钮按需连接，方便与其他客户端共用电台。
• 更完整的安装说明、已知可用机型、电台菜单设置与各模式说明见项目 wiki。

---

本作品整理自 GitHub 开源项目 adecarolis/wfweb，原作者 @adecarolis，许可证 GPL-3.0。中文介绍由 AI 根据项目 README 整理，以原仓库为准。