Términos, definidos una vez

Software que se ejecuta en hardware que el operador posee o alquila directamente, sin nada del lado del proveedor.

Un producto self-hosted se instala en tu máquina y se ejecuta allí. Ninguna base de datos del proveedor guarda tus registros, no hay un sistema de cuentas por usuario y ningún servicio puede revocar el acceso a datos que ya están en tu disco. Los dos productos de Vorqul funcionan así: VorqulBOT como proceso de Node y VorqulPanel como JAR de Java.

VorqulPanelDirect answers

Relacionado Panel de control del servidorTelemetríaLicencia única

Una única interfaz de administración para los servicios que se ejecutan en un servidor Linux.

Un panel de control reúne alojamiento web, DNS, correo, bases de datos, acceso a archivos, reglas de firewall y monitorización en una sola interfaz. Los cambios habituales dejan de significar un archivo de configuración distinto para cada subsistema. VorqulPanel cubre esas áreas en un servidor y guarda sus propios datos en SQLite o, si lo prefieres, en MySQL, MariaDB o PostgreSQL.

VorqulPanel

Relacionado Self-hostedInterruptor de móduloBase de datos del panel

Una sola compra que cubre un despliegue, en lugar de una suscripción recurrente.

VorqulPanel se licencia así. Pagas una vez por despliegue, el precio depende de en cuántos servidores se ejecuta y puedes seguir usando la versión que compraste sin renovar. Quedan excluidas la redistribución, la reventa, la sublicencia y el alojamiento para terceros.

License

Relacionado Self-hostedTelemetría

Datos de uso que el software instalado envía de vuelta a su proveedor.

La telemetría aparece tanto en software abierto como comercial y los proveedores suelen llamarla anónima. Los productos de Vorqul no envían ninguna. Eso significa también que no hay comprobación de licencia en ejecución y nada que deje de funcionar si el proveedor deja de funcionar.

Direct answers

Relacionado Self-hostedRegistro de auditoría

Un registro de acciones administrativas al que solo se añade, para poder atribuir los cambios a alguien después.

Saber que un ajuste cambió es una cosa. Saber quién lo cambió, cuándo y desde dónde es lo que da un registro de auditoría. VorqulBOT lleva uno por servidor y VorqulPanel uno por máquina, y ambos se quedan en infraestructura que controla el operador.

Moderation

Relacionado Autenticación de dos factores (TOTP)Historial de casos

Dónde guarda VorqulPanel su propio estado: SQLite por defecto, con MySQL, MariaDB y PostgreSQL como opciones y SQL Server en beta.

Es independiente de las bases de datos que el panel crea para tus sitios. Cambiar de motor más tarde no mueve los datos, así que elígelo al instalar con DB_ENGINE.

Database managementUnattended install

Relacionado Panel de control del servidorCopia offsite

Un ajuste que activa o desactiva toda una parte de VorqulPanel: alojamiento de juegos, alojamiento web, correo o una de sus subfunciones.

Un interruptor desactivado oculta la entrada del menú y además hace que la API responda 404, así que la función tampoco se alcanza por URL. No se desinstala nada ni se borra ningún dato, y al volver a activarlo todo regresa.

Feature switches

Relacionado Root helper (vorqul-helper)vorqulctl

Un segundo paso de inicio de sesión con un código temporal de una aplicación, que VorqulPanel puede exigir a los administradores.

Actívala en Settings, Account justo después de crear el admin. Si pierdes el acceso, vorqulctl reset-admin emite un nuevo enlace de configuración.

First login

Relacionado Setup URLRegistro de auditoría

La herramienta de línea de comandos que se instala con VorqulPanel para iniciar, actualizar, recuperar e inspeccionar el panel.

Envuelve el servicio systemd y las tareas que hacen falta a su alrededor: status, logs, setup-url, reset-admin, modules, update con reversión automática, fix-libs y uninstall. Se ejecuta como root o con sudo.

Command reference

Relacionado Setup URLRoot helper (vorqul-helper)Interruptor de módulo

Un pequeño script propiedad de root que realiza las pocas acciones con privilegios que necesita VorqulPanel, para que el panel pueda ejecutarse como usuario sin privilegios.

