Wavelog 介绍与选型指南

目标：一文看清 Wavelog 的定位、架构、功能矩阵与版本/社区活跃度，并给出与母项目 Cloudlog 的量化选型对比。本文为联网溯源文档，全部事实来自 Wavelog 官方网站、官方文档与 GitHub 仓库，查询日期 2026-11-01。

一、环境信息

本文不执行本地实测命令，所有数据来自公开官方渠道的联网溯源，溯源环境与口径如下：

• 溯源对象：Wavelog（业余无线电自托管日志 Web 应用）
• 信息来源：官方网站 wavelog.org、官方文档站 docs.wavelog.org、GitHub 仓库 wavelog/wavelog 及其 Releases 订阅源（releases.atom）
• 查询日期：2026-11-01
• 当前稳定版本：3.2.4（Releases 订阅源最后更新日期 2026-10-14）
• 许可证：MIT License
• 技术栈：PHP + CodeIgniter 3 + Bootstrap + jQuery，运行于 LAMP（Linux + Apache + MySQL/MariaDB + PHP）
• 目标部署环境：专业服务器、租用虚拟主机或树莓派级别的家用服务器均可承载

💡 说明：文中 stars/forks/贡献者/发布日期等量化数据均为 2026-11-01 当日查询快照，GitHub 指标随时间变化，复现时请以当日查询为准。

二、软件概述

Wavelog 是一款开源、自托管的业余无线电（HAM）日志（Logbook）Web 应用。官方定位是"你的主日志本（primary logbook）"：集中记录与保管全部 QSO（通联记录），并从同一平台向各第三方 QSL 服务分发。它支持多用户、多操作台，可配合权限管理服务于俱乐部电台，内置强大的统计分析、实体地图（DXCC/网格/国家等）、奖项核对、QSL 卡片管理与面向第三方工具的 API。

项目历史与治理：

• 2023 年底，Cloudlog 项目的四位核心开发者 DF2ET、DJ7NT、HB9HIL、LA8AJA 决定以 fork 方式继续开发，由此诞生 Wavelog；
• 2024-02-01 发布首个版本，此后在稳定性与功能上快速演进；
• 官方明确 Wavelog 是非营利、非商业、由火腿为火腿（Built from Hams for Hams）的开源项目，代码以 MIT 许可证发布；
• 官方站点标注其获得 Rudolf-Horkheimer-Award 2026，并被多个国家级无线电组织与地方俱乐部用于成员日志管理；
• 界面与文档由社区翻译为多种语言，官方提供专门的翻译平台。

官方同时给出了"What is it not"的边界声明，选型时同样重要：Wavelog 不是 QSL 服务本身，不是别人替你保管日志的"日志垃圾场"，也不是日志备份目的地；它不会自动把 QRZ、LoTW、eQSL 上你日志本里没有的记录拉进来——它的核心始终是"你自己的日志"。

三、核心架构

Wavelog 是典型的 LAMP 应用，官方文档明确其技术分层：

💡 技术拓展：PHP Web 框架不止 CodeIgniter 3。常见选型对比——

框架	特点	适用场景
CodeIgniter 3	轻量、低内存占用、上手快，但已停止大版本演进	树莓派级小硬件、单体 Web 应用
CodeIgniter 4	CI3 的重写后继，性能与安全性更好	新项目
Laravel	功能全家桶、生态庞大，资源开销更高	大型应用、快速业务开发
Symfony	组件化、企业级严谨	长期维护的中大型系统

Wavelog 实际采用 CodeIgniter 3：官方认为其成熟稳定足以支撑本项目，且能跑在树莓派级别的低资源硬件上；这也是评估 Wavelog 技术债时需要知晓的事实。

数据与互操作层：日志记录以 ADIF 为标准交换格式（导入导出均走 ADIF），QSL 服务（eQSL、LoTW、Club Log、QRZ.com、HRDLog、DARC DCL 等）的同步由内置 Cron 任务异步完成；实时通联可经 WLGate 工具桥接 WSJT-X 或电台 CAT 数据。

