H5000M · AP3000M · x86
全生态自动化定制固件
基于最新开源 ImmortalWrt 主线源码，深度适配 Hiveton H5000M 5G CPE、AirPi AP3000M Wi-Fi 6 路由与 x86 通用软路由。全系支持 QModem Next 现代化响应式与 Classic 经典双前端，集成双路温控风扇、网络模式秒切与一键 OTA 在线直升。
固件版本与产物下载中心
支持实时切换下载加速源，自动区分各机型与 QModem 前端架构，包含 Sysupgrade 固件、内核配置与 U-Boot 引导
固件刷写与升级简明建议
- 已安装本固件用户：推荐直接使用后台
系统 → 在线升级，固件内置设备唯一锚点，会自动检索匹配对应 Release，保留配置安全直升。 - H5000M / AP3000M 原厂或其他系统刷入：请下载对应机型的
*-sysupgrade.bin固件，通过 U-Boot Web 恢复页面或原系统升级入口刷入。 - x86 软路由安装：推荐使用
squashfs-combined-efi.img.gz解压后直接用 BalenaEtcher 或 PE 写入系统盘，亦提供针对虚拟机的.vmdk与.iso安装镜像。
硬件支持与平台架构矩阵
QModem 配置基于 ImmortalWrt 官方主线 Master 分支编译；H5000M / AP3000M 的 Modem Pro 统一版则基于 VIKINGYFY/immortalwrt 的 owrt 分支
Hiveton H5000M
高性能 5G CPE（旗舰蜂窝终端）
- 主控 SoC MediaTek Filogic (MT7987A + MT7996E)
- 5G 通信模组 鼎桥 TD-Tech MT5700M
- Wi-Fi 规格 Wi-Fi 7 (802.11be · 160MHz)
- 散热控制 双路温感 PWM 阶梯风扇调速
- 链路调度 5G / WAN 智能秒切与多线容灾
luci-app-h5000m-fancontrol 双温感智能风扇调度，以及 luci-app-h5000m-netmode 网络模式热备，充分释放 5G 全速潜力。
AirPi AP3000M
高性价比 Wi-Fi 6 路由器
- 主控 SoC MediaTek Filogic 820 (MT7981B)
- 无线驱动栈 官方开源 mt76 驱动
- Wi-Fi 规格 Wi-Fi 6 (802.11ax · 160MHz)
- 校准恢复 自动写 factory 分区 + MAC 绑定
-
源码来源
ImmortalWrt Master 主线
Modem Pro：VIKINGYFY owrt -
网口顺序
Modem Pro 与主线固件 LAN/WAN 相反
两套固件互刷后需调换网线
99-ap3000m-eeprom 开机自启服务，自动提取真实物理 MAC 写入校准模板，开箱即用。
x86_64 通用架构
工控机 / 软路由 / 物理 PC / 虚拟机
- 架构平台 x86_64 64位通用架构
- 适用形态 J4125 / N5105 / N100 / 多网口PC
- 虚拟化支持 PVE / ESXi / VMware / Hyper-V
- 存储扩展 NVMe + BTRFS + Samba4 私有 NAS
- 加速支持 kmod-cryptodev 硬件加解密
.vmdk，网卡驱动全面覆盖（含 Intel i225/i226 2.5G）。
QModem 蜂窝模组双方案深度对比
QModem 双前端提供两套独立方案选型，互斥编译绝不冲突；H5000M / AP3000M 另提供 Modem Pro 统一版，按需选用最称手的模组管理界面
| 对比维度 | 🚀 *-qmodem-next（现代化版） |
🏮 *-qmodem（传统经典版） |
|---|---|---|
| 前端架构与体验 | 现代响应式 JavaScript 单页视图：交互顺滑如丝，无网页白屏刷新，实时流式更新 | 经典 LuCI CBI / JS 页面架构：熟悉传统的 OpenWrt 界面结构与树状菜单排布 |
| 短信管理生态 | 深度整合 sms-forwarder-next，支持现代短信转发与 Webhook 推送 |
配合原生 sms-tool 与 sms-tool_q 短信收发控制套件 |
| 本地化语言 | 现代 Web 组件原生多语言响应设计，自适应浏览器语言偏好 | 完整匹配 luci-i18n-qmodem-zh-cn 官方简体中文语言包 |
| 底层核心引擎 |
✅ 两者底层完全共享 qmodem 核心、ubus-at-daemon、tom_modem、modem_scan 与标准 QMI 通用驱动
|
|
| 驱动互斥机制 |
🔒 显式锁定通用 kmod-usb-net-qmi-wwan，在编译期精准剔除冗余冲突驱动，两个前端互斥构建绝不并存
|
|
CPE 专属硬件套件与底层加速能力
集成模组调试、阶梯温控风扇、双模秒切与企业级 SD-WAN 跨域组网
5G 模组通用管理 (`luci-app-qmodem-generic`)
基于 QModem 的 ubus 接口开发，全面支持运行全景实时监控（固件版本、频段锁定、RSRP/RSRQ/SINR 信号指标、基站小区信息与 IMEI/IMSI）。支持快速 APN 配置与在线 AT 指令交互台。
双温感智能风扇温控 (`luci-app-h5000m-fancontrol`)
实时轮询 CPU 核心与 5G 通信模组的工作温度，依据动态温控曲线实现多阶 PWM 线性/阶梯变速。在低负载静音防噪音与极端千兆吞吐散热之间取得完美平衡。
网络模式毫秒切换 (`luci-app-h5000m-netmode`)
自由平滑切换“纯 5G 蜂窝”、“纯 WAN 有线”与“双线负载均衡 / 主备热备”。深度联动 mwan3 探针实时探测连通性，主链路断网时毫秒级无感转移流量。
固件在线直升 (`luci-app-online-upgrade`)
固件出厂烙印设备唯一特征锚点（{机型}-{前端类型}），运行时精准命中 GitHub 对应 Release，杜绝型号错刷；默认启用配置保留升级（keep_config），内置国内高速下载通道。
硬件加解密加速与轻量私有 NAS
底层开启 kmod-cryptodev 与 kmod-tls，卸载加解密运算 CPU 负荷；集成 NVMe 协议支持、BTRFS 现代文件系统与 Samba4，轻松化身高速局域网共享盘。
跨地域异地安全组网 (SD-WAN)
内置 Tailscale、EasyTier 等现代化 SD-WAN 虚拟组网协议，无需公网 IP 即可实现远程穿透、多设备内网打通与出差访问家庭内部网络资产。
出厂默认配置与快速登入面板
首次刷机引导或恢复出厂设置后的参数表，支持一键复制常用地址与无线密钥
自动化云编译流程与自定义构建指引
无需在本地搭建任何复杂的 Linux 交叉编译环境，完全依托 GitHub Actions 云端编排
Fork 按钮，将项目克隆到你的个人 GitHub 账号下。Actions 选项卡中点击启用工作流执行权限。H5000M-qmodem-next），按需填写后台默认 IP 或 Wi-Fi 参数。云端流水线职责一览
| 工作流名称 | 触发机制 | 核心职能 |
|---|---|---|
WRT-BUILD |
手动 workflow_dispatch |
自定义按需编译。可自由切换机型与版本；分支自动匹配，X86 固定使用 immortalwrt/master，无需手填；TEST=true 仅语法检查，TEST=false 实质编译 |
MTK-AUTO |
每日定时 / 手动 | 全自动拉取源码，并行构建发布 H5000M 与 AP3000M 的三版本固件（QModem Next / QModem / Modem Pro，Modem Pro 基于 VIKINGYFY owrt） |
OWRT-ALL |
每日定时 / 手动 | 全自动构建发布通用 x86_64 平台的双版本固件（含 EFI / Legacy / ISO / VMDK） |
Auto-Clean |
每日 05:00 (CST) | 定期回收历史过期制品与超过 30 天的 Runs 编译日志，保障仓库整洁 |
致敬与鸣谢
本固件的诞生离不开开源社区各位开发者的无私奉献与卓越代码贡献