You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

Termux安装bootstrap包失败 访问termux.net超时报522错误如何解决

Termux 初始化拉取bootstrap包失败排查方案

对应安装报错如下:

Unable to Install
Termux was unable to install the bootstrap packages.
Check your network connection and try again.

你跨局域网设备、境外Replit服务器访问termux.net/bootstrap/均返回522错误,已经可以基本排除单设备WiFi配置问题——522是Cloudflare CDN返回的源站连接超时错误,大概率是官方对应服务节点临时故障,可按以下优先级逐一排查解决:

  • 先校验安装包版本兼容性:你使用的Galaxy S5搭载Android 6.0.1系统,最高仅支持Termux v0.118.0版本,v0.118.1及之后的官方安装包最低要求Android 7.0,版本不兼容时也会抛出bootstrap安装失败的误导性报错,先核对你从三个渠道下载的安装包版本号,高于v0.118.0的直接淘汰。
  • 排除本地网络拦截的剩余可能性:把手机切换到移动数据网络(断开所有WiFi连接),手动将手机移动网络的DNS改为1.1.1.1或8.8.8.8后重新尝试启动Termux安装流程,如果此时能正常拉取bootstrap,说明之前的局域网宽带有域名拦截或DNS污染问题,后续使用时给Termux配置可用镜像源即可。
  • 采用离线bootstrap部署方案:如果确认是官方源临时故障,可以下载和你安装包版本、设备架构(Galaxy S5为armv7架构)匹配的离线bootstrap压缩包,完全卸载现有Termux并清除所有残留数据后重新安装,安装完成后先不要启动,将bootstrap压缩包放到/data/data/com.termux/files/目录下(该操作需要root权限,无root设备可直接下载已打包内置对应版本bootstrap的安装包直接安装),首次启动时Termux会自动读取本地压缩包完成初始化,不需要联网拉取资源。
  • 更换镜像源完成初始化:部分第三方构建的Termux安装包支持在首次启动报错页手动指定bootstrap拉取地址,可直接填入可用的Termux镜像站对应bootstrap路径,绕过故障的官方源完成初始化,初始化完成后记得把包管理源也替换为对应镜像,避免后续安装软件包时再次出现连接问题。
  • 排查残留文件冲突:如果之前设备上安装过Termux,卸载不彻底残留的文件权限异常也会触发同类报错,可在卸载Termux后用系统清理工具删除所有com.termux命名的相关目录,重启手机后再重新执行安装流程。

内容的提问来源于stack exchange,提问作者Arnold Palmer

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.08.27 03:18:15