Acepta una lista fija de acciones y rechaza todo lo demás. Su política está en /etc/vorqul-helper.conf y se recorta a los módulos que activaste, por eso activar un módulo solo en Settings no da al panel esos derechos.

The root helper

Relacionado vorqulctlLímites cgroup v2Interruptor de módulo

El enlace de un solo uso que imprime el instalador y que abre el formulario para crear la primera cuenta de administrador.

Mientras no exista un admin, quien llegue primero al puerto del panel puede crearlo, por eso la ventana se cierra una hora después de iniciar el panel. vorqulctl setup-url imprime un enlace nuevo y vorqulctl reset-admin emite uno para un administrador de reemplazo.

First login

Relacionado vorqulctlAutenticación de dos factores (TOTP)

El paso de seguridad que VorqulPanel ejecuta antes de aplicar un cambio del servidor web: probar la nueva configuración y restaurar la anterior si la prueba falla.

Por eso un vhost defectuoso no tumba todo el servidor. La misma idea cubre las zonas DNS, que se validan con named-checkzone antes de que BIND recargue.

Web hostingDNS

Relacionado Host virtual (vhost)Toma de control de vhostZona DNS

El bloque de configuración del servidor web que le dice a nginx o Apache qué sitio servir para un nombre de dominio.

VorqulPanel solo escribe sus propios archivos de vhost con prefijo vorqul- y deja en paz todo lo demás de la configuración del servidor web.

Web hosting

Relacionado Toma de control de vhostPrueba de configuración con reversiónModo reverse proxy

La confirmación explícita necesaria antes de que VorqulPanel pueda gestionar un sitio que encontró ya configurado en el servidor.

Los sitios adoptados se leen sin reescribirlos. Tras confirmar, primero se hace una copia, y la toma de control solo quita el enlace de sites-enabled y nunca borra el archivo original.

Installing on a used server

Relacionado Host virtual (vhost)Prueba de configuración con reversión

Un ajuste de dominio que coloca un vhost del servidor web delante de una aplicación que se ejecuta en un puerto local.

El panel escribe el vhost y puede emitir el certificado, así que cualquier aplicación, incluido un servicio de Node.js o Python, se sirve en un dominio normal con HTTPS.

Web hosting

Relacionado Host virtual (vhost)ACME y Let's Encrypt

El mecanismo del kernel de Linux que VorqulPanel usa para limitar la memoria, la CPU y el número de procesos de cada servidor de juegos.

Sustituye a nice, cpulimit y ulimit, que o no limitan el uso real o congelan el proceso. Un servidor que supera su techo se mata en su propio grupo y el panel registra que lo hizo el kernel, así que puedes distinguir una muerte por falta de memoria de una caída.

Game hosting

Relacionado Análisis de caídasRoot helper (vorqul-helper)

Una función de VorqulPanel que lee las últimas líneas de un servidor de juegos caído y nombra la causa probable y la solución.

Las causas típicas son una versión de Java equivocada, un puerto ya en uso, quedarse sin memoria, un EULA que falta, un plugin roto o un disco lleno. El reinicio automático se omite cuando reiniciar no puede ayudar.

Game hosting

Relacionado Límites cgroup v2

Una copia de seguridad enviada a un almacenamiento fuera del servidor, para que perder la máquina no signifique perder las copias.

VorqulPanel cifra la copia con AES-256-GCM antes de que salga del servidor. Los destinos se configuran en el panel y a una nube como Google Drive se puede llegar mediante rclone.

Backups guide

Relacionado Restore drillBase de datos del panel

Una comprobación programada en la que el panel descomprime su propia copia más reciente y abre la base de datos que contiene.

Demuestra que el archivo se puede restaurar de verdad, que es distinto de que el archivo exista.

Backups guide

Relacionado Copia offsite

Una cuenta de transferencia de archivos confinada a un solo directorio, de modo que no puede explorar el resto del servidor.

Cada servidor de juegos de VorqulPanel recibe su propia cuenta SFTP en chroot, y los sitios pueden tener una limitada a su carpeta. La protección contra fuerza bruta viene incluida.

SFTP

Relacionado Registro de auditoríanftables

El filtro de paquetes de Linux que VorqulPanel maneja, junto a ufw y firewalld, para abrir y cerrar puertos.

