Termux手机Linux环境配置指南：从初始化到高级玩法

把 Termux 装在一台不打算 root 的安卓手机上几乎是目前体验“口袋 Linux”最省事的路径。装好之后会看到一个黑乎乎的终端很多人就在这里卡住了——不知道先敲什么也不知道后面还能做什么。这篇文章专门聊装好之后的那些操作从初始化和换源开始逐步讲清楚 Python、Git、SSH、tmux 这些怎么在手机上落地最后把使用半年攒下来的几个坑一次性倒出来给刚接触的朋友少走点弯路。1. 装好后先别急着装工具这五个设置才是分水岭1.1 先跑一遍 pkg update把软件源索引更新到最新装完 Termux 的第一件事不是急着装 Python、Git而是先执行下面这条命令pkg updateTermux 的包管理器叫pkg它是对底层apt的一层封装日常用pkg就够了。刚装好的环境里软件源索引可能是旧的直接装软件经常会碰到“找不到包”或者“版本太老”的情况。执行完pkg update之后建议紧接着跑pkg upgradeupgrade会把系统里已有的基础包升级到最新版本尤其是termux-tools、bash这类核心组件。第一次升级时可能会弹出一堆配置询问比如“配置文件要保留还是更新”新手看到这界面容易慌其实直接选默认项就行。这一步会比较耗时尤其是网络状况一般的时候但千万别跳过否则后面装包时容易遇到依赖版本不匹配的问题。提示pkg update只更新索引pkg upgrade才真正升级已安装的包。两个命令连在一起写是pkg update pkg upgrade我在手机上已经养成肌肉记忆了。1.2 用 termux-setup-storage 打通手机文件访问Termux 默认活在安卓应用的私有目录里它不能直接读你手机里的照片、下载文件。如果想用 Termux 去整理下载目录、备份配置、读写 SD 卡必须手动授权存储权限。在终端里输入termux-setup-storage系统会弹出文件访问权限的申请点击“允许”。执行完之后你会发现$HOME下多了一个storage目录里面有几个快捷链接~/storage/shared 对应手机内部存储根目录 ~/storage/downloads 对应 Download 下载目录 ~/storage/dcim 对应相机相册目录 ~/storage/pictures 对应 Pictures 图片目录这里有个非常常见的误区直接把路径写成/sdcard/或者/storage/emulated/0/也能访问但 Termux 官方推荐的访问方式是走~/storage这套链接。举个例子我写脚本批量整理下载目录时会用$HOME/storage/downloads这样在不同安卓版本上路径都不会变。当初我图省事写死成/sdcard/Download后来换手机目录结构一变脚本就废了。另外提醒一句安卓 11 以上的分区存储机制比较严如果termux-setup-storage执行后没有弹出授权窗口去系统设置里找到 Termux手动打开“所有文件访问权限”相关选项再试一次。1.3 换一个下载更快的软件源用 termux-change-repoTermux 默认的软件源地址在海外直接用速度通常不理想执行pkg update时能明显感觉到卡顿。解决办法是用自带的源管理工具切换到一个更快的社区镜像源。运行termux-change-repo它会出现一个图形化选择界面用音量键上下移动、点按屏幕确认勾选Termux官方源以外的镜像站。具体选哪一个我的原则是新用户挑版本兼容性口碑好的社区镜像老用户按自己当前地理位置选距离近的。选完之后按Enter确认然后重新执行pkg update。换源这一步非常值得做。有一次我在默认源下执行pkg upgrade光下载依赖就花了快四十分钟中间还断了一次切到社区镜像之后同样的操作两三分钟就完成了。不过要注意换完源后如果提示 GPG 签名问题多半是源版本和 Termux 版本不匹配回到termux-change-repo重新选一个主流镜像即可。1.4 把键盘和快捷键调顺手不然后面全是血泪手机上没有物理键盘Termux 默认在最顶部有一排“扩展键”包含ESC、TAB、CTRL、ALT等方便触摸操作。这排键默认可能没显示可以长按终端界面在弹出的菜单里找 “More”然后选择 “Toggle Extra Keys” 打开。最容易被忽略的是音量键的用途音量减小键按住相当于CTRL键音量增大键单按相当于ESC键比如要中断一个正在跑的命令直接“音量减小 C”就行在 vim 里想退出编辑模式按“音量增大”就能触发ESC。我刚开始不知道这个设置每次想按CtrlC都得去点屏幕顶部的扩展键非常别扭。调顺这两个按键之后操作效率提升了一个量级。如果你觉得键盘高度占了太多屏幕可以在 Termux 设置里调整键盘高度或者开启全屏模式。每个手机屏幕大小不一样这些参数没有标准答案按自己手感调就行。1.5 目录规划是决定你半年后是否弃坑的关键Termux 给了你一个完整的 Linux 用户空间但也意味着你要自己管理文件。很多新用户装一堆工具之后$HOME底下乱成一锅粥想找之前写的一个脚本只能靠ls一页页翻体验非常劝退。我现在的目录结构大致是这样~/projects/ 写代码用的项目目录 ~/scripts/ 平时用的小脚本 ~/logs/ 程序运行日志 ~/backups/ 备份文件暂存地不要小看这个习惯。手机上敲命令本来就不如电脑方便要是连自己东西放哪都不知道用不了几天就会放弃。设置方式也很简单mkdir -p ~/projects ~/scripts ~/logs ~/backups有了清晰目录后面写自动备份脚本、定时整理脚本时所有输出都有地方去。2. 基础环境搭建把 Termux 当成一台正经开发机2.1 Python 环境pkg install python 之后再补两刀Python 是 Termux 里最常用的解释器之一安装命令非常简单pkg install python装完先确认版本python --versionTermux 里python和pip会同时装好但旧版本 Termux 里 pip 可能指向pip2如果你发现执行pip --version报错就直接用python -m pip代替。我后面所有 pip 操作都会优先写python -m pip避免因为环境变量问题翻车。第一刀升级 pip 本身python -m pip install --upgrade pip第二刀创建虚拟环境。Termux 和电脑一样千万别把第三方库直接往全局环境里塞。特别是手机上存储空间有限一旦包冲突最直接的后果就是 pip 安装失败然后你只能删环境重来。建议每个项目都建一个独立环境cd ~/projects python -m venv my_env source my_env/bin/activate激活虚拟环境之后命令行前面会多出(my_env)前缀这时候你装的所有包都只属于这个项目想清理就整目录删掉不影响全局。在 Termux 里跑 Python 时因为 CPU 架构不同有些带原生扩展的包下载的是 wheel 预编译包速度一般还可以个别包需要编译时会比较慢这是正常现象。2.2 Git 环境从配置到连接托管平台一次说清Git 在手机上的用法和电脑完全一样先安装pkg install git安装完成后第一件事是配置身份信息否则提交代码时会有大段报错提示git config --global user.name 你的名字 git config --global user.email 你的邮箱接下来是生成 SSH 密钥方便你免密拉取和推送代码到托管平台ssh-keygen -t ed25519 -C 你的邮箱一路按回车即可生成的密钥默认在~/.ssh/下。id_ed25519.pub是公钥文件里面的内容要复制粘贴到你常用的代码托管平台设置里id_ed25519是私钥绝对不要泄漏出去。手机丢了怎么办这就是为什么我不建议在密钥上设置复杂密码万一手机重启需要输入密码解锁私钥在手机上敲长密码会想死。真担心安全就勤快点定期更换公钥。配置好之后克隆仓库的姿势git clone gitgit服务器地址:用户名/仓库名.git日常提交git add . git commit -m 更新说明 git push在手机上用 Git 最需要注意的是别手滑执行git add -f、git reset --hard这类破坏性命令尤其是reset --hard它会把未提交的修改全部丢弃这在电脑上还能靠编辑器找回在手机终端里基本就是永久丢失。2.3 编辑器nano 起步vim 留到以后在手机上写代码、改配置选什么编辑器非常影响心情。我的建议是新手先用nanopkg install nanonano的优势是界面底部直接列出快捷键比如^O保存、^X退出几乎不需要记忆成本。在 Termux 里^就是按住音量减小键再按对应字母。改完配置文件之后按“音量增大”返回按X再按Y确认保存一气呵成。等你在 nano 里写过几个脚本之后可以尝试vimpkg install vimvim 在 Termux 里的核心价值不只是编辑而是你未来通过 SSH 远程登录到其他 Linux 机器时几乎所有环境都预装了 vim 或者 vi。提前在手机上练熟这些操作以后走到哪都不慌。但我真不建议第一天就硬啃 vim手机上没有物理键盘模式切换带来的挫败感会直接浇灭你学习的热情。2.4 下载工具与文件解压互传需要下载文件时wget和curl是最基础的工具pkg install wget curl unzip经常有人问 curl 和 wget 到底有啥区别我用下来的主观感受是curl更擅长调试接口比如带请求头、带参数访问网页 APIwget更擅长下载文件支持断点续传。日常下载压缩包我习惯用wget。拖回来的压缩包怎么解压也是新手高频问题tar -xzf 文件.tar.gz unzip 文件.zip tar -xJf 文件.tar.xz顺手整理一个速查表文件名后缀解压命令.tar.gztar -xzf 文件名.tar.xztar -xJf 文件名.tartar -xf 文件名.zipunzip 文件名手机和电脑之间传文件除了用微信/邮箱更 geek 的方式是用scp。安装了openssh之后下一节会细讲从电脑往手机推文件scp -P 8022 本地文件路径 手机用户名手机IP:~/projects/反向传也是一样把源路径和目标路径对调就行。这样传文件的好处是不用依赖任何第三方聊天软件而且走的是局域网速度非常快。3. 进阶玩法让 Termux 真正帮你干活的几个场景3.1 批量整理手机下载目录的 Python 脚本手机上最容易变得一团糟的目录就是Download各种图片、压缩包、PDF、安装包混在一起。我之前就写过一个脚本按扩展名自动分类归档。核心代码如下from pathlib import Path import shutil download Path.home() / storage / downloads ext_dirs { 图片: [.jpg, .jpeg, .png, .gif, .webp], 压缩包: [.zip, .rar, .7z, .tar.gz], 文档: [.pdf, .docx, .xlsx, .txt], 安装包: [.apk], } for target, exts in ext_dirs.items(): (download / target).mkdir(exist_okTrue) for f in download.iterdir(): if f.is_file() and f.suffix.lower() in exts: shutil.move(str(f), str(download / target / f.name)) print(整理完成)把这段代码存成~/scripts/tidy_download.py每次想清理手机时执行python ~/scripts/tidy_download.py原理不复杂就是遍历目录里每个文件根据后缀找到对应的目标分类目录然后用shutil.move移动文件。这里用Path.home() / storage / downloads而不是写死/sdcard/Download就是前面说的兼容性问题——在 Termux 里永远走符号链接路径才稳定。做这个脚本的过程中我学到的最重要一课是不要在下载目录里直接shutil.move未知文件。脚本第一版我把文件名带空格的文件全部弄成了乱码后来强制加了一层判断只有扩展名匹配的文件才会被移动其他的一概不动。宁可脚本多跑几遍也不能把文件搞丢。3.2 用 SSH 从电脑连进手机敲命令手机屏幕再大也不如电脑键盘舒服。装好 Termux 之后完全可以用电脑连接手机里的 Linux 环境在电脑上敲命令只调用手机资源。安装并启动 SSH 服务pkg install openssh passwd # 设置连接密码 sshd # 启动服务查看手机的 IP 地址pkg install net-tools ifconfig找到wlan0那一行的 IP然后在电脑终端里输入ssh -p 8022 手机用户名手机IP这里的端口是 8022不是常见的 22这是 Termux 特意避开系统保留端口的设计。手机用户名用whoami查看通常是一个很短的名字。成功登录之后你就拥有了一个会呼吸的远程 Linux 环境。我在实际使用中最大的感受是出门在外手机是主力回到家坐在电脑前随时能 SSH 进去继续跑手机上的任务两个设备之间的割裂感少了很多。几个安全方面的经验不要用太简单的密码手机上跑 SSH 服务虽然暴露在局域网内但弱密码依然等于裸奔。不需要远程时执行pkill sshd关掉服务这样更稳妥。只在可信局域网下开启 SSH不要随意把它暴露到公网。3.3 用 tmux 看住你的长任务在手机终端里跑一个耗时的脚本最怕什么最怕切后台一会儿再回来进程被系统回收了。安卓对后台进程的清理机制非常激进即使你把 Termux 锁定在后台偶尔还是会失效。解决方案是tmux。pkg install tmuxtmux 是一个终端复用器可以理解成给终端开了多个“存档位”。启动一个会话tmux new -s 下载任务在会话里正常跑你的命令或脚本。中途想离开按Ctrlb然后按d这个操作叫 detach会话会继续保持运行。回到终端后重新连接tmux attach -t 下载任务查看所有会话tmux ls用 tmux 跑长时间任务的体验非常爽。有一回我在手机上下载并编译一个稍大的开源工具预计要二三十分钟电脑端 SSH 连接又不能一直挂着就直接开个 tmux 会话detach 之后该干嘛干嘛过一会儿再重新 attach任务依然在推进。这个工具适合所有想把手机当作小型开发机的人。3.4 备份关键配置别让大更新把你打回原形Termux 更新频率不低有时候一次大版本升级之后配置文件路径变了或者某些包被自动清理辛辛苦苦配置的环境一瞬间回到解放前。所以要养成备份习惯。我备份的范畴是~/.bashrc、~/.profile、~/.ssh、~/.config等会影响环境的关键文件。备份脚本大概长这样#!/data/data/com.termux/files/usr/bin/bash BACKUP_DIR$HOME/storage/shared/termux-backups mkdir -p $BACKUP_DIR tar czf $BACKUP_DIR/termux-config-$(date %Y%m%d).tar.gz \ $HOME/.bashrc \ $HOME/.profile \ $HOME/.ssh \ $HOME/.config \ $HOME/scripts echo 备份完成$BACKUP_DIR把这段保存为~/scripts/backup_termux.sh然后执行chmod x ~/scripts/backup_termux.sh ~/scripts/backup_termux.sh备份文件会生成在手机内部存储的termux-backups目录下即使哪天把 Termux 卸载了这些配置也还在手机上。恢复也简单把 tar 包解压回$HOME即可。这里提醒一句.ssh目录含私钥备份后最好留在手机本地不要随便传到公共网盘。4. 半年实操攒下的避坑清单这些坑我替你踩过了4.1 键盘乱套敲不出特殊符号怎么办Termux 默认的扩展键包含ESC、TAB、CTRL、ALT、-、/等但有些符号比如竖线|、波浪线~、花括号{}在触摸键盘上需要切换到符号页才能找到。如果扩展键没显示长按终端界面在弹出菜单里进入 More勾选 Toggle Extra Keys 即可。如果发现安装了中文输入法后终端里打不出英文字母最常见原因是输入法处于全角中文模式。切换输入法语言到英文或者直接在 Termux 设置里禁用中文输入法的自动纠错。另外Termux 的存储权限和输入法权限不要混在一起前者是文件访问后者纯粹是键盘输入别在设置里翻错项。4.2 访问手机存储时报权限错误明明执行了termux-setup-storage但读取~/storage/downloads里的文件还是提示Permission denied这种情况通常发生在安卓版本升级之后。旧权限被系统回收需要重新执行一次termux-setup-storage。如果重试也没用去系统设置里查看 Termux 的应用权限确认“存储”权限是允许状态。部分手机系统还有“所有文件访问”的额外开关不打开的话 Termux 只能看到自己私有目录。路径检查的顺序是先看权限再看路径写没写错最后看文件是否真的存在。4.3 终端切后台再回来就卡死/进程没了这是 Termux 在安卓上最普遍的问题。由于系统的内存回收策略Termux 长时间在后台运行或者手机息屏后进程很容易被清理。解决办法有两个。轻量方案是打开系统电池优化白名单把 Termux 设为“不受限制”。进入方式每个系统略有不同一般在“设置 - 应用 - 特殊访问权限 - 电池优化”里找到 Termux设为不优化。另一个方案是使用 Termux 自带的 wake lock 工具termux-wake-lock这个命令会请求保持设备唤醒适合在跑长任务或下载时使用。任务结束后记得解除termux-wake-unlock但即使这样也不能百分百保证进程存活。所以长时间任务建议配合 tmux 使用至少任务能挂在会话里设备重启后虽然会话没了但至少你在断线前能看到任务执行到哪一步。4.4 更新或安装时报 dpkg 锁和依赖错误执行pkg install时提示Could not get lock原因是另一个包管理进程还在运行。Termux 允许开多个终端窗口如果你在窗口 A 里执行了安装窗口 B 再执行就会撞锁。解决办法是等窗口 A 完成后在窗口 B 重新执行命令。如果之前有过中断的安装进程使用pkg clean清理一下缓存和锁文件。依赖错误一般出在pkg upgrade升级到一半时手动中断这种情况优先再跑一次pkg upgrade让系统把未完成的依赖补完。不要绕过pkg直接使用apt除非你完全清楚自己在做什么pkg封装了很多 Termux 特有的兼容处理。4.5 解压中文文件名乱码从网上拖下来的压缩包尤其是 Windows 环境创建的 zip经常出现中文文件名乱码。这本质上是编码问题Windows 默认用 GBK 编码文件名而 Linux 下默认 UTF-8。用unzip直接解压中文名就会变成一串乱码。处理方式我一般用 Python 代替 unzip写法可以参考import zipfile from pathlib import Path src Path(乱码.zip) dst Path(解压输出) with zipfile.ZipFile(src) as zf: for info in zf.infolist(): raw info.filename.encode(cp437) name raw.decode(gbk, errorsreplace) target dst / name if info.is_dir(): target.mkdir(parentsTrue, exist_okTrue) else: target.parent.mkdir(parentsTrue, exist_okTrue) target.write_bytes(zf.read(info.filename))这段代码的思路是先把 zip 内部的文件名按原始编码转回字节再用 GBK 解码成正确的中文最后逐个写出文件。遇到个别解压失败的文件errorsreplace会把特殊字符替换成占位符至少保证整个目录能完整解出来。4.6 Termux 越用越大空间怎么回收Termux 本身不大但 pip 缓存、pkg 缓存、日志文件会越积越多。查看当前占用du -sh ~清理 pkg 缓存pkg clean清理 pip 缓存python -m pip cache purge清理旧的备份文件也可以考虑保持~/backups里只留最近一两份。手机上存储本来就金贵养成定期清理的习惯比什么都重要。我个人在实际操作中的体会是Termux 最迷人的地方不是它能装多少工具而是它给了你一个随手可用的 Linux 环境。上面这些操作都不是一次性能搞定的事需要你在用的时候慢慢遇到、慢慢解决。最后再分享一个小技巧不要把 Termux 当成玩具装完就扔试着每天用它在手机里做一件小事跑一个小脚本、整理几个文件、查一段日志一个月后你会发现它真的长成了你生活里顺手的存在。