Skip to content

HTTP/2 ​

코드 예제: http2-netty, http2-jetty

HTTP/2는 HTTP/1.x를 대체하기 위해 설계된 최신 바이너리 멀티플렉싱(multiplexing) 프로토콜입니다.

Ktor는 Jetty 및 Netty 서버 엔진에서 HTTP/2를 지원합니다. 그러나 두 엔진 사이에는 상당한 차이가 있으며, 각 엔진마다 추가적인 설정이 필요합니다. 호스트가 구성되고 나면 HTTP/2 지원이 자동으로 활성화됩니다.

HTTP/2 over TLS를 사용하려면 일반적으로 다음이 필요합니다.

일반 텍스트 기반 HTTP/2(h2c)는 Netty 엔진에서 사용할 수 있으며 SSL이나 ALPN 설정이 필요하지 않습니다.

SSL 인증서 설정 ​

HTTP/2 자체에는 TLS가 필수로 요구되지 않지만, 웹 브라우저는 일반적으로 암호화된 연결에서만 HTTP/2를 지원합니다. HTTP/2 over TLS를 사용하려면 서버에 SSL 인증서를 설정해야 합니다.

테스트용의 경우 JDK의 keytool 유틸리티를 사용하여 자체 서명된 인증서를 생성할 수 있습니다.

bash
keytool -keystore test.jks -genkeypair -alias testkey -keyalg RSA -keysize 4096 -validity 5000 -dname 'CN=localhost, OU=ktor, O=ktor, L=Unspecified, ST=Unspecified, C=US'

buildKeyStore() 함수를 사용하여 프로그래밍 방식으로 키스토어를 생성할 수도 있습니다.

그런 다음 application.conf 또는 application.yaml 설정 파일에서 해당 키스토어를 사용하도록 Ktor를 구성합니다.

shell
ktor {
    deployment {
        port = 8080
        sslPort = 8443
    }

    application {
        modules = [ com.example.ApplicationKt.main ]
    }

    security {
        ssl {
            keyStore = test.jks
            keyAlias = testkey
            keyStorePassword = foobar
            privateKeyPassword = foobar
        }
    }
}
yaml
ktor:
    deployment:
        port: 8080
        sslPort: 8443
    application:
        modules:
            - com.example.ApplicationKt.main

    security:
        ssl:
            keyStore: test.jks
            keyAlias: testkey
            keyStorePassword: foobar
            privateKeyPassword: foobar

ALPN 설정 ​

HTTP/2 over TLS는 클라이언트와 서버 간의 프로토콜 협상을 위해 ALPN(Application-Layer Protocol Negotiation)을 사용합니다. ALPN 설정은 사용하는 서버 엔진에 따라 달라집니다.

Jetty ​

Jetty 엔진은 추가적인 Ktor 설정 없이도 ALPN을 처리합니다. Jetty에서 HTTP/2 over TLS를 사용하려면 다음 단계를 따릅니다.

  1. Jetty 엔진으로 서버를 생성합니다.
  2. SSL 인증서를 설정합니다.
  3. sslPort를 설정합니다.

Jetty를 사용한 HTTP/2의 완전한 실행 예제는 http2-jetty를 참고하세요.

Netty ​

Netty에서 HTTP/2 over TLS를 사용하려면 Netty tcnative OpenSSL 바인딩을 추가해야 합니다.

다음 예제는 build.gradle.kts 파일에 정적으로 링크된 BoringSSL 구현체를 추가하는 방법을 보여줍니다.

kotlin
val osName = System.getProperty("os.name").lowercase()
val tcnative_classifier = when {
    osName.contains("win") -> "windows-x86_64"
    osName.contains("linux") -> "linux-x86_64"
    osName.contains("mac") -> "osx-x86_64"
    else -> null
}
dependencies {
    if (tcnative_classifier != null) {
        implementation(variantOf(libs.netty.tcnative.boringssl.static) { classifier(tcnative_classifier) })
    } else {
        implementation(libs.netty.tcnative.boringssl.static)
    }
}

tc.native.classifier는 linux-x86_64, osx-x86_64 또는 windows-x86_64가 될 수 있습니다.

Netty를 사용한 HTTP/2의 완전한 실행 예제는 http2-netty를 참고하세요.

TLS 없는 HTTP/2 ​

Netty 엔진은 TLS 없이 HTTP/2 통신을 지원하는 일반 텍스트 기반 HTTP/2(h2c)를 지원합니다. 이는 암호화가 필요하지 않은 사설 네트워크 환경에서 유용할 수 있습니다.

클라이언트는 h2c를 사용하여 직접 연결하거나 HTTP/1.1 연결을 HTTP/2로 업그레이드할 수 있습니다.

h2c를 활성화하려면 엔진 구성에서 enableH2c와 enableHttp2 옵션을 모두 true로 설정합니다.

kotlin
embeddedServer(Netty, configure = {
    connector {
        port = 8080
    }
    enableHttp2 = true
    enableH2c = true
})

동일한 서버에서 h2c와 HTTP/2 over TLS를 동시에 활성화할 수도 있습니다. 일반 텍스트 커넥터는 h2c 연결을 수락하고, SSL 커넥터는 HTTP/2 over TLS를 사용합니다.