热门搜索:
termux/package-builder
termux
用于构建Termux软件包的Docker镜像
20 次收藏下载次数: 0状态：社区镜像维护者：termux仓库类型：镜像最近更新：16 天前
让 AI 帮你使用轩辕镜像？ · 展开查看说明
如果你使用 DeepSeek、元宝 AI、Copilot、ChatGPT 等 AI 工具，协助配置轩辕镜像、编写 docker pull 命令、修改 Docker Compose 镜像地址、配置镜像加速、排查镜像拉取失败、分析报错日志等问题，请先让 AI 阅读并遵守轩辕镜像的规则文档。
只需在 AI 对话中先发送下面这句话即可：
请先完整阅读并严格遵守以下文档中的全部规则与要求：
https://xuanyuan.cloud/agents.md
在未充分阅读并理解该文档前，不要生成任何命令、配置、修改建议、故障排查方案或技术回答。后续所有输出都必须严格以该文档中的规范为最高优先级执行。查看 agents.md 用法指南与完整示范。国内用户首推 元宝 AI、DeepSeek 的深度思考模式，不推荐豆包 AI；Cursor 等编辑器可在对话 @ 该链接，或加入 User Rules。 若 AI 无法访问外链，可 打开说明文档 复制全文粘贴。文档会随站点更新，复制内容可能过期，建议定期检查。
Termux Packages Build 镜像
镜像概述
本镜像是一个基于Ubuntu环境的Docker镜像，专门用于构建 https://github.com/termux/termux-packages 仓库中定义的Termux软件包。它预配置了构建Termux包所需的编译工具链、依赖库及环境设置，旨在简化Termux软件包的本地化构建流程。
主要用途
为Termux（Android终端模拟器）构建软件包，支持基于termux-packages仓库源码编译自定义或官方软件包，满足Termux生态的包维护与开发需求。
核心功能与特性
- 预配置Ubuntu环境：基于Ubuntu系统，集成构建Termux包所需的基础依赖（如GCC、Clang、autotools、dpkg等）。
- 交叉编译支持：内置Termux目标架构（aarch64、arm、i686等）的交叉编译工具链。
- 兼容性优化：环境设置与termux-packages仓库构建流程深度适配，减少手动配置步骤。
- 轻量高效：仅包含必要构建组件，降低资源占用，提升构建效率。
使用场景与适用范围
适用对象
- Termux软件包维护者及开发者
- 需要构建自定义Termux包的用户
- 参与termux-packages项目贡献的开源开发者
典型场景
- 本地调试与构建Termux包
- 自动化CI/CD流程中集成Termux包构建步骤
- 为特定架构（如ARM、x86）交叉构建Termux包
使用方法
前提条件
- 安装Docker Engine（20.10+版本推荐）
- 克隆termux-packages仓库：
git clone https://github.com/termux/termux-packages.git
基础构建命令（docker run）
bashdocker run -it --rm \ -v /path/to/local/termux-packages:/termux-packages \ -w /termux-packages \ termux-build-image \ ./build-package.sh -a aarch64 <package-name>
参数说明：
-v /path/to/local/termux-packages:/termux-packages：挂载本地termux-packages仓库目录至容器内-w /termux-packages：设置工作目录为仓库根目录termux-build-image：镜像名称（需替换为实际镜像标签）./build-package.sh -a aarch64 <package-name>：执行构建脚本，指定架构（aarch64）和目标包名
Docker Compose配置示例
创建docker-compose.yml：
yamlversion: '3' services: termux-builder: image: termux-build-image volumes: - ./termux-packages:/termux-packages # 本地仓库路径 working_dir: /termux-packages command: ./build-package.sh -a arm <package-name> # 构建arm架构包
启动构建：
docker-compose up
配置说明
环境变量
通过-e参数传递环境变量自定义构建行为：
| 环境变量 | 描述 | 默认值 |
|---|---|---|
TERMUX_ARCH | 目标架构（支持aarch64/arm/i686/x86_64） | aarch64 |
TERMUX_DEBUG | 启用调试模式（保留临时文件），设为1启用 | 0（禁用） |
TERMUX_JOBS | 并行编译进程数（加速构建），建议设为CPU核心数 | $(nproc)（自动检测） |
构建脚本参数
通过build-package.sh参数调整构建逻辑：
| 参数 | 描述 | 示例 |
|---|---|---|
-d | 仅下载源码，不编译 | ./build-package.sh -d curl |
-f | 强制重新构建（忽略缓存） | ./build-package.sh -f python |
-o | 指定输出目录（默认：debs/） | ./build-package.sh -o ./out |
注意事项
- 目录权限：确保本地
termux-packages目录权限允许容器读写（可通过chmod -R 777临时调整，生产环境建议使用UID映射）。 - 资源需求：构建大型包（如GCC、Node.js）需至少4GB内存+10GB磁盘空间，建议配置Swap分区。
- 网络依赖：首次构建需下载源码及依赖，建议配置Docker镜像加速或代理。
- 镜像更新：定期拉取最新镜像以获取工具链更新（
docker pull termux-build-image）。
相关链接
- https://github.com/termux/termux-packages
- https://github.com/termux/termux-packages/wiki/Building-packages
- Docker Engine安装文档
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本，请访问 标签列表页面。
轩辕镜像加速拉取命令点我查看更多 package-builder 镜像标签
docker pull docker.xuanyuan.run/termux/package-builder:<标签>
DockerHub 原生拉取命令
docker pull termux/package-builder:<标签>
镜像拉取常见问题
功能
错误码
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
5
"Docker访问体验非常流畅，大镜像也能快速完成下载。"