리디렉션은 방문자를 이전 URL에서 새 URL로 보내는 기능으로, 이를 통해 사이트를 가리키는 모든 링크를 깨뜨리지 않고도 사이트 구조를 재구성할 수 있습니다. 이 가이드는 세 가지 소스 형태, 301과 302 중 선택하는 방법, 쿼리 문자열, 그리고 확인 배지를 읽는 방법을 다룹니다.
KPanel에서 리디렉션 위치
- KPanel에 로그인합니다.
- 왼쪽 사이드바에서 웹사이트를 클릭한 다음 해당 사이트를 클릭합니다.
- 사이트의 왼쪽 메뉴에서 설정를 연 다음 리다이렉트를 엽니다.
직접 주소는 /websites/<site-id>/redirects입니다.
여기서의 리디렉션은 애플리케이션이 실행되기 전, 웹 서버에 의해 적용됩니다. 이 때문에 플러그인 기반 리디렉션보다 빠르며, 애플리케이션이 전혀 인식하지 못하는 URL에 대해서도 작동합니다.
리디렉션 추가하기
- 리디렉션 추가를 클릭합니다.
- 소스 경로를 입력합니다.
- Destination을 입력합니다.
- 301 영구 또는 302 임시를 선택합니다.
- 쿼리 문자열 보존을 체크할지 결정합니다.
- 리디렉션 추가를 클릭합니다.
리디렉션이 적용된 후 사이트에 대해 직접 확인되므로, 표시되는 상태는 추측이 아니라 실제 동작을 반영합니다.
세 가지 소스 형태
| 형태 | 예시 | 일치 대상 |
|---|---|---|
| 정확히 일치 | /old-page | 해당 경로 하나만 |
| 접두사 | /old-path/ | 해당 경로와 그 하위 모든 것 |
| 와일드카드 | /blog/* | /blog/ 아래의 모든 것, 나머지를 캡처 |
와일드카드 소스는 *에 일치한 부분을 캡처하며, 목적지는 이를 $1로 참조할 수 있습니다. 따라서 소스가 /blog/*이고 목적지가 /news/$1인 경우, /blog/hello-world를 /news/hello-world로 보내며, 규칙 하나로 다른 모든 게시물에 대해서도 동일하게 작동합니다.
리디렉션이 생성된 후에는 소스 경로를 변경할 수 없습니다. 잘못 입력했다면 리디렉션을 삭제하고 새로 추가하세요. 목적지, 코드, 쿼리 설정은 모두 편집 가능합니다.
목적지
목적지는 다음 중 하나일 수 있습니다:
- 상대 경로:
/new-page처럼, 같은 사이트 내 다른 곳으로 방문자를 보냅니다. - 절대 경로:
https://example.com/new처럼, 완전히 다른 사이트로 방문자를 보냅니다.
절대 목적지는 예를 들어, 다른 곳에 호스팅된 문서를 가리키는 도메인 상의 /docs처럼 사용자 지정 경로(vanity path)를 만드는 방법입니다.
301인가 302인가
301 영구는 브라우저와 검색 엔진에게 이동이 최종적임을 알립니다. 검색 엔진은 순위 신호를 새 URL로 이전하고 이전 URL에 대한 요청을 중단합니다. 브라우저는 리디렉션을 캐시하며, 때로는 매우 오랫동안 유지합니다.
302 임시는 이동이 되돌려질 수 있음을 나타냅니다. 아무것도 이전되지 않으며 장기간 캐시되지 않습니다.
실제로 구조를 재편한 경우, 즉 페이지를 옮겼고 되돌아올 계획이 없다면 301을 사용하세요. 임시 캠페인 페이지나 점검 안내처럼 나중에 되돌릴 것으로 예상되는 경우에는 302를 사용하세요.
잘못된 301은 되돌리기 어렵습니다. 브라우저는 영구 리디렉션을 적극적으로 캐시하므로, 잘못된 규칙에 한 번 걸린 방문자는 여러분이 그 규칙을 삭제한 후에도 오랫동안 계속 따라갈 수 있으며, 여러분이 그들의 캐시를 지울 방법은 없습니다. 확신이 서지 않을 때는 302로 시작한 다음, 확신이 서면 301로 승격하세요.
쿼리 문자열 보존
쿼리 문자열 보존은 기본적으로 켜져 있습니다. 이 옵션이 켜져 있으면 ?utm_source=newsletter과 다른 모든 매개변수가 목적지까지 그대로 전달됩니다.
거의 모든 경우에 이 옵션을 켜둔 채로 두세요. 쿼리 문자열을 잃으면 캠페인 추적이 깨지고, 페이지네이션과 필터가 깨지며, 상태를 전달하는 모든 링크가 깨집니다. 리디렉션 목록에서는 이 옵션이 꺼진 규칙을 (query stripped)로 표시하므로, 어떤 규칙이 매개변수를 누락하는지 한눈에 확인할 수 있습니다.
목적지가 이전 매개변수를 절대 받아서는 안 되는 경우, 예를 들어 이전 매개변수가 다르게 해석되어 잘못된 페이지가 렌더링되는 경우에만 이 옵션을 끄세요.
상태 배지 읽기
저장할 때마다 리디렉션은 캐시를 거치지 않고 사이트에 대해 직접 테스트되며, 그 결과가 Status 열의 배지로 표시됩니다.
| 배지 | 의미 |
|---|---|
| 아직 확인되지 않음 | 아직 검사가 실행되지 않았습니다. 잠시 후 새로고침하세요 |
| 코드와 목적지가 표시된 확인됨 | 리디렉션이 작동 중이며 설정한 그대로 동작하고 있습니다 |
| 상태와 함께 적용되었지만 작동하지 않음 | 규칙은 작성되었지만 사이트가 다른 것을 반환했습니다 |
세 번째 배지가 조치가 필요한 항목입니다. 이는 설정은 되어 있지만 리디렉션이 적용되지 않고 있음을 의미하며, 표시된 상태 코드가 실제로 어떤 일이 일어났는지 알려줍니다.
저장 후 서버의 다른 설정이 같은 도메인을 사용하고 있다는 경고가 표시될 수도 있습니다. 이 경우 해당 충돌이 해결될 때까지 리디렉션이 적용되지 않으며, 메시지에는 해당 다른 설정의 이름이 표시됩니다. 이 메시지를 보고 의미를 잘 모르겠다면 지원팀에 문의하세요.
편집 및 삭제
각 행에는 편집 버튼과 삭제 버튼이 있습니다.
편집을 통해 목적지, 코드, 쿼리 설정을 변경할 수 있습니다. 소스는 고정되어 있습니다.
삭제를 클릭하면 확인을 요청하며 어떤 일이 일어날지 설명합니다. 해당 경로에 대한 요청은 더 이상 리디렉션되지 않고, 사이트가 그 경로에서 일반적으로 제공하는 것(흔히 404)을 반환합니다.
구조 재편 계획하기
많은 수의 URL을 이동하기 전에, 약간의 순서 정리만으로도 많은 고생을 덜 수 있습니다.
- 사이트맵이나 분석 도구에서 현재 URL 목록을 내보내서 실제로 트래픽이 발생하는 URL이 무엇인지 파악합니다.
- 이전 URL과 새 URL을 매핑하여, URL당 한 줄씩 작성합니다. 접두사를 공유하는 항목은 그룹으로 묶습니다.
- 그룹에는 와일드카드를 사용하세요.
/blog/*규칙 하나가 200개의 정확 일치 규칙보다 낫고, 시간이 지나도 어긋나지 않습니다. - 패턴을 따르지 않는 예외 사항에 대해 정확 일치 규칙을 추가합니다.
- 각 형태를 한 번씩 테스트한 다음, 배지를 확인합니다.
- 이후 사이트 트래픽 분석에서 4xx 수치를 지켜보세요. 404 비율이 올라간다면 무언가 놓친 것입니다.
놓친 부분에 대한 안전망으로 브랜드가 적용된 404 페이지를 추가하세요. 막다른 길을 사이트로 돌아오는 경로로 바꿔줍니다. 사용자 지정 오류 페이지를 참조하세요.
문제 해결
리디렉션이 작동하지 않습니다. 배지를 확인하세요. 적용되었지만 작동하지 않는다고 표시되면 반환된 상태 코드를 확인하세요. 200은 보통 다른 무언가가 요청에 먼저 응답했음을 의미하며, 흔히 애플리케이션 자체인 경우가 많습니다.
작동은 하지만 잘못된 URL로 이동합니다. 체인이 있는지 확인하세요. 여러분의 규칙이 다른 규칙이나 애플리케이션이 다시 리디렉션하는 경로로 트래픽을 보내고 있을 수 있습니다. 체인은 느리고 검색 엔진을 혼란스럽게 만듭니다. 첫 번째 규칙이 최종 목적지를 직접 가리키도록 하세요.
와일드카드가 모든 것을 한 페이지로 보냅니다. 목적지에 $1이 빠져 있습니다. 이것이 없으면 모든 캡처가 같은 대상으로 합쳐집니다.
삭제한 리디렉션이 브라우저에서 여전히 작동합니다. 이전에 301을 따라갔고 브라우저가 이를 캐시했습니다. 비공개 창에서 테스트하여 규칙이 정말로 사라졌는지 확인하세요.
쿼리 매개변수가 사라집니다. 해당 규칙에서 쿼리 문자열 보존이 꺼져 있습니다. 편집하여 다시 켜세요.
리디렉션이 너무 많거나 루프가 발생합니다. 두 규칙이 서로를 가리키고 있거나, 한 규칙이 자기 자신의 소스 패턴과 일치하는 경로를 가리키고 있습니다. 루프의 한쪽을 제거하세요.
관련 페이지
- 아무것도 일치하지 않을 때 방문자가 보게 되는 화면을 위한 사용자 지정 오류 페이지
- 구조 재편 후 3xx 및 4xx 수치를 지켜보기 위한 사이트 트래픽 분석
- 경로를 이동하는 대신 잠그기 위한 사이트 비밀번호 보호