<div id="readability-page-1" class="page"><article>
<header>


</header>
<nav>
<ul>
<li><a href="#busybox-%EB%8B%A4%EC%9A%B4%EB%A1%9C%EB%93%9C-%EB%B0%8F-%EC%84%A4%EC%B9%98%ED%95%98%EB%8A%94-%EB%B0%A9%EB%B2%95">BusyBox 다운로드 및 설치하는 방법</a></li>
<li><a href="#busybox-%EB%AA%85%EB%A0%B9%EC%96%B4-%EC%82%AC%EC%9A%A9%ED%95%98%EB%8A%94-%EB%B0%A9%EB%B2%95">BusyBox 명령어 사용하는 방법</a></li>
<li><a href="#docker%EC%99%80-busybox-%EC%9D%B4%EB%AF%B8%EC%A7%80">Docker와 BusyBox 이미지</a></li>
<li><a href="#%EB%B6%80%EB%A1%9D-busybox%EC%97%90-%ED%8F%AC%ED%95%A8%EB%90%9C-%EB%AA%A8%EB%93%A0-%EB%AA%85%EB%A0%B9%EC%96%B4-%EB%AA%A9%EB%A1%9D">부록: BusyBox에 포함된 모든 명령어 목록</a></li>
</ul>
</nav>
<p>BusyBox는 GPL 라이센스로 개발되고 있는, 400개 여개의 <a href="/ko/article/linux/">리눅스</a> 커맨드라인 명령어들을 모아놓은 단일 실행 파일입니다.</p>
<ul>
<li>공식 웹사이트: <a href="https://www.busybox.net/">BusyBox</a>
</li>
<li>소스코드: <a href="https://git.busybox.net/busybox">busybox - BusyBox: The Swiss Army Knife of Embedded Linux</a>
</li>
</ul>
<p>BusyBox는 스스로 임베디드 리눅스를 위한 스위스 나이프라고 소개하고 있습니다. 임베디드 리눅스와 같은 제한된 환경에서는 기본적으로 포함된 소프트웨어가 부족하거나 패키지로도 설치하기 어려운 경우가 자주 있습니다. 이런 환경에서 BusyBox를 사용하면, 손쉽게 다양한 리눅스 명령어들을 실행할 수 있게 됩니다. 또한 BusyBox에서 제공되는 명령어들은 일반적인 리눅스 명령어와 다르게 옵션이 최소화되어있습니다. BusyBox 바이너리는 1메가가 조금 넘는 정도이며, 명령어 별 바이너리도 제공되고 있습니다. 현재 BusyBox의 최신 버전은 2023년 5월 19일 릴리스된 1.36.1 버전입니다. 비슷한 프로젝트로는 <a href="http://landley.net/toybox/roadmap.html">toybox</a>가 있습니다.</p>
<h2 id="busybox-다운로드-및-설치하는-방법">BusyBox 다운로드 및 설치하는 방법</h2>
<p>BusyBox를 사용하는 방법은 가장 간단한 방법은 공식 릴리스된 바이너리 파일을 다운로드 받아 사용하는 것입니다. 아래 페이지에서 공식 바이너리 파일을 다운로드 받을 수 있습니다.</p>
<ul>
<li><a href="https://www.busybox.net/downloads/binaries/">Index of /downloads/binaries</a></li>
</ul>
<p>x86 64비트 아키텍처로 빌드된 <code>1.35.0-x86_64-linux-musl</code> 버전을 사용하려면 아래와 같이 다운로드하고 실행합니다. 또한 앞에서 링크한 바이너리 디렉터리에서 명령어 개별 바이너리를 따로 다운로드 받을 수도 있습니다.</p>
<pre><code>$ wget https://www.busybox.net/downloads/binaries/1.35.0-x86_64-linux-musl/busybox</code></pre>
<p>혹은 이 파일을 사용하고자 하는 시스템에 복사하고, 아래와 같이 실행해봅니다.</p>
<pre><code>$ ./busybox --help
BusyBox v1.35.0 (2022-01-17 19:57:02 CET) multi-call binary.
BusyBox is copyrighted by many authors between 1998-2015.
Licensed under GPLv2. See source distribution for detailed
copyright notices.
(...)</code></pre>
<p>실행이 되지 않는다면, 먼저 <code>chmod +x ./busybox</code>로 실행 권한을 추가하고 실행해봅니다. 명령어 실행 시 <code>./</code>은 현재 디렉터리에 있는 <code>busybox</code> 파일을 실행한다는 의미를 가지고 있습니다. 어느 디렉터리에서나 <code>./busybox</code>를 사용하고자 하는 경우 이 파일을 <code>/usr/bin/</code>과 같이 실행 파일을 모아놓는 디렉터리로 복사하거나, <code>PATH</code> 환경변수의 디렉터리에 적절하게 복사해주어야합니다.</p>
<p><a href="/ko/article/ubuntu/">Ubuntu</a>나 Fedora 등의 리눅스 배포판에서는 패키지 매니저로 설치할 수도 있습니다.</p>
<pre><code>## Ubunut 리눅스
$ sudo apt install busybox

