직접 답변

대상 URL 변수는 {host}, {host.domain}, {host.sub}, {path}, {qs} 같은 자리표시자이며, 리다이렉트의 대상에 입력합니다. 방문자가 도착하면 RedirHub가 각 변수를 들어오는 요청의 해당 부분으로 바꿔서, 하나의 리다이렉트 규칙으로 여러 호스트명, 서브도메인, 경로를 올바른 위치로 보낼 수 있습니다.

일반 리다이렉트는 항상 방문자를 동일한 고정 URL로 보냅니다. 변수는 대상을 동적으로 만듭니다. 즉, 대상은 각 요청의 호스트명, 경로, 쿼리 문자열로부터 구성됩니다. 이는 도메인을 이전할 때 경로를 유지하고 싶거나, 와일드카드 규칙 하나로 여러 서브도메인을 리다이렉트하려는 경우, 또는 여러 기존 도메인을 하나의 웹사이트로 통합하려는 경우에 유용합니다.

경로 또는 쿼리 문자열만 유지하면 되나요?

그 경우에는 변수가 필요 없습니다. 리다이렉트를 편집할 때 Forwarded Options(전달 옵션)에서 Path forwarding(경로 전달) 또는 Query forwarding(쿼리 전달)을 켜세요.

스위치로 할 수 없는 작업이 필요할 때 변수를 사용하세요. 예를 들어 호스트명이나 서브도메인을 삽입하거나, 대상이 이미 자체 쿼리 문자열을 가지고 있는 경우 경로를 유지하는 것 등이 있습니다.

사용 가능한 변수#

https://shop.example.co.uk/sale/shoes/?color=red 요청에 대한 예시 값
Variable삽입되는 내용예시 값
{host}요청된 전체 호스트 이름shop.example.co.uk
{host.domain}하위 도메인을 제외한 등록 도메인example.co.uk
{host.sub}하위 도메인 부분만 (@ 하위 도메인이 없을 때)shop
{path}선행 슬래시(/)가 포함된 요청 경로/sale/shoes
{uri}선행 슬래시(/)가 없는 요청 경로sale/shoes
{qs}? 또는 &를 포함한 쿼리 문자열(없으면 비어 있음)?color=red
{random_string}매 요청마다 새로 생성되는 임의의 6자 값(a–z, 0–9)k3x9a1

참고할 몇 가지 세부 사항:

  • 정확한 철자: 변수는 소문자이며 중괄호로 감싸져 있습니다. RedirHub가 인식하지 못하는 항목(예: {HOST} )은 URL에 그대로 둡니다.
  • 도메인 확장(여러 부분): {host.domain} 은 .co.uk 또는 .com.au 같은 확장자를 올바르게 처리합니다. a.b.example.com의 경우, {host.domain} 은 example.com이고 {host.sub} 은 a.b입니다.
  • 베어 도메인: 루트 도메인(example.com)으로 요청하는 경우, {host.sub} 는 @ 입니다.
  • 후행 슬래시: {path} 및 {uri} 는 후행 슬래시를 제거하므로 /blog/ 은 /blog.이 됩니다. 홈에서는 {path} 가 / 이고 {uri} 는 비어 있습니다.
  • 쿼리 문자열 연결자: {qs} 는 목적지에 아직 쿼리 문자열이 없으면 ? 를 추가하고, 이미 있으면 & 를 추가합니다. 요청에 쿼리 문자열이 없으면 아무것도 추가하지 않습니다.

전달 스위치 또는 변수?#

경로 전달(Path forwarding)과 쿼리 전달(Query forwarding)은 리다이렉트를 편집할 때 'Forwarded Options'에서 설정할 수 있습니다.
원하는 것가장 쉬운 방법Example
경로 유지경로 전달 스위치a.com/one/two → b.com/one/two
쿼리 문자열 유지쿼리 전달 스위치a.com/?ref=chatgpt → b.com/?ref=chatgpt
둘 다 유지두 개의 스위치를 모두 켜세요a.com/one?ref=x → b.com/one?ref=x
도착지에 자체 쿼리 문자열이 있으면 경로를 유지하세요{path}b.com{path}?lang=en
호스트명, 도메인 또는 서브도메인을 사용하세요{host}, {host.domain}, {host.sub}b.com/team/{host.sub}
모든 방문에 고유한 값을 추가하세요{random_string}b.com/offer?ref={random_string}

