# Opciones de configuración de Total.js 5

> Consulta las opciones de CONF, sus valores predeterminados y las recetas que muestran cómo utilizarlas.

Framework: total5
Product: Total.js 5 (total5@0.0.19)
Language: es
Content-SHA256: d1de78e96c9437329bdc838d609e458931c4233ae87f61a8463aba053bfef0b8
Snapshot: c0700e321579725c5cf4f5ace1ad7d2866d1b4f93c24a63c0b41b6b7998e976c
Sources: total5-installed@total5@0.0.19
Review: not-recorded

El archivo `config` tiene una configuración `key : value` por línea y los valores están disponibles en el objeto global `CONF` (ver la receta de configuración para el formato de archivo). las claves a continuación son definidas por `total5` 0.0.19 con estos defectos; una clave que no está aquí y no en la segunda tabla es suya. ** Las claves que comienzan con `$` son las configuraciones del marco** y las clavas `secret_` tienen secretos.

Establece los valores de la aplicación en el archivo de configuración y lealos a través de CONF. La tabla da los defectos y el propósito de cada configuración.

| Clave | Por defecto | Nota |
|---|---|---|
| `name` | `'Total.js'` | El nombre de la aplicación. En una vista, `@{'%name'}` lo imprime. |
| `version` | `'1.0.0'` | La versión de la aplicación se utiliza en la salida de startup, las estadísticas y el sufixo HTTP ETag (index.js). |
| `author` | `''` | El autor de la aplicación muestra la imprenta de startup cuando no está disponible (index.js). |
| `secret` | `F.syshash` | Establecer el secreto de la aplicación explícitamente en la configuración. |
| `secret_encryption` | `''` | La lectura clave por las rutas de WebSocket encriptadas; esto se distingue de una opción de metadatos encriptados de acción (websocket.js). |
| `secret_totalapi` | `''` | El token Fallback enviado por el driver TotalAPI integrado (api.js); mantenerse en el lado del servidor. |
| `secret_csrf` | `''` | El secreto de los tokens CSRF. Vacío: la comprobación siempre pasa. |
| `secret_tms` | `''` | El token que los clientes TMS deben enviar en la cabecera `x-token`. |
| `$root` | `''` | Prefixo de URL aplicado a los caminos de ruta y de activo; también ajusta el punto final de la API por defecto (routing.js, index.js). |
| `$cors` | `''` | Nombres de host separados por coma. |
| `$api` | `'/api/'` | Un endpoint de API por defecto. |
| `$sourcemap` | `true` | La configuración de metadatos de carga; LOAD la establece desde el modo DEBUG final o la deshabilita para las cargas selectivas de recursos (index.js). |
| `$httpreqlimit` | `0` | Límite de peticiones por IP. |
| `$httpcompress` | `true` | Permite la negociación de los gzip para las respuestas elegibles; el camino de respuesta dinámico verifica un límite de 256 bytes (controller.js). |
| `$httpetag` | `''` | Suficiente para los ETags generados por el marco; cuando está vacío, la configuración lo deriva de la versión de la aplicación (index.js, controller.js). |
| `$httpmaxsize` | `256` | KB. |
| `$httprangebuffer` | `5120` | 5 MB. |
| `$httptimeout` | `5` | 5 segundos. |
| `$httpfiles` | `an object` | Las extensiones de archivos que se sirven como archivos estáticos, como un objeto `{ extension: true }`. |
| `$httpchecktypes` | `true` | Solo para datos multipart. |
| `$httpmaxage` | `60` | En segundos. |
| `$httpmaxkeys` | `33` | Número máximo de clave de búsqueda parsed (utils.js); no un límite de campo del cuerpo JSON. |
| `$httpmaxkey` | `25` | La longitud máxima de la clave de búsqueda utilizada por el parsero de la consulta (utils.js). |
| `$httpcacheoffset` | `''` | P. ej. 1 minute. |
| `$blacklist` | `''` | HTTP/WebSocket solicita los test de tratamiento si el valor configurado contiene el IP del cliente (http.js, websocket.js). |
| `$xpoweredby` | `'Total.js'` | Valor del título de respuesta generado X-Powered-By; vacío la suprime en los caminos de respuesta inspeccionados (controller.js). |
| `$minifyjs` | `true` | Minifica los archivos JavaScript que se sirven. |
| `$minifycss` | `true` | Minifica los archivos CSS que se sirven. |
| `$minifyhtml` | `true` | Minifica el HTML que se envía. |
| `$port` | `'auto'` | HTTP escucha el puerto; se resuelve automáticamente en la startup, y las opciones de Total.run pueden superarlo (index.js). |
| `$ip` | `'0.0.0.0'` | HTTP escucha la dirección; las opciones de Total.run pueden superarla (index.js). |
| `$unixsocket` | `''` | Página de escucha de socket alternativo (index.js).Las permisiones de sockets y la configuración de proxy reversa son problemas de implementación. |
| `$timezone` | `'utc'` | La zona horaria del proceso (se establece en `process.env.TZ`). |
| `$insecure` | `false` | La configuración establece el entorno de verificación de TLS de esta bandera (index.js). |
| `$performance` | `false` | Ajusta el agente HTTP con los sockets y el tuning de los socket (index.js); no es una prueba de un aceleramiento de la aplicación. |
| `$filtererrors` | `true` | Elimina los patrones de error que coinciden en el logger de error del marco (index.js). |
| `$cleartemp` | `true` | Controlar la eliminación de las extensiones de archivos generados/temp seleccionadas por la rutina clara (index.js). |
| `$customtitles` | `false` | Cuando es falso, el generador de metadatos de visión apunta el nombre de la aplicación a un título de página no doméstica (viewengine.js). |
| `$clearcache` | `10` | Intervalo de servicio para reinstalar los cachos internos de búsqueda/visualidad/templado/construcción de solicitudes (index.js). |
| `$imageconverter` | `'gm'` | El programa al que llama `Image`: `gm`, `im` o `magick`. |
| `$imagememory` | `0` | Desactivado porque, por ejemplo, GM v1.3.32 lanza algún error sobre la memoria. |
| `$stats` | `true` | Controlar las estadísticas de la rama de salida/actualizar; selectivo LOAD puede deshabilitarlo (index.js). |
| `$npmcache` | `'/var/www/.npm'` | Npm cache ubicación aprobada por NPMINSTALL para la rama de ejecución uid-33 (index.js). |
| `$python` | `'python3'` | Comando de Interpretación utilizado por la ejecución de Python y los ayudantes de pip (index.js); instalar Python separadamente. |
| `$wsmaxsize` | `256` | KB. |
| `$wscompress` | `true` | Permite la negociación de WebSocket permiso-deflato en conexiones de servidor (websocket.js). |
| `$wsencodedecode` | `false` | La configuración inicial de codificación/decodificación del servidor WebSocket (websocket.js); verifica el formato de cable requerido antes de cambiarlo. |
| `$wsmaxlatency` | `2000` | El límite de la latencia en millisegundos utilizado por los controles de conexión WebSocket (websocket.js). |
| `$proxytimeout` | `5` | 5 segundos. |
| `$cookiesamesite` | `'Lax'` | Política de cookies de la página cuando una cookie no especifica una (controller.js). |
| `$cookiesecure` | `false` | La cookie Secure está atribuida cuando no se proporciona ningún tipo de cookie (controller.js). |
| `$csrfexpiration` | `'30 minutes'` | Cuánto tiempo es válido un token CSRF. |
| `$tapi` | `true` | Permite el driver de servicio TotalAPI integrado; la operación de control especial pasa por esta puerta local (api.js). |
| `$tapiurl` | `'eu'` | Prefixo de nombre de alojamiento regional utilizado por el driver TotalAPI (api.js). |
| `$tapimail` | `false` | Selecciona la ruta de correo TotalAPI cuando se activa la función TotalAPI (mail.js). |
| `$tapilogger` | `false` | Permite el camino de registro TotalAPI cuando se configure el acceso al servicio y su secreto (index.js). |
| `$imprint` | `true` | Se puede utilizar el banner de inicio (index.js). |
| `$tms` | `false` | Activa el endpoint WebSocket de TMS. |
| `$tmsmaxsize` | `256` | El tamaño máximo de un mensaje TMS, en kB. |
| `$tmsurl` | `'/$tms/'` | La URL del endpoint de TMS. |
| `$tmsclearblocked` | `60` | En minutos. |
| `$total5` | se establece al inicio | La carpeta del paquete `total5` (el framework lee sus propios archivos desde ella). |
| `$nodemodules` | se establece al inicio | La carpeta donde `NPMINSTALL()` instala paquetes. |
| `secret_uid` | En el inicio se | Introducción secreta utilizada por la utilidad de identificador cifrado corto; iniciada desde el hash del sistema (index.js, utils.js). |
| `$cryptoiv` | En el inicio se | Inicialización-vector buffer utilizado por los asistentes de cifrado marco; iniciado en la startup (index.js, utils.js). |
| `$httpexpire` | En el inicio se | La fecha de expiración futura del UTC HTTP se inicia y se refresca periódicamente por el marco (index.js, controller.js). |

Estas claves no tienen valor por defecto. Configuran el envío de correo y las usan `MAIL()` y `HTMLMAIL()` (consulta la receta de correo):

| Clave | Significado |
|---|---|
| `mail_smtp` | La dirección del servidor SMTP. |
| `mail_smtp_options` | Un objeto con el resto de los ajustes de conexión: `port`, `user`, `password`, `secure`... |
| `mail_from` | La dirección del remitente. |
| `mail_from_name` | El nombre del remitente. |
| `mail_reply` | La dirección que recibe las respuestas, añadida a cada mensaje. |
| `mail_cc` | Una dirección de copia, añadida a cada mensaje. |
| `mail_bcc` | Una dirección de copia oculta, añadida a cada mensaje. |

```js controllers/config.js
exports.install = function() {
	ROUTE('GET /config/', config);
};

function config($) {
	$.json({ conf: CONF });
}
```