tools / base64
base64/
텍스트·파일·이미지와 Base64를 상호 변환합니다. UTF-8, URL 안전 형식 지원.
원문
Base64
자주 묻는 질문
디코딩할 때 "Base64가 아닌 문자가 포함되어 있습니다" 또는 "길이가 올바르지 않습니다"가 나오면 어떻게 하나요?
먼저 내용이 빠짐없이 깨끗한지 확인하세요. 인식하는 문자는 A–Z, a–z, 0–9, +, /이고 URL 안전 형식의 -와 _도 알아보며, =는 맨 끝에만 올 수 있습니다. 공백, 줄바꿈, 맨 앞의 data:...;base64,는 자동으로 무시합니다. 전각 기호, 따옴표, %2B 같은 URL 인코딩 잔여물이 있으면 "Base64가 아닌 문자가 포함되어 있습니다"가 나오고, "길이가 올바르지 않습니다"는 대개 복사하다가 문자가 빠졌다는 뜻입니다.
디코딩 후 "UTF-8 텍스트가 아닙니다"가 나오거나 글자가 깨져 보이면 어떻게 하나요?
디코딩된 바이트가 UTF-8 텍스트가 아니라는 뜻입니다. 원문이 GBK 같은 다른 인코딩이었거나, 이미지·압축 파일·암호화 데이터처럼 처음부터 바이너리인 경우가 많습니다. 이 도구는 UTF-8 텍스트만 표시하고 다른 인코딩을 억지로 깨진 글자로 보여 주지 않습니다. 바이너리는 "파일 다운로드"로 저장할 수 있고, GBK 텍스트는 GBK 변환을 지원하는 다른 도구가 필요합니다.
인코딩 결과가 JS, Python, 명령줄에서 계산한 값과 다른 이유는 무엇인가요?
가장 흔한 원인은 끝의 줄바꿈이나 문자 인코딩 차이입니다. 이 도구는 입력란의 내용을 UTF-8 그대로 인코딩하며 앞뒤 공백과 줄바꿈도 지우지 않습니다. 반면 명령줄의 echo는 기본적으로 끝에 줄바꿈을 붙이므로 echo -n을 써야 같은 결과가 나옵니다. 한글이나 이모지는 상대방도 UTF-8을 쓰는지 확인하세요. JavaScript의 btoa에 그대로 넣으면 오류가 나고, Python에서는 encode('utf-8')한 뒤 b64encode해야 합니다.
끝의 =를 지워도 되나요? "URL 안전"은 무엇인가요?
디코딩할 때는 =가 없어도 되며 이 도구가 자동으로 채워 줍니다. 다만 보낼 때 생략해도 되는지는 받는 쪽에 따라 다르고, 반드시 있어야 하는 라이브러리도 있습니다. "URL 안전" 모드는 +를 -로, /를 _로 바꾸고 끝의 =를 없앤 형식이라 URL 파라미터나 파일 이름에 알맞으며 JWT도 이 형식을 씁니다. 디코딩할 때는 -와 _를 자동으로 알아보므로 따로 전환할 필요가 없습니다.
파일을 Base64로 변환할 때 크기 제한이 있나요?
있습니다. 파일 하나당 최대 20 MB이고, 넘으면 파일이 너무 크다는 안내가 나옵니다. 출력은 기본적으로 data:image/png;base64, 같은 접두어가 붙은 Data URL이라 웹 페이지의 이미지 주소나 CSS에 바로 쓸 수 있습니다. 순수한 Base64만 필요하면 쉼표 앞부분을 지우세요. Base64로 바꾸면 크기가 약 3분의 1 늘어나므로 큰 이미지를 넣는 것은 권하지 않습니다.
Base64를 이미지나 파일로 되돌리려면 어떻게 하나요?
"디코딩"으로 바꾸고 Base64 또는 전체 Data URL을 붙여넣으세요. 이미지(PNG, JPEG, GIF, WebP)로 인식되면 미리보기가 나오고, 텍스트는 그대로 표시되며, 그 밖의 바이너리는 크기만 보여 줍니다. 어느 경우든 "파일 다운로드"로 저장할 수 있고, 이미지는 형식에 맞는 확장자로, 나머지는 decoded.bin으로 저장되므로 필요하면 확장자를 직접 고치세요.
Base64는 암호화인가요? 비밀을 지키는 데 쓸 수 있나요?
아니요. Base64는 바이트를 출력 가능한 문자로 바꾸는 인코딩일 뿐이라 누구나 원래대로 되돌릴 수 있습니다. 키도 없고 비밀을 지켜 주는 효과도 없습니다. 기밀이 필요하면 AES 같은 진짜 암호화 알고리즘을 쓰세요.
입력한 텍스트와 파일이 업로드되나요?
아니요. 인코딩과 디코딩은 모두 브라우저에서 이루어지고, 선택한 파일도 내 기기에서만 읽을 뿐 서버로 전송되지 않습니다.