← 首页← 文章列表

Termux 环境配置教程（从入门到进阶）

2026-05-31·📖 13 分钟·TermuxAndroid教程

Termux 环境配置教程（从入门到进阶）

适用于 Termux 新手和想深入优化的用户 全程在手机上操作，不用电脑，不用 ADB 所有命令逐条在 Termux 里输入

📎 进阶阅读：Termux 安装 AI 编程助手教程 🤖 浏览器自动化：让 AI 控制浏览器

目录

  1. 基础配置篇

  2. 进阶配置篇

  3. 一键配置脚本

基础配置篇

1.1 下载和安装 Termux

本站直接下载（国内直连）：

选择合适的 APK 版本：

手机架构下载哪个
绝大多数手机arm64-v8a
旧手机（2015 年前）GitHub Releases 中选 armeabi-v7a
模拟器GitHub Releases 中选 x86_64

安装 APK 后不要急着打开，先看下一节。

1.2 初次打开 Termux

第一次打开 Termux 时，它会自动执行初始设置：

  1. 解压系统文件（约 1-2 分钟）
  2. 生成 ~/.bashrc 等配置文件
  3. 显示命令提示符 $

看到 $ 光标闪烁，说明初始化完成。

这时可以输入命令了。先试一个：

bash
echo Hello Termux!
bash
pkg list-all

如果你的 Termux 是中文界面但提示乱码，不用急，后面有方法设置中文环境。

1.3 更换软件源（国内用户推荐）

Termux 默认使用国外源，国内下载很慢。建议换成国内镜像源。

bash
termux-change-repo

屏幕会显示源列表：

  1. 用方向键上下移动光标
  2. 按空格键选中 Mirrors in Chinese Mainland（中国大陆镜像）
  3. 按回车键确认

或者你想手动选单个源：

1. 选 Single Mirror
2. 选 mirror.sjtu.edu.cn（上海交大，速度最快之一）
   或 mirrors.ustc.edu.cn（中科大）
   或 mirrors.tuna.tsinghua.edu.cn（清华）

选好后会自动测试源并切换到最快的那个。

如果你不在中国，选离你最近的镜像源即可。

1.4 更新所有包

换完源后，更新所有已安装的包：

bash
pkg update -y
bash
pkg upgrade -y

pkg update 是更新包列表，pkg upgrade 是真正升级。

如果升级过程中弹出文件冲突提示（显示 Y/I/N/O/D/Z），直接按 Y 回车。

升级完成后，Termux 的基础环境就是最新版了。

1.5 授予存储权限

Termux 默认只能访问自己的数据目录，不能读取你手机上的文件（照片、下载等）。

bash
termux-setup-storage

手机会弹出权限请求，点击允许。

之后 Termux 的 ~/storage 目录下会出现：

路径对应手机目录
~/storage/shared内部存储根目录
~/storage/downloads下载文件夹
~/storage/dcim相机照片
~/storage/music音乐
~/storage/pictures图片
~/storage/external-1SD 卡（如果有）

测试一下：

bash
ls ~/storage/downloads

能看到你手机下载文件夹里的文件，说明权限正常。

1.6 安装基础工具包

以下是一些常用的工具包，建议都装上：

bash
pkg install -y curl wget git nano vim openssh
包名作用
curl发送网络请求、下载文件
wget下载文件（比 curl 简单）
git版本控制、克隆仓库
nano简单易用的文本编辑器
vim强大的文本编辑器（入门难度大）
opensshSSH 远程连接

还有这些建议装：

bash
pkg install -y zip unzip tree which man
包名作用
zip / unzip压缩和解压 ZIP 文件
tree以树形结构显示目录
which查看命令的安装路径
man查看命令的帮助文档

1.7 配置 Termux 外观

修改字体大小

在 Termux 屏幕上从左边向右滑动，打开侧边栏。

进入 Settings（设置）→ Terminal（终端）→ Font size（字体大小），调整到合适的字号。

修改配色方案

侧边栏 → Settings → Terminal → Color scheme，选择你喜欢的主题。

内置主题：Dark、Light、Solarized Dark、Solarized Light、Gruvbox、Ocean 等。

开启光标闪烁

侧边栏 → Settings → Terminal → Cursor blink → 打开。

开启触摸键盘的额外按键

Termux 默认在键盘上方有一行数字键。如果你需要更多按键（如 ESC、TAB、CTRL）：

侧边栏 → Settings → Extra keys → 选择适合你的布局。

