htpasswd 생성기

Basic 인증용 htpasswd 줄을 bcrypt $2y$, SHA-512 crypt, APR1 등으로 만들고, Apache와 Nginx가 읽는 형식을 확인하며, 기존 파일로 비밀번호를 검증하고 사용자를 추가·삭제합니다.

  • 브라우저에서 처리
  • 도구 입력을 ZeroTool 서버에 업로드하지 않습니다
  • 무료 · 회원가입 불필요
사용자 이름은 UTF-8 기준 최대 255바이트입니다. 콜론, 맨 앞의 #, 제어 문자, 앞뒤 공백은 해시 전에 거부합니다.
비밀번호를 입력하거나 무작위로 20자를 만드세요. UTF-8로 해시하며 bcrypt는 앞 72바이트, CRYPT는 앞 8바이트를 씁니다. 255바이트를 넘으면 거부합니다.
서버가 읽을 수 있는 형식을 고른 뒤 생성을 누르세요. 결과 영역에 호환성 설명이 표시됩니다. 이전용인 안전하지 않은 형식은 별도 그룹에 있습니다.
해시 설정
bcrypt 비용은 4~17이고 기본값은 10입니다. 값이 클수록 오래 걸리며 17은 이 탭에서 여러 초가 걸릴 수 있습니다.

해시 계산은 이 탭 안에서 합니다. 사용자 이름, 비밀번호, 파일은 전송하거나 저장하지 않습니다.

생성된 줄 username:hash 줄 전체를 htpasswd 파일에 복사하세요. 사용자 이름, 비밀번호, 해시 설정을 바꾸면 생성된 줄이 사라지므로 편집 후 생성을 다시 눌러야 합니다.

여러 사용자 한 번에 생성한 줄에 user:password 하나
줄마다 user:password를 입력하고 한 번에 생성을 누르세요. 첫 콜론이 사용자 이름을 구분합니다. 빈 줄과 #으로 시작하는 줄은 무시하고 잘못되거나 중복된 사용자는 건너뜁니다.
선택한 형식과 해시 설정을 사용합니다.

htpasswd 파일 확인·편집비밀번호 확인, 사용자 추가·변경·삭제
htpasswd 내용을 붙여 넣거나 1 MiB 이하의 로컬 텍스트 파일을 여세요. 편집하면 표가 갱신되어 중복 사용자, 읽을 수 없는 해시 등 줄의 문제를 보여 줍니다. 편집은 이 탭에만 적용됩니다.
입력한 사용자 이름으로 확인합니다. 이름이 비어 있고 파일에 사용자 줄이 하나뿐이면 자동으로 선택합니다. 첫 일치 줄을 확인하며 추가·변경은 해당 사용자의 모든 줄을 바꾸고 삭제는 모든 일치 줄을 지웁니다.

이 버튼들은 입력한 사용자 이름, 비밀번호와 선택한 형식을 사용합니다.

예시·자세한 설명·자주 묻는 질문 실제 출력이 있는 예시, 다른 도구와의 차이, 자주 묻는 질문.

Ubuntu 서버의 Nginx에 Basic 인증 걸기

Nginx 설정은 다음과 같습니다.

location /admin/ {
    auth_basic           "Restricted";
    auth_basic_user_file /etc/nginx/.htpasswd;
}

Nginx 문서에 따르면 Nginx는 $apr1$, {SHA}, {SSHA}, {PLAIN}만 직접 처리하고 나머지는 운영체제의 crypt()에 넘깁니다. 그래서 bcrypt가 되는지는 배포판에 달려 있습니다. 2026-10-01 Docker 이미지의 시스템 crypt()로 확인한 결과입니다.

배포판bcryptSHA-512·SHA-256 crypt
Ubuntu 18.04안 됨됨
Ubuntu 20.04 / 22.04 / 24.04됨됨
Debian 11 / 12 / 13됨됨
CentOS 7.9 (glibc 2.17)안 됨됨
AlmaLinux 9.8됨됨