💡 技术拓展：业余无线电日志文件格式不止 ADIF。常见格式对比——

格式	特点	适用场景
ADIF	键值标签结构、字段最全、事实上的交换标准	日志软件间导入导出（Wavelog 主格式）
Cabrillo	竞赛专用、字段精简	比赛提交
CSV/Excel	通用表格	自定义统计

Wavelog 以 ADIF 为核心交换格式（导出头标注 ADIF_VER 3.1.8），同时支持 Cabrillo 竞赛日志导入导出。

四、功能特性

按官方站点 Features 页与文档站归纳，Wavelog 3.x 的功能矩阵如下：

• 在线日志：浏览器内直观录入 QSO；配套桌面工具 WLGate（Windows/Mac/Linux）可从 WSJT-X 记录或把电台 CAT 数据直接推送到 Wavelog（需 FLrig 或 Hamlib）。
• 高级 DX Cluster：按 DXCC、大洲、波段等过滤 spotting；Live QSO 页集成 DX waterfall，可视化波段热点并快速调谐（需 CAT 连接）。
• 强大地图：按已通联实体生成高度可定制的地图，可导出、分享，或自动生成嵌入 QRZ.com 个人简介的地图，也可嵌入自己的主页（widgets）。
• 真实统计：网格数、年度通联天数、70cm 最远距离等多维分析。
• 奖项追踪：官方称已实现 20+ 项全球奖项的进度核对（DXCC、WAZ、POTA/SOTA/WWFF 等）。
• QSL 管理：与 eQSL、LoTW、HRDLog、QRZ.com、QO-100 DX Club 等第三方服务全面同步；eQSL/LoTW 自动确认，eQSL 卡片可在 Web UI 内直接查看；支持扫描 QSL 卡片上传与标签打印。
• 俱乐部电台（Clubstation）支持：多操作员/多电台环境优化，操作员与台站可随时切换，QSO 自动归属正确操作员，适合比赛与特别事件台。
• 竞赛日志（Contest Logger）：新版竞赛记录器，支持俱乐部多操作员同场记录，窗口可自由布局。
• 卫星（SAT）工具：卫星跟踪与记录辅助。
• 呼号查询：内置 callbook lookup（QRZ.com、HamQTH 等凭据可配置）。
• API：v1 RPC + v2 REST 双轨，供电台、外部记录器、监控脚本集成。
• 多语言：社区翻译平台维护。

五、快速开始

官方推荐的快速路径是 Docker Compose 一键起栈（官方文档示例将容器 80 端口映射到宿主 8086），随后在浏览器完成安装向导。最小流程（摘自官方文档，非本地实测）：

# 官方 docker 文档给出的最小 compose 形态（示意）
services:
  wavelog-db:
    image: mariadb:11
    volumes:
      - wavelog-db:/var/lib/mysql
    environment:
      MARIADB_RANDOM_ROOT_PASSWORD: "yes"
      MARIADB_DATABASE: wavelog
      MARIADB_USER: wavelog
      MARIADB_PASSWORD: <数据库密码>
  wavelog-main:
    image: ghcr.io/wavelog/wavelog
    ports:
      - "8086:80"
    volumes:
      - wavelog-config:/var/www/html/application/config/docker
      - wavelog-uploads:/var/www/html/uploads
      - wavelog-userdata:/var/www/html/userdata
    depends_on:
      - wavelog-db
volumes:
  wavelog-db:
  wavelog-config:
  wavelog-uploads:
  wavelog-userdata:

1. docker compose up -d 启动两个服务；
2. 浏览器访问 http://<服务器IP>:8086/install，进入安装向导；
3. 数据库主机名填 wavelog-db（compose 服务名，官方特别提醒不是 localhost）；
4. 填写站点 URL、管理员账号、呼号、网格（Locator）等，点 Install，Wavelog 自动建表并跳转登录页（慢速系统可能需要几分钟）；
5. 登录后创建台站档案（Station Profile），录入第一条 QSO，再到 Admin → Cron Manager 启用需要的同步任务。