你还可以在 ~/.termux/termux.properties 中自定义按键布局，后面进阶部分会介绍。

修改完属性后要刷新才能生效：

bash
termux-reload-settings

1.8 基础配置总结

完成以上步骤后，你的 Termux 已经是一个可用的 Linux 环境了。

你目前已经学会：

技能命令
安装软件包pkg install -y 包名
搜索软件包pkg search 关键词
列出已安装pkg list-installed
删除软件包pkg uninstall 包名
查看包信息pkg show 包名
更新所有包pkg upgrade -y

---# 进阶配置篇

2.1 SSH 远程连接

2.1.1 设置密码

bash
passwd

输入两遍你要设置的密码（输入时屏幕不显示，正常现象）。

2.1.2 启动 SSH 服务

bash
sshd

默认端口是 8022（不是 22，因为手机上 22 端口被系统占用）。

2.1.3 查看手机 IP 和用户名

bash
whoami
bash
ip -4 addr show wlan0

或者在 Termux 里输入：

bash
ifconfig wlan0

找到 inet 后面的 IP 地址，类似 192.168.x.x。

2.1.4 从电脑连接

电脑终端（Mac/Linux）或 PowerShell（Windows）：

bash
ssh 用户名@192.168.x.x -p 8022

输入你刚才设置的密码即可。

2.1.5 设置 SSH 密钥登录（免密码）

在手机 Termux 上生成密钥（如果还没有）：

bash
ssh-keygen -t ed25519

一路回车即可。

把公钥添加到授权列表：

bash
cat ~/.ssh/id_ed25519.pub >> ~/.ssh/authorized_keys
bash
chmod 600 ~/.ssh/authorized_keys

然后把私钥 id_ed25519 传到电脑上，之后连接就不需要输入密码了。

2.1.6 SSH 开机自启

bash
echo "sshd" >> ~/.bashrc

这样每次打开 Termux 都会自动启动 SSH。

⚠️ 注意：~/.bashrc 只在交互式 shell 中执行。如果是通过 Termux:Boot 启动，需要用不同的方式（见 2.2 节）。

2.2 开机自启（Termux:Boot）

想让 Termux 在手机开机后自动运行某些命令（比如自动启动 SSH、启动某个服务），需要安装 Termux:Boot。

  1. 去 F-Droid 下载 Termux:Boot：https://f-droid.org/packages/com.termux.boot/

  2. 安装后，创建启动脚本：

bash
mkdir -p ~/.termux/boot
bash
cat > ~/.termux/boot/startup.sh << 'EOF'
#!/data/data/com.termux/files/usr/bin/sh
# 开机自启脚本

# 启动 SSH
sshd

# 防止手机休眠
termux-wake-lock

# 如果有其他服务，在这里添加
EOF
bash
chmod 700 ~/.termux/boot/startup.sh
  1. 重启手机测试。重启后 Termux:Boot 会自动运行 ~/.termux/boot/startup.sh。

2.3 防止手机休眠

如果长时间运行任务，手机锁屏后可能会休眠，导致 Termux 进程被暂停。

获取 Wake Lock（防止休眠）

bash
termux-wake-lock

释放 Wake Lock（允许休眠）

bash
termux-wake-unlock

查看当前是否有 Wake Lock

bash
termux-wake-lock-check

每次打开 Termux 都自动获取 Wake Lock：

bash
echo "termux-wake-lock" >> ~/.bashrc

保持屏幕常亮（在 Termux 内）

bash
termux-keep-screen-on true
bash
# 关闭
termux-keep-screen-on false

2.4 终端复用器 tmux

tmux 可以让你在同一个 Termux 窗口中开多个终端面板，互不干扰。跑长时间任务时尤其有用。

安装

bash
pkg install -y tmux

基本用法

bash
# 启动 tmux
tmux

进入 tmux 后，屏幕底部会出现一个绿色的状态条。

常用快捷键（先按 Ctrl+b，松开，再按第二个键）：

