파일 업로드
  1. base64hub
  2. 문서
  3. CLI

b64 CLI 레퍼런스

b64는 Base64를 인코딩, 디코딩, 검증합니다. 이 페이지에서는 모든 플래그와 조합 규칙, 명령이 출력하고 반환하는 내용을 정리합니다.

설치

방법명령
Homebrew (macOS, Linux)brew install base64hub-com/tap/b64
Scoop (Windows)scoop bucket add base64hub https://github.com/base64hub-com/homebrew-tap 다음에 scoop install b64
winget (Windows)winget install base64hub.b64
AUR (Arch Linux)yay -S b64-bin
설치 스크립트curl -fsSL https://base64hub.com/install.sh | sh
npmnpm i -g base64hub
pipxpipx install base64hub
Gogo install github.com/base64hub-com/base64hub-cli/cmd/b64@latest

macOS, Linux, Windows용 x86_64·arm64 릴리스 압축 파일, .deb 패키지, SHA256SUMS 파일은 다운로드 페이지에 있습니다. 설치가 됐는지는 b64 --version으로 확인하세요. b64 1.0.0이 출력됩니다.

npm과 pipx 빌드도 같은 플래그와 메시지를 쓰는 같은 명령입니다. 차이는 하나뿐입니다. Go 빌드는 표준 입력을 청크 단위로 스트리밍하고, npm과 Python 빌드는 입력 전체를 먼저 메모리로 읽습니다.

사용법

b64 [flags] [TEXT]

TEXT가 있으면 b64는 TEXT의 UTF-8 바이트를 처리하며 줄 바꿈을 덧붙이지 않습니다. TEXT가 없으면 표준 입력을 끝까지 읽거나 -i로 지정한 파일을 읽습니다. 플래그는 TEXT 앞에 와도 되고 뒤에 와도 됩니다.

인코딩은 Base64 뒤에 줄 바꿈 하나를 붙여 출력합니다. 디코딩은 원시 바이트만 쓰므로 b64 -d의 출력이 바이너리 파일일 수 있습니다.

플래그

플래그의미
-d, --decodeBase64를 원시 바이트로 디코딩합니다.
-u, --urlURL-safe 알파벳(-와 _)으로 인코딩합니다.
-n, --no-pad= 패딩 없이 인코딩합니다.
-w N, --wrap N인코딩 출력을 N자마다 줄 바꿈합니다. 0(기본값)은 줄 바꿈 없음, 76은 MIME입니다.
--data-uridata: URI로 인코딩합니다. MIME 타입은 내용으로 감지합니다.
-m TYPE, --mime TYPE--data-uri에 쓸 MIME 타입입니다.
--validate입력을 검사하고 변형과 디코딩 크기를 알려 줍니다.
-i FILE, --input FILE표준 입력 대신 FILE을 읽습니다. -는 표준 입력입니다.
-o FILE, --output FILE표준 출력 대신 FILE에 씁니다. -는 표준 출력입니다.
-h, --help도움말을 표시합니다.
-v, --versionb64와 버전을 출력합니다.
--플래그의 끝입니다. 다음 인수는 -로 시작하더라도 TEXT로 처리합니다.

플래그 조합 규칙

  • 짧은 플래그는 묶어 쓸 수 없습니다. -dn은 알 수 없는 옵션입니다. 값은 공백 뒤에 쓰거나(-w 4), 긴 플래그라면 = 뒤에 씁니다(--wrap=4). -w4는 받아들이지 않습니다.
  • -u, -n, -w, --data-uri는 인코딩에만 적용되며, -d나 --validate와 함께 쓰면 사용법 오류입니다.
  • -d와 --validate는 함께 쓸 수 없습니다.
  • --data-uri는 항상 패딩이 있는 표준 알파벳을 한 줄로 쓰므로 -u, -n, -w와 함께 쓸 수 없습니다.
  • --mime에는 --data-uri가 필요합니다.
  • TEXT와 -i는 함께 쓸 수 없고 TEXT는 하나만 허용됩니다. 공백이 들어간 텍스트는 따옴표로 감싸세요.
  • URL-safe Base64처럼 -로 시작하는 TEXT는 앞에 --를 붙여야 합니다(b64 -d -- -_-_).