El panel solo añade y quita sus propias reglas etiquetadas en sus propias tablas. Nunca vacía el conjunto de reglas, cambia la política por defecto ni toca las reglas de SSH.

Firewall

Relacionado SFTP en chrootRoot helper (vorqul-helper)

El conjunto de registros DNS de un dominio, que VorqulPanel puede servir por sí mismo mediante BIND9.

El panel escribe y valida el archivo de zona, y puede copiar registros desde y hacia Cloudflare sin borrar nada allí.

DNS

Relacionado Prueba de configuración con reversiónDKIMRegistro PTR

El protocolo y la autoridad certificadora gratuita que VorqulPanel usa, mediante acme.sh o certbot, para emitir certificados HTTPS.

Emitir exige que el registro DNS ya apunte al servidor, o un token de Cloudflare DNS para demostrar el nombre sin el puerto 80. Let's Encrypt solo permite cinco validaciones fallidas por hostname y hora, por eso el panel comprueba el DNS, el puerto 80 y la cobertura del vhost antes de contactar con la autoridad.

Web hosting

Relacionado Modo reverse proxyZona DNS

Una firma criptográfica en el correo saliente, publicada como registro DNS, que permite a los receptores verificar que el mensaje vino de tu dominio.

En VorqulPanel la clave se crea con Rspamd al añadir un dominio de correo y el panel muestra el registro que hay que publicar. Va bajo el dominio de la cabecera From, nunca bajo el host de correo.

Mail

Relacionado SPF y DMARCRegistro PTREntregabilidad

Dos registros DNS que dicen qué servidores pueden enviar correo de un dominio y qué deben hacer los receptores con el correo que no pasa la comprobación.

Funcionan junto con DKIM. VorqulPanel genera los registros y su comprobación de entregabilidad avisa cuando falta uno o está mal.

Mail

Relacionado DKIMEntregabilidadMTA-STS y TLS-RPT

La entrada DNS inversa que asigna a la IP de un servidor un nombre de host, y que revisan los servidores de correo receptores.

Se configura donde se alquila la IP, así que ningún panel puede cambiarla por ti. Un nombre de host de correo que no coincide con el PTR perjudica la entregabilidad más que la falta de un certificado.

Mail

Relacionado DKIMEntregabilidad

Políticas publicadas en DNS que dicen a los servidores emisores que deben usar TLS para llegar a tu servidor de correo y dónde informar de los fallos.

Sin MTA-STS, alguien que pueda interceptar la conexión puede quitar la oferta de STARTTLS y el remitente cae en silencio a texto plano. El archivo de política debe servirse en https://mta-sts.tu-dominio/.well-known/mta-sts.txt.

Mail

Relacionado SPF y DMARCEntregabilidad

Si el correo que envías llega de verdad a una bandeja de entrada en lugar de ser rechazado o archivado como spam.

Depende de PTR, SPF, DKIM, DMARC y de la reputación de la dirección IP. VorqulPanel revisa los registros, la cola de correo y las principales listas de bloqueo públicas, y te dice cuál es el problema.

Mail

Relacionado DKIMSPF y DMARCRegistro PTRMTA-STS y TLS-RPT

Una puntuación combinada que VorqulBOT calcula a partir de señales de actividad, retención, crecimiento e incorporación en un servidor de Discord.

La puntuación convierte cuatro tendencias separadas en un solo número que puedes seguir en el tiempo. Valora un servidor frente a su propia historia, no clasifica a nadie frente a nadie y no emite ningún veredicto sobre la moderación.

Server Health ScoreLeveling

Un registro numerado y con búsqueda de cada acción de moderación realizada en un servidor de Discord.

Cada ban, kick, aviso o timeout genera un caso con el objetivo, el moderador, el motivo, la duración y la fecha. Meses después todavía puedes decir por qué se tomó una decisión y quién la tomó, y para eso mismo se guardan.

ModerationAutoMod

Relacionado Registro de auditoríaEscalera de escaladaTranscripción de ticket

La lista única de 44 módulos que leen tanto VorqulBOT como su panel web, de modo que un interruptor no puede existir en uno e ignorarse en el otro.

