URL 구성 요소 파서

임의의 URL이나 텍스트 파일에서 구성 요소를 추출하고 분석합니다.

업로드 없음회원가입 없음즉각적인 결과
RFC 3986 / WHATWG URL 검사기실시간 호스트 · 경로 · 쿼리 · 해시 편집기100% 로컬 처리 • 서버 업로드 없음
URL 구문 분석 및 편집
오프라인 엔진 준비 완료브라우저 내 100% 개인정보 보호 • 클라우드 업로드 없음
100% 비공개 • 서버 파일 업로드 제로

Utiliome의 무료 URL 구성 요소 파서를 사용하는 이유

철저한 개인정보 보호, 즉각적인 실행, 번거로움 없는 사용을 위해 처음부터 설계되었습니다. 구독, 결제, 회원가입이 필요 없습니다.

WHATWG 및 RFC 3986 구성 요소 분해

스킴(scheme), userinfo 인증 정보, 오리진(origin), 호스트명, 서브도메인, 등록 가능 도메인, TLD, 명시적/기본 포트, 인덱스된 경로 세그먼트, 쿼리 쌍, 해시 프래그먼트로 정밀하게 분해합니다.

실시간 양방향 URL 재구성

호스트명 전환, 포트 변경, 경로 세그먼트 업데이트, 쿼리 값 수정 등 개별 필드를 편집하면 정규화된 URL이 즉시 다시 조립됩니다.

IDN, IPv6 및 커스텀 URI 스킴 지원

