Base64 인코더 · 디코더

다국어 UTF-8 텍스트를 손실 없이 Base64 문자열로 인코딩하거나 원문으로 해독합니다.

Base64 · 인코딩 · UTF-8

도구 작업 공간을 불러오는 중입니다...

온라인 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를 다룰 때 가장 흔히 겪는 문제가 한글 깨짐 현상입니다. 대표적으로 다음 두 가지 원인 때문에 한글이 깨지거나 변환 오류가 발생합니다.

  1. 브라우저 기본 함수(btoa / atob)의 1바이트 Latin-1 한계: 자바스크립트 내장 함수 btoa()와 atob()는 각 문자의 코드 포인트가 0x00~0xFF(1바이트 Latin-1 범위)인 경우만 전제로 설계되었습니다. 여기에 3바이트 UTF-8 문자인 한글을 그대로 넣으면 btoa()는 예외(InvalidCharacterError)를 일으키고, atob()로 디코딩하면 3바이트 시퀀스가 1바이트 문자 3개로 잘못 쪼개져 가나다 같은 깨진 문자가 출력됩니다.
  2. 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% 브라우저 로컬 처리: 서버 전송이나 로그 저장 없이 오직 사용자 기기의 브라우저 내부에서만 변환이 이루어집니다.

단계별 사용 방법

  1. 규격 탭 선택: 상단 필터 바에서 일반 작업용 표준(Standard) 또는 URL·JWT용 URL-Safe 모드를 선택합니다.
  2. 텍스트 또는 Base64 입력: 좌측 입력창에 인코딩할 일반 텍스트·JSON을 입력하거나, 디코딩할 Base64 문자열을 붙여넣습니다.
  3. 인코딩 또는 디코딩 실행: 상단 도구 모음에서 인코딩(Encode) 또는 디코딩(Decode) 버튼을 누르면 우측 결과창에 변환 결과와 바이트 크기가 즉시 표시됩니다.
  4. 결과 검증 및 복사: 전환(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 규격을 사용해야 합니다.

자주 묻는 질문

Base64 디코딩 시 한글이 깨지는 이유와 UTF-8 한글 깨짐 해결 방법은 무엇인가요?

기존 변환기나 단순 atob()/btoa() 코드는 한글 같은 멀티바이트 문자를 1바이트 Latin-1 문자열로 잘못 처리하기 때문에 한글이 깨지거나 오류가 발생합니다. UTF-8 바이트 배열(Uint8Array) 단위로 먼저 해독한 뒤 UTF-8 디코더로 문자를 재조합하면 한글 깨짐 없이 원문을 복원할 수 있으며, AllUtility는 이 바이트 스트림 방식을 기본으로 사용합니다.

일반 Base64와 URL-Safe Base64 인코딩·디코딩의 차이는 무엇인가요?

표준 Base64는 62·63번째 문자로 +와 /를 사용하고 길이를 맞추기 위해 끝에 = 패딩을 붙입니다. 반면 URL-Safe Base64는 URL 예약 문자 충돌을 막기 위해 +를 -로, /를 _로 치환하고 상황에 따라 = 패딩을 생략하며, JWT 토큰이나 OAuth 인증 파라미터에서 표준으로 사용됩니다.

Base64 문자열 끝에 붙는 = 또는 == 패딩 기호는 무슨 의미인가요?

Base64는 원본 데이터를 3바이트(24비트) 묶음으로 나누어 4글자로 인코딩합니다. 전체 바이트 수가 3의 배수로 떨어지지 않아 마지막 블록이 1바이트 또는 2바이트만 남으면, 4글자 블록 규칙을 맞추기 위해 빈 자리에 각각 == 또는 = 패딩을 채워 넣습니다.

JSON이나 JWT 페이로드를 Base64 인코딩·디코딩할 때 서버로 데이터가 전송되나요?

아니요, 전혀 전송되지 않습니다. 모든 Base64 인코딩·디코딩 연산은 사용자의 웹 브라우저 메모리 내부에서 100% 로컬로 처리되므로, API 키가 포함된 JSON이나 쿠버네티스 시크릿 값도 외부 유출 걱정 없이 확인할 수 있습니다.

비밀번호나 민감한 정보를 Base64로 인코딩해서 보관하면 안전한가요?

안전하지 않습니다. Base64는 데이터를 텍스트 채널에서 안전하게 전달하기 위한 공개 인코딩 방식(RFC 4648)일 뿐 암호화(Encryption)가 아닙니다. 누구나 디코딩 한 번으로 원문을 확인할 수 있으므로 보안 저장 용도로는 반드시 암호화 알고리즘이나 솔트 기반 해시 함수를 사용해야 합니다.