변수와 스위치는 함께 사용할 수 있습니다. 예를 들어 {host.sub}가 포함된 대상에 Path 전달을 더하면 하위 도메인과 경로가 모두 유지됩니다(아래 예시 참조).

리다이렉트에 변수를 추가하는 방법#

  1. RedirHub 대시보드에서 해당 리다이렉트를 열거나, 새 리다이렉트를 만드세요.
  2. 대상 URL에서 값이 들어갈 위치에 변수를 입력하세요. 예: https://www.example.com/team/{host.sub} .
  3. 대상에 직접 {path}, {uri} 또는 {qs}를 넣었다면, 해당 리다이렉트에 대해 Path 전달 또는 Query 전달을 끄세요(아래 참조).
  4. 저장한 다음 홈페이지를 포함해 실제 URL 몇 개를 테스트해 보세요. 문제가 있어 보이면 새 리다이렉트 문제 해결을 확인하세요.

예시#

대상에 자체 쿼리 문자열이 있는 경우 경로를 유지#

textDestination: https://www.new-domain.com{path}?lang=en

old-domain.com/blog/hello  →  https://www.new-domain.com/blog/hello?lang=en
old-domain.com/            →  https://www.new-domain.com/?lang=en

Path 전달은 항상 경로를 대상의 맨 끝에 추가합니다. 여기서는 https://www.new-domain.com/?lang=en/blog/hello 가 됩니다. {path}를 사용하면 경로가 들어갈 위치를 직접 결정할 수 있습니다. 대상에 쿼리 문자열이 없다면, 대신 Path 전달을 켜기만 하면 됩니다.

각 하위 도메인을 별도의 페이지로 전송#

textSource:      *.example.com
Destination: https://www.example.com/team/{host.sub}

alice.example.com  →  https://www.example.com/team/alice
bob.example.com    →  https://www.example.com/team/bob

와일드카드 소스 하나로 모든 하위 도메드를 커버하고, 변수가 각 도메인을 어디로 보낼지 결정합니다. 와일드카드 하위 도메인에 대해 자세히 알아보세요. (플랜 사용 가능 여부 및 SSL 포함)

하위 도메드는 유지하고 도메인만 변경#

textSource:      *.old-brand.com
Destination: https://{host.sub}.new-brand.com   + Path forwarding on

shop.old-brand.com/cart  →  https://shop.new-brand.com/cart
docs.old-brand.com/api   →  https://docs.new-brand.com/api

주의하세요

기본 도메인에서는 {host.sub}가 @이므로, old-brand.com/cart는 https://@.new-brand.com/cart가 됩니다.

루트 도메인(old-brand.com)에 대해 목적지 https://new-brand.com 으로 별도의 리디렉션을 만들고, Path forwarding을 켭니다.

여러 도메인을 통합하고 방문자가 어디에서 왔는지 확인#

textDestination: https://www.new-brand.com/?from={host.domain}

old-brand.co.uk/        →  https://www.new-brand.com/?from=old-brand.co.uk
shop.old-brand.de/sale  →  https://www.new-brand.com/?from=old-brand.de

모든 기존 도메인은 동일한 목적지(destination)를 사용할 수 있으며, 분석(analytics)으로 각 방문자가 입력한 도메인이 무엇인지 계속 확인할 수 있습니다.

쿼리 문자열 유지#

textDestination: https://www.new-domain.com/landing?src=old   + 쿼리 포워딩 on

old-domain.com/?utm_source=mail  →  https://www.new-domain.com/landing?src=old&utm_source=mail
old-domain.com/                  →  https://www.new-domain.com/landing?src=old

