Base64 인코딩·디코딩 방법
텍스트 인코딩: 인코딩을 고르고 글을 입력하거나 붙여넣으면 Base64 결과가 바로 나옵니다.
Base64 디코딩: 디코딩을 고르고 Base64 문자열을 붙여넣으세요. data:로 시작하는 URL을 통째로 붙여넣어도 앞부분은 자동으로 제거됩니다. 결과가 읽을 수 있는 텍스트면 바로 보여 주고, 이미지나 다른 파일이면 미리보기(이미지인 경우)와 파일 다운로드 버튼이 나옵니다.
파일 인코딩: 인코딩 모드에서 아래의 파일을 Base64로 인코딩으로 내려가 20MB 이하 파일을 고르고 결과를 복사하세요. 바로 쓸 수 있는 data: URL 형식으로 받을 수도 있습니다.
이런 데 쓰여요
- HTML이나 CSS에 data URL로 이미지 넣기 (예:
background-image: url(data:image/png;base64,...)) - 텍스트만 다루는 JSON API로 바이너리 데이터 보내기
- 토큰 살펴보기 — JWT의 각 부분은 URL-safe Base64로 인코딩된 JSON입니다
- 뒤에서 Base64로 인코딩되는 메일 첨부파일
아이디:비밀번호를 Base64로 인코딩하는 기본 인증(Basic Auth) 헤더- 로그, 쿠키, 설정 파일 속 인코딩된 값 디버깅
Base64의 원리
Base64는 입력을 3바이트(24비트)씩 묶어 6비트씩 네 덩어리로 나눕니다. 6비트 값(0~63)마다 64개 문자 중 하나를 대응시킵니다. 입력 길이가 3의 배수가 아니면 끝에 =를 붙여 길이를 맞춥니다.
3바이트가 4글자가 되므로 Base64 결과는 원본보다 약 33% 큽니다. 그래서 큰 이미지를 data URL로 넣으면 성능에 좋지 않고, 작은 아이콘 정도에만 쓰는 게 좋습니다.
일반 Base64와 URL-safe
| 방식 | 62·63번 문자 | 패딩 | 쓰이는 곳 |
|---|---|---|---|
| 일반 | +, / |
= |
메일, data URL, 대부분의 API |
| URL-safe | -, _ |
보통 생략 | JWT, URL, 파일 이름 |
디코딩할 때는 두 방식을 자동으로 구분하고, 패딩이 빠졌거나 공백·줄바꿈이 섞여 있어도 처리합니다. 메일이나 로그에서 Base64를 복사하면 이런 일이 흔합니다.
이미지를 Base64로 (data URL)
작은 이미지를 HTML이나 CSS에 직접 넣으려면 data: URL 형식으로를 켜고 이미지 파일을 인코딩한 뒤 복사하세요. 이렇게 쓸 수 있습니다.
- HTML:
<img src="data:image/png;base64,iVBOR..." alt=""> - CSS:
background-image: url("data:image/png;base64,iVBOR...")
요청 하나를 줄일 수 있어 아주 작은 아이콘에는 도움이 됩니다. 몇 KB를 넘는 이미지는 일반 이미지 파일이 더 낫습니다. 따로 캐시될 수 있고 HTML이나 CSS가 3분의 1만큼 무거워지지 않기 때문입니다. 대략 4KB 이하의 작은 아이콘, 자리 표시 이미지, 외부 이미지가 차단될 수 있는 메일 템플릿에만 쓰는 것을 권합니다.
Base64는 암호화가 아닙니다
다시 강조하지만 Base64는 아무것도 숨기지 않습니다. 텍스트만 받는 시스템을 안전하게 통과하도록 데이터를 다른 문자로 적을 뿐이고, 누구나 1초 만에 풀 수 있습니다. 비밀 정보를 보호하려면 진짜 암호화를 쓰고, 기본 인증 헤더처럼 Base64로 인코딩된 계정 정보도 평문과 똑같이 조심해서 다뤄야 합니다.
문제가 생겼을 때
- “Base64에 쓸 수 없는 문자가 들어 있습니다” — 앞뒤에 따옴표나 다른 글이 섞여 있는지 확인하세요.
- “길이가 올바르지 않습니다” — 복사하다가 중간에 잘렸을 가능성이 큽니다.
- 디코딩 결과가 깨진 글자처럼 보여요 — 바이너리 데이터이거나 다른 문자 인코딩으로 만든 텍스트입니다. 파일 다운로드로 원본 바이트를 저장하세요.
내 기기에서만 처리
인코딩과 디코딩은 모두 브라우저에서 이루어집니다. 서버로 보내면 안 되는 토큰, 계정 정보, 개인 파일을 다룰 때 특히 중요합니다. 디코딩한 JSON을 보기 좋게 정리하려면 JSON 포매터를 쓰세요.