Base64 인코딩 및 디코딩: 언제, 어떻게 사용할까

2026년 3월 31일 · 12분 읽기

Base64 인코딩이란?

Base64는 바이너리 데이터를 ASCII 문자열로 변환하는 바이너리-텍스트 인코딩 방식입니다. 64개의 출력 가능한 문자(A-Z, a-z, 0-9, +, /)와 패딩을 위한 등호(=)를 사용합니다. "Base64"라는 이름은 바이너리 데이터를 표현하기 위해 64개의 고유한 문자를 기반으로 사용한다는 데서 유래했습니다.

Base64가 필수적인 이유는 다음과 같습니다: 텍스트 전용으로 설계된 시스템을 통해 바이너리 데이터를 안전하게 전송할 수 있게 해줍니다. Base64 이전에는 이메일을 통해 이미지를 보내거나 JSON에 바이너리 데이터를 포함하면 데이터가 손상되거나 시스템이 완전히 중단되었습니다.

Base64는 암호화가 아닙니다 — 이것은 중요한 구분입니다. 보안이나 난독화를 전혀 제공하지 않습니다. 누구나 키나 비밀번호 없이 즉시 Base64를 디코딩할 수 있습니다. 이것은 기밀성이 아닌 호환성을 위해 설계된 순수한 인코딩 방식입니다.

여러분은 매일 Base64를 접하고 있으며, 종종 인식하지 못한 채로:

• MIME 인코딩을 통해 전송되는 이메일 첨부파일
• HTML과 CSS에 직접 이미지를 포함하는 데이터 URL
• 인증에 사용되는 JWT(JSON Web Token)
• API 인증 헤더(Basic Auth)
• 웹 애플리케이션에 포함된 폰트 및 자산
• JSON 또는 XML 문서에 저장된 바이너리 데이터
• 인증서 파일 및 암호화 키

Base64의 내부 작동 원리

Base64는 입력 데이터의 3바이트(24비트)를 4개의 문자(각 6비트)로 변환합니다. 이 수학적 관계는 Base64가 텍스트로 변환하면서 데이터 무결성을 유지하는 방법의 기초입니다.

"Hi" 텍스트를 인코딩하는 완전한 예제를 살펴보겠습니다:

1. ASCII 바이트로 변환: "Hi"는 72, 105가 됩니다
2. 이진수로 변환: 01001000 01101001 (총 16비트)
3. 6비트 청크로 그룹화: 010010 | 000110 | 1001xx
4. 불완전한 그룹 패딩: 010010 | 000110 | 100100
5. Base64 알파벳에 매핑: S (18), G (6), k (36)
6. 패딩 문자 추가: SGk=

패딩 문자(=)는 최종 그룹에서 누락된 바이트 수를 나타냅니다. =가 하나면 1바이트가 누락되었고, =가 두 개면 2바이트가 누락되었음을 의미합니다.

Base64 문자 집합

표준 Base64 인코딩에 사용되는 64개의 문자는 다양한 시스템에서 보편적으로 안전하도록 신중하게 선택되었습니다:

크기 트레이드오프

3개의 입력 바이트가 4개의 출력 문자가 되므로, Base64는 데이터 크기를 약 33% 증가시킵니다. 이것은 텍스트 안전 전송을 달성하기 위한 근본적인 트레이드오프입니다.

예를 들어:

• 3KB 바이너리 파일은 Base64 인코딩 시 4KB가 됩니다
• 100KB 이미지는 133KB가 됩니다
• 1MB PDF는 1.33MB가 됩니다

이러한 크기 증가는 Base64가 사용 사례에 적합한지 결정할 때 고려해야 할 중요한 사항입니다.

Base64를 사용해야 할 때

Base64는 바이너리 데이터가 텍스트 전용 시스템을 통과해야 하는 특정 시나리오에서 빛을 발합니다. 이러한 사용 사례를 이해하면 인코딩이 적절한 시기에 대해 정보에 입각한 결정을 내리는 데 도움이 됩니다.

이메일 첨부파일 및 MIME

SMTP(Simple Mail Transfer Protocol)는 1982년에 7비트 ASCII 텍스트 전용으로 설계되었습니다. 이메일에 PDF, 이미지 또는 바이너리 파일을 첨부하면 이메일 클라이언트가 자동으로 Base64로 인코딩합니다.

