파일 업로드
  1. base64hub
  2. 문서

base64hub 문서

base64hub가 웹사이트 밖에서 제공하는 모든 것의 레퍼런스입니다. 모든 제품이 같은 Base64 규칙을 따르므로 한 페이지에서 익힌 내용은 다른 페이지에서도 그대로 통합니다.

제품 고르기

하고 싶은 일사용할 것문서
터미널이나 스크립트에서 인코딩·디코딩b64 CLICLI
Node.js에서 Base64 함수 호출npm base64hubnpm 패키지
Python에서 Base64 함수 호출PyPI base64hubPython 패키지
AI 어시스턴트에 정확한 Base64 도구 제공base64hub-mcpMCP 서버
탭을 열지 않고 Chrome에서 인코딩·디코딩확장 프로그램Chrome 확장 프로그램
어떤 언어나 노코드 도구에서든 HTTP 요청https://api.base64hub.com/v1HTTP API
휴대폰에서 인코딩·디코딩@base64hubbot텔레그램 봇

모두 무료이고 MIT 라이선스이며, 런타임 의존성이 하나도 없습니다. 설치 명령과 다운로드는 다운로드 페이지에 있습니다.

공통 규칙

모든 제품이 하나의 명세와 하나의 테스트 벡터 세트를 공유하므로 결과가 바이트 단위로 일치합니다.

인코딩은 URL-safe 알파벳(-와 _)이나 패딩 없음을 요청하지 않는 한 RFC 4648의 표준 알파벳과 = 패딩을 씁니다. 줄 바꿈은 N자마다 \n을 넣되 끝에는 넣지 않으며, 76은 MIME의 줄 길이입니다. data URI는 줄 바꿈하지 않으며, MIME 타입을 주지 않으면 내용으로 감지합니다. PNG, JPEG, GIF, WebP, PDF, SVG는 시그니처로 판정하고, 그다음 UTF-8 텍스트는 text/plain;charset=utf-8, 나머지는 application/octet-stream이 됩니다.

디코딩은 일부러 너그럽게 만들었습니다.

  1. 앞뒤 공백을 잘라 내고 data:...;base64, 접두사를 제거합니다.
  2. 텍스트 안의 공백, 탭, CR, LF는 무시합니다.
  3. 끝의 = 패딩은 있어도 없어도 됩니다. =가 세 개 이상이거나 끝이 아닌 곳에 있으면 오류입니다.
  4. 두 알파벳을 모두 받아들이며, 한 문자열에 섞여 있어도 됩니다.
  5. 그 밖의 문자는 오류이고, 마지막 4자 묶음에 한 글자만 남는 길이도 오류입니다.
  6. 빈 입력은 빈 출력으로 디코딩됩니다.

오류는 왼쪽부터 차례로 보고하며, 위치는 정리한 입력에서 0부터 셉니다. CLI와 API는 다음과 같은 문구를 씁니다.

invalid character '!' at position 4
unexpected '=' at position 2: padding is only allowed at the end
too much padding: 3 '=' at position 2, at most 2 are allowed
invalid length: 5 characters leave a single character in the last group

검증은 디코딩이 성공할 때 정확히 성공합니다. 또한 variant(+나 /가 있으면 standard, -나 _가 있으면 url, 둘 다 있으면 mixed, 둘 다 없으면 either), 입력 길이가 4의 배수로 맞춰져 있는지(padded), 디코딩한 크기(bytes)를 알려 줍니다.

API JSON, MCP 결과, 봇처럼 텍스트만 보여 줄 수 있는 곳에서는 유효한 UTF-8이 아닌 디코딩 바이트를 깨진 문자 대신 16진수로 제공합니다.

웹사이트 자체

base64hub.com의 도구는 브라우저에서 실행되며 API를 호출하지 않습니다. 콘텐츠 보안 정책이 익명 페이지 조회 집계를 제외한 모든 요청을 차단합니다. 이 문서의 코드 예제는 복사해서 쓰라고 있는 것이며, 이 페이지들은 API에 아무 요청도 보내지 않습니다.

업데이트 2026. 11. 22.