Server Plugin

HttpsRedirect

필수 의존성: io.ktor:ktor-server-http-redirect

코드 예제: ssl-engine-main-redirect

네이티브 서버

Ktor supports Kotlin/Native and allows you to run a server without an additional runtime or virtual machine.

지원: ✅

HttpsRedirect 플러그인은 모든 HTTP 요청을 처리하기 전에 해당 HTTPS 대응부로 리다이렉트합니다. 기본적으로 리소스는 301 Moved Permanently를 반환하지만, 302 Found를 반환하도록 설정할 수도 있습니다.

의존성 추가

HttpsRedirect을 사용하려면 빌드 스크립트에 ktor-server-http-redirect 아티팩트를 포함해야 합니다:

Gradle (Kotlin)Gradle (Groovy)Maven

HttpsRedirect 설치

애플리케이션에 HttpsRedirect 플러그인을 설치하려면, 지정된

모듈(module)

Modules allow you to structure your application by grouping routes.

내의 install 함수에 이를 전달하세요. 아래 코드 스니펫은 HttpsRedirect을 설치하는 방법을 보여줍니다...

• ... embeddedServer 함수 호출 내부에서.
• ... Application 클래스의 확장 함수인 명시적으로 정의된 module 내부에서.

embeddedServermodule

위의 코드는 기본 설정으로 HttpsRedirect 플러그인을 설치합니다.

리버스 프록시(reverse proxy) 뒤에 있는 경우, HTTPS 요청을 올바르게 감지하려면 ForwardedHeader 또는 XForwardedHeader 플러그인을 설치해야 합니다. 이러한 플러그인 중 하나를 설치한 후 무한 리다이렉트가 발생하면, 자세한 내용은 이 FAQ 항목을 확인하세요.

HttpsRedirect 설정

아래 코드 스니펫은 원하는 HTTPS 포트를 구성하고 요청된 리소스에 대해 301 Moved Permanently를 반환하도록 설정하는 방법을 보여줍니다:

install(HttpsRedirect) {
    sslPort = 8443
    permanentRedirect = true
}

전체 예제는 여기에서 찾을 수 있습니다: ssl-engine-main-redirect.