fyasshole/micube repository overview

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

---

---

⁠📢 Test v4.3 最新版本更新亮点

1. 🤖 【AI 原生 MCP 领航员接入 · 全面支持 DeepSeek、豆包、通义千问、Claude 等全系大模型】重磅首发： 正式原生内置轻量 MCP (Model Context Protocol 2024-11-05) 领航员服务！纯 Go 原生零依赖嵌入守护进程（内存开销 <1MB · 纯内网安全监听），无缝兼容 DeepSeek、豆包 (火山引擎)、通义千问 (Qwen)、Claude 等主流大模型 及 Cursor / Cherry Studio。无需打开控制台后台，直接以日常口语与 AI 对话，AI 即可自动感知全息网速流量、扫描在线终端设备、一句话流控改策略、秒级平滑热切双核引擎及一键全栈网络自愈加固！
2. 🛡️ 【DNS 回环与递归死锁免疫卫士 (Anti-Recursive DNS Deadlock Guard)】上线： 中间表示层编译器清洗管道自动识别并剥离回环/死锁地址（127.0.0.0/8、127.0.0.53、0.0.0.0、::1、localhost 等），自愈兜底注入高可用直连（AliDNS/TencentDNS）与海外加密 DNS（DoT 1.1.1.1），彻底阻断查询回环死锁与 CPU 满载风险。
3. ⚡ 【节点细粒度连通性诊断与状态透视 (Granular Latency Diagnostics)】落地： 节点测速彻底告别单调“0ms / 超时”，细分提供 正常、DNS解析失败、握手超时、连接被拒、系统资源受限、TLS握手异常、连接重置 等 7 大精准故障根因透视，异常节点以彩色专属状态胶囊清晰呈现。
4. 👑 【网关 + DNS 全双双指主路由】终极免折腾形态正式落地： 全家手机电脑 100% 保持默认 DHCP，主路由 FastTrack 硬件芯片满血直出，CubeX 幕后接管国际跨境分流，看门狗 0 秒无感逃生。
5. 🎨 【控制台视觉美化与 UI 通栏横向排版优化】： AI MCP 领航员全面升级横向通栏大卡片排版，左右列底部严丝合缝齐平，操作按钮响应式自适应防溢出。
6. 🚀 真实进出站网速毫秒动态刷新： 实时反映当前真实下载和上传速度，动态累加并保存本月实际跨境/出站流量，告别数字看似不动的问题。
7. 🔄 双引擎双循环无损验证： Mihomo 与 sing-box 双核热切换丝滑顺畅，国内真实直连与国际分流通道 100% 零中断。

---

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

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

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

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

---

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

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

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

---

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

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

---

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

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

---

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

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

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

• Proxmox VE (PVE) CT 容器 (🥇 强烈推荐首选方案)：

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

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

  # 拉取官方最新镜像 (标签统一为 latest 或 Test-v4.3)
  docker pull fyasshole/cubex:latest
  
  # 单行启动容器
  docker run -d \
    --name cubex \
    --restart always \
    --net=host \
    --cap-add=NET_ADMIN \
    --device /dev/net/tun:/dev/net/tun \
    -v /vol1/1000/cubex/data:/app/data \
    -v /vol1/1000/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

⁠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"
  /tool netwatch add host=10.0.0.7 interval=3s timeout=1s 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⁠