ZeroTermux 中文文档 下载 App

ZeroTermux 安装教程——从卸载旧 Termux 到第一次启动

第一步：彻底卸载 Termux

这是最重要的前提。如果你的设备上装过原版 Termux、旧版 ZeroTermux 或同签名的应用，必须先卸载干净再装新 ZeroTermux。

卸载步骤：

  1. 打开手机「设置 → 应用管理」
  2. 找到所有 Termux 相关的应用（可能叫 Termux、Termux Boot、Termux Widget 等）
  3. 逐个卸载，包括清除数据
  4. 如果之前装过 ZeroTermux 的旧版本，同样卸载

为什么要卸载？ZeroTermux 和原版 Termux 共享包名（com.termux）的部分文件，不卸载直接覆盖可能导致安装失败、环境损坏或两个应用互相干扰。

第二步：下载 APK

ZeroTermux 的最新版本统一从 get.zerotermux.dev 下载，这个地址始终指向最新稳定版。

用手机浏览器（Chrome / Firefox 均可）打开该地址，浏览器会自动开始下载 APK。下载完成后文件一般在内部存储的 Download 目录里。

只从 get.zerotermux.dev 获取官方版本。其他渠道的 APK 可能被修改或落后于最新版本。

第三步：安装 APK

  1. 打开手机文件管理器，找到刚下载的 .apk 文件
  2. 点击文件，系统会弹出安装确认
  3. 如果提示「未知来源应用」，前往设置开启对应权限
  4. 返回安装界面，点击「安装」并等待完成

第四步：首次启动

安装完成后打开 ZeroTermux，会进入引导流程。完整的引导和故障排除见 首次启动引导流程。

简要流程：

  1. 选择使用习惯（Termux 风格 / ZeroTermux 风格）
  2. 授予内部存储权限
  3. 选择数据目录（推荐内部存储）
  4. 等待 Bootstrap 基础环境安装完成

首次启动期间不要切后台、不要清理进程，否则可能导致 Bootstrap 安装失败。

安装失败怎么办

如果安装时报错或首次启动一直停在加载界面：