Termux 换源实操：把卡死的 apt update 换成国内镜像源

大陆用户第一次在 Termux 里敲「apt update」，多半会卡在 0% 半天不动，或者干脆超时退出。这不是手机问题，也不是网络欠费，而是 Termux 的官方软件源放在境外，国内访问起来时好时坏，赶上线路抽风就直接连不上。把源换成国内镜像，列表几秒钟就能拉完，后面装包也快得多。

💡

Termux 换源，就是把默认境外官方源（packages.termux.org）替换成清华、中科大等国内镜像源。最简单的方法：运行「termux-change-repo」，勾选 Main Repository，镜像选 Tsinghua 或 USTC，回车即可，「apt update」通常几秒跑完。

$ cat 目录

换源原因图形化换源手动改源验证生效常见坑

一、为什么 Termux 默认源在国内这么慢

Termux 的软件包来自官方仓库 packages.termux.org，服务器在海外。你每执行一次「apt update」或「pkg install」，手机都要跨洋去拉索引和 deb 包，延迟高、带宽窄，apt update 卡在 0% 或者刷出 Ign、Err 报错几乎是常态。更麻烦的是，Play 商店版的 Termux 自 2022 年起不再维护，旧版用户不换源基本装不了东西。所以换国内镜像源，是大陆用户拿到 Termux 之后的第一件正事。如果 Termux 都还没装好，先去Termux安卓版下载拿官方同源包，再回来换源。

二、方法一：用 termux-change-repo 图形化一键换源

刚上手、不熟悉命令行的话，直接跑官方自带的换源工具最省心。在 Termux 里输入：

termux-change-repo

终端会弹出一个 TUI 选择界面。先用方向键把光标移到 Main Repository，按空格勾选，回车进入下一步；在镜像列表里找到 Mirrors by Tsinghua University 或者 Mirrors by USTC，同样空格选中再回车，工具就会自动把源地址改写好。整个过程不用碰任何配置文件，最适合怕改错的新手。换完记得立刻执行「pkg update」把索引拉一遍。想看完整的图形化步骤截图，可以翻我们的图文教程。

三、方法二：手动改 $PREFIX/etc/apt/sources.list.d

有些机型或旧版本没有 termux-change-repo，或者你就是想自己掌控源文件，那就手动改。先记牢一个点：$PREFIX 在 Termux 里等于 /data/data/com.termux/files/usr，命令里直接写 $PREFIX 就行，别手敲完整路径。动手之前，先把整个目录备份到 $HOME，比如：

cp -r $PREFIX/etc/apt/sources.list.d ~/sources-backup

改坏了还能还原。主仓库文件是 $PREFIX/etc/apt/sources.list。用内置编辑器（推荐「nano」或「vim」）打开，把内容替换成一行清华源：

deb https://mirrors.tuna.tsinghua.edu.cn/termux/apt/termux-main stable main

如果你还启用了社区源，得一并改掉，否则那部分还是会走境外。x11-repo 和 root-repo 分别在 $PREFIX/etc/apt/sources.list.d/x11.list 和 root.list，写法：

# x11 社区源
deb https://mirrors.tuna.tsinghua.edu.cn/termux/apt/termux-x11 x11 main
# root 社区源
deb https://mirrors.tuna.tsinghua.edu.cn/termux/apt/termux-root root stable

中科大（USTC）和北外（BFSU）只是换掉域名，路径结构一致：

# 中科大
deb https://mirrors.ustc.edu.cn/termux/apt/termux-main/ stable main
# 北外
deb https://mirrors.bfsu.edu.cn/termux/apt/termux-main stable main

改完保存，执行「apt update && apt upgrade」即可。强调一句：只用 Termux 内置的编辑器改，别用 RE 管理器之类的外部 Root 工具去动这个目录，权限和符号链接很容易被你改坏。三个镜像的官方写法以各自帮助页为准：清华 TUNA、中科大 USTC、北外 BFSU。

四、验证换源是否生效

怎么确认换源真的生效了？最直接的就是看速度。重新跑「apt update」，留意下载地址是不是已经变成 mirrors.tuna.tsinghua.edu.cn 之类的中文镜像域名，并且进度条能跑满、几秒结束。想进一步验证，可以用「pkg search」随便搜个包，比如：

pkg search python

能正常列出结果，就说明源是通的。另外留意自己手机的架构，现在主流安卓基本都是 arm64，Termux 会按需拉对应架构的包，看到 arm64 字样属正常，不必惊慌。

五、换源常见坑

坑一：系统时间不对。手机时间如果偏差太大，HTTPS 证书会校验失败，报 certificate has expired 之类错误。先去系统设置把日期时间调成自动同步，再重跑「apt update」。
坑二：手滑改坏 $PREFIX。这个目录是 Termux 的根，一旦把 sources.list 写错格式或者误删文件，apt 可能直接罢工。开头那句备份不是废话。
坑三：换完源就当完事。换源只是第一步，紧接着应该跑一次「pkg update && pkg upgrade」把基础包升到最新，顺手把备份与迁移的思路也规划好，后面折腾环境才不慌。

六、一句话总结

换源本身不复杂，但它决定了你之后每一次装包是几秒还是半小时。挑一个离你近的镜像（清华、中科大、北外都行），按上面任意一种方法改好，Termux 才算真正在大陆跑得顺。需要官方同源安装包或从零开始的步骤，回到Termux 中文网首页看安装教程。若你是从非 Play 渠道新装，也可以先看Termux 谷歌下架后怎么办。

💡

基础命令与软件包管理可回顾图文教程；其他疑问见常见问题。