En esta página

Qt HTTP Server

Qt HTTP Server se ofrece soporte para integrar la funcionalidad de servidor HTTP en una aplicación. El principal caso de uso consiste en exponer la funcionalidad de la aplicación a través de API REST, o en hacer que los dispositivos de un entorno de confianza también sean configurables a través de HTTP. Un entorno de confianza también implica que el servidor « Qt HTTP Server » no debe estar expuesto directamente a Internet ni utilizarse para proporcionar la funcionalidad de un servidor web de uso general a los usuarios finales. Para obtener más detalles, consulta «Limitaciones y seguridad».

Descripción general

Qt HTTP Server proporciona los componentes básicos para integrar en una aplicación un servidor HTTP ligero compatible con HTTP/2, HTTP/1.1 y HTTP/1.0. Existen clases para los mensajes enviados y recibidos, así como para las distintas partes de un servidor HTTP.

La clase ` QHttpServer ` dispone de la función ` route()` para asociar funciones ejecutables a diferentes URL entrantes. Estas funciones ejecutables pueden tomar como argumentos una colección ` extensible ` de diferentes tipos copiables que se extraen de la URL. Los tipos admitidos son la mayoría de los tipos numéricos, ` QString`, ` QByteArray` y ` QUrl`. Opcionalmente, las funciones ejecutables también pueden tomar objetos ` QHttpServerRequest ` y ` QHttpServerResponder ` como argumentos. La clase QHttpServerRequest contiene toda la información de una solicitud entrante y es necesaria para obtener el body() a partir de una solicitud HTTP POST. Las funciones devuelven un objeto QHttpServerResponse o responden utilizando el argumento QHttpServerResponder. La clase QHttpServerResponse contiene una respuesta completa y cuenta con numerosos constructores para diferentes tipos, mientras que la clase QHttpServerResponder dispone de varios métodos para enviar la respuesta al cliente.

La clase QHttpServer también cuenta con la función addAfterRequestHandler() para procesar un QHttpServerResponse con mayor detalle, y la función setMissingHandler() para anular el comportamiento predeterminado de devolver 404 Not Found cuando no se encuentra ninguna ruta que coincida. De la clase QAbstractHttpServer hereda la función bind() para vincularse a un QTcpServer, QSslServer o QLocalServer en escucha.

También se puede crear un servidor HTTP creando una subclase de la clase QAbstractHttpServer y sobrescribiendo las funciones handleRequest() y missingHandler().

El registro en tiempo de ejecución se puede configurar tal y como se describe aquí.

Limitaciones y seguridad

Qt HTTP Server no cuenta con muchas de las características y optimizaciones más avanzadas que tienen los servidores HTTP de uso general. Tampoco ha sido sometido al mismo escrutinio en lo que respecta a diversos vectores de ataque a través de la red. Por lo tanto, utiliza Qt HTTP Server únicamente para conexiones locales o en una red de confianza, y no expongas los puertos a Internet.

No obstante, puede añadir compatibilidad con HTTPS como medida de seguridad básica. Si Qt se compila con soporte para TLS, puede vincular el servidor HTTP a un objeto ` QSslServer `, lo que proporciona gestión de la seguridad de la capa de transporte (TLS).

La función ` QSslSocket::SupportedFeature::ServerSideAlpn ` del backend TLS activo es necesaria para la compatibilidad con HTTP/2. Para comprobar si un backend la admite, utilice ` QSslSocket::isFeatureSupported`.

Consulte «Qt HTTP Server: consideraciones de seguridad».

Uso del módulo

Para utilizar un módulo Qt es necesario vincularlo a la biblioteca del módulo, ya sea directamente o a través de otras dependencias. Varias herramientas de compilación ofrecen soporte específico para ello, entre ellas CMake y qmake.

Compilación con CMake

Utilice el comando « find_package() » para localizar los componentes del módulo necesarios en el paquete Qt6:

find_package(Qt6 REQUIRED COMPONENTS HttpServer)
target_link_libraries(mytarget PRIVATE Qt6::HttpServer)

Consulte también la descripción general de «Compilación con CMake ».

Compilación con qmake

Para configurar el módulo para la compilación con qmake, añade el módulo como valor de la variable QT en el archivo .pro del proyecto:

QT += httpserver

Licencias

Qt HTTP Server está disponible bajo licencias comerciales de The Qt Company. Además, está disponible bajo la Licencia Pública General de GNU, versión 3. Consulta «Licencias de Qt» para obtener más detalles.

Referencia

Ejemplos

El módulo proporciona los siguientes ejemplos a modo de guía para el uso de la API.

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.