base64hub 문서
base64hub가 웹사이트 밖에서 제공하는 모든 것의 레퍼런스입니다. 모든 제품이 같은 Base64 규칙을 따르므로 한 페이지에서 익힌 내용은 다른 페이지에서도 그대로 통합니다.
제품 고르기
| 하고 싶은 일 | 사용할 것 | 문서 |
|---|---|---|
| 터미널이나 스크립트에서 인코딩·디코딩 | b64 CLI | CLI |
| Node.js에서 Base64 함수 호출 | npm base64hub | npm 패키지 |
| Python에서 Base64 함수 호출 | PyPI base64hub | Python 패키지 |
| AI 어시스턴트에 정확한 Base64 도구 제공 | base64hub-mcp | MCP 서버 |
| 탭을 열지 않고 Chrome에서 인코딩·디코딩 | 확장 프로그램 | Chrome 확장 프로그램 |
| 어떤 언어나 노코드 도구에서든 HTTP 요청 | https://api.base64hub.com/v1 | HTTP 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이 됩니다.
디코딩은 일부러 너그럽게 만들었습니다.
- 앞뒤 공백을 잘라 내고
data:...;base64,접두사를 제거합니다. - 텍스트 안의 공백, 탭, CR, LF는 무시합니다.
- 끝의
=패딩은 있어도 없어도 됩니다.=가 세 개 이상이거나 끝이 아닌 곳에 있으면 오류입니다. - 두 알파벳을 모두 받아들이며, 한 문자열에 섞여 있어도 됩니다.
- 그 밖의 문자는 오류이고, 마지막 4자 묶음에 한 글자만 남는 길이도 오류입니다.
- 빈 입력은 빈 출력으로 디코딩됩니다.
오류는 왼쪽부터 차례로 보고하며, 위치는 정리한 입력에서 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.