01
UA 값만 준비하기
한 줄에 UA 값 또는 User-Agent:로 시작하는 헤더를 넣습니다. 헤더 이름의 대소문자는 구분하지 않고 앞뒤 공백만 제거합니다. 전체 접근 로그에서 값을 추출하거나 JSON 따옴표와 이스케이프를 해제하지 않으므로 필요한 필드를 먼저 골라 주세요.
HTTP 및 요청 디버깅
User-Agent 파서
한 줄에 UA 하나를 입력하세요. 인식한 값과 확인할 수 없는 필드를 함께 보여 줍니다.
User-Agent 파서
User-Agent 입력
UA는 브라우저에서 처리하며 입력을 전송하거나 저장하지 않습니다.
분석 결과
분석 규칙을 불러오는 중…
분석 옵션
한 줄에 UA 하나 · 최대 500개 · UA당 500자 · 전체 입력 512KiB.
문자열의 규칙 일치 결과입니다. 미확인은 데스크톱을 뜻하지 않으며 버전은 동결될 수 있습니다.
파서: ua-parser-js 1.0.41 · 포함된 규칙: 1.0.41
분석 규칙을 불러오는 중…
고객이 보낸 한 줄에 Mozilla, Chrome, Safari가 모두 들어 있어도 브라우저를 세 개 사용한다는 뜻은 아닙니다. User-Agent 파서는 호환성을 위해 남은 표기를 규칙으로 해석합니다. 기본 Edge 예제로 어떤 이름이 실제 브라우저 항목에 나타나는지 확인해 보세요.
사용자 에이전트가 포함된 로그를 살필 때는 UA 값만 한 줄씩 추출하세요. 같은 문자열이 반복되어도 순서를 유지하며 원래 행 번호를 기록합니다. 운영체제를 알아냈더라도 기기 유형까지 확인할 수 있는 것은 아닙니다.
User-Agent 파서를 사용하는 이유
미확인 정보를 추측으로 채우지 않기
User-Agent 파서는 열한 개 필드를 독립적으로 표시합니다. 브라우저 분석이 성공해도 기기 유형은 알 수 없을 수 있습니다. 이를 데스크톱으로 자동 분류하지 않으므로 재현 환경을 정하기 전에 원문에 어떤 근거가 있는지 확인할 수 있습니다.
여러 기록에서도 출처 유지하기
원문과 실제 분석한 UA, 원래 행 번호가 결과에 함께 남습니다. 빈 줄은 따로 세고 중복 기록도 보존합니다. 알려진 브라우저 사이에 사용자 정의 클라이언트가 있어도 그 행을 숨기지 않아 입력과 결과를 대조할 수 있습니다.
로그의 맥락을 보존하는 방법
02
자동 갱신 시점 선택하기
자동 분석은 마지막 수정 후 350ms를 기다립니다. 끄면 분석 버튼이나 Ctrl/Cmd+Enter로 실행할 수 있습니다. 입력을 바꾸는 즉시 이전 결과의 내보내기가 잠깁니다. 필드와 JSON 보기 전환은 재분석을 일으키지 않습니다.
03
교체와 내보내기 범위 확인하기
현재 브라우저, 예제, 비우기는 먼저 교체할 기록 수와 내용을 보여 줍니다. 적용 후 한 번 되돌리면 입력과 결과가 함께 복구됩니다. 화면에는 50개씩 추가 표시하지만 복사와 다운로드는 항상 전체 결과를 포함합니다.
결과에 기록되는 항목
브라우저와 렌더링 엔진 구분
브라우저 이름, 보고된 전체 버전과 주 버전을 따로 보여 줍니다. 엔진과 운영체제에도 각각 이름과 버전이 있습니다. Edge 문자열에 Chrome이나 Safari 표기가 있어도 이름 하나만 보고 분류하지 않으며 동결된 버전도 보고된 값으로 유지합니다.
기기와 CPU 단서 분리
기기 유형, 제조사, 모델, CPU 아키텍처는 별도 필드입니다. 모바일로 인식했다고 정확한 모델을 알 수 있는 것은 아닙니다. 빠진 값은 JSON에서 null이고 unknownFields에도 필드 이름을 기록하므로 후속 처리에서 빈 정보를 확인할 수 있습니다.
원문과 정규화된 입력 보존
raw에는 원래 행 전체가, ua에는 헤더 접두사와 주변 공백을 제거한 값이 들어갑니다. line은 1부터 시작하는 원래 행 번호입니다. 분석을 위해 값을 정리해도 입력 편집기의 내용은 바꾸지 않으며 내보낸 뒤에도 변환 과정을 대조할 수 있습니다.
버전이 명시된 동일한 규칙
ua-parser-js 1.0.41과 함께 배포된 규칙을 사용합니다. 현재 브라우저 버튼으로 가져온 값에도 붙여 넣은 문자열과 같은 분석 경로를 적용합니다. 터치 기능, Brave 감지, Client Hints를 더하지 않아 다른 기기의 과거 로그에 현재 환경이 섞이지 않습니다.
문자열로 판단할 수 없는 것
- 사람이나 봇의 신원을 검증하지 않음
- UA는 클라이언트가 자유롭게 바꿀 수 있는 자기소개입니다. 사람 여부나 검색 봇 분류를 제공하지 않습니다. 익숙한 브라우저가 표시되더라도 스크립트가 그 이름을 보냈을 수 있으므로 인증이나 기능 지원의 증거로 사용할 수 없습니다.
- 동결되거나 생략된 값을 복원하지 않음
- Windows NT 10.0만으로 Windows 10과 11을 구분할 수 없습니다. 데스크톱 모드의 iPad는 Macintosh를 표시할 수도 있습니다. 생략된 모델과 버전을 추측해서 채우지 않으며 기기 유형이 없으면 데스크톱 대신 확인 불가로 남깁니다.
- 잘라내기 대신 명시적인 제한
- 빈 줄을 제외한 500개 기록, 전체 UTF-8 입력 512KiB까지 받습니다. 정규화한 각 UA는 UTF-16 코드 단위 500개까지입니다. 한도를 넘거나 허용되지 않는 제어 문자가 있으면 행과 열을 표시하고 전체 분석을 중단하며 일부 결과만 내보내지 않습니다.
- 텍스트 입력만 처리
- 파일 가져오기, URL 조회, 요청 재전송, 전체 로그 자동 추출, Client Hints 보강은 제공하지 않습니다. 따옴표와 이스케이프는 그대로 두고 빈 줄만 건너뜁니다. 중복 제거·정렬·트래픽 통계는 하지 않으며 내보내기 형식은 JSON입니다.
User-Agent 파서 자주 묻는 질문
내 브라우저의 UA는 어떻게 확인하나요?
현재 브라우저를 누르고 교체 미리보기를 확인한 뒤 적용하세요. navigator.userAgent 값만 가져옵니다. 화면 크기나 터치 기능 등의 정보를 더하지 않으므로 다른 문자열을 붙여 넣었을 때와 같은 기준으로 볼 수 있습니다.
봇이나 크롤러인지 판단할 수 있나요?
이 페이지는 봇 분류를 하지 않습니다. Googlebot이라고 쓰인 UA도 검증되지 않은 문자열이며 브라우저 필드가 비어 있을 수 있습니다. 실제 크롤러의 출처를 확인하려면 UA 밖의 근거가 필요합니다.
대부분의 UA가 Mozilla/5.0으로 시작하는 이유는 무엇인가요?
오래된 사이트와의 호환성을 위해 이어져 온 표기입니다. Mozilla라는 단어만으로 Firefox라고 판정해서는 안 됩니다. 브라우저 이름을 구분하는 다른 토큰까지 포함하도록 문자열 전체를 유지하세요.
UA 분석이 틀릴 수 있는 이유는 무엇인가요?
브라우저들이 서로의 호환 표기를 포함하고, 일부 버전과 모델은 개인정보 보호를 위해 고정됩니다. 낯선 클라이언트나 사용자가 변경한 값도 규칙을 벗어날 수 있습니다. 결과와 원문을 대조하고 실제 환경에서 동작을 확인하세요.
Client Hints와 UA 문자열은 어떻게 다른가요?
Client Hints는 별도의 헤더나 API로 구조화된 값을 제공합니다. 이 도구는 입력한 UA만 해석하며 현재 기기에 추가 정보를 요청하지 않습니다. 과거 로그의 주인과 지금 도구를 여는 기기가 다를 수 있기 때문입니다.
잘못 해석된 UA가 있나요?