Skip to content

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

33 Commits

Folders and files

Repository files navigation

VoHive (Community Reborn Edition)

面向高通 4G/LTE/5G 模组(Quectel EC20/EC25/EG25 等)与全球免漫游通信(VoWiFi / eSIM / SMS)的极客综合管理与网关平台。


⚠️ 开源致敬与免责声明

本项目为社区抢救维护版(Forked & Reborn)。原作者 iniwex5 的核心仓库及底层 vowifi-go 等关键依赖库已遗憾 404 失效。本项目在 windloom 源码备份的基础上进行了深度清洗:修复了依赖断链、移除了冗余的强制自动更新与联网后门逻辑,并重构了自动化构建流水线。

使用注意:本项目仅供技术交流、硬件性能测试与本地网络学习使用,基于原作者的非商业协议开源。严禁用于任何非法、违规、灰黑产或违反当地法律法规的网络环境。 涉及底层的国际运营商连接(VoWiFi/IMS)、硬件热插拔与资费消耗等风险,均由使用者自行承担,作者与社区不对任何直接或间接损失负责。


✨ 本分支 (xepes0/vohive-cont) 的独家突破特性

  • 🛡️ 彻底去中心化与安全加固:修复了原版依赖跑路导致的编译崩溃,剥离了强制远程检查更新的后门逻辑,纯本地环境运行更安全、更稳定。
  • ⚡ OpenWrt ARM64 极致专版(首创!):针对小闪存、ARM64 软路由(如 QWRT 等)特制优化!在云端流水线深度脱壳与瘦身,将体积压缩至 ~8MB,彻底根治 ARM64 架构下的 Segmentation fault(段错误)。
  • 🚀 RAMDisk 内存盘极速守护架构:独创 /tmp/run 内存盘极速释放执行,实现对路由器本地 Flash 闪存的「0 磨损、0 占位」!内置精巧启动脚本(Launcher),彻底规避 OpenWrt 底层 procd 不认工作目录及命令切片崩溃的顽疾。
  • 📦 全架构开箱即用:引入全新的 GitHub Actions 自动化流水线。每次代码提交,自动同步生成 AMD64 (x86_64) 与 ARM64 双架构的纯净版 Docker 镜像,并自动提取出厂合规配置文件。

🚀 极速部署指南

方案一:OpenWrt / QWRT 软路由一键盲选秒通(推荐 🔥)

如果你拥有 ARM64 / x86 的 OpenWrt 或 QWRT 软路由,且插入了大疆等通信模组,无需手动下载、无需写任何配置文件。直接在路由器的 SSH 终端中粘贴执行以下极客密语:

wget --no-check-certificate -O - https://raw.githubusercontent.com/xepes0/vohive-cont/main/install.sh | sh

你将体验到的全自动流水线:

  1. 自动初始化纯净目录与出厂默认配置文件 (/etc/vohive/config/config.yaml)。
  2. 自动下载 ~8MB 的极限精简底包 (vohive.gz) 到本地卡槽。
  3. 自动向系统注册 procd 守护进程,并在启动瞬间将其高速释放至内存盘(RAMDisk)常驻执行。
  4. 无需任何前台人工干预! 安装完毕后,打开浏览器访问 http://<软路由IP>:7575 即可直接进入管理面板!

常用运维指令:

  • 启动服务:/etc/init.d/vohive start
  • 停止服务:/etc/init.d/vohive stop
  • 重启服务:/etc/init.d/vohive restart
  • 查看运行日志:logread | grep -i vohive

方案二:Docker 一键部署(适合 NAS / Linux 物理机)

本仓库的最新双架构容器镜像已实时托管至 GitHub 容器注册表(GHCR),适合具有充足硬盘空间的宿主机部署。

1. 创建必要的数据目录:

mkdir -p vohive/{config,data,logs}

2. 创建 docker-compose.yml 文件:

services:
  vohive:
    image: ghcr.io/xepes0/vohive-cont:latest
    container_name: vohive
    restart: unless-stopped
    network_mode: host
    privileged: true
    volumes:
      - ./config:/app/config
      - ./data:/app/data
      - ./logs:/app/logs
      # 将宿主机 USB 设备直通给容器,用于识别 4G/LTE 模组
      - /dev:/dev
    environment:
      TZ: Asia/Shanghai
      CONFIG_PATH: /app/config/config.yaml

3. 启动服务:

docker compose up -d

默认后台管理地址:http://<设备IP>:7575。


🛠️ 核心功能概览

  • 多模组热插拔并发管理:USB 热插拔实时发现 (ttyUSB / cdc-wdm 等),自动识别 IMEI / ICCID,多网卡设备状态可视化。
  • 全球免漫游通信 (VoWiFi / IMS 接入):支持通过前置代理 (SOCKS5/HTTP) 连接国际运营商 ePDG 网关,提供通话与实时短信接入,彻底省去高昂漫游费。
  • 轻量级代理出站引擎:内建 SOCKS5 / HTTP 代理内核,基于底层物理网卡(wwan0 等)严格绑定策略与分流,网关探测可视化。
  • eSIM 芯片直接调度:支持直接通过 AT / QMI 指令对设备内的 eSIM Profile 芯片进行一键操作(在线下载、激活、暂停、删除)。
  • 全渠道实时告警通知:重要验证码、系统断连、来电及告警消息可秒级实时推送至 Telegram、飞书、Bark 等终端。

📄 License & 法律声明

本项目基于原作者的 PolyForm Noncommercial License 1.0.0 协议发布(详见 LICENSE 文件),仅限于非商业性质的个人交流与学习。内置的底层依赖项(如 vowifi-go, quectel-qmi-go 等)遵循其各自原始的开源协议。

在分发、构建二进制或发布公开 Docker 镜像前,请认真确认相关开源协议的义务;详情参阅 THIRD_PARTY_NOTICES.md。


© 2026 Community Reborn Project · Dedicated to All Geeks & Network Engineers

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages