BusyBox工具箱：鸿蒙PC上的Unix工具集

ohos-busybox是为 OpenHarmony 平台编译的 BusyBox 工具集。本文档详细介绍如何在鸿蒙PC上安装和使用官方适配完成的 BusyBox 工具，包括 HNP 包的打包、安装和使用方法。

📋 目录

• 一、项目概述
• 二、为什么需要 HNP 包
• 三、HNP 包打包方法
• 四、安装与使用
• 五、使用示例
• 六、常见问题
• 七、总结与最佳实践
• 八、参考资料

一、项目概述

1.1 BusyBox 工具简介

BusyBox是一个集成了大量 Unix 工具的精简工具箱，它将许多常用的 Unix 工具打包成一个可执行文件。BusyBox 被设计为在资源受限的环境中运行，是嵌入式 Linux 系统的标准组件。

核心特性：

• 🧰工具集成：将数百个 Unix 工具集成到单个可执行文件中
• 📦体积小巧：相比完整工具集，体积大幅减小
• ⚡高效运行：针对嵌入式环境优化，启动速度快
• 🔧功能完整：提供 ls、grep、tar、sed、awk 等常用工具
• 🎯符号链接：通过符号链接提供不同的命令接口
• 🔄跨平台：支持多种架构和操作系统

主要应用场景：

• 嵌入式系统和 IoT 设备
• 系统恢复和救援环境
• 容器和轻量级虚拟化环境
• 资源受限的开发环境
• 系统管理和维护工具
• 作为完整 Unix 工具集的替代方案
  

1.2 项目信息

1.3 BusyBox 包含的工具

BusyBox 集成了数百个 Unix 工具，主要包括：

文件操作类：

• ls,cp,mv,rm,mkdir,rmdir,touch,cat,head,tail
• find,grep,sed,awk,sort,uniq,wc

压缩归档类：

• tar,gzip,gunzip,bzip2,xz

系统信息类：

• ps,top,free,df,du,mount,umount

网络工具类：

• wget,ftpget,ftpput,telnet,nc

文本处理类：

• vi,less,more,cut,paste,join

其他工具：

• sh,ash,bash（简化版 shell）
• init,getty,login
• chmod,chown,chgrp

1.4 为什么需要 ohos-busybox？

在鸿蒙PC上进行开发时，我们经常需要：

1. ✅Unix 工具集：提供完整的 Unix 命令行工具
2. ✅系统管理：进行文件操作、系统监控等任务
3. ✅脚本执行：运行各种 shell 脚本
4. ✅开发调试：在开发环境中使用常用工具
5. ✅资源优化：在资源受限环境中提供轻量级工具集

二、为什么需要 HNP 包

2.1 系统安全限制

重要说明：在鸿蒙PC上，由于系统安全规格限制等原因，暂不支持通过"解压 + 配 PATH"的方式直接使用 tar.gz 包。

这意味着：

• ❌ 不能直接解压 tar.gz 包到任意目录
• ❌ 不能通过设置 PATH 环境变量来使用
• ✅ 必须打包成 HNP（HarmonyOS Native Package）格式才能正常使用

2.2 HNP 包的优势

HNP 包是鸿蒙PC的官方包管理格式，具有以下优势：

• ✅系统集成：与鸿蒙PC的包管理系统集成
• ✅安全可靠：通过官方工具安装，符合系统安全规范
• ✅易于管理：支持安装、卸载、更新等操作
• ✅路径规范：统一安装在/data/service/hnp/目录下

2.3 其他平台的使用方式

在鸿蒙开发板上：

可以使用传统的"解压 + 配 PATH"方式：

# 使用 hdc 推送文件到设备hdcfilesend busybox-1.37.0-ohos-arm64.tar.gz /data# 进入设备 shellhdc shell# 解压并配置cd/datatar-zxf busybox-1.37.0-ohos-arm64.tar.gzexportPATH=$PATH:/data/busybox-1.37.0-ohos-arm64/bin# 现在可以使用 busybox 命令了busyboxls

在鸿蒙容器中：

# 启动容器docker run -itd --name=ohos ghcr.io/hqzing/docker-mini-openharmony:latest dockerexec-it ohossh# 下载并安装cd/rootcurl-L -O https://github.com/Harmonybrew/ohos-busybox/releases/download/1.37.0/busybox-1.37.0-ohos-arm64.tar.gztar-zxf busybox-1.37.0-ohos-arm64.tar.gz -C /optexportPATH=$PATH:/opt/busybox-1.37.0-ohos-arm64/bin# 使用 busyboxbusybox --help

三、HNP 包打包方法

3.1 准备工作

在开始打包之前，需要准备以下内容：

1. 预构建的 tar.gz 包：从 release 页面 下载
2. hnpcli 工具：鸿蒙PC的包管理工具
3. 打包脚本：用于自动化打包过程

3.2 下载预构建包

# 下载 busybox 预构建包wgethttps://github.com/Harmonybrew/ohos-busybox/releases/download/1.37.0/busybox-1.37.0-ohos-arm64.tar.gz

3.3 创建打包脚本

创建一个pack_hnp.sh脚本来自动化打包过程：

#!/bin/bashset-e# 配置变量BUSYBOX_VERSION="1.37.0"TAR_FILE="busybox-${BUSYBOX_VERSION}-ohos-arm64.tar.gz"EXTRACT_DIR="busybox-${BUSYBOX_VERSION}-ohos-arm64"HNP_PUBLIC_PATH="/data/service/hnp"BUSYBOX_INSTALL_PATH="${HNP_PUBLIC_PATH}/busybox.org/busybox_${BUSYBOX_VERSION}"OUTPUT_DIR="output"WORKDIR=$(pwd)# 创建输出目录mkdir-p${OUTPUT_DIR}# 解压 tar.gz 包if[!-d"${EXTRACT_DIR}"];thenecho"解压${TAR_FILE}..."tar-zxf${TAR_FILE}fi# 创建安装目录echo"创建安装目录..."mkdir-p${BUSYBOX_INSTALL_PATH}/bin# 复制文件echo"复制文件..."cp-r${EXTRACT_DIR}/bin/*${BUSYBOX_INSTALL_PATH}/bin/if[-f"${EXTRACT_DIR}/LICENSE"];thencp${EXTRACT_DIR}/LICENSE${BUSYBOX_INSTALL_PATH}/fiif[-f"${EXTRACT_DIR}/AUTHORS"];thencp${EXTRACT_DIR}/AUTHORS${BUSYBOX_INSTALL_PATH}/fi# 创建 hnp.jsonecho"创建 hnp.json..."cat>${BUSYBOX_INSTALL_PATH}/hnp.json<<'EOF' { "type": "hnp-config", "name": "busybox", "version": "1.37.0", "install": { "links": [ { "source": "bin/busybox", "target": "busybox" }, { "source": "bin/busybox", "target": "ls" }, { "source": "bin/busybox", "target": "cp" }, { "source": "bin/busybox", "target": "mv" }, { "source": "bin/busybox", "target": "rm" }, { "source": "bin/busybox", "target": "mkdir" }, { "source": "bin/busybox", "target": "rmdir" }, { "source": "bin/busybox", "target": "cat" }, { "source": "bin/busybox", "target": "grep" }, { "source": "bin/busybox", "target": "tar" }, { "source": "bin/busybox", "target": "gzip" }, { "source": "bin/busybox", "target": "sed" }, { "source": "bin/busybox", "target": "awk" }, { "source": "bin/busybox", "target": "find" }, { "source": "bin/busybox", "target": "wget" } ] } } EOF# 设置执行权限chmod+x${BUSYBOX_INSTALL_PATH}/bin/busybox# 使用 hnpcli 打包（如果可用）ifcommand-v hnpcli&>/dev/null;thenecho"使用 hnpcli 打包..."hnpcli pack -i${BUSYBOX_INSTALL_PATH}-o${OUTPUT_DIR}/echo"HNP 包已生成:${OUTPUT_DIR}/busybox.hnp"elseecho"警告: 未找到 hnpcli 工具，跳过 HNP 包生成"echo"请手动使用 hnpcli 打包:"echo" hnpcli pack -i${BUSYBOX_INSTALL_PATH}-o${OUTPUT_DIR}/"fi# 生成 tar.gz 包（备用）echo"生成 tar.gz 包..."cd${HNP_PUBLIC_PATH}/busybox.orgtar-zcf${WORKDIR}/${OUTPUT_DIR}/ohos_busybox_${BUSYBOX_VERSION}.tar.gz busybox_${BUSYBOX_VERSION}/cd->/dev/nullecho"打包完成！"echo"输出文件："echo" -${OUTPUT_DIR}/busybox.hnp (如果 hnpcli 可用)"echo" -${OUTPUT_DIR}/ohos_busybox_${BUSYBOX_VERSION}.tar.gz"

3.4 执行打包

# 赋予脚本执行权限chmod+x pack_hnp.sh# 执行打包./pack_hnp.sh

3.5 验证打包结果

打包完成后，验证生成的文件：

# 检查 HNP 包ls-lh output/busybox.hnp# 检查 tar.gz 包ls-lh output/ohos_busybox_1.37.0.tar.gz# 验证安装目录结构tree${BUSYBOX_INSTALL_PATH}/

预期的安装目录结构：

/data/service/hnp/busybox.org/busybox_1.37.0/ ├── bin/ │ └── busybox # busybox 可执行文件 ├── LICENSE # 许可证文件 ├── AUTHORS # 作者信息 └── hnp.json # HNP 配置文件

四、安装与使用

4.1 安装 HNP 包

使用 hnpcli 安装

# 在鸿蒙PC上执行hnpcliinstalloutput/busybox.hnp

手动安装（使用 tar.gz）

# 在鸿蒙PC上执行# 1. 解压 tar.gz 包tar-xzf ohos_busybox_1.37.0.tar.gz# 2. 复制到安装目录sudocp-r busybox_1.37.0/* /data/service/hnp/busybox.org/busybox_1.37.0/# 3. 设置执行权限sudochmod+x /data/service/hnp/busybox.org/busybox_1.37.0/bin/*# 4. 创建符号链接（根据 hnp.json 配置）# hnp 系统会自动处理 links 配置，但也可以手动创建sudoln-sf /data/service/hnp/busybox.org/busybox_1.37.0/bin/busybox /usr/local/bin/busybox

4.2 验证安装

# 检查 busybox 是否可用busybox --help# 查看 busybox 版本busybox|head-1# 查看支持的所有命令busybox --list

4.3 使用 BusyBox

安装完成后，可以通过两种方式使用 BusyBox：

方式一：直接调用 busybox

# 使用 busybox 执行命令busyboxls-la busyboxgrep"pattern"file.txt busyboxtar-czf archive.tar.gz directory/

方式二：使用符号链接（如果已配置）

# 直接使用命令名（如果 hnp.json 中配置了符号链接）ls-lagrep"pattern"file.txttar-czf archive.tar.gz directory/

五、使用示例

5.1 文件操作示例

# 列出文件busyboxls-lah# 复制文件busyboxcpsource.txt dest.txt# 移动文件busyboxmvold.txt new.txt# 删除文件busyboxrmfile.txt# 创建目录busyboxmkdir-p /path/to/directory# 查看文件内容busyboxcatfile.txt# 查看文件前几行busyboxhead-n10file.txt# 查看文件后几行busyboxtail-n20file.txt

5.2 文本处理示例

# 搜索文本busyboxgrep"pattern"file.txt# 递归搜索busyboxgrep-r"pattern"/path/to/directory# 文本替换busyboxsed's/old/new/g'file.txt# 文本过滤busyboxawk'{print$1}'file.txt# 排序busyboxsortfile.txt# 去重busyboxuniqfile.txt# 统计行数、字数busyboxwc-l file.txt

5.3 压缩归档示例

# 创建 tar 归档busyboxtar-cf archive.tar files/# 创建 gzip 压缩的 tar 归档busyboxtar-czf archive.tar.gz files/# 解压 tar 归档busyboxtar-xf archive.tar# 解压 gzip 压缩的 tar 归档busyboxtar-xzf archive.tar.gz# 压缩文件busyboxgzipfile.txt# 解压文件busybox gunzip file.txt.gz

5.4 系统信息示例

# 查看进程busyboxpsaux# 查看磁盘使用busyboxdf-h# 查看目录大小busyboxdu-sh /path/to/directory# 查找文件busyboxfind/path -name"*.txt"# 网络下载busyboxwgethttp://example.com/file.txt

5.5 Shell 脚本示例