## Fedora 리눅스
$ sudo dnf install busybox</code></pre>
<p>패키지 매니저를 통해서 설치하면 따로 실행 파일 위치를 잡아줄 필요가 없습니다. 대신 패키지 매니저의 공식 저장소에서 관리하는 버전이 최신 버전보다 낮을 수 있습니다.</p>
<pre><code>$ busybox
BusyBox v1.30.1 (Ubuntu 1:1.30.1-7ubuntu3) multi-call binary.
BusyBox is copyrighted by many authors between 1998-2015.
Licensed under GPLv2. See source distribution for detailed
copyright notices.
(...)</code></pre>
<p>미리 제공되는 바이너리나 패키지 매니저를 통하지 않고 자신이 사용하는 환경에서 직접 빌드를 해야하는 경우, 아래 링크에서 소스코드를 다운로드 받을 수 있습니다.</p>
<ul>
<li><a href="https://www.busybox.net/downloads/">Index of /downloads</a></li>
</ul>
<h2 id="busybox-명령어-사용하는-방법">BusyBox 명령어 사용하는 방법</h2>
<p>BusyBox에는 수백개의 명령어가 포함되어있습니다. 기본적인 사용 방법은 <code>busybox</code> 명령어 뒤에 사용하고자 하는 명령어를 첫번째 인자로 붙여주는 방법입니다. 예를 들어 <code>wget</code> 명령어를 사용하고 싶다면 다음과 같이 실행합니다.</p>
<pre><code>$ busybox wget
BusyBox v1.30.1 (Ubuntu 1:1.30.1-7ubuntu3) multi-call binary.

Usage: wget [-c|--continue] [--spider] [-q|--quiet] [-O|--output-document FILE]
[--header 'header: value'] [-Y|--proxy on/off] [-P DIR]
[--no-check-certificate]
[-S|--server-response] [-U|--user-agent AGENT] URL...

Retrieve files via HTTP or FTP

        --spider        Only check URL existence: $? is 0 if exists
        --no-check-certificate  Don't validate the server's certificate
        -c              Continue retrieval of aborted transfer
        -q              Quiet
        -P DIR          Save to DIR (default .)
        -S              Show server response
        -O FILE         Save to FILE ('-' for stdout)
        -U STR          Use STR for User-Agent header
        -Y on/off       Use proxy</code></pre>
