zhangmc/busybox

busybox/busybox-plus 镜像文档

镜像概述

本镜像提供两个版本的轻量级Linux工具集：v1为标准busybox（amd64架构），v2为busybox-plus（基于radial/busyboxplus项目）。两者均以极小体积提供核心Linux命令与工具，适用于容器化环境中的基础镜像构建、系统调试及轻量级任务执行场景。

核心功能与特性

v1: busybox-linux-amd64

• 轻量级设计：镜像体积极小（通常<5MB），启动速度快
• 基础命令集成：包含ls、cp、mv、sh、grep等核心Linux命令
• amd64架构支持：针对x86_64架构优化，兼容性强
• 零依赖：独立运行，无需额外系统库支持

v2: busybox-plus (from radial/busyboxplus)

• 增强工具集：在标准busybox基础上扩展，包含curl、wget、git、rsync等网络与开发工具
• 多协议支持：支持HTTP/HTTPS、SSH、Git等协议操作
• 保持轻量特性：在增强功能的同时维持较小体积（通常<20MB）
• 兼容标准busybox：命令使用方式与标准busybox完全兼容

使用场景

• 基础镜像：作为其他应用镜像的基础层，减少最终镜像体积
• 容器调试：临时启动容器执行命令，排查系统或网络问题
• 轻量级任务：运行简单脚本、文件处理、网络请求等短任务
• CI/CD流程：在流水线中执行命令行操作，如文件同步、版本控制等

使用方法

拉取镜像

bash
# 拉取v1标准版本
docker pull [镜像仓库地址]/busybox-linux-amd64:latest

# 拉取v2增强版本
docker pull [镜像仓库地址]/busybox-plus:latest

基本运行示例

交互式shell（v1）

bash
docker run -it --rm [镜像仓库地址]/busybox-linux-amd64 sh

执行单条命令（v2，使用curl）

bash
docker run --rm [镜像仓库地址]/busybox-plus curl https://example.com

挂载本地目录（执行文件处理）

bash
docker run --rm -v $(pwd):/data [镜像仓库地址]/busybox-linux-amd64 sh -c "ls -l /data && cp /data/source.txt /data/dest.txt"

Docker Compose配置示例

yaml
version: '3'
services:
  busybox-task:
    image: [镜像仓库地址]/busybox-plus:latest
    command: sh -c "wget https://example.com/file.txt -O /data/file.txt"
    volumes:
      - ./data:/data

配置说明

环境变量

无特殊环境变量，可通过命令行参数或挂载文件进行配置。

数据持久化

通过-v参数挂载宿主机目录实现数据持久化，如：

bash
docker run -v /host/path:/container/path [镜像仓库地址]/busybox-linux-amd64 sh

网络配置

默认使用桥接网络，可通过--network参数指定网络模式，如：

bash
docker run --network host [镜像仓库地址]/busybox-plus ping example.com

注意事项

• v1版本仅包含基础命令，复杂网络或开发操作建议使用v2版本
• 镜像默认使用root用户运行，生产环境可通过--user参数指定非root用户
• 避免在该镜像中运行长时间服务，更适合短期任务或作为基础层使用