온라인 Base64 인코딩·디코딩 변환기 개요
Base64(RFC 4648)는 이진(Binary) 데이터나 다국어 문자열을 제어 문자 충돌 없이 순수 ASCII 출력 가능 문자 64종(A-Z, a-z, 0-9, +, /)과 패딩 기호(=)만으로 표현하는 표준 인코딩 규격입니다. API 통신 페이로드, JSON 내부 텍스트·바이너리 필드, HTTP Basic 인증 헤더, JWT(JSON Web Token) 클레임 확인, 쿠버네티스 시크릿(Kubernetes Secret) 매니페스트, 이메일 MIME 본문 등 텍스트 기반 환경에서 데이터 손상을 막기 위해 널리 쓰입니다.
AllUtility의 Base64 인코딩·디코딩 변환기는 표준 Base64와 URL-Safe Base64 규격을 모두 지원하며, 일반 텍스트와 JSON 문자열을 즉시 상호 변환합니다. 모든 인코딩·디코딩 연산은 외부 서버로 전송되지 않고 100% 사용자의 브라우저 로컬 메모리에서만 실행되므로 민감한 토큰이나 사내 설정 데이터도 안전하게 다룰 수 있습니다.
UTF-8 한글 깨짐 원인과 해결 원리
웹이나 개발 환경에서 Base64를 다룰 때 가장 흔히 겪는 문제가 한글 깨짐 현상입니다. 대표적으로 다음 두 가지 원인 때문에 한글이 깨지거나 변환 오류가 발생합니다.
- 브라우저 기본 함수(
btoa/atob)의 1바이트 Latin-1 한계: 자바스크립트 내장 함수btoa()와atob()는 각 문자의 코드 포인트가0x00~0xFF(1바이트 Latin-1 범위)인 경우만 전제로 설계되었습니다. 여기에 3바이트 UTF-8 문자인 한글을 그대로 넣으면btoa()는 예외(InvalidCharacterError)를 일으키고,atob()로 디코딩하면 3바이트 시퀀스가 1바이트 문자 3개로 잘못 쪼개져가나다같은 깨진 문자가 출력됩니다. - UTF-8과 EUC-KR 인코딩 방식 불일치: 원문은 EUC-KR(한글 2바이트)로 인코딩되었는데 디코더가 UTF-8(한글 3바이트)로 해석하거나, 반대로 UTF-8 바이트 시퀀스를 레거시 인코딩으로 읽으면 바이트 경계가 어긋나 글자가 완전히 깨집니다.
AllUtility는 UTF-8 바이트 스트림 직렬화 파이프라인으로 이 문제를 근본적으로 해결합니다.
- 인코딩 시: 입력 문자열을 먼저
TextEncoder기반의 UTF-8 바이트 배열(Uint8Array)로 변환한 뒤, 24비트(3바이트) 단위를 6비트씩 4개의 Base64 문자로 매핑합니다. - 디코딩 시: Base64 문자열의 공백·줄바꿈과 URL-Safe 문자를 정규화한 뒤 원본 바이트 스트림(
Uint8Array)으로 복원하고,TextDecoder('utf-8')로 멀티바이트 경계를 맞춰 재조합함으로써 한글·한자·일본어·이모지를 손실 없이 복원합니다.
핵심 기능
- UTF-8 한글 깨짐 완벽 해결: 바이트 스트림 기반 인코딩·디코딩으로 한글, 한자, 특수기호, 이모지가 섞인 텍스트와 JSON도 손상 없이 변환합니다.
- 표준 Base64 · URL-Safe 모드 전환: 상단 탭에서 일반 표준 규격(
+,/,=)과 URL·파일명·JWT에 적합한 URL-Safe 규격(-,_, 패딩 생략 가능)을 클릭 한 번으로 전환할 수 있습니다. - 줄바꿈·공백 자동 정제 디코딩: 인증서 파일이나 이메일 본문처럼 여러 줄로 나뉜 Base64 코드를 붙여넣어도 공백과 개행을 자동 정리해 정확히 해독합니다.
- 입출력 전환(Swap) 및 실시간 바이트 확인: 입력과 출력 영역의 문자 수와 바이트(
B) 크기를 실시간으로 표시하며, 전환 버튼과 원클릭 클립보드 복사를 제공합니다. - 100% 브라우저 로컬 처리: 서버 전송이나 로그 저장 없이 오직 사용자 기기의 브라우저 내부에서만 변환이 이루어집니다.
단계별 사용 방법
- 규격 탭 선택: 상단 필터 바에서 일반 작업용 표준(Standard) 또는 URL·JWT용 URL-Safe 모드를 선택합니다.
- 텍스트 또는 Base64 입력: 좌측 입력창에 인코딩할 일반 텍스트·JSON을 입력하거나, 디코딩할 Base64 문자열을 붙여넣습니다.
- 인코딩 또는 디코딩 실행: 상단 도구 모음에서 인코딩(Encode) 또는 디코딩(Decode) 버튼을 누르면 우측 결과창에 변환 결과와 바이트 크기가 즉시 표시됩니다.
- 결과 검증 및 복사: 전환(Swap) 버튼으로 결과를 다시 입력창으로 옮겨 왕복 검증하거나, 복사(Copy) 버튼으로 코드·설정 파일에 바로 붙여넣으세요.
실전 변환 예제 및 표준 규격 비교
Base64는 3바이트(24비트) 입력 데이터를 4개의 ASCII 문자로 표현하므로 인코딩 결과 길이는 원본 바이트 대비 약 33% 늘어납니다.
원문 (UTF-8 한글 포함):
AllUtility Base64 한글 테스트!
표준 Base64 인코딩 결과:
QWxsVXRpbGl0eSBCYXNlNjQg7ZWc6riAIO2FjOyKpO2KuCE=
URL-Safe Base64 인코딩 결과 (+ -> -, / -> _, 끝부분 = 패딩 제거):
QWxsVXRpbGl0eSBCYXNlNjQg7ZWc6riAIO2FjOyKpO2KuCE
실무 적용 시 아래 두 가지 주의사항을 함께 점검하는 것이 좋습니다.
- Base64는 암호화가 아닌 인코딩입니다: 변환 결과가 읽을 수 없는 문자열처럼 보여도 비밀 키 없이 누구나 즉시 원문으로 디코딩할 수 있습니다. 비밀번호나 개인정보 보호에는 반드시 HTTPS(TLS) 전송과 AES 암호화 또는 단방향 해시를 적용해야 합니다.
- 표준 Base64 대 URL-Safe Base64: URL 쿼리 파라미터나 경로에 표준 Base64의
+,/,=기호를 그대로 넣으면 퍼센트 인코딩(%2B,%2F)이나 경로 분리가 발생해 파싱 오류가 날 수 있으므로, 웹 주소나 JWT 토큰에서는 URL-Safe 규격을 사용해야 합니다.