Base64는 개발 중 정말 자주 마주칩니다.
- API token
- Basic Auth
- JWT segment
- 작은 바이너리 데이터
- 설정 파일에 들어간 encoded string
문제는 Base64 자체보다 “이 값이 어떤 바이트였는지” 확인해야 할 때가 많다는 점입니다.
그래서 만든 도구가 Base64 String and Binary Converter입니다.
어떤 도구인가
이 도구는 문자열과 Base64 사이를 변환하고, 결과 바이트를 함께 보여줍니다.
주요 기능은 이렇습니다.
- Text to Base64
- Base64 to Text
- UTF-8 decode
- byte inspector
- hex output
- binary output
- URL-safe alphabet 옵션
- padding 생략 옵션
- line wrapping 옵션
계산은 브라우저 안에서만 처리합니다.
기본 사용법
텍스트를 Base64로 바꾸려면:
Text to Base64모드를 선택합니다.- 입력창에 문자열을 넣습니다.
- 결과 Base64와 byte inspector를 확인합니다.
Copy result로 결과를 복사합니다.
반대로 Base64를 읽으려면:
Base64 to Text모드로 바꿉니다.- Base64 문자열을 붙여 넣습니다.
- decoded UTF-8 text를 확인합니다.
- 깨지는 문자가 있으면 byte view를 같이 봅니다.
URL-safe Base64
일반 Base64는 +, /, = 문자를 사용할 수 있습니다.
하지만 URL이나 JWT에서는 URL-safe variant가 자주 쓰입니다.
+ / -> - _
padding = 생략 가능
그래서 JWT segment를 볼 때는 URL-safe 옵션이 중요합니다.
일반 Base64 decoder에 JWT payload를 넣으면 padding 문제나 alphabet 차이 때문에 실패할 수 있습니다.
byte inspector가 필요한 이유
문자열은 눈에 보이지만 실제 저장되는 값은 바이트입니다.
특히 한글이나 이모지처럼 UTF-8에서 여러 byte를 쓰는 문자는 Base64 결과가 예상보다 길어질 수 있습니다.
byte inspector를 보면:
- 원본 문자열의 UTF-8 byte
- hex 표현
- binary 표현
을 같이 확인할 수 있습니다.
encoding 문제를 잡을 때 “글자는 같은데 byte가 다름” 같은 상황을 빠르게 볼 수 있습니다.
오류가 날 때 확인할 것
Base64 decode가 실패하면 보통 아래 중 하나입니다.
- 잘못된 문자 포함
- padding 누락
- URL-safe variant를 일반 Base64로 처리
- 줄바꿈이나 공백 포함
- 실제로는 Base64가 아닌 값
도구에서는 잘못된 입력을 넣으면 오류 메시지를 표시하고 결과를 비웁니다.
한 줄 요약
Base64 String and Binary Converter는 텍스트와 Base64를 변환하면서 UTF-8 byte, hex, binary 값을 함께 확인하는 브라우저 기반 인코딩 도구입니다.