文档与快速上手
三个产品,三条最快路径。命令都可以一键复制;更完整的说明在各仓库的 README 与文档里。
moxsh · 安卓液态玻璃终端 Android 9+(minSdk 28)
第 1 步 · 安装 App。下载页提供每个版本的正式签名 APK 与多个国内加速镜像,任选其一:
第 2 步 · (可选)安装自研 PRoot 引擎。App 内已内置;这条命令是给原版 Termux 用户用的——把同一个引擎装成 Termux 里的 moxsh-proot 命令:
curl -fsSL https://raw.githubusercontent.com/codecloud-dev/moxsh-terminal/main/scripts/install-moxsh-proot.sh | bash装完即可进入 Ubuntu(二进制从 GitHub Release 下载并做 sha256 校验,放不下就不装,绝不静默):
moxsh-proot -R ~/ubuntu -0 -- bashApp 内还有:Ubuntu / Debian / Kali / Alpine 一键安装(国内镜像优先)、图形包管理器、资源监控、AI 助手。详见 GitHub README。
moxwebgpu · WebGPU 计算框架 ~30KB · 零依赖
方式一 · 浏览器零构建。一个 script 标签拿到全局 MoxWebGPU——你现在看到的页面背景,就是同一个 bundle 在你的 GPU 上实时算的:
<script src="https://mox-site.pages.dev/webgpu/moxwebgpu.browser.js"></script>const gpu = await MoxWebGPU.mox.init();方式二 · 源码构建(TypeScript 源码 + vitest + tsup):
git clone https://github.com/codecloud-dev/moxwebgpu.git && cd moxwebgpu && pnpm install && pnpm build说明:npm 账号关联后即发布,届时 npm install moxwebgpu 直接可用(发布流程已就绪,关注仓库 Release)。WebGPU 需要安全上下文:Chrome / Edge 113+,或 localhost。想先看效果:在线演示 · 开发者接入页。
mox-id · 统一账号与云同步
登录。点本站右上角「登录」,两种入口:
- 账号密码登录:用「邮箱 / 用户名 + 密码」直接登录(首次需先注册;改邮箱必须先在登录态内走一次快捷登录完成所有权校验后才能在个人中心修改)。
- 快捷登录:GitHub / Gitee 一键授权,30 天内免重复登录,授权只读取公开资料。
个人中心。顶部导航「个人中心」里管理一切:头像、昵称、联系邮箱、商品兑换、订单与资产、登录设备、账号注销。
云同步。在 moxsh 的「账号与云同步」卡片登录后,多设备配置与命令历史自动同步;内容在客户端加密后才上传,服务端看不到明文。
ProoT 增值服务与兑换 ¥5.99 / 30 天
ProoT 引擎分两层,别搞混:
- 个人版(免费):基础 PRoot 容器能力,开箱即用,无需兑换。
- ProoT 增值服务(
proot-pro,按月订阅):解锁下列需要付费才能用的高级能力。这是「个人版兑换」之上的增值层——个人版解决"能不能用",增值服务解决"用得更猛"。
购买与兑换。在 兑换页 用爱发电订单号或兑换码把授权赋予本设备;订阅按 30 天一个周期计费(¥5.99 / 周期)。
到期与离线。授权带到期时间,即便设备 30 天不联网,到期当天也会自动失效,续费后在 App 内执行 mox redeem status 刷新即可恢复。订阅型授权离线也按到期日判定,不依赖每次联网。
仅增值服务解锁的 4 项功能(在 ProoT 配方列表里标 🔒,持有 proot-pro 授权即解锁):
pro-gpu· GPU / WebGPU 加速透传:容器内启用 Mesa/EGL/Vulkan 与 WebGPU 转发,图形与 AI 推理能用上宿主 GPU。pro-nested· 嵌套容器(Docker / Podman):在 ProoT 容器内再跑容器运行时,支持镜像构建与编排。pro-systemd· systemd 常驻:让容器以 systemd 作为 PID 1,支持服务自启与日志归集。pro-snapshot· 容器快照与克隆:对 rootfs 做增量快照并一键克隆,支持备份还原与多实例并行。
常见问题
需要 root 吗?
不需要。moxsh 无需 root、装上即用;PRoot 发行版也是用户态隔离,不碰系统分区。
支持哪些设备?
Android 9(API 28)及以上。WebGPU 演示需要 Chrome / Edge 113+ 或任意桌面浏览器的 localhost 安全上下文。
我的数据存在哪?
云同步内容在客户端加密后才上传,服务端看不到明文;登录凭证只存本机浏览器。发现陌生设备时,可在个人中心一键踢掉。
npm 上为什么搜不到 moxwebgpu?
moxwebgpu 尚未发布到 npm(发布流水线已就绪,待绑定 npm 账号后上线)。在这之前请用上方的浏览器 bundle 或源码构建,能力完全一致;正式发布后 npm install moxwebgpu 才会可用。
遇到问题怎么办?
首选 GitHub Issues(我们都会看);也可以发 邮箱。报 bug 时附上机型、系统版本与复现步骤最有力。