快捷键作用
Ctrl+b c创建新窗口
Ctrl+b n切换到下一个窗口
Ctrl+b p切换到上一个窗口
Ctrl+b 0-9切换到指定编号的窗口
Ctrl+b %垂直分割面板
Ctrl+b "水平分割面板
Ctrl+b 方向键切换到相邻面板
Ctrl+b d断开 tmux（任务在后台继续运行）
Ctrl+b [进入滚动模式（翻看历史输出），按 q 退出
Ctrl+b x关闭当前面板

断开后重新连接：

bash
tmux attach

查看所有 tmux 会话：

bash
tmux ls

在后台运行任务最常用的模式：

bash
tmux
# 在 tmux 里启动你的任务
# 按 Ctrl+b d 断开
# 任务在后台继续跑
# 想查看时：tmux attach

2.5 备份和恢复 Termux

备份

bash
# 进入 home 目录
cd ~

# 打包整个 Termux 环境（不包括 tmp 和缓存）
tar -czf ~/storage/downloads/termux-backup-$(date +%Y%m%d).tar.gz \
  --exclude=~/storage \
  --exclude=~/termux-browser-pilot \
  --exclude=~/.cache \
  --exclude=~/tmp \
  ~/../

备份文件会保存到手机的 下载 文件夹。

恢复

先把备份文件放到手机上，然后：

bash
# 确保 storage 已授权
termux-setup-storage

# 解压恢复（假设备份文件在下载目录）
tar -xzf ~/storage/downloads/termux-backup-20260526.tar.gz -C /data/data/com.termux/files/

# 重启 Termux

⚠️ 恢复前建议先备份现有环境。恢复后如果程序运行异常，重启一下 Termux 或手机。

使用 Termux 自带备份命令

bash
# 备份到 ~/storage/shared
termux-backup ~/storage/shared/termux-backup.tar.gz
bash
# 恢复
termux-restore ~/storage/shared/termux-backup.tar.gz

2.6 安装更多开发语言

bash
# Node.js（运行 JavaScript）
pkg install -y nodejs-lts

# Python3
pkg install -y python3

# Go 语言
pkg install -y golang

# Rust
pkg install -y rust

...

没必要全部装，按需选择。

2.7 配置 Node.js 和 npm

安装

bash
pkg install -y nodejs-lts

查看版本：

bash
node --version
npm --version

配置 npm 全局安装路径

npm 默认全局安装到 $PREFIX/lib/node_modules，一般不需要改。

但如果遇到权限问题：

bash
mkdir -p ~/.npm-global
bash
npm config set prefix ~/.npm-global

然后确保 ~/.npm-global/bin 在 PATH 中：

bash
echo 'export PATH=$PATH:$HOME/.npm-global/bin' >> ~/.bashrc
bash
source ~/.bashrc

常用 npm 操作

bash
# 安装全局包
npm install -g 包名

# 安装本地包
npm install 包名

# 查看已安装的全局包
npm list -g --depth=0

# 更新 npm 自身
npm update -g npm

2.8 配置 Python pip

换国内源（可选）

bash
cat > ~/.pip/pip.conf << 'EOF'
[global]
index-url = https://mirrors.aliyun.com/pypi/simple/
trusted-host = mirrors.aliyun.com
EOF

其他镜像源：

源URL
阿里云https://mirrors.aliyun.com/pypi/simple/
清华https://pypi.tuna.tsinghua.edu.cn/simple
中科大https://pypi.mirrors.ustc.edu.cn/simple

常用 pip 操作

bash
# 安装包
pip install 包名

# 安装包（忽略系统保护）
pip install --break-system-packages 包名

# 查看已安装
pip list

# 查看包信息
pip show 包名

...

2.9 oh-my-zsh 美化终端

Termux 默认用 bash，可以换成 zsh + oh-my-zsh，让终端更好看、更好用。

安装 zsh

bash
pkg install -y zsh

安装 oh-my-zsh

bash
sh -c "$(curl -fsSL https://raw.githubusercontent.com/ohmyzsh/ohmyzsh/master/tools/install.sh)"

安装过程中会问是否切换默认 shell 到 zsh，输入 y 回车。

安装主题和插件

bash
# 语法高亮插件
git clone https://github.com/zsh-users/zsh-syntax-highlighting.git ~/.oh-my-zsh/custom/plugins/zsh-syntax-highlighting
bash
# 自动补全插件
git clone https://github.com/zsh-users/zsh-autosuggestions.git ~/.oh-my-zsh/custom/plugins/zsh-autosuggestions

修改配置

bash
nano ~/.zshrc

找到 ZSH_THEME="robbyrussell"，改成：

ZSH_THEME="agnoster"

其他推荐主题：ys、gentoo、dpoggi。

找到 plugins=(git)，改成：

plugins=(git zsh-syntax-highlighting zsh-autosuggestions)

保存（nano 里按 Ctrl+X → y → 回车）。

生效

bash
source ~/.zshrc

或者关掉 Termux 重新打开。

2.10 FTP/HTTP 文件服务器

通过 HTTP 分享文件

bash
pkg install -y python3
bash
cd ~/storage/shared
bash
python3 -m http.server 8080

然后同一 Wi-Fi 下的电脑浏览器访问 http://你的手机IP:8080。

通过 FTP 分享文件

bash
pkg install -y vsftpd

配置：

bash
cat > $PREFIX/etc/vsftpd.conf << 'EOF'
anonymous_enable=YES
local_enable=YES
write_enable=YES
anon_upload_enable=YES
anon_mkdir_write_enable=YES
anon_root=/data/data/com.termux/files/home/storage/shared
listen_port=2121
EOF
bash
vsftpd $PREFIX/etc/vsftpd.conf

FTP 客户端连接 ftp://手机IP:2121，匿名登录。

2.11 定时任务（cron）

安装

bash
pkg install -y termux-services
bash
pkg install -y cronie

启动 cron 服务

bash
crond

编辑定时任务

bash
crontab -e

按 i 进入编辑模式，添加任务。示例：

# 每天凌晨 2 点清理临时文件
0 2 * * * rm -rf ~/tmp/*

# 每 30 分钟检查一次 SSH 是否在运行
*/30 * * * * pgrep sshd || sshd

# 每天早上 8 点执行备份
0 8 * * * tar -czf ~/storage/downloads/backup-$(date +\%Y\%m\%d).tar.gz ~/

按 ESC → :wq 回车保存。

查看已有任务

bash
crontab -l

2.12 环境变量配置

Termux 的 ~/.bashrc（或 ~/.zshrc）文件在每次打开 Termux 时自动执行，适合配置环境变量。

打开配置文件

bash
nano ~/.bashrc

常用配置示例

bash
# 自定义 PATH
export PATH=$PATH:$HOME/.local/bin:$HOME/bin

# 设置默认编辑器
export EDITOR=nano

# 设置语言
export LANG=en_US.UTF-8

# Git 配置
export GIT_EDITOR=nano

...

让配置生效

bash
source ~/.bashrc

或者直接关掉 Termux 重新打开。

2.13 性能优化

2.13.1 清理缓存

bash
pkg clean
bash
apt-get autoremove -y
bash
rm -rf ~/.cache/pip ~/tmp/*

2.13.2 限制日志大小

bash
echo 'export HISTSIZE=1000' >> ~/.bashrc
bash
echo 'export HISTFILESIZE=2000' >> ~/.bashrc

2.13.3 使用软链接优化存储空间

如果手机存储空间不足，可以把大目录移到 SD 卡或共享存储：

bash
# 把 pip 缓存移到共享存储
mkdir -p ~/storage/shared/.termux-cache/pip
ln -sf ~/storage/shared/.termux-cache/pip ~/.cache/pip

2.13.4 加快 pkg 命令

bash
pkg install -y gnupg
bash
pkg update -y

定期更新确保软件包列表和签名是最新的，能加快后续安装速度。

2.13.5 检查磁盘使用量

bash
du -sh ~/*
bash
df -h

---## 3. 一键配置脚本

复制下面全部内容，在 Termux 里长按粘贴，按回车执行。

基础配置一键脚本

bash
set -e
echo "=== Termux 基础一键配置 ==="

# 切换为国内源（注释掉如果你不在中国）
echo "请手动执行 termux-change-repo 切换镜像源"
echo "或跳过此步"

# 更新
pkg update -y && pkg upgrade -y

# 存储权限
termux-setup-storage
...

进阶配置一键脚本

bash
set -e
echo "=== Termux 进阶配置 ==="

# 安装额外工具
pkg install -y tmux zsh cronie

# 安装 oh-my-zsh
sh -c "$(curl -fsSL https://raw.githubusercontent.com/ohmyzsh/ohmyzsh/master/tools/install.sh)" "" --unattended

# 安装 zsh 插件
git clone https://github.com/zsh-users/zsh-syntax-highlighting.git ~/.oh-my-zsh/custom/plugins/zsh-syntax-highlighting 2>/dev/null
git clone https://github.com/zsh-users/zsh-autosuggestions.git ~/.oh-my-zsh/custom/plugins/zsh-autosuggestions 2>/dev/null
...

如果遇到本教程没覆盖的问题，欢迎在评论区留言。