아직 Ubuntu 18.04를 쓰는 서버라면 bcrypt 해시는 비밀번호가 맞아도 통과하지 않습니다. 이때는 SHA-512 crypt를 고르세요. 이 도구로 만든 줄을 실제 Nginx 1.29.8(Debian 13, Alpine 3.23 이미지)과 Apache 2.4.68에 넣고 curl -u로 로그인한 결과, bcrypt·SHA-512·SHA-256·APR1·SHA-1·CRYPT는 모두 통과했고, 접두사 없는 평문은 둘 다 실패했으며 {PLAIN}은 Nginx만 받았습니다.

예시: 한글이 들어간 비밀번호

사용자 dev, 비밀번호 비밀번호-2026으로 만든 줄입니다(솔트가 무작위라 직접 만든 결과는 다릅니다).

dev:$2y$10$RYy2T5zioSgpcl.cMcvjteIyGsnTWTIPiSIpDoOM/iIKrBMMtVXx6
dev:$6$.BQqvpsYMcZksBEv$ecEwmGaT8W5F1nxEDwHdbVbsTnTXOcjgdeY.RI3BVhZfHgdT/C4M4tzMHTvR9KssH31z1xMF387T7kms2bief/
dev:$apr1$myiOSWeZ$vOXUZDMK1YJPDYKtP3uSY0

세 줄 모두 Apache htpasswd의 htpasswd -vb .htpasswd dev 비밀번호-2026에서 Password for user dev correct.가 나왔습니다(SHA-512 줄은 httpd:2.4 컨테이너 안의 htpasswd로 확인. macOS htpasswd는 SHA-2 crypt를 지원하지 않습니다). 한글 4자는 UTF-8로 12바이트라 이 비밀번호는 17바이트이고, 도구는 "UTF-8 17바이트로 해시합니다"라고 표시합니다. 서버는 바이트를 비교하므로, 다른 인코딩(EUC-KR 등)으로 보내는 클라이언트에서는 맞는 비밀번호도 실패합니다.

형식별 정리

  • bcrypt $2y$: Apache htpasswd -B와 같은 출력. Apache 2.4는 모든 플랫폼에서, Nginx는 위 표처럼 OS에 따라 읽습니다. 비용 4~17.
  • SHA-512 / SHA-256 crypt: htpasswd -5, -2와 같은 출력. Linux의 Apache와 Nginx는 읽지만 macOS·Windows의 Apache는 못 읽습니다.
  • APR1 $apr1$: htpasswd 기본값. Apache와 Nginx가 직접 구현해 어디서나 동작하지만, 1000회 고정 MD5이고 비용 설정이 없습니다.
  • SHA-1 {SHA}, CRYPT, 평문: Apache 문서가 안전하지 않다고 적는 형식입니다. CRYPT는 앞 8바이트만, 평문은 Windows·NetWare의 Apache에서만 쓰입니다.

기존 파일 확인과 편집

파일을 붙여 넣으면 줄마다 형식과 주의점을 보여 줍니다. 실제 서버에서 확인한, 두 서버가 다르게 읽는 경우입니다.

  • 같은 사용자가 두 줄이면 Apache와 Nginx 모두 첫 줄만 씁니다.
  • 줄 앞에 공백이 있으면 Apache는 공백을 지운 이름으로, Nginx는 공백 포함 이름으로 읽습니다.
  • 해시 뒤에 공백이 있으면 Apache는 지우고 Nginx는 비교에 포함해 매번 로그인이 실패합니다.
  • 사용자 이름에 :가 있으면 htpasswd는 종료 코드 6으로 거부합니다. 이 도구도 생성하지 않습니다.

사용자 추가·변경은 htpasswd -b처럼 같은 이름의 줄을 제자리에서 바꾸고, 주석과 빈 줄을 그대로 두고, 새 사용자는 끝에 붙입니다. 줄바꿈 방식(LF·CRLF)도 유지합니다. 사용자 삭제는 htpasswd -D처럼 그 사용자의 줄을 모두 지웁니다.

다른 온라인 생성기와의 차이

2026-10-01 데스크톱 Chromium에서 페이지의 네트워크 요청을 기록하며 시험했습니다.

  • 다이나믹랩스 htpasswd 생성기(Bing "htpasswd 생성" 1위)는 브라우저 안에서 계산하고, 콜론이나 공백이 든 사용자 이름을 막습니다. 다만 형식은 {SHA}와 {SHA256} 두 가지뿐이고, 페이지에 bcrypt는 "브라우저에서는 생성 불가"라고 적혀 있습니다. {SHA256} 줄은 Apache 2.4.68과 Nginx 1.29.8 모두에서 로그인이 실패했습니다.
  • web2generators.com(영어 검색 1위)은 사용자 이름과 비밀번호를 자기 서버로 POST하고 MD5만 만듭니다.