不想动手的可以先体验官方 Demo 站点；传统 LAMP 手工部署路径见官方 Installation 文档。

⚠️ 注意：官方文档明确提醒，自建 Wavelog 需要具备基本的 LAMP 知识与排错能力，否则管理界面与所连服务出问题时会比较吃力。

六、适用场景与限制

适用场景：

• 个人火腿的主日志本：随时随地浏览器记录/查询，数据完全自持；
• 俱乐部/协会电台：多操作员权限管理、QSO 自动归属，国家级组织与地方俱乐部已在用；
• 竞赛与远征：竞赛日志器 + 多操作员 + Cabrillo 导出；
• 卫星/EME 等特种通联：SAT 工具与波段地图；
• QSL 中台：统一管理 eQSL/LoTW/QRZ/Club Log/HRD/DCL 的收发与确认状态；
• 家用树莓派：CI3 + Bootstrap 的低资源开销使入门级硬件即可承载。

限制与取舍：

• 框架停留在 CodeIgniter 3，官方明确 CI4 迁移不在当前路线图，长期技术演进需关注；
• 自托管意味着备份、升级、HTTPS、反代都要自己负责；
• 不是托管服务：不提供公共 QSL 路由以外的服务承诺，实例可用性由运维者负责；
• API v2 要求 3.1.0 及以上版本，老版本实例需先升级；
• 功能面广，单实例配置项较多（config.php 60+ 项、options 表、cron 表），需要一定学习成本——详见站内配置篇。

七、同类选型对比

Wavelog 与母项目 Cloudlog 的对比最有决策价值（两者同源、同为 MIT、同为 CodeIgniter 3 LAMP 应用）。以下量化数据查询日期 2026-11-01：

解读与选型建议：

• 社区热度上 Wavelog 已反超（stars 583 vs 577），且发布节奏极快（2026-06 至 2026-10 四个月即 10 个版本，含 3.0 大版本），功能演进（API v2、竞赛器、俱乐部电台）明显快于 Cloudlog；Cloudlog 的 forks 更多属历史积累。
• 新部署直接选 Wavelog；存量 Cloudlog 用户迁移可先经 ADIF 导出/导入验证，两栈同为 CI3+MySQL，数据模型兼容度高。
• 只想要"能记日志的极简页面"且极度厌恶升级周期的用户，Cloudlog 仍是选项；需要 API 自动化、多操作员、竞赛功能的用户应选 Wavelog。
• Cloudlog 的完整量化画像见站内 《Cloudlog 介绍与选型指南》，其部署篇见 《Ubuntu 22.04 安装 Cloudlog 指南》，配置篇见 《Cloudlog 2.8.21 配置参数详解》，运维篇见 《Cloudlog 2.8.21 常用命令与运维排障详解》。

💡 技术拓展：自托管 HAM 日志并非只有 Wavelog/Cloudlog 一家。生态位对比——

方案	形态	特点
Wavelog	自托管 Web	功能面最全、演进最快（本文主角）
Cloudlog	自托管 Web	Wavelog 的母项目，节奏保守
QRZ.com Logbook / Club Log	托管服务	零运维，但数据不在自己手里
N1MM+ / WSJT-X 本地日志	桌面软件	竞赛/弱信号专用，常作为 Wavelog 的上游数据源

本专栏的取舍：主日志本自托管选 Wavelog，桌面工具产生的记录经 ADIF/WLGate 汇入。

八、参考链接

• Wavelog 官方网站：https://www.wavelog.org
• Wavelog 官方文档：https://docs.wavelog.org
• GitHub 仓库：https://github.com/wavelog/wavelog
• GitHub Releases 订阅源：https://github.com/wavelog/wavelog/releases.atom
• Cloudlog 仓库（母项目）：https://github.com/magicbug/Cloudlog
• 站内相关：《Cloudlog 介绍与选型指南》