Este é um guia de #referência para descrever todas as Configurações Ocultas do Site disponíveis.
Nível de usuário necessário: Administrador
As configurações ocultas do site no Discourse são opções de configuração avançadas que não estão disponíveis na interface padrão de administração. Elas fornecem flexibilidade adicional para personalizar a funcionalidade da sua instância do Discourse.
Para informações adicionais sobre a modificação das configurações ocultas do site, consulte: Ativar Configurações Ocultas do Site.
Abaixo está uma tabela de referência de todas as configurações ocultas do site disponíveis no Discourse.
Básico
Configurações que ajudam a ajustar aspectos fundamentais da sua instância do Discourse:
| Configuração do Site | Tipo | Descrição | Valor Padrão |
|---|---|---|---|
| max_category_nesting | inteiro | Define o número máximo de níveis de aninhamento de categorias permitidos. | 2 |
| enable_mobile_theme | booleano | Ativa um tema específico para dispositivos móveis. Desative para usar uma folha de estilo responsiva em todos os dispositivos. | TRUE |
| enable_upload_debug_mode | booleano | Ativa o registro detalhado (verbose logging) para uploads, útil para depurar problemas de upload. | FALSE |
| default_theme_id | inteiro | O ID do tema padrão usado para novos usuários e usuários anônimos. | -1 |
| enable_badge_sql | booleano | Permite o uso de SQL para definir consultas de distintivos (badges) diretamente na interface de administração. | FALSE |
| vapid_public_key_bytes | string | Armazena a chave pública usada na autenticação VAPID, necessária para o envio de Notificações Push Web. | “” |
| vapid_public_key | string | Chave pública usada para autenticação VAPID para Notificações Push Web. | “” |
| vapid_private_key | string | Chave privada usada para autenticação VAPID para Notificações Push Web. | “” |
| vapid_base_url | string | A URL base configurada para o VAPID afirmar a identidade do servidor nas Notificações Push Web. | “” |
| enable_passkeys | booleano | Ativa o uso de chaves de acesso (passkeys) baseadas em WebAuthn para autenticação segura de usuários sem senhas. | TRUE |
| verbose_upload_logging | booleano | Ativa registros detalhados para atividades do processo de upload, o que é útil para identificar e diagnosticar problemas com uploads de arquivos. | FALSE |
| verbose_auth_token_logging | booleano | Ativa o registro detalhado para processos de tokens de autenticação. | FALSE |
| max_suspicious_distance_km | inteiro | Define a distância máxima em quilômetros entre endereços IP sucessivos para que o login seja considerado suspeito. | 100 |
| discourse_connect_csrf_protection | booleano | Ativa a proteção CSRF para autenticação DiscourseConnect. | TRUE |
| invites_per_page | inteiro | Número de convites exibidos por página na página de convites. | 40 |
| max_notifications_per_user | inteiro | Número máximo de notificações que um usuário pode ter antes que as mais antigas sejam automaticamente excluídas. | 10000 |
| max_bookmarks_per_user | inteiro | Número máximo de marcadores que um usuário pode criar. | 2000 |
Publicação
Personalize como a publicação funciona dentro da sua instância do Discourse:
| Configuração do Site | Tipo | Descrição | Valor Padrão |
|---|---|---|---|
| show_copy_button_on_codeblocks | booleano | Adiciona um botão aos blocos de código para copiar o conteúdo do bloco para a área de transferência do usuário | TRUE |
| disable_watched_word_checking_in_user_fields | booleano | Desativa a verificação de palavras monitoradas nos campos de usuário | FALSE |
| max_draft_length | inteiro | Define o comprimento máximo permitido para rascunhos | 150000 |
| max_drafts_per_user | inteiro | Número máximo de rascunhos que um usuário pode ter | 10000 |
| group_pm_user_limit | inteiro | Número máximo de usuários que podem ser incluídos em uma mensagem privada de grupo | 1000 |
Gerencie como os e-mails são enviados e recebidos da sua plataforma Discourse:
| Configuração do Site | Tipo | Descrição | Valor Padrão |
|---|---|---|---|
| bounce_score_erode_on_send | float | Reduz a pontuação de bounce cada vez que um e-mail é enviado, permitindo uma recuperação mais rápida de bounces. | 0.1 |
| email_custom_template | string | Modelo HTML personalizado para e-mails. Usado se o padrão precisar ser substituído. | “” (vazio) |
| email_custom_css | string | CSS personalizado para estilizar e-mails. Usado se o padrão precisar ser substituído. | “” (vazio) |
| email_custom_css_compiled | string | Versão compilada do CSS personalizado para e-mails. | “” (vazio) |
| enable_secondary_emails | booleano | Permite que os usuários adicionem endereços de e-mail secundários ao seu perfil. | TRUE |
| max_participant_names | inteiro | Número máximo de nomes de participantes exibidos nas notificações por e-mail para mensagens de grupo. | 10 |
Arquivos
Defina como arquivos e uploads são gerenciados:
| Configuração do Site | Tipo | Descrição | Valor Padrão |
|---|---|---|---|
| max_export_file_size_kb | inteiro | Especifica o tamanho máximo do arquivo para exportações em kilobytes. | 50000 |
| export_authorized_extensions | string | Especifica as extensões de arquivo permitidas para exportações. | “zip” |
| secure_uploads_pm_only | booleano | Se verdadeiro, uploads seguros são ativados apenas para mensagens privadas. | FALSE |
| enable_s3_transfer_acceleration | booleano | Se verdadeiro, ativa a Aceleração de Transferência do Amazon S3. | FALSE |
| s3_http_continue_timeout | inteiro | Tempo em segundos para aguardar uma resposta 100 Continue do S3 antes de enviar o payload da solicitação. | 1 |
| s3_install_cors_rule | booleano | Se verdadeiro, instala regras CORS no S3 para permitir solicitações de qualquer domínio. | TRUE |
| s3_presigned_get_url_expires_after_seconds | inteiro | Duração em segundos após a qual uma URL assinada para objetos S3 expirará. | 300 |
| decompressed_theme_max_file_size_mb | inteiro | Tamanho máximo do arquivo em megabytes para um arquivo de tema após ser descomprimido. | 1000 |
| decompressed_backup_max_file_size_mb | inteiro | Tamanho máximo do arquivo em megabytes para arquivos de backup após a descompressão. | 100000 |
| composer_media_optimization_image_resize_pre_multiply | booleano | Otimize o manuseio de imagens pré-multiplicando o canal alfa em manipulações de canvas para melhorar a qualidade do redimensionamento de imagens. | FALSE |
| composer_media_optimization_image_encode_quality | inteiro | Qualidade de codificação JPG usada no processo de recodificação para otimização de imagens. | 0 |
| composer_media_optimization_image_resize_linear_rgb | booleano | Ao redimensionar, use RGB linear para melhorar a qualidade da imagem redimensionada. | FALSE |
| composer_ios_media_optimisation_image_enabled | booleano | Ativa estratégias específicas de otimização de imagem em dispositivos iOS para melhorar o desempenho. | TRUE |
| video_thumbnails_enabled | booleano | Ativa a geração de miniaturas para arquivos de vídeo enviados ao fórum. | TRUE |
Segurança
Ajuste os recursos de segurança para atender às necessidades do seu fórum:
| Configuração do Site | Tipo | Descrição | Valor Padrão |
|---|---|---|---|
| allow_indexing_non_canonical_urls | booleano | Permite a indexação de URLs não canônicas. | TRUE |
| non_crawler_user_agents | lista | Lista de user agents considerados como não-crawlers. | "trident |
| crawler_user_agents | lista | Lista de user agents considerados como crawlers. | "rss |
| browser_update_user_agents | lista | User agents para navegadores desatualizados para mostrar mensagens de atualização. | "MSIE 6 |
| crawler_check_bypass_agents | string | User agents que podem contornar verificações de crawler. | “cubot” |
| keep_old_ip_address_count | inteiro | Número de endereços IP antigos a serem mantidos para cada usuário. | 0 |
| content_security_policy_collect_reports | booleano | Ativa a coleta de relatórios de violação de CSP. | FALSE |
| allow_embedding_site_in_an_iframe | booleano | Permite que o site seja incorporado dentro de um iframe em outros sites. | FALSE |
| send_old_credential_reminder_days | inteiro | Número de dias para lembrar sobre credenciais antigas. Se definido como 0, os lembretes são desativados. | 0 |
| disable_onebox_media_download_controls | booleano | Desativa os controles de download de mídia em embeds de áudio/vídeo onebox. | FALSE |
| cross_origin_opener_policy_header | string | Define o cabeçalho Cross-Origin-Opener-Policy. Opções disponíveis: unsafe-none, same-origin, same-origin-allow-popups. | “same-origin-allow-popups” |
Onebox
Controle como os oneboxes são tratados:
| Configuração do Site | Tipo | Descrição | Valor Padrão |
|---|---|---|---|
| force_get_hosts | lista | Domínios onde a solicitação GET é forçada devido a problemas com solicitações HEAD | us.battle.net news.yahoo.com *.medium.com |
| onebox_user_agent | string | Define a string user agent usada pelo sistema Onebox ao fazer solicitações HTTP. Se a configuração estiver vazia, ele recua para um user agent padrão definido em Onebox.options.user_agent |
“” |
| inline_onebox_user_agent | string | User agent personalizado usado ao buscar respostas de onebox inline, se especificado | “” |
Limites de Taxa
Gerencie recursos e segurança através de limites de taxa:
| Configuração do Site | Tipo | Descrição | Valor Padrão |
|---|---|---|---|
| rate_limit_search_anon_global_per_minute | inteiro | Limite global de taxa para solicitações de busca anônimas por minuto | 150 |
| rate_limit_search_anon_user_per_minute | inteiro | Limite de taxa por usuário para solicitações de busca anônimas por minuto | 15 |
| rate_limit_search_anon_global_per_second | inteiro | Limite global de taxa para solicitações de busca anônimas por segundo | 8 |
| rate_limit_search_anon_user_per_second | inteiro | Limite de taxa por usuário para solicitações de busca anônimas por segundo | 2 |
| rate_limit_search_user | inteiro | Limite de taxa por usuário para solicitações de busca de usuários logados por minuto | 30 |
| max_allowed_secondary_emails | inteiro | Número máximo de e-mails secundários que um usuário pode ter | 10 |
| max_batch_presign_multipart_per_minute | inteiro | Número máximo de operações multipart de pré-assinatura em lote que um usuário pode iniciar por minuto | 20 |
| max_presigned_put_per_minute | inteiro | Número máximo de operações PUT pré-assinadas que um usuário pode iniciar por minuto | 10 |
| max_create_multipart_per_minute | inteiro | Número máximo de criações multipart que um usuário pode iniciar por minuto | 10 |
| max_complete_multipart_per_minute | inteiro | Número máximo de conclusões multipart que um usuário pode iniciar por minuto | 10 |
| max_uploads_per_minute | inteiro | Número máximo de operações de upload que um usuário pode iniciar por minuto | 10 |
Desenvolvedor
Adapte o ambiente de desenvolvimento:
| Configuração do Site | Tipo | Descrição | Valor Padrão |
|---|---|---|---|
| force_hostname | string | Força um hostname específico para o site. | “” |
| port | inteiro | Configura o número da porta que o servidor escuta. | “” |
| enable_chunked_encoding | booleano | Ativa respostas com codificação chunked pelo servidor, potencialmente ajudando com proxies que armazenam respostas em buffer. | TRUE |
| long_polling_base_url | string | URL base a ser usada para long polling, útil para separar o tráfego de CDN da interação direta com o site. | “/” |
| background_polling_interval | inteiro | Frequência em milissegundos para polling em background por clientes. | 60000 |
| polling_interval | inteiro | Frequência em milissegundos para polling ativo por clientes logados. | 3000 |
| anon_polling_interval | inteiro | Frequência em milissegundos para clientes anônimos fazerem polling no servidor. | 25000 |
| rebake_old_posts_count | inteiro | Número de posts que são re-assados por tarefas automatizadas executadas em segundo plano. | 80 |
| migrate_to_new_scheme | booleano | Alternar se deve migrar uploads antigos para um novo esquema de armazenamento, usado principalmente durante atualizações. | FALSE |
| max_new_topics | inteiro | Número máximo de novos tópicos que um usuário pode criar, usado para evitar spam ou sobrecarga do sistema. | 500 |
| wizard_enabled | booleano | Ativa ou desativa o assistente de configuração mostrado após a instalação. | TRUE |
| bypass_wizard_check | booleano | Permite ignorar a verificação de conclusão do assistente de configuração, útil para desenvolvedores ou configurações automatizadas. | FALSE |
| logging_provider | enum | Determina o framework de registro para a aplicação. Pode ser ‘default’ ou um framework alternativo suportado. | “default” |
| bootstrap_error_pages | booleano | Ativa ou desativa páginas de erro com estilo bootstrap. Útil para manter a consistência de estilo nas páginas de erro. | FALSE |
| include_associated_account_ids | booleano | Incluir IDs de contas associadas em certas saídas—útil para um manuseio de dados de contas mais conectado. | FALSE |
| max_sidebar_section_links | inteiro | Número máximo de links por seção da barra lateral, controlando a desordem da interface e o desempenho. | 50 |
| instrument_gc_stat_per_request | booleano | Se deve coletar e registrar estatísticas de coleta de lixo (garbage collection) a cada solicitação HTTP—útil para ajuste de desempenho. | FALSE |
| warn_critical_js_deprecations | booleano | Ativa avisos para depreciações críticas de JavaScript para administradores—ajuda na preparação para atualizações ou correções. | TRUE |
| warn_critical_js_deprecations_message | string | Mensagem personalizada anexada aos avisos de depreciação JS crítica, tornando as notificações mais informativas. | “” |
Incorporação
Permita ou restrinja a incorporação de conteúdo:
| Configuração do Site | Tipo | Descrição | Valor Padrão |
|---|---|---|---|
| embed_by_username | string | Nome de usuário a ser usado para conteúdo incorporado. | “” |
| embed_post_limit | inteiro | Número máximo de posts a serem incorporados de uma fonte externa. | 100 |
| embed_topic_limit_per_page | inteiro | Número máximo de tópicos exibidos por página para tópicos incorporados. | 200 |
| embed_title_scrubber | string | Expressão regular usada para limpar ou modificar títulos em conteúdo incorporado. | “” |
| blocked_embed_selectors | string | Seletores CSS que especificam elementos a excluir do conteúdo incorporado. | “” |
| allowed_embed_classnames | string | Nomes de classe permitidos no conteúdo incorporado, ajuda a filtrar o estilo do conteúdo. | “emoji” |
Backups
Personalize as configurações de backup:
| Configuração do Site | Tipo | Descrição | Valor Padrão |
|---|---|---|---|
| include_s3_uploads_in_backups | booleano | Determina se os uploads armazenados no S3 devem ser incluídos nos backups do site. | FALSE |
Busca
Otimize a funcionalidade de busca dentro do seu site Discourse:
| Configuração do Site | Tipo | Descrição | Valor Padrão |
|---|---|---|---|
| prioritize_exact_search_title_match | booleano | Dá prioridade aos resultados de busca que correspondem exatamente aos termos de busca nos títulos. | TRUE |
| max_duplicate_search_index_terms | inteiro | Define o número máximo de termos duplicados indexados para busca. | 6 |
| use_pg_headlines_for_excerpt | booleano | Ativa o suporte a headlines do Postgres para gerar trechos de busca. | FALSE |
| search_max_indexed_word_length | inteiro | Comprimento máximo das palavras indexadas para busca. | 100 |
| search_ranking_normalization | string | Controla a normalização das classificações de busca para melhorar a relevância dos resultados. | “0” |
| search_ranking_weights | string | Define os fatores de ponderação usados nos cálculos de classificação de busca. | “” |
| search_recent_regular_posts_offset_post_id | inteiro | Deslocamento de ID de post para recuperar posts recentes nos resultados de busca. | 0 |
| search_enable_recent_regular_posts_offset_size | inteiro | Determina o número de posts regulares recentes a considerar na busca. | 200000 |
| category_search_priority_low_weight | float | Define a ponderação inferior para priorizar categorias nos resultados de busca. | 0.8 |
| category_search_priority_high_weight | float | Define a ponderação superior para priorizar categorias nos resultados de busca. | 1.2 |
| search_page_size | inteiro | Número de resultados por página em consultas de busca. | 50 |
Sem Categoria
Várias configurações que não se encaixam em outras categorias:
| Configuração do Site | Tipo | Descrição | Valor Padrão |
|---|---|---|---|
| has_login_hint | booleano | Determina se dicas de login devem aparecer | FALSE |
| min_new_topics_time | inteiro | Tempo mínimo entre novos tópicos | 0 |
| general_category_id | inteiro | ID para a categoria geral | -1 |
| meta_category_id | inteiro | ID para a categoria meta | -1 |
| staff_category_id | inteiro | ID para a categoria de equipe | -1 |
| uncategorized_category_id | inteiro | ID para a categoria sem categoria | -1 |
| backup_drafts_to_pm_length | inteiro | Comprimento dos rascunhos em MPs antes que o backup seja necessário | 0 |
| view_user_route | string | Seção padrão da página de perfil do usuário | “summary” |
| tos_topic_id | inteiro | ID para o tópico de Termos de Serviço | -1 |
| guidelines_topic_id | inteiro | ID para o tópico de diretrizes | -1 |
| privacy_topic_id | inteiro | ID para o tópico de política de privacidade | -1 |
| welcome_topic_id | inteiro | ID para o tópico de boas-vindas | -1 |
| admin_quick_start_topic_id | inteiro | ID para o tópico do guia de início rápido de administrador | -1 |
| ios_app_id | string | ID da App Store para o aplicativo iOS | “1173672076” |
| android_app_id | string | ID da Play Store para o aplicativo Android | “com.discourse” |
| pwa_display_browser_regex | string | Regex para determinar se a exibição PWA está definida como ‘browser’ | “a^” |
| always_include_topic_excerpts | booleano | Incluir trechos de tópicos toda vez | FALSE |
| max_bulk_invites | inteiro | Número máximo de convites em lote possíveis | 50,000 |
| skip_email_bulk_invites | booleano | Ignorar o envio de e-mails em convites em lote | FALSE |
| max_api_invites | inteiro | Número máximo de convites por solicitação de API | 200 |
| overridden_robots_txt | string | Regras personalizadas para robots.txt | “” |
| show_category_definitions_in_topic_lists | booleano | Mostrar posts de definição de categoria nas listas de tópicos | FALSE |
| max_automatic_membership_email_domains | inteiro | Número máximo de domínios de e-mail de associação automática possíveis | 50 |
API
Gerencie como a API opera dentro da sua instância do Discourse:
| Configuração do Site | Tipo | Descrição | Valor Padrão |
|---|---|---|---|
| api_key_last_used_epoch | inteiro | Rastreia o último tempo de epoch usado para chaves de API. Não diretamente acessível ou editável. | # O valor é adicionado em uma migração |
| revoke_api_keys_maxlife_days | inteiro | Número de dias antes que uma chave de API seja automaticamente revogada, defina como 0 para nunca. | 0 |
Painel de Controle
Ajuste quais relatórios são exibidos no painel de administração e como os tópicos populares são definidos:
| Configuração do Site | Tipo | Descrição | Valor Padrão |
|---|---|---|---|
| verbose_user_stat_count_logging | booleano | Ativa o registro detalhado para atualizações de contagem de estatísticas de usuários. | FALSE |
| hot_topics_gravity | float | Controla a configuração de gravidade usada no cálculo de tópicos populares. | 1.2 |
| hot_topics_recent_days | inteiro | Define o número de dias recentes a considerar para calcular as pontuações de tópicos populares. | 7 |