yanzinetworks/toolbox

Toolbox 镜像文档

镜像概述

Toolbox是一个基于Alpine Linux的工具集镜像，旨在提供轻量级、高兼容性的工具环境。该镜像特别优化了glibc兼容性，并支持在受控情况下从主机系统绑定挂载二进制文件，同时允许通过构建参数灵活定制包含的软件包。

核心功能与特性

• Alpine基础：基于轻量级Alpine Linux构建，确保镜像体积小、启动速度快、资源占用低。
• glibc兼容性：提供glibc兼容支持，可运行依赖glibc的应用程序，扩展工具适用范围。
• 受控绑定挂载：支持在特定受控场景下从主机系统绑定挂载二进制文件，便于容器与主机环境的交互操作。
• 可定制软件包：构建镜像时，可通过PKGS构建参数自定义需要添加的软件包列表，灵活适配不同工具需求。

使用场景与适用范围

• 轻量级工具环境：适用于需要轻量级、便携工具集的场景，如临时命令行操作、脚本执行等。
• 主机二进制交互：需在容器内访问或运行主机系统二进制文件的场景，如调试、兼容性测试等。
• 自定义工具集构建：根据项目或工作流需求，通过PKGS参数定制包含特定工具的镜像，适用于开发、测试或运维场景。

使用方法与配置说明

构建镜像

构建Toolbox镜像时，可通过--build-arg参数指定PKGS来定义需要添加的软件包。例如，如需添加curl和jq工具，构建命令如下：

bash
docker build --build-arg PKGS="curl jq" -t my-toolbox .

说明：PKGS参数接受空格分隔的软件包名称列表，指定需要额外安装的工具。基础镜像已包含Alpine默认工具，PKGS用于补充自定义工具。

运行容器

基本运行

直接运行容器以使用默认工具集：

bash
docker run -it --rm my-toolbox

绑定挂载主机二进制文件

如需从主机绑定挂载二进制文件（如/usr/local/bin/custom-tool），可使用-v参数：

bash
docker run -it --rm -v /usr/local/bin/custom-tool:/usr/local/bin/custom-tool my-toolbox

注意：绑定挂载前需确保容器内环境（如依赖库）与主机二进制文件兼容，避免运行时错误。

依赖说明

该镜像基于YanziNetworks Alpine镜像构建，详情可参考：https://github.com/YanziNetworks/alpine%E3%80%82