종료 코드와 메시지

코드의미
0성공.
1잘못된 입력, 또는 파일을 읽거나 쓸 수 없음.
2사용법 오류: 알 수 없는 플래그, 잘못된 값, 함께 쓸 수 없는 플래그.

오류는 b64: <message> 형식으로 표준 오류에 출력됩니다. --validate는 유효한 입력이면 valid (<variant>, <bytes> bytes)를 표준 출력에 쓰고, 그렇지 않으면 invalid: <reason>을 표준 오류에 쓰고 종료 코드 1로 끝납니다.

$ b64 -d 'Zm9v!'
b64: invalid character '!' at position 4
$ b64 -d 'Zm=9v'
b64: unexpected '=' at position 2: padding is only allowed at the end
$ b64 -d 'Zg==='
b64: too much padding: 3 '=' at position 2, at most 2 are allowed
$ b64 -d 'Zm9vY'
b64: invalid length: 5 characters leave a single character in the last group
$ b64 -d -u Zm9v
b64: --url only applies to encoding, not to --decode

위치는 공백, 탭, 줄 바꿈을 제거한 입력에서 0부터 셉니다.

예제

텍스트 인코딩과 디코딩:

$ b64 "Hello, hub!"
SGVsbG8sIGh1YiE=
$ b64 -d SGVsbG8sIGh1YiE=
Hello, hub!

URL-safe, 패딩이 있을 때와 없을 때:

$ printf '\xfb\xff\xbf' | b64 --url
-_-_
$ b64 --url --no-pad "Привет"
0J_RgNC40LLQtdGC
$ b64 -n f
Zg

줄 바꿈. echo가 붙이는 줄 바꿈도 함께 인코딩된다는 점에 주의하세요.

$ b64 -w 4 foobar
Zm9v
YmFy
$ echo hello | b64
aGVsbG8K

data URI, 자동 감지 또는 타입 직접 지정:

$ b64 --data-uri Hello
data:text/plain;charset=utf-8;base64,SGVsbG8=
$ b64 --data-uri -m text/csv 'a,b'
data:text/csv;base64,YSxi
$ b64 --data-uri -i logo.png -o logo.txt

디코딩은 너그럽습니다. 줄 바꿈, data: 접두사, 빠진 패딩을 받아들이며, -로 시작하는 문자열은 -- 뒤에 둡니다.

$ b64 -d 'data:text/plain;base64,SGk='
Hi
$ b64 -d -- -_-_ | xxd -p
fbffbf

스크립트에서 검증하기:

$ b64 --validate SGVsbG8sIGh1YiE=
valid (either, 11 bytes)
$ b64 --validate 'a+b_'
valid (mixed, 3 bytes)
if b64 --validate -i token.txt >/dev/null 2>&1; then
  echo "token looks like Base64"
else
  echo "token is broken" >&2
fi

파일 입력과 출력:

b64 -i photo.jpg -o photo.b64
b64 -d -i photo.b64 -o photo-copy.jpg

감지하는 MIME 타입

--mime 없이 --data-uri를 쓰면 처음 몇 바이트를 봅니다. PNG, JPEG, GIF, WebP, PDF는 시그니처로 판정하고, SVG는 텍스트가 <svg로 시작하거나 <?xml로 시작하면서 <svg를 포함할 때 판정합니다. 그 밖에 제어 문자가 없는 유효한 UTF-8 텍스트(탭, CR, LF는 괜찮음)는 text/plain;charset=utf-8이 되고, 나머지는 모두 application/octet-stream이 됩니다.

업데이트 2026. 11. 22.