퓨니코드(Punycode) 국제화 도메인(xn--), 대괄호로 묶인 IPv6 리터럴([::1]:8080), 비 HTTP 딥링크 스킴(myapp://), 포트가 명시된 내부 엔드포인트를 완벽히 처리합니다.

100% 클라이언트 사이드 무유출 검사

모든 과정이 브라우저 메모리 내에서만 실행되므로 OAuth 리다이렉트 URL, AWS S3 프리사인드(Presigned) 링크, 웹훅 토큰, Basic 인증 자격 증명이 외부 서버로 절대 전송되지 않습니다.

Utiliome vs 기존 클라우드 대안

로컬 우선 WebAssembly 엔진과 기존 클라우드 도구를 비교해 보세요.

기능 Utiliome (로컬 브라우저) 기존 클라우드 변환기
WHATWG 및 RFC 3986 구성 요소 분해 스킴(scheme), userinfo 인증 정보, 오리진(origin), 호스트명, 서브도메인, 등록 가능 도메인, TLD, 명시적/기본 포트, 인덱스된 경로 세그먼트, 쿼리 쌍, 해시 프래그먼트로 정밀하게 분해합니다. 고급 설정이 없는 제한적인 기본 옵션
실시간 양방향 URL 재구성 호스트명 전환, 포트 변경, 경로 세그먼트 업데이트, 쿼리 값 수정 등 개별 필드를 편집하면 정규화된 URL이 즉시 다시 조립됩니다. 별도 프로그램 설치나 수동 작업이 필요함
데이터 개인정보 보호 및 처리 100% 브라우저 로컬 처리 (서버 업로드 제로) 데이터를 외부 클라우드 서버로 전송 및 저장
이용 요금 및 회원가입 평생 100% 무료 · 회원가입 및 로그인 불필요 회원가입 강제 또는 유료 구독 결제 필요
작동 방식

간단한 3단계 URL 구성 요소 파서 사용법

소프트웨어 설치가 필요 없습니다. 웹 브라우저 내에서 모든 작업이 직접 실행됩니다.

1

URL 붙여넣기 또는 업로드

입력란에 HTTP(S) 주소, 커스텀 URI 스킴, IPv6 서비스 엔드포인트 또는 서명된 콜백 링크를 입력하거나 일반 텍스트 파일을 드롭합니다.

2

분해된 URI 필드 검사

파싱된 오리진, Authority 자격 증명, 서브도메인/도메인/TLD 분리 결과, 디코딩된 경로 세그먼트 목록, 쿼리 키-값 파라미터 및 프래그먼트 식별자를 확인합니다.

3

구성 요소 편집 및 결과 복사

스테이징 호스트 교체, 포트 번호 조정, 파라미터 업데이트 등 원하는 구성 요소를 개별적으로 수정한 뒤 재구성된 URL이나 구조화된 JSON 분석 결과를 복사합니다.

URL 구성 요소 파싱 및 실시간 재구성 작동 원리

빠른 답변: URL 파서는 RFC 3986 구조적 구분자(://, @, :, /, ?, #)를 따라 URI(Uniform Resource Identifier)를 토큰화하여 Authority, 계층적 경로 세그먼트, 쿼리 파라미터, 프래그먼트 상태를 분리함으로써 수동 문자열 슬라이싱 없이도 각 필드를 검사하거나 수정할 수 있게 해줍니다.

수동 정규 표현식이나 단순한 split('/') 헬퍼 함수는 Basic 인증 자격 증명, 명시적 포트, 퍼센트 인코딩된 슬래시(%2F), .co.kr이나 .co.uk 같은 다중 파트 공개 접미사(Public Suffix), 또는 해시 프래그먼트 내부에 포함된 물음표(?)를 만나면 자주 오작동합니다. 표준 명세를 준수하는 파서는 개별 구성 요소를 디코딩하기 전에 엄격한 구문 순서에 따라 구분자를 먼저 스캔합니다.

자격 증명, 다단계 서브도메인, 비기본 TLS 포트, 인코딩된 경로 세그먼트, 쿼리 파라미터 및 프래그먼트 앵커를 포함하는 복잡한 웹훅(Webhook) 전달 URL을 살펴보겠습니다.

https://deploy:tok_9f8a@staging.api.example.co.uk:8443/v2/orgs/acme%20corp/webhooks?event=push&active=true#delivery-log

이 URI를 분해하면 다음과 같이 독립적으로 편집 가능한 속성들이 추출됩니다.

{
  "href": "https://deploy:tok_9f8a@staging.api.example.co.uk:8443/v2/orgs/acme%20corp/webhooks?event=push&active=true#delivery-log",
  "protocol": "https:",
  "scheme": "https",
  "username": "deploy",
  "password": "tok_9f8a",
  "origin": "https://staging.api.example.co.uk:8443",
  "host": "staging.api.example.co.uk:8443",
  "hostname": "staging.api.example.co.uk",
  "subdomain": "staging.api",
  "domain": "example.co.uk",
  "tld": "co.uk",
  "port": "8443",
  "pathname": "/v2/orgs/acme%20corp/webhooks",
  "pathSegments": ["v2", "orgs", "acme corp", "webhooks"],
  "search": "?event=push&active=true",
  "queryParams": {
    "event": "push",
    "active": "true"
  },
  "hash": "#delivery-log"
}

이스케이프 손상 없이 구성 요소 수정하기

여러 개발 환경을 오가며 디버깅할 때, 정확한 경로 인코딩과 서명된 쿼리 페이로드는 그대로 유지하면서 캡처한 프로덕션이나 스테이징 콜백 URL을 로컬 서비스로 연결해야 하는 경우가 많습니다. scheme을 http로, hostname을 localhost로, port를 3000으로 변경하고 username/password를 지우면 다음과 같이 깔끔하게 재구성됩니다.

http://localhost:3000/v2/orgs/acme%20corp/webhooks?event=push&active=true#delivery-log

세 번째 경로 세그먼트(acme corp)는 pathname 내부에서 %20 퍼센트 인코딩을 자동으로 유지하므로, HTTP 요청 라인이나 마크다운 로그에서 공백으로 인해 URL이 잘리는 현상을 방지합니다.

RFC 3986 일반 URI 구문 vs WHATWG URL 표준 비교

빠른 답변: RFC 3986은 일반 URI를 위한 상태 비저장(stateless) ABNF 문법 규칙을 정의하는 반면, 최신 브라우저, Node.js, Deno, Cloudflare Workers는 특수 스킴(Special Scheme) 정규화, 기본 포트 생략, 백슬래시 변환, UTS #46 퓨니코드(Punycode) IDNA 인코딩을 강제하는 WHATWG URL Living Standard를 구현합니다.

RFC 3986과 WHATWG URL 표준 간의 미묘한 차이를 이해하면 라우팅 버그, 서명 검증 오류, 그리고 서버 사이드 요청 위조(SSRF) 취약점을 예방할 수 있습니다.

표준 구조 문법 (RFC 3986 섹션 3)

RFC 3986은 모든 일반 URI를 왼쪽에서 오른쪽으로 고정된 우선순위에 따라 5가지 주요 구성 요소로 나눕니다.

  foo://user:pass@example.com:8042/over/there?name=ferret#nose
  \_/   \_______________________/ \_________/ \_________/ \__/
   |                |                  |           |        |
scheme          authority             path       query   fragment
  • Scheme (스킴): 반드시 ASCII 영문자로 시작해야 하며 그 뒤에 영문자, 숫자, +, -, 또는 .이 올 수 있습니다(ALPHA *( ALPHA / DIGIT / "+" / "-" / "." )). 소문자로 정규화됩니다.
  • Authority (권한 영역): //로 시작하며 다음 /, ?, # 또는 문자열 끝에서 종료됩니다. 선택적인 userinfo@, host(등록된 도메인 이름, IPv4 주소 또는 대괄호로 묶인 [IPv6] 리터럴), 그리고 선택적인 :port로 세분화됩니다.
  • Path (경로): / 세그먼트의 계층적 시퀀스입니다. 점 세그먼트(. 및 ..)는 remove_dot_segments 알고리즘(RFC 3986 섹션 5.2.4)을 통해 해석됩니다.
  • Query (쿼리): 경로 뒤의 첫 번째 ?로 시작하며 # 또는 문자열 끝에서 종료됩니다.
  • Fragment (프래그먼트): #로 시작하며 이후에 나오는 ?나 / 문자를 포함하여 URI 끝까지 남은 모든 문자를 소비합니다.

WHATWG 특수 스킴(Special Schemes) vs 불투명 경로(Opaque Paths)

WHATWG URL 상태 머신은 http, https, ws, wss, ftp, file의 6가지 스킴을 특수 스킴(special schemes) 으로 지정합니다. 특수 URL은 비특수 스킴(mailto:, urn:, data:, myapp://)에서는 건너뛰는 엄격한 정규화 과정을 거칩니다.

  1. 기본 포트 생략: https://example.com:443/api는 443이 https의 기본 포트(http/ws는 80, https/wss는 443, ftp는 21)와 일치하므로 port가 ""로 설정되고 https://example.com/api로 직렬화됩니다. 반면 redis://cache.internal:6379 같은 커스텀 스킴은 :6379를 그대로 유지합니다.
  2. 백슬래시 정규화: 특수 스킴에서는 Authority 및 경로 세그먼트 내부의 백슬래시(\) 문자가 슬래시(/)로 정규화되지만, 비특수 스킴에서는 \를 불투명한 일반 경로 문자로 취급합니다.
  3. 빈 경로 슬래시 추가: https://example.com은 끝에 루트 슬래시가 붙어 직렬화(pathname = "/")되는 반면, custom://host는 빈 pathname을 가질 수 있습니다.
  4. IDNA 퓨니코드 변환: https://münchen.example/path와 같은 유니코드 도메인 레이블은 UTS #46을 통해 hostname 속성에서 ASCII 호환 인코딩(https://xn--mnchen-3ya.example/path)으로 변환됩니다.

IPv6 리터럴 및 다중 레이블 공개 접미사(Public Suffix)

IPv6 주소에는 콜론이 포함되어 있어 RFC 2732에 따라 대괄호로 감싸지 않으면 :port 구분자와 충돌합니다(예: http://[2001:db8:85a3::8a2e:370:7334]:8080/health). 또한 호스트명을 서브도메인, 등록 가능 도메인, TLD로 분해할 때 단순히 마지막 점을 기준으로 나눌 수 없습니다. 국가 코드 2단계 도메인(example.co.kr, example.co.uk, app.com.au)과 플랫폼 접미사는 다중 레이블 접미사 인식이 필요하므로 단순한 uk나 kr이 아닌 co.uk, co.kr이 유효 TLD(eTLD)로 인식되어야 합니다.

보안 참고 사항: 파서 간 해석 차이(Parser Differentials)와 SSRF

프록시가 관대한 RFC 3986 정규식을 사용해 URL을 검증하고 업스트림 HTTP 클라이언트가 WHATWG 파서를 사용해 요청을 가져올 때 보안 허용 목록(Allowlist)이 우회될 수 있습니다. 여러 개의 @ 구분자(https://allowed.example@169.254.169.254/latest/meta-data/)나 백슬래시(https://attacker.example\@allowed.example/)가 포함된 입력은 한 파서에서는 호스트를 allowed.example로 읽게 만들면서 실제 HTTP 클라이언트는 169.254.169.254나 attacker.example에 연결하도록 유도할 수 있습니다. 항상 HTTP 클라이언트가 사용하는 것과 동일한 WHATWG 정규화로 파싱한 후 origin과 hostname을 검증하고, 예상치 못한 username/password Authority 필드는 제거하거나 거부해야 합니다.

URL 구성 요소 파서 vs 쿼리 스트링 파서 vs URL 인코더: 어떤 도구를 써야 할까요?

빠른 답변: 스킴, Authority, 호스트, 포트, 경로, 쿼리, 해시에 걸친 전체 URI 구조를 검사하고 재구성하려면 'URL 구성 요소 파서'를 사용하세요. 깊게 중첩된 쿼리 편집 및 양방향 JSON 변환에는 '쿼리 스트링 파서'를, 원시 문자열 이스케이프에는 'URL 인코더 및 디코더'를 사용하면 됩니다.

URL 조작 작업은 다루는 구문 계층에 따라 명확히 구분됩니다. 현재 작업 중인 계층에 맞게 설계된 도구를 선택하면 구분자가 이중 인코딩되거나 중첩된 파라미터 타입이 손실되는 문제를 피할 수 있습니다.

기능 URL 구성 요소 파서 (현재 도구) 쿼리 스트링 파서 URL 인코더 및 디코더 퍼센트 인코더
주요 입력 전체 URL 또는 커스텀 URI ?a=1&b=2, 폼 바디 또는 JSON 원시 문자열 또는 인코딩된 URL 구성 요소 엄격한 RFC 3986 %XX 이스케이프가 필요한 원시 텍스트
Authority, 호스트, 포트 및 TLD 분리 전체 분해 + 실시간 편집 쿼리 이외의 URL 부분 제거 구조적 파싱 없음 구조적 파싱 없음
경로 세그먼트 검사 인덱스된 디코딩 경로 배열 해당 없음 구조적 파싱 없음 구조적 파싱 없음
중첩 쿼리 배열 및 대괄호 평면(Flat) 키-값 쿼리 검사 tag[]=a, filter[k]=v 및 JSON 동기화 완벽 지원 해당 없음 해당 없음
공백 인코딩 제어 (+ vs %20) 표준 URI 구성 요소 규칙 + 또는 %20 직렬화 설정 가능 구성 요소 및 폼 이스케이프 지원 엄격한 RFC 3986 %20 바이트 인코딩

다른 연관 도구로 전환해야 하는 경우

  • 깊게 중첩된 API 필터를 편집하거나 쿼리 파라미터를 JSON으로 변환할 때: 반복되는 배열 키(?id=1&id=2), qs 스타일의 대괄호 표기법(filter[status]=open), application/x-www-form-urlencoded POST 페이로드 또는 JSON 테스트 픽스처를 다룰 때는 쿼리 스트링 파서를 여세요.
  • 단일 파라미터 값을 이스케이프하거나 언이스케이프할 때: URL에 삽입하기 전에 &, =, + 또는 유니코드 문자가 포함된 원시 문자열을 encodeURIComponent 시맨틱으로 안전하게 이스케이프해야 한다면 URL 인코더 및 디코더를 사용하세요.
  • OAuth / AWS SigV4를 위한 엄격한 RFC 3986 바이트 수준 이스케이프: !, ', (, ), * 같은 문자를 반드시 16진수로 인코딩해야 하는 정규 요청(Canonical Request) 서명 작업에는 퍼센트 인코더를 사용하세요.
  • 제목에서 깔끔한 SEO 경로 세그먼트를 생성할 때: 사람이 읽는 제목을 소문자 하이픈으로 연결된 경로 슬러그로 변환하려면 URL 경로 정리 및 슬러그 변환 (Slugify)를 사용하세요.
FAQ

URL 구성 요소 파서 자주 묻는 질문 및 기술 가이드

Utiliome의 무료 온라인 url 파서 사용에 관한 모든 정보.

파싱된 URL에서 host, hostname, origin의 차이점은 무엇인가요?

WHATWG URL 명세에서 hostname은 도메인 이름이나 대괄호로 묶인 IPv6 리터럴(api.example.com 또는 [::1])만 포함합니다. host는 기본 포트가 아닌 명시적 포트가 있을 때만 :port를 덧붙입니다(예: api.example.com:8443, 단 https에서 443 포트를 사용하는 경우 api.example.com). origin은 host 앞에 스킴과 :// 구분자를 붙인 값(https://api.example.com:8443)으로, CORS 및 postMessage에서 사용하는 웹 보안 경계를 나타냅니다.

해시(#) 뒤에 오는 쿼리 스트링은 왜 queryParams가 아니라 프래그먼트 안에 남게 되나요?

RFC 3986 섹션 3.5에 따라 첫 번째 # 구분자는 경로 또는 쿼리 구성 요소를 종료하고 프래그먼트 식별자를 시작하며, 이는 URI의 맨 끝까지 이어집니다. https://app.example.com/#/orders?status=paid와 같은 해시 라우팅 기반 단일 페이지 애플리케이션(SPA) 링크에서 ?status=paid는 클라이언트 사이드 hash(#/orders?status=paid)의 일부이며 HTTP 서버로 전송되지 않습니다. 해시 라우트 내부에 포함된 파라미터를 파싱하려면 ?부터 시작하는 부분 문자열을 복사하여 쿼리 스트링 파서에 붙여넣으세요.

HTTP나 HTTPS URL을 재구성할 때 왜 :80이나 :443 같은 기본 포트가 사라지나요?

WHATWG URL 표준의 특수 스킴(Special Schemes)은 기본 포트를 정의하고 있습니다(http 및 ws는 80, https 및 wss는 443, ftp는 21). https://example.com:443/v1처럼 URL이 해당 스킴의 기본 포트를 명시적으로 지정한 경우, 표준을 준수하는 정규화기는 동등한 오리진이 동일하게 비교될 수 있도록 정규 직렬화 과정에서 :443을 생략합니다. :8443이나 :3000 같은 비기본 포트는 항상 그대로 유지됩니다.

경로 세그먼트 내부의 퍼센트 인코딩된 슬래시(%2F)는 어떻게 처리되나요?

구조적 / 구분자 분할은 퍼센트 디코딩이 일어나기 전에 먼저 수행됩니다. 예를 들어 /repos/acme%2Fcore/commits의 경우, 먼저 분할을 수행해 세 개의 세그먼트(["repos", "acme%2Fcore", "commits"])를 만든 다음 세그먼트 단위로 디코딩하여 acme/core를 단일 식별자로 추출합니다. 만약 경로 분할 전에 %2F를 먼저 디코딩한다면 잘못하여 네 개의 경로 세그먼트가 생성되어 REST 라우트 매칭이 깨지게 됩니다.

OAuth 콜백 URL이나 AWS S3 프리사인드(Presigned) URL을 이곳에서 검사해도 안전한가요?

네, 안전합니다. 모든 URL 파싱, 구성 요소 편집 및 JSON 직렬화는 브라우저의 JavaScript 런타임 내에서 100% 로컬로 실행됩니다. 붙여넣은 URL, X-Amz-Signature 파라미터, code 인가 코드, 또는 userinfo 자격 증명은 어떠한 네트워크 요청, 애널리틱스 비콘, 서버 사이드 로그로도 전송되거나 기록되지 않습니다.