이 도구는 브라우저에서 bcrypt와 SHA-512 crypt를 만들고, 기존 줄로 비밀번호를 확인하며, 두 서버가 다르게 읽는 줄을 짚어 줍니다.

제한 사항

  • 생성 형식은 Apache htpasswd가 만드는 7가지와 $2a$, {PLAIN}입니다. 확인할 때는 $1$(MD5 crypt)와 {SSHA}도 읽습니다. yescrypt($y$), scrypt, $2x$는 알아보기만 하고 확인하지 못합니다.
  • bcrypt 비용은 417(APR 상한), SHA-2 라운드 수는 이 도구에서 10001000000입니다. 비용 17은 브라우저에서 몇 초 이상 걸립니다.
  • 파일 편집은 텍스트에만 적용되며 서버에 쓰지 않습니다.
  • Digest 인증용 htdigest 파일은 형식이 달라 지원하지 않습니다.

FAQ

어떤 형식을 골라야 하나요? Nginx에서 bcrypt 해시로 로그인이 안 되면요?

서버가 읽을 수 있다면 bcrypt $2y$를 쓰세요. Apache 2.4는 어떤 플랫폼에서도 읽습니다. Nginx는 $apr1$, {SHA}, {SSHA}, {PLAIN}만 직접 처리하고 bcrypt는 운영체제의 crypt()에 맡깁니다. 2026-10-01 Docker로 확인한 결과 Ubuntu 18.04와 CentOS 7.9의 crypt()는 bcrypt를 받지 않았고, Ubuntu 20.04 이상, Debian 11 이상, AlmaLinux 9, Alpine은 받았습니다. 지원하지 않는 시스템에서는 SHA-512 crypt를 쓰세요. APR1은 모든 Apache와 Nginx가 읽는 형식입니다.

$2y$와 $2a$는 무엇이 다른가요?

해시는 같고 접두사만 다릅니다. $2y$는 Apache htpasswd -B가 쓰는 형식이고 Apache Password Formats 문서도 이 형태로 적습니다. OpenBSD의 crypt()는 $2a$와 $2b$만 읽으므로 OpenBSD에서만 $2a$를 고르세요. $2b$는 APR이 직접 처리하지 않고 시스템 crypt()에 넘기므로 macOS와 Windows의 Apache에서 실패합니다.

bcrypt 비용은 얼마로 하나요?

htpasswd 기본값은 5, 범위는 4~17이고 이 도구는 10에서 시작합니다. Basic 인증은 요청마다 비밀번호를 보내므로 서버도 요청마다 bcrypt를 계산합니다. Apple M1 Max에서 htpasswd -v 확인 한 번이 비용 5에서 약 13ms, 10에서 약 72ms, 12에서 약 266ms였습니다.

한글 비밀번호를 써도 되나요?

됩니다. 이 도구는 UTF-8로 해시하므로 클라이언트도 UTF-8로 보내야 합니다. UTF-8 터미널에서 curl -u로 보낸 한글 비밀번호는 Apache와 Nginx 모두 통과했습니다. 다만 bcrypt는 앞 72바이트만 쓰고 한글 한 글자는 3바이트이므로, 25자 이상이면 도구가 경고합니다.

비밀번호가 서버로 전송되나요?

아니요. 해시는 bcrypt.js와 페이지 코드로 이 탭 안에서만 계산하고 저장하지 않습니다. 이 페이지는 분석·광고 스크립트도 불러오지 않습니다. 생성할 때 브라우저 개발자 도구의 Network 패널에서 확인할 수 있습니다.

평문 형식을 써도 되나요?

쓸 수 있는 경우는 많지 않습니다. Apache는 Windows와 NetWare에서만 평문 비밀번호를 받습니다(htpasswd 매뉴얼의 -p). Nginx는 {PLAIN} 접두사가 붙은 평문만 읽는데, 문서에서는 쓰지 말아야 할 예시로 설명합니다. Linux의 Apache에서는 평문 줄이 일치하지 않습니다.