이 경우에는 변수가 필요하지 않습니다. 쿼리 포워딩 스위치는 방문자의 쿼리 문자열을 추가하고, ? 또는 &를 알아서 선택하므로 캠페인 추적이 그대로 유지됩니다. 리디렉션을 통해 UTM 파라미터를 보존하는 방법도 참고하세요 .

무작위 값 추가#

textDestination: https://www.example.com/offer?ref={random_string}

example.com/promo  →  https://www.example.com/offer?ref=4k9zq1  (요청마다 다름)

변수와 포워딩 스위치#

경로 포워딩(Path forwarding)과 쿼리 포워딩(Query forwarding) 스위치는 내부적으로 동일한 변수를 사용합니다. 경로 포워딩은 목적지 끝에 /{uri} 를 추가하고, 쿼리 포워딩은 {qs} 를 추가합니다. 이미 목적지에 {path}, {uri} 또는 {qs}를 직접 넣었다면, 해당하는 스위치를 꺼 두세요. 그렇지 않으면 값이 두 번 추가됩니다:

textDestination: https://www.new-domain.com{path}   + 경로 포워딩 on

old-domain.com/about  →  https://www.new-domain.com/about/about

변수는 방문자를 어디로 보낼지만 변경합니다. 요청을 처리하는 리디렉션(redirect)은 RedirHub의 일치 규칙(matching rules) 에 의해 결정됩니다 .

문제 해결#

  • 변수가 URL에 그대로 표시됩니다: 철자, 소문자, 중괄호를 확인하세요.
  • 이중 슬래시가 나타납니다 (new-domain.com//about): {path} 는 이미 슬래시로 시작합니다. https://new-domain.com{path} 또는 https://new-domain.com/{uri} 로 작성하세요.
  • 경로 또는 쿼리 문자열이 반복됩니다: 해당 리디렉션에 대해 경로 전달(Path forwarding) 또는 쿼리 전달(Query forwarding)을 끄세요.
  • 호스트 이름에 @가 나타납니다: 요청이 루트 도메인(베어 도메인)으로 전송되었습니다. 루트 도메인을 위한 별도의 리디렉션을 추가하세요.

자주 묻는 질문

아니요. 리디렉션을 편집할 때 전달된 옵션에서 경로 전달 또는 쿼리 전달을 활성화하세요. 스위치로 할 수 없는 것, 예를 들어 호스트 이름이나 서브 도메인을 삽입하거나 목적지가 이미 자체 쿼리 문자열을 가지고 있을 때 경로를 유지해야 할 때만 변수를 사용하세요.

네. 변수는 중괄호 안에 소문자로 작성되어야 하며, 정확히 나열된 대로 작성해야 합니다. 예를 들어 {host.domain}. RedirHub가 인식하지 못하는 변수, 예를 들어 {HOST} 또는 {domain}은 목적지에서 변경되지 않고 그대로 남습니다.

네. 필요한 만큼 많은 변수를 조합할 수 있으며, 각 변수는 여러 번 나타날 수 있습니다. 예를 들어, https://{host.sub}.new-brand.com{path}{qs}는 서브 도메인, 경로 및 쿼리 문자열을 유지합니다.

둘 다 후행 슬래시 없이 요청된 경로를 삽입합니다. {path}는 슬래시(/blog/hello)로 시작하므로 도메인 바로 뒤에 놓아야 합니다. {uri}는 선행 슬래시가 없으므로 (blog/hello) 슬래시를 직접 추가해야 합니다: https://new-domain.com/{uri}.

{host.domain}은 다중 부분 도메인 끝을 이해합니다. shop.example.co.uk에 대한 요청은 example.co.uk를 반환하고, {host.sub}는 shop을 반환합니다.

네. 변수는 *.example.com과 같은 와일드카드 소스에 의해 커버되는 모든 서브 도메인에 고유한 목적지를 제공하는 가장 쉬운 방법입니다. 예를 들어 https://www.example.com/team/{host.sub}.

관련 도움말

전체 문서 보기