<p>첫 번째 줄에서 BusyBox의 <code>wget</code>이 실행된 것을 확인할 수 있습니다. 사용법은 다른 리눅스에서 사용하는 <code>wget</code> 인터페이스와 크게 다르지 않습니다만, 옵션이 최소화되어있으므로 옵션이나 동작이 일부 다를 수 있습니다.</p>
<p>BusyBox는 기본적으로 단일 바이너리로 이루어져있기 때문에 다른 명령어를 사용할 때 항상 <code>busybox &lt;명령어&gt;</code> 형식을 사용합니다. <code>busybox</code> 없이 명령어들을 실행하고자 한다면 <code>--install</code> 옵션으로 개별 명령어들을 전부 특정 디렉터리에 설치할 수 있습니다. 아래는 개별 명령어들을 설치하는 예시입니다.</p>
<pre><code>$ mkdir busybox-bin
$ busybox --install ./busybox-bin
$ cd busybox-bin
$ ls -1 | wc -l
402</code></pre>
<p><code>ls</code>와 <code>wc</code> 명령어로 간단히 확인해보면 402개의 실행 파일이 설치된 것을 확인할 수 있습니다. 여기에 설치된 실행 파일을 직접 실행하면 더 이상 <code>busybox</code>를 붙이지 않아도 됩니다.</p>
<pre><code>$ ./wget
BusyBox v1.30.1 (Ubuntu 1:1.30.1-7ubuntu3) multi-call binary.
(...)</code></pre>
<p>앞서 <code>busybox wget</code>을 실행한 결과와 같은 것을 확인할 수 있습니다.</p>
<p>BusyBox에는 다양한 리눅스 명령어들이 포함되어있습니다. BusyBox에 포함된 모든 명령어 목록은 이 글의 마지막 부록에 포함되어있습니다. 여기서 모든 명령어를 소개할 수는 없습니다만, 리눅스 주요 명령어들에 대한 해설은 다음 글을 참고해주세요.</p>
<ul>
<li><a href="https://www.lainyzine.com/ko/article/summary-of-linux-commands/">리눅스 명령어 사용법 총 정리</a></li>
</ul>
<div>
<p>
BusyBox의 기본 셸
</p>
<p>
BusyBox에는 <code>sh</code> 명령어도 포함되어있습니다. 이 셸은 Bash가 아니고, 경량 리눅스 셸로 알려진 <a href="https://github.com/brgl/busybox/blob/master/shell/ash.c">Almquist 셸</a>입니다. 따라서 Bash 스크립트가 정상 동작하지 않을 수 있으므로 사용에 주의가 필요합니다.
</p>
</div>
<h2 id="docker와-busybox-이미지">Docker와 BusyBox 이미지</h2>
<p><a href="/ko/article/docker/">Docker</a>에 익숙하다면 BusyBox에 대해서 들어봤거나 이미 잘 활용하고 있을 수도 있습니다. Docker에서는 다양한 리눅스 배포판 이미지들을 베이스 이미지로 제공하고 있습니다. 예를 들어 Ubuntu 이미지를 사용하고자 한다면 다음과 같이 실행합니다.</p>
<pre><code>$ docker run -it ubuntu:latest bash</code></pre>
<p><code>/etc/lsb-release</code> 파일을 출력해 현재 환경이 Ubuntu 인것을 간단히 확인해볼 수 있습니다.</p>
<ul>
<li>관련 글: <a href="https://www.lainyzine.com/ko/article/how-to-check-your-linux-distribution-and-version/">리눅스 배포판 및 버전 확인하는 방법</a>
</li>
</ul>
<pre><code>root@cea1790440be:/# cat /etc/lsb-release
DISTRIB_ID=Ubuntu
DISTRIB_RELEASE=22.04
DISTRIB_CODENAME=jammy
DISTRIB_DESCRIPTION="Ubuntu 22.04.2 LTS"</code></pre>
<p>이와 마찬가지로 BusyBox 이미지도 사용해볼 수 있습니다.</p>
<pre><code>$ docker run -it busybox:latest sh</code></pre>
<p>단, 앞서 소개한대로, BusyBox는 리눅스 배포판이 아니라 소프트웨어를 모아놓은 바이너리 파일입니다. Docker의 공식 BusyBox 이미지는 BusyBox의 유틸리티를 사용할 수 있도록 구성되어있는 최소한의 이미지라고 할 수 있습니다. BusyBox 이미지가 어떻게 만들어졌는지는 다음 저장소에서 확인할 수 있습니다.</p>
<ul>
<li><a href="https://github.com/docker-library/busybox/tree/master">docker-library/busybox: Docker Official Image packaging for Busybox</a></li>
</ul>
<p>Docker 컨테이너에서 busybox 명령어를 사용해봅니다.</p>
<pre><code>/ # busybox wget
BusyBox v1.36.1 (2023-06-24 00:03:42 UTC) multi-call binary.
(...)</code></pre>
<p>또한 BusyBox 이미지에는 실행파일들이 <code>/bin</code>에 설치되어있어 <code>busybox</code>를 붙이지 않고도 소프트웨어를 실행하는 것이 가능합니다.</p>
<pre><code>/ # busybox wget
BusyBox v1.36.1 (2023-06-24 00:03:42 UTC) multi-call binary.
(...)