El registro nombra cada módulo, el grupo al que pertenece y si empieza activado. Nueve empiezan activados: moderación, niveles, afk, encuestas, economía, juegos, sorteos, recordatorios y comandos con prefijo. Los otros 35 empiezan desactivados. El proceso del bot y el panel web leen el mismo archivo, así que las dos mitades no pueden separarse, que es como suelen fallar los bots con una interfaz web aparte.

PluginsVorqulBOT

Una de las 15 comprobaciones de mensajes que VorqulBOT puede ejecutar antes de que un moderador vea un mensaje, cada una con su propio umbral, acción y duración.

Los filtros cubren spam, texto repetido, enlaces, invitaciones, mayúsculas, menciones, menciones masivas, ghost pings, avalanchas de emojis, avalanchas de spoilers, zalgo, phishing, nitro falso, estafas cripto y expresiones regulares propias. Solo phishing y nitro falso están activados por defecto. Cada filtro funciona de forma independiente, así que uno puede borrar, otro dar un timeout y un tercero banear.

AutoMod

Relacionado Escalera de escaladaShadow-mute

Una regla que convierte un número de infracciones dentro de una ventana de tiempo en una acción más dura, sin que un moderador decida cada vez.

VorqulBOT tiene dos. La escalada de AutoMod se dispara con aciertos repetidos del filtro dentro de una ventana, de una hora por defecto. Las acciones por avisos funcionan igual pero a mano: un número, una ventana en días y una acción, de modo que tres avisos en siete días pueden significar un mute. Varias reglas se pueden combinar y los reincidentes escalan solos.

ModerationAutoMod

Relacionado Historial de casosFiltro de AutoModJail

Un mute en el que el miembro sigue viendo sus propios mensajes y nadie más los ve.

Elimina el bucle de respuesta. Si le dices a un miembro que está silenciado, discute o vuelve con otra cuenta. Si ve sus mensajes publicados como siempre, suele perder el interés. VorqulBOT lo ofrece como shadowmute y unshadowmute, junto al mute, el timeout y el jail habituales.

Moderation

Un estado de moderación que quita a un miembro sus roles y reduce su acceso a un conjunto restringido de canales.

Jail está entre un timeout y un ban. El miembro se queda en el servidor y aún puedes hablar con él, lo que ayuda mientras aclaras un incidente, pero pierde acceso a todo lo que alcanzaba antes. Los roles vuelven con unjail.

Moderation

Relacionado Comprobación de cuentas alternativasEscalera de escalada

El módulo que mantiene los comandos de texto antiguos como !daily funcionando junto a los comandos slash.

Los comandos slash ganan en casi todo, pero un servidor que lleva tres años escribiendo !daily seguirá escribiéndolo. El puente asigna la forma de texto al mismo manejador. Nadie tiene que reaprender y nada se mantiene dos veces. Es uno de los nueve módulos activados por defecto.

VorqulBOTEconomy

Relacionado Comando slash

Un archivo de configuración que le dice al panel Pterodactyl cómo instalar e iniciar una aplicación concreta.

VorqulBOT incluye uno. Impórtalo, sube los archivos por SFTP, pon el token de Discord en las variables de Startup y pulsa iniciar. El primer arranque instala las dependencias y compila el código por sí solo. Si ya usas un panel de alojamiento de juegos, es el camino más corto para poner el bot en marcha.

VorqulBOTDirect answers

Relacionado Self-hostedPrivileged intents

Un límite por servidor en VorqulBOT (free, premium o pro) que sube los topes de unas pocas funciones.

Los topes afectan a mensajes fijados, roles por reacción, respuestas automáticas, mensajes programados y webhooks salientes. Free permite 3 mensajes fijados, 5 roles por reacción, 10 respuestas automáticas, 5 mensajes programados y ningún webhook. Pro permite 100, 100, 500, 200 y 5. El bot es self-hosted, así que el nivel lo fijas tú para tus servidores y nunca me lo compras a mí.

Direct answers

Un hash HMAC-SHA256 del cuerpo de la petición, enviado en una cabecera para que el receptor pueda demostrar que la petición vino del bot.

VorqulBOT envía a una URL que eliges cuatro eventos de miembros: entrada, salida, ban y unban. Si defines un secreto compartido, cada petición lleva una cabecera X-Vorqul-Signature calculada a partir del cuerpo con ese secreto, y tu endpoint puede rechazar todo lo que no coincida. Sin secreto los eventos siguen llegando, solo que sin autenticar.

