在手机上跑一个完整的 Ubuntu这事第一次听说的人多半会皱眉ARM 手机、Android 系统、没有 root 权限怎么可能塞得下一个完整的 Linux 发行版但 termux 这个工具把这件看似不可能的事做成了日常操作。termux 是 Android 平台上的一个终端模拟器加 Linux 环境它自带包管理器能直接装 Python、Git、编译器这些常用工具而 ubuntu 作为最主流的 Linux 发行版之一软件源齐全、文档丰富、生态成熟把它搬到手机上等于随身带了一台随时能连的开发机。这篇文章面向的是三类人想在通勤路上写两行代码的程序员、买不起笔记本却想学 Linux 的学生、以及习惯用手机做轻量运维的运维人员。下面我会把自己反复折腾 termux 安装 ubuntu 的全过程拆开讲包括底层原理、版本选择、完整命令、踩过的坑和长期使用后的维护经验尽量做到你看完就能照着复现。1. 先想清楚为什么要在 Termux 里跑 Ubuntu1.1 手机端跑 Linux 的真实需求场景很多人以为这是极客的玩具其实真正用起来之后需求是相当务实的。Termux 本身已经能装 Python、Node、GCC 这些东西但它基于 Android 的 bionic libc很多为 glibc 编译的二进制包根本跑不起来官方源的软件版本也偏旧。这时候 Ubuntu 的价值就体现出来了apt 源里有几万个包pip 装某些带 C 扩展的库时不用再头疼编译链很多开源项目给的官方安装文档就是针对 Debian/Ubuntu 写的照着抄基本不会出错。我自己的使用场景主要有三个。第一个是通勤时写脚本地铁上没座位掏手机比掏笔记本现实得多用 Termux 加外接蓝牙键盘配合 tmux 分屏写写 Python 小工具完全够用。第二个是做学习环境学 Linux 命令、练 shell 脚本、玩 Docker 的基本概念手机上是零成本的沙盒玩坏了直接删掉 rootfs 重装几分钟的事。第三个是应急运维出门在外电脑不在身边服务器出了状况用手机 SSH 上去看日志、重启服务比干着急强太多。这里要说清楚一个定位问题手机上的 Ubuntu 不是用来替代笔记本的它的价值在于“随时可用”和“低门槛试错”。你不会用它在上面编译 Chromium但用它跑一个 Flask 接口、写一个爬虫、跑几百行数据处理体验是完全可以接受的。想明白这一点后面的所有折腾才有意义否则你会在性能对比里不断失望。1.2 proot 与 chroot 的差别为什么 Termux 只能用 proot这是理解整件事的核心。正常的 Linux 里chroot 能把一个进程的根目录切换到指定路径让进程以为自己在一个独立的系统里。但 chroot 需要 root 权限而且它只是改了根目录视角没有做系统调用层面的隔离。Android 上普通应用拿不到 root所以 chroot 这条路对大多数人走不通。proot 是另一套思路。它用 ptrace 系统调用去拦截并翻译目标程序的系统调用把涉及路径、UID、GID 的操作在用户态重写一遍。打个比方chroot 像是把一个人关进一间屋子而 proot 像是在他眼前贴了一层滤镜让他看到的所有门牌号都被改了但他自己毫无察觉。因为是用户态实现proot 完全不需要 root 权限普通 App 就能跑起来。代价也很明显。ptrace 拦截意味着每一次系统调用都要多绕一圈文件密集型的操作会明显变慢编译大项目时的差距尤其明显。另外 proot 无法真正修改内核相关的东西比如加载内核模块、修改网络栈参数、使用需要 CAP_NET_ADMIN 的功能这些都会失败。理解了这一层你就不会奇怪为什么有些命令在手机 Ubuntu 里报“Operation not permitted”——不是你的配置错了是 proot 的机制决定的边界。提示看到权限相关的报错时先判断是不是 proot 的固有限制再去搜索解决方案能省下大量无效折腾的时间。1.3 我踩过的坑三类人不适合折腾这个说句实在话我不建议所有人都来做这件事。第一类是手机存储小于 32GB 的人Ubuntu 根文件系统解压完差不多 300MB 到 500MB装完常用开发工具轻松破 3GB再算上缓存和 pip 包很容易把手机塞满系统会开始清理后台进程你的会话随时可能被杀掉。第二类是用 Android 5.x 或 6.x 老设备的人。Termux 现在的新版本对系统 API 级别有要求老设备往往只能装到很旧的 Termux 版本而那批版本的源基本已经不可用pkg update直接报错你会卡在第一步。这类设备如果非要玩得去 GitHub Releases 页面找历史版本同时手动把源换成还能访问的镜像折腾成本会翻好几倍。第三类是期待图形桌面体验的人。手机 Ubuntu 可以装 XFCE 加 VNC但那个流畅度只能说是“能看”滑动拖影、输入延迟都很明显日常用起来远不如纯命令行舒服。如果你的目标是一个顺滑的移动桌面那这条路大概率会让你失望。把期待值摆正后面每一步都会顺畅很多。2. 环境准备与安装前必须搞定的几件事2.1 Termux 的获取渠道与版本选择这一步就有人走错。Google Play 上的 Termux 版本已经多年没有更新API 级别偏低装完之后pkg update经常直接失败因为官方源已经不再为那个版本提供服务。正确的获取渠道是 F-Droid 或者项目的 GitHub Releases 页面这两个来源的包更新及时源配置也是对的。选版本的时候有两个方向。追求稳定就装 F-Droid 上的正式版更新节奏慢但问题少想用新特性就下载 GitHub Releases 里的 APK注意看清楚架构绝大多数手机是 arm64-v8a老设备可能是 armeabi-v7a装错了直接闪退。安装前把旧版本卸载干净不同签名的包不能互相覆盖安装这个坑我吃过一次装完发现两个图标都在但都打不开。装完之后第一件事是执行termux-change-repo这个命令在较新版本里内置了它能帮你把软件源切换到国内镜像速度差别是几十倍级别的。如果没有这个命令就手动编辑$PREFIX/etc/apt/sources.list替换域名。换完源再跑pkg update pkg upgrade -y这一步可能要几分钟耐心等它跑完中途千万别关。2.2 基础配置存储权限、时区与必要工具Termux 默认只能访问自己的私有目录要读写手机相册、下载目录得先执行termux-setup-storage系统会弹出权限请求同意之后会在 home 下生成storage目录里面有shared、downloads、dcim等软链接。这个权限对后面往外拷文件很重要建议一开始就开好。接下来装几个基础工具这些后面都会用到pkg install -y git wget curl nano vim openssh tmux简单说一下每个的用途。git 用于拉代码wget 和 curl 下载文件nano 和 vim 是编辑器openssh 提供 ssh 客户端和服务端tmux 是终端复用器——这个在手机上尤其重要因为 Android 随时可能因为内存压力杀掉你的会话用 tmux 挂起任务切回来还能接上。时区也要顺手设对否则日志时间全是 UTC排查问题时会看晕termux-wake-locktermux-wake-lock是申请一个唤醒锁防止系统在息屏后杀掉 Termux 进程。做长时间任务比如编译、下载大文件时这条命令基本是必须的配合 tmux 一起用稳定性提升非常明显。想释放的话执行termux-wake-unlock。2.3 空间与电量被忽略的两个硬约束存储空间的账要提前算。Ubuntu 基础 rootfs 大概 300MB 出头装完 build-essential 和 Python 全家桶会涨到 2GB 以上如果再装 Node、数据库、桌面环境5GB 是很容易到的。建议预留至少 6GB 空闲空间因为 Android 在存储紧张时的行为很激进不光杀后台还可能让写入直接失败报出一些莫名其妙的 I/O 错误。电量同样重要。proot 的 CPU 开销比原生高跑编译的时候手机会明显发热同时耗电速度很快。我一般会插着充电线做长时间任务并且把屏幕亮度调低。有的手机在高温下会降频编译时间会突然拉长这不是命令的问题是温控在起作用。另外建议在开发者选项里把“后台进程限制”设成标准限制某些厂商的省电策略会直接冻结 Termux 的网络访问表现为 apt 卡在 0% 不动非常迷惑。注意如果 apt 下载长期卡在 0%先检查是不是被系统省电策略限制了网络把 Termux 加入电池优化白名单通常能解决。3. 用 proot-distro 装 Ubuntu 的完整实操3.1 安装 proot-distro 并确认可用发行版现在主流做法是用 proot-distro 这个工具它把 proot 的复杂参数、rootfs 下载、解压、登录入口都封装好了一句命令搞定。安装很简单pkg install -y proot-distro装完先看看它支持哪些发行版proot-distro list输出会列出可用的发行版名称常见的有 ubuntu、debian、alpine、archlinux 等还会标注是否已经安装。Ubuntu 在这个列表里通常有几个版本的别名比如ubuntu指向当前的 LTS 版本。选哪个版本有讲究想稳定就选 LTS软件包版本老但兼容性好想用新特性可以选非 LTS但会遇到更多依赖冲突。我个人的建议是选 LTS因为在 proot 环境里稳定比新更重要你本来就不是为了追新才用手机的。顺便看一下 rootfs 会装到哪。默认路径在$PREFIX/var/lib/proot-distro/installed-rootfs/这个目录在 Termux 私有空间里不受存储权限限制。如果你打算装多个发行版记得算好空间每个都是独立的一份 rootfs。3.2 安装 Ubuntu 与首次登录安装命令本身只有一行但过程取决于网速国内直连官方源可能很慢甚至中途断掉proot-distro install ubuntu它会自动下载 rootfs 压缩包、校验、解压、做基础配置。如果中途失败多半是下载问题重新执行一次即可它会清理掉不完整的状态。想指定版本可以写成proot-distro install ubuntu22.04这种形式具体支持哪些标签以proot-distro list的输出为准。装完登录proot-distro login ubuntu第一次进去你会看到提示符变成了 root这说明你现在是 Ubuntu 容器里的 root 用户。做一个快速验证cat /etc/os-release uname -a第一条会显示 Ubuntu 的版本信息第二条显示的仍然是手机的 Android 内核版本——这点很关键说明你并没有真的换内核只是在一个被重定向的文件系统里运行这也解释了为什么很多内核相关的操作会失败。退出直接输入exit回到 Termux 环境。想每次都省去敲命令可以在 Termux 里加个别名写进~/.bashrcalias ubproot-distro login ubuntu --shared-tmp--shared-tmp让 Termux 和 Ubuntu 共用同一个 /tmp某些工具之间传临时文件时会方便不少。3.3 换 apt 源、建普通用户、配中文环境进去之后第一件事是换源否则apt update会慢到让你怀疑人生。这里有个容易翻车的点Ubuntu 从 24.04 开始把源文件格式改成了 deb822 风格路径是/etc/apt/sources.list.d/ubuntu.sources而 22.04 及以前还是传统的/etc/apt/sources.list。改动之前先确认自己在哪个版本用cat /etc/os-release看 VERSION_ID改错文件会导致完全不起作用。改完源执行apt update apt upgrade -y然后是建普通用户。一直用 root 不是好习惯很多工具会因此报错或者拒绝运行。创建用户并给 sudo 权限apt install -y sudo adduser dev usermod -aG sudo dev之后登录时用参数切过去proot-distro login ubuntu --user dev如果这个参数在你的版本里不被支持可以在 Ubuntu 内用su - dev切换或者在 Termux 侧写好带--user的别名。中文环境方面装 locales 并生成apt install -y locales locale-gen zh_CN.UTF-8然后设置时区避免日志时间对不上ln -sf /usr/share/zoneinfo/Asia/Shanghai /etc/localtime date这里有个实际经验Termux 侧和 Ubuntu 侧的 locale 是分开的终端显示中文乱码有时是 Termux 这边的问题不只是容器内的。可以试着在 Termux 里执行export LANGzh_CN.UTF-8看是否改善两边都配置正确中文才会正常显示。3.4 目录互通与文件传输的几种方式默认情况下proot-distro 会把 Termux 的 home 目录绑定到 Ubuntu 内相同的绝对路径上所以你可以在 Ubuntu 里直接访问 Termux 的文件cd /data/data/com.termux/files/home ls这个路径看着别扭可以在 Ubuntu 的~/.bashrc里加个软链接操作起来顺手很多ln -s /data/data/com.termux/files/home ~/termux-home往外传文件时Termux 侧的 storage 目录同样可以被 Ubuntu 访问把文件放进~/storage/downloads就能在手机文件管理器里看到。反方向想从手机拷东西进 Ubuntu也是走这个路径。如果要用--bind挂载额外目录登录时加参数proot-distro login ubuntu --bind /sdcard/Documents:/home/dev/docs注意 proot 的 bind 是用户态模拟的性能不如原生挂载处理大量小文件时会明显变慢。如果要跑大型项目我一般把代码放在 Ubuntu 内部路径下只把最终产物拷出来这样能避开不少性能损失。4. 把 Ubuntu 变成能写代码的日常环境4.1 Python、Node 与编译工具链的安装取舍基础开发环境这一套命令不复杂但选择有讲究apt install -y build-essential python3 python3-pip python3-venv git curlbuild-essential 包含 gcc、g、make 这些装它的时候会带上几十个包体积不小但是值得因为很多 pip 包在没有轮子可用时需要本地编译没有它就直接报gcc not found。Python 这边Ubuntu 自带的版本通常够用但要记住不要用 root 直接pip installUbuntu 从某个版本开始会拦截系统级 pip 安装报 externally-managed-environment 错误。正确做法是用 venvpython3 -m venv ~/venv source ~/venv/bin/activate pip install -U pip setuptools wheelNode 的话Ubuntu 源里的版本偏老如果要新版本用 NodeSource 的源或者 nvm。我个人在手机上更偏向 nvm因为它不需要 root切换版本也方便curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/master/install.sh | bash source ~/.bashrc nvm install --lts说一个性能上的取舍。手机上装依赖时能装预编译轮子就别选源码编译pip install时注意看输出里是Downloading xxx.whl还是Building wheel for xxx。前者几秒钟后者可能跑十几分钟还会让手机烫得拿不住。遇到必须编译的包可以考虑在电脑上编译好再传过来或者找有没有纯 Python 的替代实现。4.2 SSH 与远程访问的正确姿势这块要分清楚两个方向。方向一是从手机往外连服务器这是 Termux 侧 openssh 客户端的事ssh userhost直接用就行把密钥放在~/.ssh/下权限设成 600这些和在电脑上没区别。方向二是从电脑连手机里的 Ubuntu这个才是容易踩坑的地方。很多人第一反应是在 Ubuntu 容器里装 openssh-server然后发现启动失败。原因还是 prootsshd 需要特权端口、需要设置 setuid 相关的权限这些在 proot 里做不了。可行的做法是在 Termux 侧启动 sshd默认监听 8022 端口sshd然后用电脑连接手机的局域网 IP端口 8022登录进去就是 Termux 环境再proot-distro login ubuntu进容器。虽然多了一步但是稳定可靠。想省事可以把登录命令写进 Termux 的.bashrc登录后直接进 Ubuntu。排查连不上的时候按这个顺序看手机和电脑是不是同一个局域网、Termux 里sshd进程是否在跑、IP 地址是不是拿到了新的、ifconfig或ip addr看到的地址对不对。很多路由器会开启客户端隔离这种情况下同一 Wi-Fi 下设备之间也连不通需要在路由器设置里关掉。注意在公共网络环境下不要随意开启手机的 SSH 服务也不要把它的端口对外暴露局域网内自己用就够了。4.3 图形桌面什么时候值得装什么时候不值得想上图形界面需要两部分Ubuntu 内的桌面环境和 VNC 服务端加上手机端的 VNC 客户端。以轻量的 XFCE 为例apt install -y xfce4 xfce4-terminal dbus-x11 tigervnc-standalone-server装完之后配置 VNC 密码并启动vncpasswd vncserver :1 -geometry 1280x720 -depth 24然后在手机浏览器或者 VNC 客户端里连127.0.0.1:5901。第一次看到桌面的那一刻确实挺有成就感但用十分钟你就会发现几个现实问题鼠标操作靠触摸屏很难精准窗口拖动有拖影输入法在 VNC 里经常不工作内存占用直接翻倍手机很快开始卡。所以我的建议很明确图形桌面用来做演示、截图、跑一两个必须要有界面才能用的程序可以装当成日常开发环境不建议。真正在手机上高效工作的方式还是 tmux 加命令行编辑器这套组合占资源少、响应快、稳定性高长时间挂着也不容易被系统干掉。如果非要图形界面把分辨率设到 1280x720 或者更低颜色深度用 24 位能省不少资源。4.4 编辑器与字体小细节带来的体验差异编辑器方面vim 和 nano 都够用但如果你习惯图形编辑器Ubuntu 里可以装 code-server通过浏览器访问比装完整桌面轻量得多。装完之后在浏览器里打开对应地址写代码的体验接近桌面版编辑器而且手机和电脑都能访问同一个环境改完保存直接生效这一点在移动场景下非常实用。字体这个细节值得单独说。很多在电脑上很漂亮的编程字体在手机的小屏加上 Termux 的渲染下会变得难认。等宽字体里JetBrains Mono、Fira Code、Hack 这几款在小字号下的可读性都不错带连字的字体要谨慎小屏上连字反而会增加辨识负担。Termux 侧可以直接替换字体文件把 ttf 放到~/.termux/font.ttf然后执行termux-reload-settings生效。另外建议把 Termux 的字号调大一点很多人默认字号在手机上看着费劲长时间盯着容易疲劳。还有一点Ubuntu 容器内的终端配色和 Termux 侧是两套配置别指望改一边两边都变遇到颜色不对的时候先确认是哪一层在渲染。5. 常见问题排查实录5.1 安装中断与网络相关故障最常见的报错是安装到一半卡住或者直接失败输出里能看到下载相关的错误。这类问题的排查顺序是先确认 Termux 侧的源是否可用pkg update能跑通说明没问题再确认 Ubuntu rootfs 的下载地址是否可达。有些网络环境下官方地址访问很慢这种情况只能换时间重试或者找镜像。还有一种情况是提示空间不足。执行df -h看剩余空间如果可用空间只剩几百兆安装肯定失败。清理办法是删掉不需要的发行版 rootfs路径在$PREFIX/var/lib/proot-distro/installed-rootfs/直接用proot-distro remove 名称更安全。DNS 解析失败也是高频问题表现为apt update报“Temporary failure resolving”。可以在 Ubuntu 内检查/etc/resolv.conf如果没有可用的 nameserver手动写一个进去比如nameserver 223.5.5.5。注意这个文件在某些情况下会被重写重启后可能失效长期方案是在启动脚本里重新写一遍。5.2 命令找不到与 PATH 混乱command not found这类问题在跨环境使用时特别多。原因通常是你在 Termux 里装了某个工具进 Ubuntu 后自然找不到因为两边是完全独立的文件系统Termux 的$PREFIX/bin不在 Ubuntu 的 PATH 里。解决办法只有在 Ubuntu 内重新装一遍不要试图把 Termux 的二进制直接软链过去架构和运行库都可能不匹配。另一类是 shell 配置文件读错。Ubuntu 里 root 用户和普通用户的.bashrc是分开的你用--user dev登录时读的是/home/dev/.bashrc之前给 root 配的环境变量全都失效于是出现“昨天还能用的命令今天找不到”。养成习惯配置环境变量时确认当前用户或者写进/etc/profile.d/下的全局脚本里。还有一个隐蔽的坑Termux 的$PREFIX在 Ubuntu 内展开会得到空值或者错误的路径因为那个环境变量在容器里没有定义。写脚本的时候不要硬编码这类变量用容器内的标准路径。5.3 中文乱码、时区与权限问题速查下面这张表是我这几年攒下来的遇到问题先对着查一遍能省下大量搜索时间现象可能原因处理方式中文显示成方块或问号容器内未生成对应 locale装 locales执行 locale-gen日志时间差 8 小时时区未设置软链 /etc/localtime 到对应时区文件apt 提示 resolving 失败DNS 不可用检查并写入可用的 nameserver权限拒绝、Operation not permittedproot 机制限制换用不需要该权限的替代方案会话突然断开、任务中断系统回收后台进程用 tmux 挂任务申请唤醒锁安装后磁盘空间快速下降缓存与未清理的包apt clean、清理 pip 缓存编译时手机极热并变慢温控降频降低任务规模插电并保持散热换源后 apt 无效版本对应的源文件路径不对24.04 用 .sources22.04 用 sources.list这张表里的每一条我都实际遇到过至少一次。其中 proot 权限限制那条最容易被误判很多人会怀疑是自己的配置有问题反复重装系统其实换个思路绕开就行。比如需要低端口监听就用高位端口需要修改系统参数就在 Termux 层处理别在容器里死磕。5.4 老设备与低配机型的适配经验如果你手上的设备比较老有几个地方要提前调整预期。首先是 Termux 版本的选择老系统只能装老版本而老版本的源配置通常已经失效需要手动替换成还能用的镜像地址。这个过程没有统一的教程因为不同的镜像在不同时间的可用性不一样只能自己试。其次是内存。2GB 内存的设备跑 Ubuntu 加编译任务基本是自虐建议只装最小化的软件集合别装桌面环境把 swappiness 相关的行为交给系统默认处理不要人为干预。进程数也要控制同时开三个以上重任务后台被杀的概率会大幅上升。最后是发热和续航。老设备的散热设计通常比较差跑十分钟编译就能到烫手的程度这时候最好把手机放在硬质平面上别放床上或者沙发这种保温材质上。我有一台老机器就是这么被我折腾到电池衰减加速的虽然后来换了新设备但教训还是值得说一句能用不代表适合长时间高强度使用量力而行。6. 长期维护、备份与性能调优6.1 备份与迁移别等重装才想起来玩 proot 环境迟早会遇到需要重装的情况可能是系统升级后不兼容也可能是自己把配置改坏了。提前备份能省下大量时间。proot-distro 提供了备份能力proot-distro backup ubuntu --output ~/ubuntu-backup.tar.gz这个命令会把整个 rootfs 打包恢复的时候用proot-distro restore ~/ubuntu-backup.tar.gz备份文件建议挪到手机存储或者传到别的设备上因为万一 Termux 本身被卸载私有目录会一起消失放在里面的备份也保不住。备份体积通常有几个 G压缩之后能小一些但也别指望太小提前算好空间。我个人的做法是分两级重要的配置文件和项目代码放在 Termux home 下用 git 同步到远程仓库整个 rootfs 每周打一次包只在本地保留最近两份。这样即使环境彻底崩了恢复核心工作成果只要几分钟重建环境也就是重新跑一遍安装脚本的事。6.2 性能调优的几个实用手段性能优化上能做的事情其实有限因为硬件和 proot 机制摆在那里。但有几个手段实测有效。第一是减少跨边界操作。前面说过Termux 侧和 Ubuntu 侧的文件互相访问要走 proot 的翻译层频繁读写会明显变慢。把项目放在 Ubuntu 内部路径只在必要时往外拷能提升不少。我做数据处理时对比过同样的脚本全在容器内跑比反复读写共享目录快出好几倍。第二是控制并发。手机的 CPU 核心数看着不少但大小核调度加上温控实际可用算力远低于纸面参数。编译时用make -j2而不是默认的满核整体耗时反而更短因为避免了降频。pip 安装可以加--no-cache-dir减少磁盘压力或者在空间紧张时清缓存。第三是精简服务。别装用不到的后台服务VNC、数据库、消息队列这些常驻进程每一个都在吃内存手机上的内存是稀缺资源。需要的时候临时起来用完就关这个习惯能显著延长会话的存活时间。6.3 日常使用中的几个习惯建议长期用下来我总结出几条让自己少生气的习惯。第一是重要的长任务一定放 tmux 里跑会话断了能接回来这个在前面提过但值得再说一遍因为它是移动端和桌面端最大的体验差异来源。第二是定期清理 apt 缓存和日志apt clean加上清理/var/log下的老日志能稳定回收一部分空间。第三是给 Termux 加自启动配置如果设备支持的话可以用 Termux:Boot 在开机时拉起 tmux 会话和相关服务省去每次手动敲命令的麻烦。第四是保持更新节奏稳定别一有新版本就立刻升尤其是 Android 系统大版本更新之后Termux 和 proot-distro 都可能有兼容问题等社区反馈稳定了再动手更稳妥。最后分享一个我自己用着很顺的小技巧把所有重复性操作写成一个 shell 脚本放在 Termux home 下比如一键更新、一键备份、一键进容器并激活虚拟环境。手机输入效率本来就低能少敲一次就少敲一次这些脚本积累下来才是让你愿意长期用下去的真正原因。这套环境我在几台设备上反复搭过最大的体会是能跑起来不难难的是把它变成顺手的工作流。前期配置花的那些时间最后都会在“随时能干活”这件事上赚回来。