/ # which wget
/bin/wget</code></pre>
<p>BusyBox 이미지는 5메가를 조금 넘는 수준입니다. 일반적으로 BusyBox 이미지 사용을 추천하지는 않습니다만, 다른 배포판 이미지에 비해서 매우 작은 크기를 가지고 있어 경량화된 Docker 이미지를 만들 때 주로 사용됩니다. 예를 들어 BusyBox 이미지에직접 만든 소프트웨어 바이너리가 10메가 정도 한다고 가정해보면 15메가 정도에 커스텀 Docker 이미지를 만드는 게 가능합니다.</p>
<h2 id="부록-busybox에-포함된-모든-명령어-목록">부록: BusyBox에 포함된 모든 명령어 목록</h2>
<p>다음은 <a href="https://busybox.net/downloads/BusyBox.html">BusyBox 공식 문서</a>에서 인용한 BusyBox에 포함된 전체 명령어 목록입니다. 명령어 목록에서 확인할 수 있듯이 대부분은 리눅스에서 기본적으로 활용되는 명령어들입니다. 이러한 명령어들을 사용할 수 없는 환경에서 유용하게 활용할 수 있습니다.</p>
<pre><code>        [, [[, acpid, addgroup, adduser, adjtimex, ar, arp, arping, ash,
        awk, basename, beep, blkid, brctl, bunzip2, bzcat, bzip2, cal, cat,
        catv, chat, chattr, chgrp, chmod, chown, chpasswd, chpst, chroot,
        chrt, chvt, cksum, clear, cmp, comm, cp, cpio, crond, crontab,
        cryptpw, cut, date, dc, dd, deallocvt, delgroup, deluser, depmod,
        devmem, df, dhcprelay, diff, dirname, dmesg, dnsd, dnsdomainname,
        dos2unix, dpkg, du, dumpkmap, dumpleases, echo, ed, egrep, eject,
        env, envdir, envuidgid, expand, expr, fakeidentd, false, fbset,
        fbsplash, fdflush, fdformat, fdisk, fgrep, find, findfs, flash_lock,
        flash_unlock, fold, free, freeramdisk, fsck, fsck.minix, fsync,
        ftpd, ftpget, ftpput, fuser, getopt, getty, grep, gunzip, gzip, hd,
        hdparm, head, hexdump, hostid, hostname, httpd, hush, hwclock, id,
        ifconfig, ifdown, ifenslave, ifplugd, ifup, inetd, init, inotifyd,
        insmod, install, ionice, ip, ipaddr, ipcalc, ipcrm, ipcs, iplink,
        iproute, iprule, iptunnel, kbd_mode, kill, killall, killall5, klogd,
        last, length, less, linux32, linux64, linuxrc, ln, loadfont,
        loadkmap, logger, login, logname, logread, losetup, lpd, lpq, lpr,
        ls, lsattr, lsmod, lzmacat, lzop, lzopcat, makemime, man, md5sum,
        mdev, mesg, microcom, mkdir, mkdosfs, mkfifo, mkfs.minix, mkfs.vfat,
        mknod, mkpasswd, mkswap, mktemp, modprobe, more, mount, mountpoint,
        mt, mv, nameif, nc, netstat, nice, nmeter, nohup, nslookup, od,
        openvt, passwd, patch, pgrep, pidof, ping, ping6, pipe_progress,
        pivot_root, pkill, popmaildir, printenv, printf, ps, pscan, pwd,
        raidautorun, rdate, rdev, readlink, readprofile, realpath,
        reformime, renice, reset, resize, rm, rmdir, rmmod, route, rpm,
        rpm2cpio, rtcwake, run-parts, runlevel, runsv, runsvdir, rx, script,
        scriptreplay, sed, sendmail, seq, setarch, setconsole, setfont,
        setkeycodes, setlogcons, setsid, setuidgid, sh, sha1sum, sha256sum,
        sha512sum, showkey, slattach, sleep, softlimit, sort, split,
        start-stop-daemon, stat, strings, stty, su, sulogin, sum, sv,
        svlogd, swapoff, swapon, switch_root, sync, sysctl, syslogd, tac,
        tail, tar, taskset, tcpsvd, tee, telnet, telnetd, test, tftp, tftpd,
        time, timeout, top, touch, tr, traceroute, true, tty, ttysize,
        udhcpc, udhcpd, udpsvd, umount, uname, uncompress, unexpand, uniq,
        unix2dos, unlzma, unlzop, unzip, uptime, usleep, uudecode, uuencode,
        vconfig, vi, vlock, volname, watch, watchdog, wc, wget, which, who,
        whoami, xargs, yes, zcat, zcip</code></pre>

</article></div>

LZ: 프로그래머 가이드

LainyZine

BusyBox는 다양한 리눅스 명령어들을 모아놓은 단일 실행 파일로 임베디드 환경이나 Docker 등에서 많이 활용됩니다. 이 글에서는 BusyBox를 소개하고 사용방법을 알아봅니다.
전체 기사는 이 링크에서 읽을 수 있습니다.

BusyBox 소개와 사용법

댓글