파일 업로드
  1. base64hub
  2. 다운로드
  3. CLI
v1.0.0 · 오픈 소스 · MIT

b64: macOS·Linux·Windows용 Base64 명령줄 도구

b64는 터미널에서 Base64를 인코딩하고 디코딩하고 검사합니다. 작은 바이너리 하나가 macOS, Linux, Windows에서 같은 플래그로 동작하며, 파이프와 스크립트에 맞게 만들어졌습니다.

brew install base64hub-com/tap/b64
무료 계정 없음, 키 없음 MIT 오픈 소스 라이선스 0개 런타임 의존성 업데이트 2026. 11. 22.

b64가 하는 일

b64는 바이트를 Base64 텍스트로 바꾸고 다시 되돌립니다. 텍스트를 인수로 주거나, 데이터를 파이프로 넘기거나, -i로 파일을 지정하세요. 인코딩하면 결과 뒤에 줄 바꿈 하나를 붙여 출력하고, 디코딩하면 원래 바이트만 그대로 쓰므로 바이너리 파일도 손상 없이 나옵니다.

$ b64 "Hello, hub!"
SGVsbG8sIGh1YiE=
$ b64 -d SGVsbG8sIGh1YiE=
Hello, hub!
$ printf '\xfb\xff\xbf' | b64 --url
-_-_
$ b64 --url --no-pad "Привет"
0J_RgNC40LLQtdGC

마지막 두 줄은 URL-safe 알파벳(+와 / 대신 -와 _)과 = 패딩이 없는 출력을 보여 줍니다. JWT와 URL에서 쓰는 형태입니다. 차이는 Base64와 Base64URL 비교에서 설명합니다.

설치

위의 설치 상자에 패키지 관리자별 명령이 모두 있습니다. 요약하면 다음과 같습니다.

플랫폼명령
macOS, Linux (Homebrew)brew install base64hub-com/tap/b64
Windows (winget)winget install base64hub.b64
Windows (Scoop)scoop bucket add base64hub https://github.com/base64hub-com/homebrew-tap 다음에 scoop install b64
Arch Linux (AUR)yay -S b64-bin
모든 Unix 셸curl -fsSL https://base64hub.com/install.sh | sh
Node.js나 Python이 있을 때npm i -g base64hub 또는 pipx install base64hub
Go가 있을 때go install github.com/base64hub-com/base64hub-cli/cmd/b64@latest

파일을 직접 받고 싶다면 전체 다운로드에 x86_64와 arm64용 .tar.gz, .zip, .deb 빌드와 이를 확인할 SHA256SUMS 파일이 있습니다. npm과 PyPI 빌드도 같은 플래그를 쓰는 같은 b64 명령을 설치합니다.

자주 쓰는 예

줄 바꿈에 주의하세요. echo는 줄 바꿈을 하나 붙이고, b64는 받은 바이트를 모두 인코딩합니다.

$ echo hello | b64
aGVsbG8K
$ printf 'hello' | b64
aGVsbG8=

긴 출력을 줄 바꿈하려면(예: MIME용 76자) -w를 씁니다.

$ printf 'foobar' | b64 -w 4
Zm9v
YmFy

data URI를 만듭니다. MIME 타입은 내용(PNG, JPEG, GIF, WebP, PDF, SVG, 텍스트)으로 감지하거나 -m으로 지정합니다.

$ printf 'Hi' | b64 --data-uri
data:text/plain;charset=utf-8;base64,SGk=
$ b64 --data-uri -i logo.png -o logo.txt

문자열을 믿기 전에 검사하세요. 잘못된 입력에 대한 판정은 종료 코드 1과 함께 stderr로 나갑니다. -로 시작하는 문자열은 플래그로 읽히지 않도록 앞에 --를 붙여야 합니다.

$ b64 --validate -- -_-_
valid (url, 3 bytes)
$ b64 --validate 'Zm9vY'
invalid: invalid length: 5 characters leave a single character in the last group
$ b64 -d 'Zm9v!'
b64: invalid character '!' at position 4

b64와 base64 명령 비교

Linux에는 GNU coreutils의 base64가, macOS에는 BSD 버전이 들어 있고 둘의 플래그는 서로 다릅니다(자세한 내용은 Bash에서 Base64 사용하기 참고). b64는 어느 시스템에서나 똑같이 동작합니다. 아래 GNU 열은 coreutils 9.7로 확인했습니다.

작업GNU base64b64
출력 줄 길이-w 0이 없으면 76자에서 줄 바꿈-w N이 없으면 한 줄
URL-safe 알파벳없음(basenc --base64url은 가능)-u / --url
-나 _가 든 입력 디코딩base64: invalid input허용
data: URI 입력과 출력없음--data-uri, 디코딩할 때는 접두사를 제거
문자열 검사없음변형과 바이트 수를 알려 주는 --validate
오류 정보invalid input잘못된 문자와 그 위치

b64의 디코딩은 일부러 너그럽게 만들었습니다. 공백, 탭, 줄 바꿈은 무시하고, 패딩은 있어도 없어도 되며, 두 알파벳을 모두 받아들입니다. 그 밖의 것, 예를 들어 엉뚱한 !나 중간에 있는 =는 오류이며 종료 코드 1로 끝납니다. 사용법 오류는 종료 코드 2이므로 스크립트에서 잘못된 데이터와 잘못된 명령줄을 구분할 수 있습니다.

오프라인에서 동작

b64는 모든 작업을 사용자의 컴퓨터에서 처리하며 계정도 네트워크 연결도 필요 없습니다. Go 빌드는 표준 입력을 청크 단위로 스트리밍하므로 수 GB 입력에서도 메모리 사용량이 늘지 않습니다. 브라우저에서 문자열 하나만 처리할 때는 이 사이트의 Base64 인코더와 디코더를 쓰세요. 모든 플래그와 종료 코드는 CLI 문서에서 다룹니다.

자주 묻는 질문

Homebrew로 Base64 명령줄 도구를 설치하려면 어떻게 하나요?

brew install base64hub-com/tap/b64를 실행하세요. 포뮬러는 base64hub-com/tap tap에 있으며 macOS와 Linux에 b64 명령을 설치합니다.

b64를 base64 명령 대신 그대로 쓸 수 있나요?

아니요, 플래그가 다릅니다. b64는 -w를 주지 않으면 줄을 바꾸지 않고, 어느 시스템에서나 -d로 디코딩하며, URL-safe 출력, data URI, 검증 기능이 더 있습니다. base64의 동작을 그대로 기대하는 스크립트에서는 계속 base64를 쓰세요.

명령줄에서 파일을 Base64로 인코딩하려면 어떻게 하나요?

b64 -i photo.jpg -o photo.b64 또는 b64 < photo.jpg > photo.b64를 쓰세요. --data-uri를 붙이면 HTML이나 CSS에 붙여넣을 수 있는 data:image/jpeg;base64,… 문자열이 나옵니다.

b64가 'valid (either, …)'를 출력하는 이유는 무엇인가요?

문자열에 + / - _가 하나도 없어서 표준 알파벳과 URL-safe 알파벳 양쪽에서 유효하기 때문입니다. 이런 문자가 들어 있으면 standard, url, mixed가 표시됩니다.

base64hub의 다른 제품