MIME(Multipurpose Internet Mail Extensions) 표준은 바이너리 첨부파일의 주요 인코딩 방법으로 Base64를 사용합니다. 이를 통해 파일이 통과하는 이메일 서버와 관계없이 파일이 온전하게 도착하도록 보장합니다.

웹 개발에서의 데이터 URL

데이터 URL을 사용하면 별도의 HTTP 요청을 하는 대신 HTML, CSS 또는 JavaScript에 작은 파일을 직접 포함할 수 있습니다. 이는 특히 다음과 같은 경우에 유용합니다:

• 작은 아이콘 및 로고(5KB 미만)
• 로딩 스피너 및 UI 요소
• 인라인 SVG 대안
• 중요한 CSS 배경 이미지

데이터 URL 구조 예제:

data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAUA...

API 인증

HTTP Basic Authentication은 자격 증명을 Base64 형식으로 인코딩합니다. 사용자 이름과 비밀번호를 보낼 때 콜론으로 결합되고 Base64로 인코딩됩니다:

Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=

이 인코딩은 헤더를 HTTP 전송에 안전하게 만들지만, 자격 증명은 쉽게 디코딩됩니다(따라서 HTTPS가 필수적입니다).

JSON 및 XML 데이터 전송

JSON과 XML은 바이너리 데이터를 직접 포함할 수 없는 텍스트 기반 형식입니다. 이러한 형식에 바이너리 콘텐츠를 포함해야 할 때 Base64 인코딩이 표준 솔루션입니다:

• MongoDB 문서에 이미지 저장
• REST API를 통한 파일 업로드 전송
• 구성 파일에 바이너리 데이터 포함
• JSON Web Keys(JWK)에 인증서 포함

JWT 토큰

JSON Web Token은 헤더, 페이로드, 서명의 세 가지 구성 요소에 Base64URL 인코딩(URL 안전 변형)을 사용합니다. 이를 통해 JWT를 URL, HTTP 헤더 및 쿠키에서 안전하게 전송할 수 있습니다.

JavaScript에서의 Base64

JavaScript는 Base64 인코딩 및 디코딩을 위한 내장 함수를 제공하지만, 브라우저와 Node.js 환경에서 다르게 작동합니다.

브라우저 환경

최신 브라우저에는 btoa()(binary to ASCII) 및 atob()(ASCII to binary) 함수가 포함되어 있습니다:

// 인코딩
const encoded = btoa('Hello, World!');
console.log(encoded); // SGVsbG8sIFdvcmxkIQ==

// 디코딩
const decoded = atob('SGVsbG8sIFdvcmxkIQ==');
console.log(decoded); // Hello, World!

중요한 제한사항: btoa()는 Latin1 범위(0-255)의 문자를 포함하는 문자열에서만 작동합니다. 유니코드 문자열의 경우 추가 단계가 필요합니다:

// 유니코드 문자열 인코딩
function encodeUnicode(str) {
  return btoa(encodeURIComponent(str).replace(/%([0-9A-F]{2})/g,
    (match, p1) => String.fromCharCode('0x' + p1)
  ));
}

// 유니코드 문자열 디코딩
function decodeUnicode(str) {
  return decodeURIComponent(atob(str).split('').map(c =>
    '%' + ('00' + c.charCodeAt(0).toString(16)).slice(-2)
  ).join(''));
}

const encoded = encodeUnicode('Hello 世界');
console.log(encoded); // SGVsbG8g5LiW55WM

Node.js 환경

Node.js는 Base64 작업에 Buffer API를 사용하며, 바이너리 데이터와 유니코드를 올바르게 처리합니다:

// 인코딩
const encoded = Buffer.from('Hello, World!').toString('base64');
console.log(encoded); // SGVsbG8sIFdvcmxkIQ==

// 디코딩
const decoded = Buffer.from('SGVsbG8sIFdvcmxkIQ==', 'base64').toString('utf8');
console.log(decoded); // Hello, World!

// 유니코드와 완벽하게 작동
const unicodeEncoded = Buffer.from('Hello 世界').toString('base64');
console.log(unicodeEncoded); // SGVsbG8g5LiW55WM

Node.js에서 파일 인코딩

Node.js로 파일을 읽고 인코딩하는 것은 간단합니다:

const fs = require('fs');

// 파일 읽기 및 인코딩
const fileBuffer = fs.readFileSync('image.png');
const base64Image = fileBuffer.toString('base64');

// 인코딩된 데이터 저장
fs.writeFileSync('image.txt', base64Image);

