fyasshole/cubex repository overview

⁠🌌 CubeX · 宿主共生双引擎智能透明网关

---

---

⁠📢 Test v5.2 最新版本更新亮点

1. 🛡️ 【主路由 Fake-IP 黑洞防外泄兜底与 0 证书报错防线 (Blackhole Guard Route)】重磅首发： 自动在主路由 RouterOS 注入 198.18.0.0/15 blackhole distance=200 兜底路由。当旁路由容器冷启、升级或网络重载时，Fake-IP 报文瞬间命中本地黑洞静默吸收，绝对杜绝逃逸至光猫/外网，彻底终结光猫伪证书引发的 NET::ERR_CERT_COMMON_NAME_INVALID 与 HSTS 浏览器强阻断痛点。
2. 🐂 【飞牛 fnOS 与通用 Linux Docker 极简部署原生支持】冲刺 10K+ 下载量： 针对 Docker Hub 突破 9.9K 下载量的飞牛与 Docker 用户群，全新发布官方开箱即用 scripts/docker/docker-compose-fnos.yml，内置 host 网络模式、TUN 网卡透传、数据持久化卷与安全特权配置，零摩擦一行命令启动！
3. ⚡ 【自愈总线 DNS 劫持规则原子保活 (Idempotent Zero-Teardown)】： 重构 CleanAndReapplyRouting 逻辑，健康状态下保持 DNS 劫持规则 0 毫秒连续工作，消除了自愈期间 DNS 泄露至主路由明文上游的竞态窗口。
4. 🎯 【Netwatch 应用级 TCP 心跳探针防抖加固】： 将 RouterOS Netwatch 探针超时从 800ms 优化放宽至 2s（探测间隔 3s），杜绝双核热重载瞬时高负载导致的心跳误判脱钩。
5. 🖱️ 【全页面滑鼠滚轮平滑滚动与底部防截断大留白】： 彻底修复卡片拦截鼠标滚轮事件 Bug，全站卡片支持平滑穿透滚动；底部拓展 96px+ 超大沉浸留白，移动端与 PC 端操作按钮全域防遮挡。
6. 📱 【手机端全沉浸 PWA 桌面 Web App 原生加固】： 补齐高清桌面图标与 standalone 全屏沉浸元数据，消除手机浏览器地址栏干扰，实现 App 级原生顺滑交互。
7. 📜 【全域 105 套全量高精 MRS/SRS 规则体系标准化】： 全平台彻底纠偏并标准化 105 套 MRS/SRS 规则集，覆盖主流应用精准分流与 217heidai 权威广告过滤。
8. 🤖 【AI 原生 MCP 领航员接入 · 全面支持 DeepSeek、豆包、通义千问、Claude】： 纯 Go 原生零依赖嵌入守护进程（内存开销 <1MB · 纯内网安全监听），无需打开控制台后台，直接以日常口语与 AI 对话即可完成运维与自愈。

---

⁠💎 为什么“网关 + DNS 统统指向主路由”才是家庭与极客的最优解？

折腾软路由与旁路由的开发者与网络爱好者们，谁没有经历过网关服务波动引发的局域网大面积断网痛点？
以往不管是传统全包旁路由，还是上一代所谓“网关留主路、改旁路 DNS”方案，一旦你在弱电箱升级固件、换订阅节点、热切换双核、或者写错一行配置把代理搞崩，全家 Wi-Fi 立即弹出黄色感叹号！
家用影音与远程协同顺畅无阻，彻底告别因旁路波动引发的局域网大面积断网与智能设备失联！

CubeX Test v5.2 正式打破魔咒，带来划时代的突破：【网关 + DNS 双双指向主路由】的终极免折腾形态！智能跨网分流与国际加速与国内全速直连两者兼得，全家网络绝对永不断线！

1. 🛡️ 终端 100% 彻底躺平：
   全家所有手机、电视、平板、电脑、智能家居，通通保持出厂系统默认的 DHCP（网关=主路由，DNS=主路由）！连主路由 DHCP 服务端的 Option 6 都不用修改，新设备进门连上 Wi-Fi 就能直接享受全球加速与全域去广告！
2. ⚡ 国内大流量芯片级满血直出：
   全网 90% 以上的国内大流量（微信、B站、爱奇艺、抖音、王者荣耀、百度网盘、局域网 NAS）由主路由器物理芯片级 FastTrack 硬件加速原地直通光猫，直接跑满 2.5G/万兆物理线速，主路由 CPU 占用降至仅 ~1%！
