사이트 리디렉트

Redirects send visitors from an old URL to a new one, which is how you restructure a site without breaking every link pointing at it. This guide covers the three source shapes, choosing between 301…

리다이렉트는 방문자를 이전 URL에서 새 URL로 보내며, 이를 통해 모든 링크를 깨뜨리지 않으면서 사이트를 재구성할 수 있습니다. 이 가이드는 세 가지 소스 형태, 301과 302 중 선택, 쿼리 문자열, 그리고 확인 배지 읽기를 다룹니다.

KPanel에서 리다이렉트의 위치

KPanel에 로그인합니다.
왼쪽 사이드바에서 Websites를 클릭한 후 사이트를 클릭합니다.
사이트의 탭 스트립에서 Advanced를 열고 Redirects를 엽니다.

직접 주소는 /websites/<site-id>/redirects입니다.

KPanel에서 사이트에 대한 리다이렉트

여기의 리다이렉트는 애플리케이션이 실행되기 전에 웹 서버에서 적용됩니다. 이는 플러그인 기반 리다이렉트보다 빠르며, 애플리케이션이 인식하지 못할 URL에 대해서도 작동합니다.

리다이렉트 추가

Add redirect를 클릭합니다.
Source path를 입력합니다.
Destination을 입력합니다.
301 Permanent 또는 302 Temporary를 선택합니다.
Preserve query string을 체크한 상태로 유지할지 결정합니다.
Add redirect를 클릭합니다.

리다이렉트가 적용되고 사이트에 대해 직접 확인되므로, 보이는 상태는 가정이 아닌 실제 동작을 반영합니다.

세 가지 소스 형태

형태	예시	일치
Exact	`/old-page`	그 경로만
Prefix	`/old-path/`	그 경로와 그 아래의 모든 것
Wildcard	`/blog/*`	`/blog/` 아래의 모든 것, 나머지 캡처

