TurboSoporta dominios y subdominios multinivel, certificados SSL, direcciones alias, redirecciones, reescrituras, headers o MIME personalizados. Adapta diferentes lenguajes de programación. Controla frecuencias, cantidades, tiempos y tamaños de requests.
Turbo es un servidor web rápido que incluye una interfaz sencilla para configurarlo en tiempo real; organizar uno o más sitios web como dominios y subdominios multinivel; instalar y cambiar certificados SSL fácilmente, o crearlos y renovarlos con la integración a Certbot; adaptar distintos lenguajes de programación asignando preprocesadores para archivos con extensiones específicas; aplicar direcciones web alias, redirecciones de URL y reescrituras de URI; incluir cabeceras (headers) adicionales o modificar cabeceras de tipos de contenidos (MIME) según extensiones de archivos; ajustar frecuencias y cantidades permitidas de peticiones; o limitar tiempos de procesamiento y tamaños para peticiones (requests); e incluye mitigación nativa integrada contra la vulnerabilidad DDoS HTTP/2 Rapid Reset (CVE-2023-44487).
REQUISITOS
- Conocimiento de servidores (VPS, bare metal...), sistema operativo Linux y línea de comandos Bash.
- Distribución de Linux con systemd, nano y wget (comúnmente preinstalados).
- Servidor con arquitectura de 64 bits y 128 MB de RAM disponible (mínimo recomendado).
- Opcional: instalación de Certbot (instrucciones), para obtener y renovar certificados SSL.
> uname -m
> sudo
Para usuarios de proveedores de VPS (como AWS, Google Cloud, etc.), las opciones están en las consolas de administración.
> sudo mkdir /home/server/
> sudo wget https://github.com/okzgn/turbo-go/releases/download/v2.3.rc3/turbo-v2.3.rc3-linux-amd64 -O /home/server/turbo
> sudo chmod 755 /home/server/turbo
Para pruebas, pasar de aquí a Cómo utilizar.
> cd /etc/systemd/system/ > sudo nano turbo.serviceEscribir o pegar este contenido en el editor:
[Unit] Description=Turbo After=network.target [Install] WantedBy=multi-user.target [Service] Type=simple ExecStart=/home/server/turbo WorkingDirectory=/home/server/ Restart=always RestartSec=5 StandardOutput=/dev/null StandardError=/dev/nullGuardar el archivo turbo.service (Ctrl + O, Enter, Ctrl + X).
> sudo systemctl daemon-reload > sudo systemctl enable turbo
> sudo systemctl start turbo
Otros comandos:
- Para detener momentáneamente el servicio, use el comando stop.
- O use disable para detener completamente el servicio del servidor web.
REQUISITOS
- Sistema operativo Windows 10 / Server 2016 o superior.
- Equipo o servidor con arquitectura de 64 bits (x64, AMD64).
- Privilegios de Administrador (para abrir puertos y ejecutar el servidor).
- PowerShell instalado y actualizado, para ejecutar los siguientes comandos (ejemplos).
> mkdir C:\server\
> Invoke-WebRequest https://github.com/okzgn/turbo-go/releases/download/v2.3.rc3/turbo-v2.3.rc3-windows-x64.exe -OutFile C:\server\turbo.exe
> New-NetFirewallRule -DisplayName "Turbo" -Direction Inbound -LocalPort 80,443 -Protocol TCP -Action Allow
Para usuarios de proveedores de VPS (Azure, AWS, etc.), recuerde que también deberá abrir estos puertos desde la consola de administración en la nube.
> cd C:\server\ > .\turbo.exe
Nota: En Windows, si cierra la ventana de la terminal, el servidor se detendrá. Para mantenerlo activo en segundo plano de forma permanente, puede configurar turbo.exe como un servicio de Windows utilizando herramientas gratuitas como WinSW (recomendado), NSSM o mediante el Programador de tareas.
La versión gratuita se distribuye bajo la licencia GNU Affero General Public License (AGPL v3). Al descargarla, acepta sus términos.
IMPORTANTE
Como mínimo, completar la instalación hasta el paso 6.
EN CASO DE:
Ejecutar Turbo para continuar.
- No instalar o no iniciar Turbo como servicio (paso 7 u 8).
- Hacer pruebas.
Ejemplo:
> cd /home/server/ > sudo ./turboEjemplo, ejecutar SIN sudo:
> cd /home/server/ > sudo setcap cap_net_bind_service=+ep ./turbo > ./turbo
EN CASO DE:
Ejecutar Turbo (como Administrador) para continuar.
- Hacer pruebas de configuración.
- Haber cerrado la terminal donde se ejecutaba el servidor.
Ejemplo:
> cd C:\server\ > .\turbo.exe
Acceda a la interfaz (panel de control o administración, GUI) a través de una de las siguientes direcciones web.
Mediante la IP pública o el dominio web del servidor donde instaló Turbo.
http://11.22.33.44/admin:
http://dominio.com/admin:
O con localhost, si no está conectado a Internet:
http://localhost/admin:
Allí, el formulario de acceso se verá como a continuación.
Ingrese con los datos por defecto:
Usuario: Turbo
Contraseña: Admin
IMPORTANTE
- Los datos de acceso por defecto se restablecen en caso de: reiniciar el proceso, servicio o servidor (VPS, etc.), o al cerrar y volver a ejecutar Turbo.
- Para cambiar los datos de acceso por defecto desde el binario, compile Turbo desde el código fuente y con las instrucciones del repositorio oficial de Turbo.
- Variables de entorno para cambiar usuario, contraseña y directorio de sitios: TURBO_USER, TURBO_PASSWORD, TURBO_DIR (respectivamente). O cambie las credenciales desde la interfaz y guarde la configuración.
- Personalización de la interfaz (GUI): Puede sobreescribir o reemplazar completamente los archivos del panel de administración en tiempo real creando una carpeta llamada turbo.dev con sus archivos respectivos (turbo.dev/admin/#.html, turbo.dev/inside/#.html) en el directorio de sitios. Implica conocer a profundidad y de manera avanzada la API (documentación de API).
Al ingresar, según la pantalla del dispositivo, la interfaz luce como en la imagen. Desde dentro podrá cambiar el usuario y la contraseña por defecto, o instalar certificados SSL para conectarse de forma segura. Cada sesión es única y se cierra automáticamente si el lapso de inactividad supera 1 minuto.
Continúe a Documentación para conocer las opciones de la interfaz.
Estas opciones requerirán la contraseña en el primer cuadro de diálogo. Si se usan por primera vez, ingrese la contraseña por defecto (vea la sección interfaz de configuración).
Estas opciones se refieren a los tiempos permitidos para procesar o responder las peticiones recibidas por el servidor web. Se pueden especificar en milisegundos (ms), segundos (s) o minutos (m).
Estas opciones fijan lapsos de tiempo de referencia y el número de peticiones que, durante esos lapsos, el servidor web aceptará de cada emisor (IP).
Estas opciones especifican la cantidad de bytes que el servidor procesará de las peticiones entrantes.
Esta opción crea la estructura de directorios (carpetas) para cada sitio en el directorio de sitios. Se puede agregar como: localhost, IP (v4), o dirección web multinivel (con o sin wildcards). Al agregarlo, se verá en la interfaz, y al hacer clic en cualquier sitio agregado se mostrarán las opciones disponibles, las configuraciones de cada sitio y sus subdominios. En cada sitio, se incluye automáticamente el subdominio raíz, que equivale al mismo sitio, para configurarlo específicamente. No hay límite de sitios ni datos relativos a sitios. Los archivos públicos de cada sitio deben colocarse dentro de la subcarpeta creada automáticamente con el nombre @. El servidor traducirá a # físicamente en el disco los comodines * de los dominios con wildcards (ej. *.org, *.com.es).
Opciones disponibles para cualquier sitio o subdominio.
Añade direcciones que dirigen al mismo sitio o subdominio, sin redireccionar. Los alias añadidos se eliminan haciendo clic en cada uno.
Ejecuta Certbot, si está instalado, para solicitar el certificado SSL para el sitio o subdominio. Certbot se ejecutará en segundo plano, y se mostrará el resultado o el estado del proceso haciendo clic en Respuesta SSL. Si el sitio o subdominio es wildcard, Certbot podría necesitar instalar componentes adicionales para obtener el certificado.
Activa la redirección al protocolo HTTPS de todas las visitas o peticiones por medio de HTTP del sitio o subdominio. Para activar esta opción, se necesita un certificado SSL previamente obtenido con Crear SSL; o colocar archivos válidos (fullchain.pem y privkey.pem) de certificados SSL en el directorio (carpeta) del sitio o subdominio para instalarlos al hacer clic. La instalación, actualización o desactivación de certificados SSL se realiza en tiempo real en la memoria RAM sin interrumpir las conexiones activas ni requerir el reinicio del servidor.
/home/server/dominio.com/fullchain.pemPara otros subdominios:
/home/server/dominio.com/privkey.pem
/home/server/dominio.com/subdominio/fullchain.pem
/home/server/dominio.com/subdominio/privkey.pem
Elimina el contenido del directorio (carpeta) del sitio o subdominio y sube en su lugar los archivos o directorios seleccionados.
Elimina todo lo relacionado con un sitio o subdominio, incluido el directorio (carpeta). Si es sitio, los subdominios también se eliminarán con toda la información relacionada. Si es subdominio raíz, esta opción se mostrará como Borrar sitio, ya que equivale al mismo sitio. En cualquier caso, no se harán cambios en el archivo de configuración hasta que se utilice la opción guardar configuración.
Estas opciones son únicamente para sitios o subdominios raíz, porque son equivalentes y, por defecto, comparten estas opciones de redirección.
Visita: https://dominio.com
Redirección: https://www.dominio.com
Visita: https://www.dominio.com
Redirección: https://dominio.com
Esta opción crea la estructura de directorios (carpetas) de cada subdominio dentro del directorio del sitio al que pertenece, a excepción del subdominio raíz. Se puede agregar como multinivel (nivel3.nivel2.subdominio) y puede incluir wildcards. Al agregarlo, se verá en la interfaz, y al hacer clic en cualquier subdominio agregado se mostrarán las opciones disponibles y las configuraciones de cada subdominio. No hay límite de subdominios ni datos relativos a subdominios. Los archivos públicos de cada subdominio deben colocarse dentro de la subcarpeta creada automáticamente con el nombre @. El servidor traducirá a # físicamente en el disco los comodines * de los subdominios con wildcards (ej. *.ejemplo.com, *.area.dominio.org).
Opciones disponibles para cualquier subdominio.
Agrega una sobrescritura de la cabecera (header) Content-Type por defecto de los archivos con la extensión especificada del subdominio, por el contenido ingresado. Es posible especificar una extensión vacía para referirse a archivos sin extensión (como en la imagen).
Agrega la cabecera (header) con el nombre y contenido especificado a todos los archivos del subdominio.
Agrega una reescritura de la ruta de archivo, directorio, o recurso (URI) determinado, para tratarlo internamente como otra ruta de archivo, directorio o recurso especificado sin redireccionarlo. No es obligatorio ingresar una URI existente. Se puede acceder a la información de la primera URI y datos del sitio y subdominio con palabras clave (útil en sitios o subdominios con wildcards y para preprocesadores).
Para redireccionar normalmente una ruta relativa, ingrese solo el dominio de destino. La ruta se añadirá automáticamente al dominio.
{PALABRA_CLAVE}Palabras clave disponibles:
Asigna el preprocesador determinado para todos los archivos con la extensión especificada del subdominio. El preprocesador requiere procesar y responder, mediante CGI y las variables de entorno respectivas, las peticiones de los archivos con la extensión especificada.
Para preprocesadores como php-cgi, Turbo inyecta automáticamente la variable de entorno REDIRECT_STATUS=CGI, permitiendo ejecutar scripts de PHP directamente sin modificar el archivo php.ini.
IMPORTANTE: En caso de que el binario no exista o la configuración para preprocesar los archivos no esté activa, los archivos para uso dinámico (preprocesados, usualmente código) serán servidos como estáticos (texto plano, etc., dependiendo del MIME), lo que puede exponer la confidencialidad de estos archivos y su código fuente.
Agrega el archivo por defecto para responder a peticiones (requests) de directorios (carpetas). Es necesario que el archivo especificado exista en cada directorio. Si se especifica más de uno, la prioridad son los archivos asociados con preprocesadores.
Para registrar los accesos rechazados por el limitador de frecuencia, cree un archivo accesible llamado turbo.denials, y para registrar cada acceso a cada archivo o ruta en el servidor, cree otro archivo llamado turbo.visits, en el mismo directorio donde esté el ejecutable de Turbo. Ya que pueden aumentar mucho de tamaño, no cree estos archivos si no necesita registros. Cualquier otro registro se mostrará en la salida estándar (stdout) o en la consola.
Permite bloquear de forma manual e inmediata direcciones IP específicas (IPv4 o IPv6). Se ingresa la dirección IP y la fecha en formato timestamp UNIX hasta el cual el IP permanecerá bloqueado. Transcurrido ese tiempo, el servidor la desbloquea automáticamente. Para eliminar el bloqueo manualmente antes de la fecha, haga clic sobre la X del IP en la lista.
Permite personalizar la respuesta o plantilla de texto/HTML devuelta por el servidor cuando ocurre un código de estado de error HTTP determinado (códigos entre 400 y 599, o 0 para la respuesta general por defecto). Se utiliza la etiqueta {TURBO_RESPONSE_CODE} para incluir dinámicamente el código de error en la respuesta.
Permite definir reglas globales de sustitución de caracteres especiales en las URIs recibidas. Sustituye caracteres que puedan causar conflictos con delimitadores de URL (por ejemplo: ; por -.-, # por -,-, o & por -_-) por cadenas seguras antes de ser procesadas por el motor de rutas y la interfaz.