Termux - Android终端应用与Linux环境

本文翻译整理自：https://github.com/termux/termux-app

---

---

一、关于 Termux

Termux 是一款Android终端模拟应用，同时提供完整的Linux环境支持。

请注意：
1、本仓库仅包含应用本体（用户界面与终端模拟功能）
2、需在应用内安装的软件包请参见 termux/termux-packages
3、快速了解Termux包管理可查阅 Package Management，该文档也包含解决执行apt或pkg命令时出现**repository is under maintenance or down**错误的方法

我们正在招募Termux安卓应用维护者

---

重要通知：Android 12+上的稳定性问题

Android系统会强制终止超过32个的进程（该限制为所有应用共享），并终止CPU占用过高的进程。您可能会在终端中看到[Process completed (signal 9) - press Enter]消息，而实际上并未主动退出shell进程。相关细节请查阅：

• 问题追踪 #2366
• Google Issue Tracker
• 幻影缓存进程文档
• 解决方案注释

完整文档页将后续添加。Android 12L或13预计会提供禁用进程终止的选项，因此Android 11用户需谨慎升级（特别是未root设备）。

---

相关链接资源

• github : https://github.com/termux/termux-app
• 官网：https://termux.com
• 官方文档：https://wiki.termux.com/wiki/Main_Page
• Community : https://wiki.termux.com/wiki/Community
• Blog : https://termux.dev/blog
• FAQ : https://wiki.termux.com/wiki/FAQ
• Discord | Twitter
• License : GPLv3

---

关键功能特性

• 完整Linux终端环境
• 无需root权限
• 支持APT包管理
• 可扩展插件体系
• 自定义终端样式
• 任务自动化支持

---

二、安装

当前最新版本为 v0.118.2

重要提示：
强烈建议尽快升级至v0.118.0或更高版本，该版本修复了多个关键漏洞（包括此处披露的世界可读漏洞）。关于Google Play版本的特殊说明请参见下文。

---

系统要求

• Android ≥7（完整支持）
• Android 5/6（有限支持，详见兼容性说明）

---

安装源选择

所有Termux插件应用必须使用相同签名源的APK，混合安装会导致兼容性问题。切换安装源前需完全卸载现有应用。

---

1、F-Droid

• 下载地址：https://f-droid.org/en/packages/com.termux/
• 特点：
  • 更新延迟约1周
  • 仅提供通用APK（约180MB）
  • 无需安装F-Droid客户端即可下载APK

---

2、GitHub

• 正式版：Releases页面（≥0.118.0）
• 开发版：Build Action
• 注意：
  • Android ≥7选择apt-android-7版本
  • Android 5/6选择apt-android-5版本
  • 提供架构专用APK（约120MB）

安全警告：
GitHub版本使用测试密钥签名，请勿通过非官方渠道获取构建版本。

---

3、Google Play（实验分支）

• 仅限Android 11+设备
• 存在功能缺失和BUG
• 独立代码库：https://github.com/termux-play-store/
• 问题反馈需提交至专属仓库

---

三、卸载

完整卸载步骤：
1、进入系统设置→应用管理
2、搜索并卸载所有Termux及插件应用（包括）：

• Termux:API
• Termux:Boot
• Termux:Float
• Termux:Styling
• Termux:Tasker
• Termux:Widget

建议操作：
卸载前执行数据备份

---

四、重要资源链接

---

社区支持

• Reddit社区
• Matrix用户频道
• 开发者频道
• 技术支持邮箱：support@termux.dev

---

文档中心

• 主Wiki
• 应用Wiki
• 软件包Wiki

---

实用指南

• 文件系统布局
• 与Linux的差异
• 远程访问方案
• 终端设置手册
• Android存储管理

---

五、调试指南

调试步骤：
1、进入Termux设置→调试→日志级别
2、选择日志级别：

• 关闭：无日志
• 常规：错误/警告/信息级日志
• 调试：增加调试信息
• 详细：完整日志记录

3、通过以下方式获取日志：

• 实时查看：执行logcat命令
• 导出日志：logcat -d > logcat.txt
• ADB抓取：参考官方指南

快速生成报告：
长按终端→更多→报告问题→确认包含调试信息

---

六、贡献者指南

---

开发规范

1、代码共享库：termux-shared

• 定义公共常量与工具类
• 禁止硬编码路径
• 新增代码需遵循LICENSE

2、版本命名遵循语义化版本2.0

• 格式：主版本.次版本.修订号(-预发布)(+构建元数据)
• 示例：v0.118.0

---

提交信息规范

必须使用约定式提交格式：

<类型>[可选范围]: <描述>[可选正文][可选脚注]

---

允许的类型（严格匹配）：

• Added：新功能
• Changed：功能变更
• Deprecated：弃用功能
• Removed：移除功能
• Fixed：BUG修复
• Security：安全更新

示例：
Added(terminal): Add new keybinding feature
Fixed!: Resolve critical crash issue

---

七、分支维护

---

分叉注意事项

1、修改包名需同步调整：

• 参照TermuxConstants文档
• 重新编译bootstrap压缩包

2、插件适配：

• 部分插件仍硬编码com.termux值
• 需手动修改兼容新包名

3、库引用：
参考分支开发指南

---

伊织 xAI 2025-04-23（三）