// 디코딩 및 저장
const decodedBuffer = Buffer.from(base64Image, 'base64');
fs.writeFileSync('image-copy.png', decodedBuffer);

Python에서의 Base64

Python의 base64 모듈은 뛰어난 유니코드 지원과 함께 포괄적인 인코딩 및 디코딩 기능을 제공합니다.

기본 인코딩 및 디코딩

import base64

# 문자열 인코딩
text = "Hello, World!"
encoded = base64.b64encode(text.encode('utf-8'))
print(encoded)  # b'SGVsbG8sIFdvcmxkIQ=='

# 디코딩
decoded = base64.b64decode(encoded).decode('utf-8')
print(decoded)  # Hello, World!

# 유니코드가 원활하게 작동
unicode_text = "Hello 世界"
encoded_unicode = base64.b64encode(unicode_text.encode('utf-8'))
print(encoded_unicode)  # b'SGVsbG8g5LiW55WM'

파일 작업

Python은 파일 인코딩 및 디코딩을 간단하게 만듭니다:

import base64

# 파일 인코딩
with open('image.png', 'rb') as file:
    encoded = base64.b64encode(file.read())
    
with open('image.txt', 'wb') as file:
    file.write(encoded)

# 파일 디코딩
with open('image.txt', 'rb') as file:
    decoded = base64.b64decode(file.read())
    
with open('image-copy.png', 'wb') as file:
    file.write(decoded)

URL 안전 인코딩

Python에는 문제가 되는 문자를 대체하는 URL 안전 Base64 변형이 포함되어 있습니다:

import base64

text = "Hello, World!"
encoded_bytes = text.encode('utf-8')

# 표준 Base64
standard = base64.b64encode(encoded_bytes)
print(standard)  # b'SGVsbG8sIFdvcmxkIQ=='

# URL 안전 Base64 (+를 -로, /를 _로 대체)
urlsafe = base64.urlsafe_b64encode(encoded_bytes)
print(urlsafe)  # b'SGVsbG8sIFdvcmxkIQ=='

# URL 안전 디코딩
decoded = base64.urlsafe_b64decode(urlsafe).decode('utf-8')
print(decoded)  # Hello, World!

데이터 URL 인코딩

웹 사용을 위한 Python에서 데이터 URL 생성:

import base64
import mimetypes

def create_data_url(filepath):
    mime_type, _ = mimetypes.guess_type(filepath)
    with open(filepath, 'rb') as file:
        encoded = base64.b64encode(file.read()).decode('utf-8')
    return f"data:{mime_type};base64,{encoded}"

# 사용법
data_url = create_data_url('logo.png')
print(data_url[:50])  # data:image/png;base64,iVBORw0KGgoAAAANSUhEU...

커맨드 라인에서의 Base64

Unix 계열 시스템에는 터미널에서 직접 빠른 인코딩 및 디코딩 작업을 위한 base64 명령이 포함되어 있습니다.

기본 사용법

# 문자열 인코딩
echo "Hello, World!" | base64
# 출력: SGVsbG8sIFdvcmxkIQo=

# 문자열 디코딩
echo "SGVsbG8sIFdvcmxkIQo=" | base64 -d
# 출력: Hello, World!

# 파일 인코딩
base64 image.png > image.txt

# 파일 디코딩
base64 -d image.txt > image-copy.png

# 줄 바꿈 없이 인코딩 (데이터 URL에 유용)
base64 -w 0 image.png > image-oneline.txt

macOS 차이점

macOS에서 base64 명령은 약간 다른 옵션을 가지고 있습니다:

# macOS에서 디코딩
base64 -D image.txt > image-copy.png

# macOS에서 줄 바꿈 없이 인코딩
base64 -b 0 image.png > image-oneline.txt

실용적인 커맨드 라인 예제

# 이미지에서 데이터 URL 생성
echo "data:image/png;base64,$(base64 -w 0 logo.png)"

# 클립보드 내용 인코딩 (xclip이 있는 Linux)
xclip -o | base64

# 빠른 API 인증 헤더
echo -n "username:password" | base64
# 출력: dXNlcm5hbWU6cGFzc3dvcmQ=

# 인코딩/디코딩 후 파일 무결성 확인
md5sum original.pdf
base64 original.pdf | base64 -d | md5sum
# 두 체크섬이 일치해야 함

데이터 URL 및 인라인 이미지

데이터 URL은 Base64 인코딩을 사용하여 HTML, CSS 또는 JavaScript에 파일 콘텐츠를 직접 포함합니다. 이것은