Plugins

Relacionado Inicio de sesión del panel con OAuth2

El tiempo mínimo entre dos mensajes que ganan XP. VorqulBOT usa 60 segundos por defecto.

Sin cooldown, los niveles premian el volumen y lo más alto del ranking es para quien escribe más mensajes de una palabra. Con él, veinte mensajes rápidos dan exactamente lo mismo que uno. Es el ajuste más importante de un sistema de niveles y los servidores casi siempre lo dejan como lo trajo el bot.

Leveling

Una puntuación heurística que un moderador puede ejecutar sobre un miembro, construida con la antigüedad de la cuenta, el avatar, la fecha de entrada y los roles.

Una cuenta de menos de 7 días puntúa 40, de menos de 30 puntúa 25 y de menos de 90 puntúa 10. Un avatar por defecto suma 20, entrar hace menos de un día suma 15, no tener roles suma 10 y los bots puntúan cero. Trata el resultado como una prueba para una decisión humana y no hagas un ban automático. Heurísticas como estas dan falsos positivos y un ban equivocado cuesta más confianza de la que ahorra en tiempo.

ModerationAnti-Raid

Relacionado JailHistorial de casos

La conversación de un ticket de soporte escrita en un archivo de texto y publicada en un canal que designas.

VorqulBOT exporta los últimos 100 mensajes de un canal de ticket. Es lo que Discord devuelve en una sola consulta y normalmente cubre todo el ticket. El archivo es sencillo a propósito: texto, autores y marcas de tiempo, así que se abre en cualquier sitio y es fácil de buscar. Nada va a un servicio externo.

Tickets

Ajustes de Discord que un bot debe activar antes de poder ver presencias, miembros del servidor y el contenido de los mensajes.

VorqulBOT necesita activados en el portal de desarrolladores de Discord los intents de presencia, miembros del servidor y contenido de mensajes. Sin ellos parece que los comandos no hacen nada.

Discord setup

Relacionado Comando slashInicio de sesión del panel con OAuth2

Un comando de Discord que se escribe con una barra inicial, que el bot registra en Discord y que este muestra en el selector de comandos.

Registrarlo exige el scope applications.commands en la invitación y un paso de deploy. Cuando faltan los comandos slash, repite el deploy y revisa el scope de la invitación.

VorqulBOT

Relacionado Privileged intentsPrefix bridge

Cómo inicias sesión en el panel web de VorqulBOT: mediante Discord, con una dirección de redirección que debe coincidir con la que registraste.

Una diferencia entre el redirect URI del portal de Discord y la dirección del panel es la causa más común de un inicio de sesión fallido. Si dejas NEXTAUTH_URL vacío, se detecta automáticamente.

First dashboard sign-in

Relacionado Privileged intentsFirma de webhook

Un índice de texto en la raíz de un sitio que apunta a los modelos de lenguaje a su contenido canónico.

La convención toma su forma de robots.txt y funciona al revés: en lugar de restringir a los rastreadores, les da un mapa seleccionado. Es una convención emergente y no un estándar ratificado, y nadie ha establecido de forma independiente cuánto ayuda a la recuperación. vorqul.com publica uno en /llms.txt y una variante con todo el contenido en /llms-full.txt.

llms.txt

Relacionado Entity homeRenderizado en el servidor

La única página canónica que posee una marca y que declara, de forma legible por máquinas, qué es.

Una entity home hace afirmaciones explícitas sobre categoría, propósito y audiencia, las respalda con datos estructurados y se corrobora cuando la misma descripción aparece en perfiles de terceros. Cuando esas fuentes discrepan, un sistema confía menos en la entidad. En Vorqul esa página es /about, enlazada a un identificador de Wikidata.

About

Relacionado llms.txt

Producir el HTML completo antes de que llegue al cliente, en lugar de montarlo con JavaScript en el navegador.

Los rastreadores de recuperación que hay tras los motores de respuestas descargan HTML y en general omiten JavaScript, así que todo lo que solo existe tras la hidratación en el cliente les resulta invisible. vorqul.com está construido de forma estática. Cada página llega como HTML completo y el poco JavaScript que se envía se ocupa de los menús, la sugerencia de idioma y la analítica que has aceptado.

Relacionado llms.txt