#!/bin/sh# 使用 busybox 的 ash shell# 变量赋值NAME="BusyBox"VERSION=$(busybox|head-1)# 条件判断if[-f"file.txt"];thenecho"文件存在"busyboxcatfile.txtelseecho"文件不存在"fi# 循环foriin$(busyboxseq110);doecho"数字:$i"done# 函数hello(){echo"Hello from BusyBox!"}hello

六、常见问题

6.1 为什么某些功能被禁用了？

在构建过程中，某些难以适配的功能被直接禁用了：

• CONFIG_SHA1_HWACCEL：SHA1 硬件加速
• CONFIG_FEATURE_UTMP：UTMP 功能
• CONFIG_FEATURE_SU_CHECKS_SHELLS：su 检查 shells
• CONFIG_HOSTID：hostid 命令
• CONFIG_HUSH：hush shell

这些功能在 OpenHarmony 平台上可能不完全兼容，因此被禁用以确保稳定性。

6.2 如何查看 BusyBox 支持的所有命令？

# 列出所有支持的命令busybox --list# 查看特定命令的帮助busybox<command>--help

6.3 如何从源码构建 BusyBox？

参考项目中的build.sh脚本：

# 1. 准备构建环境（Ubuntu 24.04 x64）sudoaptupdate&&sudoaptinstall-y build-essentialunzip# 2. 下载并执行构建脚本gitclone https://github.com/Harmonybrew/ohos-busybox.gitcdohos-busybox ./build.sh

构建脚本会：

1. 下载 OpenHarmony SDK
2. 下载 BusyBox 源码
3. 应用适配补丁
4. 配置和编译
5. 打包生成 tar.gz 文件

6.4 符号链接不工作怎么办？

如果通过符号链接使用命令时出现问题，可以：

1. 检查符号链接是否存在：

   ls-l /usr/local/bin/busybox

2. 手动创建符号链接：

   sudoln-sf /data/service/hnp/busybox.org/busybox_1.37.0/bin/busybox /usr/local/bin/busybox

3. 直接使用 busybox 命令：

   busybox<command>[args]

6.5 如何在脚本中使用 BusyBox？

在脚本中，可以这样使用：

#!/bin/sh# 使用 busybox 的绝对路径BUSYBOX="/data/service/hnp/busybox.org/busybox_1.37.0/bin/busybox"# 或者确保 busybox 在 PATH 中exportPATH=$PATH:/data/service/hnp/busybox.org/busybox_1.37.0/bin# 使用命令$BUSYBOXls-la$BUSYBOXgrep"pattern"file.txt

6.6 性能问题

BusyBox 是单可执行文件，通过符号链接调用时会有轻微的性能开销。如果对性能有要求，可以考虑：

1. 直接使用busybox <command>而不是符号链接
2. 在脚本中缓存 busybox 路径
3. 对于频繁使用的命令，创建独立的符号链接

七、总结与最佳实践

7.1 总结

BusyBox 是一个强大的工具集，为鸿蒙PC提供了完整的 Unix 命令行工具：

• ✅功能丰富：集成了数百个常用 Unix 工具
• ✅体积小巧：相比完整工具集，体积大幅减小
• ✅易于部署：通过 HNP 包可以方便地安装和管理
• ✅跨平台：支持多种使用场景（PC、开发板、容器）

7.2 最佳实践

1. 使用 HNP 包安装：

   • 在鸿蒙PC上，优先使用 HNP 包进行安装
   • 遵循系统的包管理规范

2. 合理使用符号链接：

   • 根据需要配置符号链接
   • 避免创建过多不必要的符号链接

3. 脚本中使用绝对路径：

   • 在脚本中使用 busybox 时，使用绝对路径更可靠
   • 或者确保 PATH 环境变量正确设置

4. 了解功能限制：

   • 某些功能在 OpenHarmony 上可能不可用
   • 查看busybox --list了解支持的命令

5. 性能优化：

   • 对于频繁使用的命令，考虑直接调用
   • 在脚本中缓存 busybox 路径

7.3 适用场景

BusyBox 特别适合以下场景：

• ✅嵌入式开发：资源受限的开发环境
• ✅系统维护：系统恢复和救援操作
• ✅容器环境：轻量级容器中的工具集
• ✅脚本开发：需要完整 Unix 工具的脚本环境
• ✅开发调试：开发过程中的常用工具需求