Esta es una guía de #referencia para describir todas las Configuraciones de Sitio Ocultas disponibles.
Nivel de usuario requerido: Administrador
Las configuraciones de sitio ocultas en Discourse son opciones de configuración avanzadas que no están disponibles a través de la interfaz de administración estándar. Proporcionan flexibilidad adicional para personalizar la funcionalidad de tu instancia de Discourse.
Para obtener información adicional sobre la modificación de configuraciones de sitio ocultas, consulta: Habilitar Configuraciones de Sitio Ocultas.
A continuación se presenta una tabla de referencia de todas las configuraciones de sitio ocultas disponibles en Discourse.
Básico
Configuraciones que te ayudan a ajustar aspectos fundamentales de tu instancia de Discourse:
| Configuración de Sitio | Tipo | Descripción | Valor por Defecto |
|---|---|---|---|
| max_category_nesting | entero | Establece el número máximo de niveles de anidación de categorías permitidos. | 2 |
| enable_mobile_theme | booleano | Habilita un tema específico para dispositivos móviles. Desactívalo para usar una hoja de estilos adaptable en todos los dispositivos. | TRUE |
| enable_upload_debug_mode | booleano | Habilita el registro detallado para las cargas, útil para depurar problemas de carga. | FALSE |
| default_theme_id | entero | El ID de tema predeterminado utilizado para nuevos usuarios y usuarios anónimos. | -1 |
| enable_badge_sql | booleano | Permite el uso de SQL para definir consultas de insignias directamente dentro de la interfaz de administración. | FALSE |
| vapid_public_key_bytes | cadena | Almacena la clave pública utilizada en la autenticación VAPID, necesaria para enviar notificaciones de Web Push. | “” |
| vapid_public_key | cadena | Clave pública utilizada para la autenticación VAPID para notificaciones de Web Push. | “” |
| vapid_private_key | cadena | Clave privada utilizada para la autenticación VAPID para notificaciones de Web Push. | “” |
| vapid_base_url | cadena | La URL base configurada para VAPID para afirmar la identidad del servidor en las notificaciones de Web Push. | “” |
| enable_passkeys | booleano | Habilita el uso de passkeys basadas en WebAuthn para la autenticación segura de usuarios sin contraseñas. | TRUE |
| verbose_upload_logging | booleano | Habilita registros detallados para las actividades del proceso de carga, lo cual es útil para identificar y diagnosticar problemas con las cargas de archivos. | FALSE |
| verbose_auth_token_logging | booleano | Habilita el registro detallado para los procesos de tokens de autenticación. | FALSE |
| max_suspicious_distance_km | entero | Define la distancia máxima en kilómetros entre direcciones IP sucesivas para que el inicio de sesión se considere sospechoso. | 100 |
| discourse_connect_csrf_protection | booleano | Habilita la protección CSRF para la autenticación de DiscourseConnect. | TRUE |
| invites_per_page | entero | Número de invitaciones mostradas por página en la página de invitaciones. | 40 |
| max_notifications_per_user | entero | Número máximo de notificaciones que un usuario puede tener antes de que las más antiguas se eliminen automáticamente. | 10000 |
| max_bookmarks_per_user | entero | Número máximo de marcadores que un usuario puede crear. | 2000 |
Publicación
Personaliza cómo funcionan las publicaciones dentro de tu instancia de Discourse:
| Configuración de Sitio | Tipo | Descripción | Valor por Defecto |
|---|---|---|---|
| show_copy_button_on_codeblocks | booleano | Añade un botón a los bloques de código para copiar el contenido del bloque al portapapeles del usuario. | TRUE |
| disable_watched_word_checking_in_user_fields | booleano | Desactiva la comprobación de palabras vigiladas en los campos de usuario. | FALSE |
| max_draft_length | entero | Establece la longitud máxima permitida para los borradores. | 150000 |
| max_drafts_per_user | entero | Número máximo de borradores que un usuario puede tener. | 10000 |
| group_pm_user_limit | entero | Número máximo de usuarios que pueden incluirse en un mensaje privado de grupo. | 1000 |
Correo electrónico
Gestiona cómo se envían y reciben correos electrónicos desde tu plataforma Discourse:
| Configuración de Sitio | Tipo | Descripción | Valor por Defecto |
|---|---|---|---|
| bounce_score_erode_on_send | flotante | Reduce la puntuación de rebote cada vez que se envía un correo electrónico, permitiendo una recuperación más rápida de los rebotes. | 0.1 |
| email_custom_template | cadena | Plantilla HTML personalizada para correos electrónicos. Se utiliza si es necesario anular la predeterminada. | “” (vacío) |
| email_custom_css | cadena | CSS personalizado para dar estilo a los correos electrónicos. Se utiliza si es necesario anular la predeterminada. | “” (vacío) |
| email_custom_css_compiled | cadena | Versión compilada del CSS personalizado para correos electrónicos. | “” (vacío) |
| enable_secondary_emails | booleano | Permite a los usuarios agregar direcciones de correo electrónico secundarias a su perfil. | TRUE |
| max_participant_names | entero | Número máximo de nombres de participantes mostrados en las notificaciones por correo electrónico para mensajes de grupo. | 10 |
Archivos
Define cómo se gestionan los archivos y las cargas:
| Configuración de Sitio | Tipo | Descripción | Valor por Defecto |
|---|---|---|---|
| max_export_file_size_kb | entero | Especifica el tamaño máximo de archivo para las exportaciones en kilobytes. | 50000 |
| export_authorized_extensions | cadena | Especifica las extensiones de archivo que se permiten para las exportaciones. | “zip” |
| secure_uploads_pm_only | booleano | Si es verdadero, las cargas seguras se habilitan solo para mensajes privados. | FALSE |
| enable_s3_transfer_acceleration | booleano | Si es verdadero, habilita la aceleración de transferencia de Amazon S3. | FALSE |
| s3_http_continue_timeout | entero | Tiempo en segundos para esperar una respuesta 100 Continue de S3 antes de enviar la carga de la solicitud. | 1 |
| s3_install_cors_rule | booleano | Si es verdadero, instala reglas CORS en S3 para permitir solicitudes desde cualquier dominio. | TRUE |
| s3_presigned_get_url_expires_after_seconds | entero | Duración en segundos después de la cual expirará una URL firmada para objetos S3. | 300 |
| decompressed_theme_max_file_size_mb | entero | Tamaño máximo de archivo en megabytes para un archivo de tema después de su descompresión. | 1000 |
| decompressed_backup_max_file_size_mb | entero | Tamaño máximo de archivo en megabytes para archivos de respaldo después de la descompresión. | 100000 |
| composer_media_optimization_image_resize_pre_multiply | booleano | Optimiza el manejo de imágenes pre-multiplicando el canal alfa en manipulaciones de canvas para mejorar la calidad del redimensionamiento de imágenes. | FALSE |
| composer_media_optimization_image_encode_quality | entero | Calidad de codificación JPG utilizada en el proceso de re-codificación para la optimización de imágenes. | 0 |
| composer_media_optimization_image_resize_linear_rgb | booleano | Al redimensionar, usa RGB lineal para mejorar la calidad de la imagen redimensionada. | FALSE |
| composer_ios_media_optimisation_image_enabled | booleano | Habilita estrategias específicas de optimización de imágenes en dispositivos iOS para mejorar el rendimiento. | TRUE |
| video_thumbnails_enabled | booleano | Habilita la generación de miniaturas para archivos de video cargados en el foro. | TRUE |
Seguridad
Ajusta las funciones de seguridad para satisfacer las necesidades de tu foro:
| Configuración de Sitio | Tipo | Descripción | Valor por Defecto |
|---|---|---|---|
| allow_indexing_non_canonical_urls | booleano | Permite la indexación de URLs no canónicas. | TRUE |
| non_crawler_user_agents | lista | Lista de agentes de usuario considerados como no rastreadores. | "trident |
| crawler_user_agents | lista | Lista de agentes de usuario considerados como rastreadores. | "rss |
| browser_update_user_agents | lista | Agentes de usuario para navegadores desactualizados para mostrar mensajes de actualización. | "MSIE 6 |
| crawler_check_bypass_agents | cadena | Agentes de usuario que pueden eludir las comprobaciones de rastreo. | “cubot” |
| keep_old_ip_address_count | entero | Número de direcciones IP antiguas que se conservan para cada usuario. | 0 |
| content_security_policy_collect_reports | booleano | Habilita la recopilación de informes de violaciones de CSP. | FALSE |
| allow_embedding_site_in_an_iframe | booleano | Permite incrustar el sitio dentro de un iframe en otros sitios. | FALSE |
| send_old_credential_reminder_days | entero | Número de días para recordar credenciales antiguas. Si se establece en 0, los recordatorios están desactivados. | 0 |
| disable_onebox_media_download_controls | booleano | Desactiva los controles de descarga de medios en las incrustaciones de audio/video de onebox. | FALSE |
| cross_origin_opener_policy_header | cadena | Establece la cabecera Cross-Origin-Opener-Policy. Opciones disponibles: unsafe-none, same-origin, same-origin-allow-popups. | “same-origin-allow-popups” |
Onebox
Controla cómo se manejan los oneboxes:
| Configuración de Sitio | Tipo | Descripción | Valor por Defecto |
|---|---|---|---|
| force_get_hosts | lista | Dominios donde se fuerza la solicitud GET debido a problemas con las solicitudes HEAD | us.battle.net news.yahoo.com *.medium.com |
| onebox_user_agent | cadena | Define la cadena de agente de usuario utilizada por el sistema Onebox al realizar solicitudes HTTP. Si la configuración está vacía, recurre a un agente de usuario predeterminado definido en Onebox.options.user_agent |
“” |
| inline_onebox_user_agent | cadena | Agente de usuario personalizado utilizado al obtener respuestas de onebox en línea, si se especifica | “” |
Límites de velocidad
Gestiona los recursos y la seguridad a través de límites de velocidad:
| Configuración de Sitio | Tipo | Descripción | Valor por Defecto |
|---|---|---|---|
| rate_limit_search_anon_global_per_minute | entero | Límite de velocidad global para solicitudes de búsqueda anónimas por minuto | 150 |
| rate_limit_search_anon_user_per_minute | entero | Límite de velocidad por usuario para solicitudes de búsqueda anónimas por minuto | 15 |
| rate_limit_search_anon_global_per_second | entero | Límite de velocidad global para solicitudes de búsqueda anónimas por segundo | 8 |
| rate_limit_search_anon_user_per_second | entero | Límite de velocidad por usuario para solicitudes de búsqueda anónimas por segundo | 2 |
| rate_limit_search_user | entero | Límite de velocidad por usuario para solicitudes de búsqueda de usuarios conectados por minuto | 30 |
| max_allowed_secondary_emails | entero | Número máximo de correos electrónicos secundarios que un usuario puede tener | 10 |
| max_batch_presign_multipart_per_minute | entero | Número máximo de operaciones multipart de pre-firma por lotes que un usuario puede iniciar por minuto | 20 |
| max_presigned_put_per_minute | entero | Número máximo de operaciones PUT con firma que un usuario puede iniciar por minuto | 10 |
| max_create_multipart_per_minute | entero | Número máximo de creaciones multipart que un usuario puede iniciar por minuto | 10 |
| max_complete_multipart_per_minute | entero | Número máximo de finalizaciones multipart que un usuario puede iniciar por minuto | 10 |
| max_uploads_per_minute | entero | Número máximo de operaciones de carga que un usuario puede iniciar por minuto | 10 |
Desarrollador
Adapta el entorno de desarrollo:
| Configuración de Sitio | Tipo | Descripción | Valor por Defecto |
|---|---|---|---|
| force_hostname | cadena | Forza un nombre de host específico para el sitio. | “” |
| port | entero | Configura el número de puerto en el que escucha el servidor. | “” |
| enable_chunked_encoding | booleano | Habilita respuestas con codificación por fragmentos por parte del servidor, lo que podría ayudar con proxies que almacenan en búfer las respuestas. | TRUE |
| long_polling_base_url | cadena | URL base para usar en la sondeo largo, útil para separar el tráfico CDN de la interacción directa con el sitio. | “/” |
| background_polling_interval | entero | Frecuencia en milisegundos para el sondeo en segundo plano por parte de los clientes. | 60000 |
| polling_interval | entero | Frecuencia en milisegundos para el sondeo activo por parte de los clientes conectados. | 3000 |
| anon_polling_interval | entero | Frecuencia en milisegundos para que los clientes anónimos consulten al servidor. | 25000 |
| rebake_old_posts_count | entero | Número de publicaciones que se vuelven a hornear por tareas automatizadas que se ejecutan en segundo plano. | 80 |
| migrate_to_new_scheme | booleano | Activa o desactiva la migración de cargas antiguas a un nuevo esquema de almacenamiento, principalmente utilizado durante las actualizaciones. | FALSE |
| max_new_topics | entero | Número máximo de nuevos temas que un usuario puede crear, utilizado para evitar spam o sobrecarga del sistema. | 500 |
| wizard_enabled | booleano | Habilita o deshabilita el asistente de configuración que se muestra después de la instalación. | TRUE |
| bypass_wizard_check | booleano | Permite omitir la comprobación de finalización del asistente de configuración, útil para desarrolladores o configuraciones automatizadas. | FALSE |
| logging_provider | enum | Determina el framework de registro para la aplicación. Puede ser ‘default’ o un framework alternativo compatible. | “default” |
| bootstrap_error_pages | booleano | Habilita o deshabilita páginas de error con estilo inicializadas. Útil para mantener la consistencia del estilo en las páginas de error. | FALSE |
| include_associated_account_ids | booleano | Incluir IDs de cuentas asociadas en ciertas salidas—útil para un manejo de datos de cuentas más conectado. | FALSE |
| max_sidebar_section_links | entero | Número máximo de enlaces por sección de la barra lateral, controlando el desorden de la interfaz de usuario y el rendimiento. | 50 |
| instrument_gc_stat_per_request | booleano | Si se deben recopilar y registrar estadísticas de recolección de basura por cada solicitud HTTP—útil para el ajuste del rendimiento. | FALSE |
| warn_critical_js_deprecations | booleano | Habilita advertencias para administradores sobre deprecaciones críticas de JavaScript—ayuda a prepararse para actualizaciones o correcciones. | TRUE |
| warn_critical_js_deprecations_message | cadena | Mensaje personalizado añadido a las advertencias de deprecación de JS críticas, haciendo las notificaciones más informativas. | “” |
Incrustación
Permite o restringe la incrustación de contenido:
| Configuración de Sitio | Tipo | Descripción | Valor por Defecto |
|---|---|---|---|
| embed_by_username | cadena | Nombre de usuario a utilizar para el contenido incrustado. | “” |
| embed_post_limit | entero | Número máximo de publicaciones a incrustar desde una fuente externa. | 100 |
| embed_topic_limit_per_page | entero | Número máximo de temas mostrados por página para temas incrustados. | 200 |
| embed_title_scrubber | cadena | Expresión regular utilizada para limpiar o modificar títulos en contenido incrustado. | “” |
| blocked_embed_selectors | cadena | Selectores CSS que especifican elementos a excluir del contenido incrustado. | “” |
| allowed_embed_classnames | cadena | Nombres de clase permitidos en contenido incrustado, ayuda a filtrar el estilo del contenido. | “emoji” |
Respaldo
Personaliza las configuraciones de respaldo:
| Configuración de Sitio | Tipo | Descripción | Valor por Defecto |
|---|---|---|---|
| include_s3_uploads_in_backups | booleano | Determina si las cargas almacenadas en S3 deben incluirse en los respaldos del sitio. | FALSE |
Búsqueda
Optimiza la funcionalidad de búsqueda dentro de tu sitio Discourse:
| Configuración de Sitio | Tipo | Descripción | Valor por Defecto |
|---|---|---|---|
| prioritize_exact_search_title_match | booleano | Da prioridad a los resultados de búsqueda que coinciden exactamente con los términos de búsqueda en los títulos. | TRUE |
| max_duplicate_search_index_terms | entero | Establece el número máximo de términos duplicados indexados para la búsqueda. | 6 |
| use_pg_headlines_for_excerpt | booleano | Habilita el soporte de encabezados de Postgres para generar extractos de búsqueda. | FALSE |
| search_max_indexed_word_length | entero | Longitud máxima de las palabras indexadas para la búsqueda. | 100 |
| search_ranking_normalization | cadena | Controla la normalización de las clasificaciones de búsqueda para mejorar la relevancia de los resultados. | “0” |
| search_ranking_weights | cadena | Establece los factores de ponderación utilizados en los cálculos de clasificación de búsqueda. | “” |
| search_recent_regular_posts_offset_post_id | entero | Desplazamiento de ID de publicación para recuperar publicaciones recientes en los resultados de búsqueda. | 0 |
| search_enable_recent_regular_posts_offset_size | entero | Determina el número de publicaciones recientes regulares a considerar en la búsqueda. | 200000 |
| category_search_priority_low_weight | flotante | Establece la ponderación inferior para priorizar categorías en los resultados de búsqueda. | 0.8 |
| category_search_priority_high_weight | flotante | Establece la ponderación superior para priorizar categorías en los resultados de búsqueda. | 1.2 |
| search_page_size | entero | Número de resultados por página en las consultas de búsqueda. | 50 |
Sin categorizar
Varias configuraciones que no encajan en otras categorías:
| Configuración de Sitio | Tipo | Descripción | Valor por Defecto |
|---|---|---|---|
| has_login_hint | booleano | Determina si deben aparecer sugerencias de inicio de sesión | FALSE |
| min_new_topics_time | entero | Tiempo mínimo entre nuevos temas | 0 |
| general_category_id | entero | ID para la categoría general | -1 |
| meta_category_id | entero | ID para la categoría meta | -1 |
| staff_category_id | entero | ID para la categoría de personal | -1 |
| uncategorized_category_id | entero | ID para la categoría sin categorizar | -1 |
| backup_drafts_to_pm_length | entero | Longitud de los borradores en mensajes privados antes de necesitar respaldo | 0 |
| view_user_route | cadena | Sección predeterminada de la página de perfil de usuario | “summary” |
| tos_topic_id | entero | ID para el tema de Términos de Servicio | -1 |
| guidelines_topic_id | entero | ID para el tema de directrices | -1 |
| privacy_topic_id | entero | ID para el tema de política de privacidad | -1 |
| welcome_topic_id | entero | ID para el tema de bienvenida | -1 |
| admin_quick_start_topic_id | entero | ID para el tema de guía de inicio rápido de administración | -1 |
| ios_app_id | cadena | ID de App Store para la aplicación iOS | “1173672076” |
| android_app_id | cadena | ID de Play Store para la aplicación Android | “com.discourse” |
| pwa_display_browser_regex | cadena | Expresión regular para determinar si la visualización PWA está configurada en ‘browser’ | “a^” |
| always_include_topic_excerpts | booleano | Incluir extractos de temas cada vez | FALSE |
| max_bulk_invites | entero | Número máximo de invitaciones masivas posibles | 50,000 |
| skip_email_bulk_invites | booleano | Omitir el envío de correos electrónicos en invitaciones masivas | FALSE |
| max_api_invites | entero | Número máximo de invitaciones por solicitud de API | 200 |
| overridden_robots_txt | cadena | Reglas personalizadas para robots.txt | “” |
| show_category_definitions_in_topic_lists | booleano | Mostrar publicaciones de definición de categoría en listas de temas | FALSE |
| max_automatic_membership_email_domains | entero | Número máximo de dominios de correo electrónico de membresía automática posibles | 50 |
API
Gestiona cómo opera la API dentro de tu instancia de Discourse:
| Configuración de Sitio | Tipo | Descripción | Valor por Defecto |
|---|---|---|---|
| api_key_last_used_epoch | entero | Rastrea la última hora de uso (epoch) de las claves API. No es directamente accesible ni editable. | # El valor se agrega en una migración |
| revoke_api_keys_maxlife_days | entero | Número de días antes de que una clave API sea revocada automáticamente, establece en 0 para nunca. | 0 |
Panel de control
Ajusta qué informes se muestran en el panel de administración y cómo se definen los temas populares:
| Configuración de Sitio | Tipo | Descripción | Valor por Defecto |
|---|---|---|---|
| verbose_user_stat_count_logging | booleano | Habilita el registro detallado para las actualizaciones de conteo de estadísticas de usuario. | FALSE |
| hot_topics_gravity | flotante | Controla la configuración de gravedad utilizada en el cálculo de temas populares. | 1.2 |
| hot_topics_recent_days | entero | Define el número de días recientes a considerar para calcular las puntuaciones de temas populares. | 7 |