3. 🕊️ 随便怎么折腾绝不断网的免死金牌：
   CubeX 在独立沙盒容器中作为幕后智能出站网关，你在后台随便怎么折腾（双核反复热切、升级固件、更新 105 套规则、甚至强杀进程拔掉容器），配合主路由 Netwatch 毫秒双向逃生看门狗，全家网络绝对永不断线，微信不重连，国内游戏不掉线，客厅电视播《甄嬛传》丝滑得像没发生过任何事！家庭地位固若金汤！

---

⁠📸 控制台真实界面一览 (60FPS 顺滑体验)

⁠1. ✨ 全息动态流量拓扑大屏

全息动态拓扑：局域网设备 ➔ 主路由智能分流 ➔ CubeX 混动中枢。全屋设备物理 MAC 实时识别、60FPS 顺滑拖拽零卡顿、真实网速毫秒级动态刷新！

---

⁠2. 宿主共生中枢与一键全栈自愈

原生无缝融入 RouterOS v7、爱快 iKuai、OpenWrt 与 Linux Docker，支持 0 秒故障逃生与智能回指自愈。

---

⁠3. 217heidai 权威规则与 105 套全量分流体系

深度集成 217heidai 权威规则库，直接在入口处拦截视频贴片广告与流氓追踪探针，上网清爽干净。

---

⁠🚀 极客三步躺平法使用指南 (Quick Start)

⁠1️⃣ 第一步：拉起 CubeX 容器

在任何宿主中通过一行命令拉起 CubeX（分配独立 IP，例如 10.0.0.7 或局域网空闲 IP）：

• 飞牛 fnOS (官方推荐 Compose 一键启动)：

  # 下载官方 Compose 配置并启动
  curl -fsSL https://ghproxy.net/https://raw.githubusercontent.com/zyeyefyass/CubeX/main/scripts/docker/docker-compose-fnos.yml -o docker-compose.yml
  docker compose up -d
  

  Copy
• 通用 Linux Docker (单行拉起 · 标签统一为 latest)：

  docker run -d \
    --name cubex \
    --restart always \
    --net=host \
    --cap-add=NET_ADMIN \
    --device /dev/net/tun:/dev/net/tun \
    -v /etc/cubex/data:/app/data \
    -v /etc/cubex/etc:/app/etc \
    -v /etc/localtime:/etc/localtime:ro \
    -e TZ=Asia/Shanghai \
    -e CUBEX_PORT=2026 \
    -e CUBEX_LISTEN=:2026 \
    fyasshole/cubex:latest
  

  Copy
• Proxmox VE (PVE) CT 容器：

  curl -4 -fsSL https://ghproxy.net/https://github.com/zyeyefyass/CubeX/releases/latest/download/install_pve_lxc.sh | bash
  

  Copy

⁠2️⃣ 第二步：主路由一键下发联动策略 (30秒全自动)

• MikroTik RouterOS：WinBox 导入 setup-routeros-v7.rsc 或执行 2 条命令：

  /ip route add dst-address=198.18.0.0/15 gateway=10.0.0.7 comment="CubeX-FakeIP-Backtrack"
  /ip route add dst-address=198.18.0.0/15 type=blackhole distance=200 comment="CubeX-FakeIP-Blackhole"
  /tool netwatch add host=10.0.0.7 interval=3s timeout=2s comment="CubeX-Zero-Downtime-Escape"
  

  Copy
• 爱快 iKuai 64位 主路由：在 CubeX 控制台【宿主共生凭据】填入爱快密码，点击【⚡ 一键全栈自愈爱快主路由】，全自动下发回指与 DHCP 联动！
• OpenWrt：终端执行官方安装脚本 setup-openwrt.sh 自动完成 Macvlan-Shim 与看门狗编排。

⁠3️⃣ 第三步：全屋终端彻底躺平！

全家手机、电视、电脑连上 Wi-Fi 就能用！网关是主路由 IP，DNS 也是主路由 IP！
国际跨境分流秒开，国内满速，去广告生效，随便折腾拔电全家网络永不断线！

---

⁠📖 完整项目主页与源码文档

👉 更详尽的技术解析与发布包下载，请直达 GitHub 官方仓库：
🔗 https://github.com/zyeyefyass/CubeX⁠