와일드카드 소스는 *와 일치하는 모든 것을 캡처하며, 대상에서 $1으로 참조할 수 있습니다. 따라서 /blog/*의 소스와 /news/$1의 대상을 사용하면 /blog/hello-world를 /news/hello-world으로 보내고, 한 규칙으로 다른 모든 게시물에 대해서도 동일하게 작동합니다.

리다이렉트가 생성된 후 소스 경로를 변경할 수 없습니다. 잘못된 경우 리다이렉트를 제거하고 새로 추가합니다. 대상, 코드, 쿼리 설정은 모두 편집 가능합니다.

대상

대상은 다음 중 하나입니다:

Relative (상대 경로), 예: /new-page, 같은 사이트의 다른 위치로 방문자를 보냅니다.
Absolute (절대 경로), 예: https://example.com/new, 완전히 다른 사이트로 보냅니다.

절대 경로는 vanity path를 만드는 방법입니다: 예를 들어 도메인의 /docs이 다른 곳에서 호스팅되는 문서를 가리킵니다.

301 또는 302

301 Permanent는 브라우저와 검색 엔진에 이동이 최종적이라고 알립니다. 검색 엔진은 순위 신호를 새 URL로 전달하고 이전 URL을 요청하지 않습니다. 브라우저는 리다이렉트를 캐시하며, 때때로 매우 오랫동안 캐시합니다.

302 Temporary는 이동이 되돌려질 수 있음을 나타냅니다. 아무것도 전달되지 않고 장기간 캐시되지 않습니다.

실제 재구성의 경우 301을 사용합니다: 페이지를 이동했고 돌아오지 않을 것입니다. 임시 캠페인을 가리키거나 유지 보수 공지를 게시하는 등 되돌릴 것으로 예상되는 경우 302를 사용합니다.

잘못된 301은 취소하는 데 비용이 많이 듭니다. 브라우저는 영구 리다이렉트를 공격적으로 캐시하므로, 잘못된 규칙을 한 번 따른 방문자는 삭제한 후에도 오랫동안 계속 따를 수 있으며, 캐시를 지울 방법이 없습니다. 확실하지 않을 때는 302로 시작하고 확실해진 후 301로 승격시킵니다.

쿼리 문자열 유지

Preserve query string은 기본적으로 활성화되어 있습니다. 활성화되면 ?utm_source=newsletter 및 다른 모든 매개변수가 대상으로 전달됩니다.

거의 모든 경우에 활성화된 상태로 두십시오. 쿼리 문자열을 잃으면 캠페인 추적이 깨지고, 페이지 매김과 필터가 깨지며, 상태를 전달하는 모든 링크가 깨집니다. 리다이렉트 목록은 비활성화된 규칙을 (query stripped)로 표시하므로 매개변수를 삭제하는 규칙을 한눈에 볼 수 있습니다.

대상이 이전 매개변수를 받으면 안 되는 경우, 예를 들어 이전 매개변수가 다르게 해석되어 잘못된 페이지가 렌더링되는 경우에만 비활성화합니다.

상태 배지 읽기

매 저장 후 리다이렉트는 캐시를 통하지 않고 사이트에 대해 직접 테스트되며, 그 결과가 Status 열의 배지가 됩니다.

배지	의미
Not yet verified	확인이 아직 실행되지 않았습니다. 잠시 후 새로고침하세요
Verified, with the code and destination	리다이렉트가 활성화되어 있고 구성한 대로 정확하게 작동 중입니다
Applied but not challenging, with a status	규칙이 작성되었지만 사이트가 다른 응답을 반환했습니다

세 번째 배지는 조치해야 할 것입니다. 이는 구성이 적용되었지만 리다이렉트가 작동하지 않음을 의미하며, 표시된 상태 코드는 대신 발생한 일을 알려줍니다.

저장 후 서버의 다른 구성이 같은 도메인을 요청한다는 경고가 표시될 수도 있습니다. 그 경우 해당 충돌이 해결될 때까지 리다이렉트가 적용되지 않으며, 메시지는 다른 구성의 이름을 표시합니다. 표시되는 경우 의미를 확실히 모르면 지원팀에 문의하세요.

편집 및 제거

각 행에는 편집 버튼과 제거 버튼이 있습니다.

편집은 대상, 코드, 쿼리 설정을 변경할 수 있게 합니다. 소스는 고정됩니다.

제거는 확인을 요청하고 발생할 일을 설명합니다: 해당 경로에 대한 요청은 리다이렉트되지 않고 사이트가 정상적으로 제공하는 것을 반환하며, 이는 종종 404입니다.

재구성 계획

많은 수의 URL을 이동하기 전에, 약간의 순서가 많은 문제를 절약합니다.

현재 URL 목록을 내보냅니다 사이트맵이나 분석에서, 실제로 트래픽을 얻는 것을 알 수 있도록 합니다.
이전을 새로 매핑합니다, URL당 한 줄. 접두사를 공유하는 모든 것을 그룹화합니다.
그룹에 와일드카드를 사용합니다. 하나의 /blog/* 규칙이 200개의 정확한 규칙을 이기며 드리프트되지 않습니다.
패턴을 따르지 않는 예외에 대해 정확한 규칙을 추가합니다.
각 형태를 한 번씩 테스트한 후 배지를 확인합니다.
이후 Site Traffic Analytics에서 4xx 개수를 감시합니다. 상승하는 404 점유율은 놓친 것이 있음을 의미합니다.

놓친 모든 것에 대한 안전망으로 브랜드된 404 페이지를 추가합니다. 이는 막힌 끝을 사이트로 돌아가는 경로로 바꿉니다. Custom Error Pages를 참조하세요.

문제 해결

리다이렉트가 작동하지 않습니다. 배지를 확인합니다. 적용되었지만 도전하지 않음이라고 표시되면 반환된 상태 코드를 기록합니다. 200은 보통 다른 것이 요청에 먼저 응답했음을 의미하며, 종종 애플리케이션 자체입니다.

작동하지만 잘못된 URL에 도착합니다. 체인을 확인합니다: 규칙이 다른 규칙이나 애플리케이션이 다시 리다이렉트하는 경로로 트래픽을 보낼 수 있습니다. 체인은 느리고 검색 엔진을 혼동시킵니다. 첫 번째 규칙이 최종 대상을 직접 가리키도록 합니다.

와일드카드가 모든 것을 한 페이지로 보냅니다. 대상에 $1이 누락되어 있습니다. 없으면 모든 캡처가 같은 대상으로 축소됩니다.

삭제한 리다이렉트가 여전히 브라우저에서 발생합니다. 이전에 301을 따랐고 브라우저에서 캐시했습니다. 개인 창에서 테스트하여 규칙이 정말 사라졌는지 확인합니다.

쿼리 매개변수가 사라집니다. 해당 규칙에서 Preserve query string이 비활성화되어 있습니다. 편집하고 다시 활성화합니다.

너무 많은 리다이렉트 또는 루프입니다. 두 규칙이 서로를 가리키거나, 규칙이 자신의 소스 패턴과 일치하는 경로를 가리킵니다. 루프의 한쪽을 제거합니다.