Dies ist ein #Referenzleitfaden zur Beschreibung aller verfügbaren versteckten Site-Einstellungen.
Erforderliche Benutzerstufe: Administrator
Versteckte Site-Einstellungen in Discourse sind erweiterte Konfigurationsoptionen, die nicht über die Standard-Admin-Oberfläche verfügbar sind. Sie bieten zusätzliche Flexibilität, um die Funktionalität Ihrer Discourse-Instanz anzupassen.
Weitere Informationen zum Ändern versteckter Site-Einstellungen finden Sie unter: Versteckte Site-Einstellungen aktivieren.
Nachfolgend finden Sie eine Referenztabelle aller in Discourse verfügbaren versteckten Site-Einstellungen.
Grundlegend
Einstellungen, die Ihnen helfen, grundlegende Aspekte Ihrer Discourse-Instanz anzupassen:
| Site-Einstellung | Typ | Beschreibung | Standardwert |
|---|---|---|---|
| max_category_nesting | Integer | Legt die maximale Anzahl erlaubter Verschachtelungsebenen für Kategorien fest. | 2 |
| enable_mobile_theme | Boolean | Aktiviert ein mobilspezifisches Theme. Deaktivieren Sie dies, um ein responsives Stylesheet für alle Geräte zu verwenden. | TRUE |
| enable_upload_debug_mode | Boolean | Aktiviert eine ausführliche Protokollierung für Uploads, nützlich zur Fehlerbehebung bei Upload-Problemen. | FALSE |
| default_theme_id | Integer | Die Standard-Theme-ID für neue und anonyme Benutzer. | -1 |
| enable_badge_sql | Boolean | Erlaubt die Verwendung von SQL, um Badge-Abfragen direkt in der Admin-Oberfläche zu definieren. | FALSE |
| vapid_public_key_bytes | String | Speichert den öffentlichen Schlüssel, der für die VAPID-Authentifizierung verwendet wird und für das Senden von Web-Push-Benachrichtigungen erforderlich ist. | “” |
| vapid_public_key | String | Öffentlicher Schlüssel für die VAPID-Authentifizierung bei Web-Push-Benachrichtigungen. | “” |
| vapid_private_key | String | Privater Schlüssel für die VAPID-Authentifizierung bei Web-Push-Benachrichtigungen. | “” |
| vapid_base_url | String | Die Basis-URL, die für VAPID konfiguriert ist, um die Serveridentität bei Web-Push-Benachrichtigungen zu bestätigen. | “” |
| enable_passkeys | Boolean | Aktiviert die Verwendung von WebAuthn-basierten Passkeys für eine sichere Benutzerauthentifizierung ohne Passwörter. | TRUE |
| verbose_upload_logging | Boolean | Aktiviert detaillierte Protokolle für Upload-Prozessaktivitäten, was hilfreich ist, um Probleme mit Datei-Uploads zu identifizieren und zu diagnostizieren. | FALSE |
| verbose_auth_token_logging | Boolean | Aktiviert eine detaillierte Protokollierung für Authentifizierungstoken-Prozesse. | FALSE |
| max_suspicious_distance_km | Integer | Definiert die maximale Distanz in Kilometern zwischen aufeinanderfolgenden IP-Adressen, damit ein Login als verdächtig gilt. | 100 |
| discourse_connect_csrf_protection | Boolean | Aktiviert den CSRF-Schutz für die DiscourseConnect-Authentifizierung. | TRUE |
| invites_per_page | Integer | Anzahl der Einladungen, die pro Seite auf der Einladungsseite angezeigt werden. | 40 |
| max_notifications_per_user | Integer | Maximale Anzahl von Benachrichtigungen, die ein Benutzer haben kann, bevor ältere automatisch gelöscht werden. | 10000 |
| max_bookmarks_per_user | Integer | Maximale Anzahl von Lesezeichen, die ein Benutzer erstellen kann. | 2000 |
Beiträge
Passen Sie an, wie Beiträge innerhalb Ihrer Discourse-Instanz funktionieren:
| Site-Einstellung | Typ | Beschreibung | Standardwert |
|---|---|---|---|
| show_copy_button_on_codeblocks | Boolean | Fügt Codeblöcken eine Schaltfläche hinzu, um den Blockinhalt in die Zwischenablage des Benutzers zu kopieren. | TRUE |
| disable_watched_word_checking_in_user_fields | Boolean | Deaktiviert die Prüfung auf überwachte Wörter in Benutzerfeldern. | FALSE |
| max_draft_length | Integer | Legt die maximal zulässige Länge für Entwürfe fest. | 150000 |
| max_drafts_per_user | Integer | Maximale Anzahl von Entwürfen, die ein Benutzer haben kann. | 10000 |
| group_pm_user_limit | Integer | Maximale Anzahl von Benutzern, die in einer Gruppen-PM enthalten sein können | 1000 |
Verwalten Sie, wie E-Mails von Ihrer Discourse-Plattform gesendet und empfangen werden:
| Site-Einstellung | Typ | Beschreibung | Standardwert |
|---|---|---|---|
| bounce_score_erode_on_send | Float | Verringert die Absprungrate jedes Mal, wenn eine E-Mail gesendet wird, was eine schnellere Erholung von Absprüngen ermöglicht. | 0.1 |
| email_custom_template | String | Benutzerdefinierte HTML-Vorlage für E-Mails. Wird verwendet, wenn das Standardverhalten überschrieben werden muss. | “” (leer) |
| email_custom_css | String | Benutzerdefiniertes CSS für das Styling von E-Mails. Wird verwendet, wenn das Standardverhalten überschrieben werden muss. | “” (leer) |
| email_custom_css_compiled | String | Kompilierte Version des benutzerdefinierten CSS für E-Mails. | “” (leer) |
| enable_secondary_emails | Boolean | Ermöglicht Benutzern, sekundäre E-Mail-Adressen zu ihrem Profil hinzuzufügen. | TRUE |
| max_participant_names | Integer | Maximale Anzahl von Teilnehmernamen, die in E-Mail-Benachrichtigungen für Gruppennachrichten angezeigt werden. | 10 |
Dateien
Definieren Sie, wie Dateien und Uploads verwaltet werden:
| Site-Einstellung | Typ | Beschreibung | Standardwert |
|---|---|---|---|
| max_export_file_size_kb | Integer | Gibt die maximale Dateigröße für Exporte in Kilobyte an. | 50000 |
| export_authorized_extensions | String | Gibt die Dateierweiterungen an, die für Exporte zulässig sind. | “zip” |
| secure_uploads_pm_only | Boolean | Wenn wahr, sind sichere Uploads nur für private Nachrichten aktiviert. | FALSE |
| enable_s3_transfer_acceleration | Boolean | Wenn wahr, wird die Amazon S3 Transfer Acceleration aktiviert. | FALSE |
| s3_http_continue_timeout | Integer | Zeit in Sekunden, die gewartet wird, bis eine 100 Continue-Antwort von S3 vorliegt, bevor die Anforderungsnutzlast gesendet wird. | 1 |
| s3_install_cors_rule | Boolean | Wenn wahr, werden CORS-Regeln auf S3 installiert, um Anfragen von beliebigen Domains zuzulassen. | TRUE |
| s3_presigned_get_url_expires_after_seconds | Integer | Dauer in Sekunden, nach der eine vorunterschriebene URL für S3-Objekte abläuft. | 300 |
| decompressed_theme_max_file_size_mb | Integer | Maximale Dateigröße in Megabyte für eine Themendatei nach der Dekomprimierung. | 1000 |
| decompressed_backup_max_file_size_mb | Integer | Maximale Dateigröße in Megabyte für Sicherungsdateien nach der Dekomprimierung. | 100000 |
| composer_media_optimization_image_resize_pre_multiply | Boolean | Optimiert die Bildverarbeitung durch Vervielfältigung des Alphakanals bei Canvas-Manipulationen, um die Qualität der Bildgröße zu verbessern. | FALSE |
| composer_media_optimization_image_encode_quality | Integer | JPG-Kodierungsqualität, die im Re-Kodierungsprozess für die Bildoptimierung verwendet wird. | 0 |
| composer_media_optimization_image_resize_linear_rgb | Boolean | Verwenden Sie beim Ändern der Größe lineares RGB, um die Qualität des geänderten Bildes zu verbessern. | FALSE |
| composer_ios_media_optimisation_image_enabled | Boolean | Aktiviert spezifische Bildoptimierungsstrategien auf iOS-Geräten, um die Leistung zu verbessern. | TRUE |
| video_thumbnails_enabled | Boolean | Aktiviert die Generierung von Vorschaubildern für Videodateien, die im Forum hochgeladen wurden. | TRUE |
Sicherheit
Passen Sie Sicherheitsfunktionen an die Bedürfnisse Ihres Forums an:
| Site-Einstellung | Typ | Beschreibung | Standardwert |
|---|---|---|---|
| allow_indexing_non_canonical_urls | Boolean | Ermöglicht die Indexierung nicht-kanonischer URLs. | TRUE |
| non_crawler_user_agents | Liste | Liste der User-Agents, die als Nicht-Crawler gelten. | "trident |
| crawler_user_agents | Liste | Liste der User-Agents, die als Crawler gelten. | "rss |
| browser_update_user_agents | Liste | User-Agents für veraltete Browser, um Aktualisierungsmeldungen anzuzeigen. | "MSIE 6 |
| crawler_check_bypass_agents | String | User-Agents, die Crawler-Checks umgehen können. | “cubot” |
| keep_old_ip_address_count | Integer | Anzahl der alten IP-Adressen, die für jeden Benutzer gespeichert werden. | 0 |
| content_security_policy_collect_reports | Boolean | Aktiviert die Sammlung von CSP-Verletzungsberichten. | FALSE |
| allow_embedding_site_in_an_iframe | Boolean | Ermöglicht die Einbettung der Site in einem iframe auf anderen Sites. | FALSE |
| send_old_credential_reminder_days | Integer | Anzahl der Tage, um an alte Anmeldeinformationen zu erinnern. Wenn auf 0 gesetzt, sind Erinnerungen deaktiviert. | 0 |
| disable_onebox_media_download_controls | Boolean | Deaktiviert Medien-Download-Steuerelemente in Onebox-Audio/Video-Einbettungen. | FALSE |
| cross_origin_opener_policy_header | String | Setzt den Cross-Origin-Opener-Policy-Header. Verfügbare Optionen: unsafe-none, same-origin, same-origin-allow-popups. | “same-origin-allow-popups” |
Onebox
Steuern Sie, wie Oneboxes behandelt werden:
| Site-Einstellung | Typ | Beschreibung | Standardwert |
|---|---|---|---|
| force_get_hosts | Liste | Domains, bei denen aufgrund von Problemen mit HEAD-Anfragen eine GET-Anfrage erzwungen wird | us.battle.net news.yahoo.com *.medium.com |
| onebox_user_agent | String | Definiert die User-Agent-Zeichenfolge, die vom Onebox-System bei HTTP-Anfragen verwendet wird. Wenn die Einstellung leer ist, wird auf einen Standard-User-Agent zurückgegriffen, der in Onebox.options.user_agent definiert ist. |
“” |
| inline_onebox_user_agent | String | Benutzerdefinierter User-Agent, der beim Abrufen von Inline-Onebox-Antworten verwendet wird, falls angegeben | “” |
Ratenbegrenzungen
Verwalten Sie Ressourcen und Sicherheit durch Ratenbegrenzungen:
| Site-Einstellung | Typ | Beschreibung | Standardwert |
|---|---|---|---|
| rate_limit_search_anon_global_per_minute | Integer | Globale Ratenbegrenzung für anonyme Suchanfragen pro Minute | 150 |
| rate_limit_search_anon_user_per_minute | Integer | Ratenbegrenzung pro Benutzer für anonyme Suchanfragen pro Minute | 15 |
| rate_limit_search_anon_global_per_second | Integer | Globale Ratenbegrenzung für anonyme Suchanfragen pro Sekunde | 8 |
| rate_limit_search_anon_user_per_second | Integer | Ratenbegrenzung pro Benutzer für anonyme Suchanfragen pro Sekunde | 2 |
| rate_limit_search_user | Integer | Ratenbegrenzung pro Benutzer für Suchanfragen von angemeldeten Benutzern pro Minute | 30 |
| max_allowed_secondary_emails | Integer | Maximale Anzahl sekundärer E-Mails, die ein Benutzer haben darf | 10 |
| max_batch_presign_multipart_per_minute | Integer | Maximale Anzahl von Batch-Vorunterschrift-Multipart-Operationen, die ein Benutzer pro Minute initiieren kann | 20 |
| max_presigned_put_per_minute | Integer | Maximale Anzahl von vorunterschriebenen PUT-Operationen, die ein Benutzer pro Minute initiieren kann | 10 |
| max_create_multipart_per_minute | Integer | Maximale Anzahl von Multipart-Erstellungen, die ein Benutzer pro Minute initiieren kann | 10 |
| max_complete_multipart_per_minute | Integer | Maximale Anzahl von Multipart-Abschlüssen, die ein Benutzer pro Minute initiieren kann | 10 |
| max_uploads_per_minute | Integer | Maximale Anzahl von Upload-Operationen, die ein Benutzer pro Minute initiieren kann | 10 |
Entwickler
Passen Sie die Entwicklungsumgebung an:
| Site-Einstellung | Typ | Beschreibung | Standardwert |
|---|---|---|---|
| force_hostname | String | Erzwingt einen bestimmten Hostnamen für die Site. | “” |
| port | Integer | Konfiguriert die Portnummer, auf der der Server lauscht. | “” |
| enable_chunked_encoding | Boolean | Aktiviert Chunked-Encoding-Antworten durch den Server, was bei Proxys, die Antworten puffern, hilfreich sein kann. | TRUE |
| long_polling_base_url | String | Basis-URL für Long-Polling, nützlich zur Trennung von CDN-Datenverkehr und direkter Site-Interaktion. | “/” |
| background_polling_interval | Integer | Frequenz in Millisekunden für Hintergrundabfragen durch Clients. | 60000 |
| polling_interval | Integer | Frequenz in Millisekunden für aktive Abfragen durch angemeldete Clients. | 3000 |
| anon_polling_interval | Integer | Frequenz in Millisekunden für anonyme Clients, um den Server abzufragen. | 25000 |
| rebake_old_posts_count | Integer | Anzahl der Beiträge, die von automatisierten Aufgaben im Hintergrund neu verarbeitet werden. | 80 |
| migrate_to_new_scheme | Boolean | Schaltet um, ob alte Uploads auf ein neues Speicherschema migriert werden sollen, hauptsächlich während Updates verwendet. | FALSE |
| max_new_topics | Integer | Maximale Anzahl neuer Themen, die ein Benutzer erstellen kann, verwendet zur Verhinderung von Spam oder Systemüberlastung. | 500 |
| wizard_enabled | Boolean | Aktiviert oder deaktiviert den Einrichtungsassistenten, der nach der Installation angezeigt wird. | TRUE |
| bypass_wizard_check | Boolean | Ermöglicht das Umgehen der Überprüfung des Abschlusses des Einrichtungsassistenten, nützlich für Entwickler oder automatisierte Setup-Prozesse. | FALSE |
| logging_provider | Enum | Bestimmt das Protokollierungsframework für die Anwendung. Kann ‘default’ oder ein alternatives unterstütztes Framework sein. | “default” |
| bootstrap_error_pages | Boolean | Aktiviert oder deaktiviert bootgestützte, gestaltete Fehlerseiten. Nützlich zur Wahrung der Stilkonsistenz auf Fehlerseiten. | FALSE |
| include_associated_account_ids | Boolean | Schließt IDs verbundener Konten in bestimmten Ausgaben ein – nützlich für eine besser vernetzte Kontodatenverarbeitung. | FALSE |
| max_sidebar_section_links | Integer | Maximale Anzahl von Links pro Seitenleistenabschnitt, zur Kontrolle von UI-Unordnung und Leistung. | 50 |
| instrument_gc_stat_per_request | Boolean | Ob Garbage-Collection-Statistiken pro HTTP-Anfrage gesammelt und protokolliert werden sollen – nützlich für Leistungsoptimierungen. | FALSE |
| warn_critical_js_deprecations | Boolean | Aktiviert Warnungen für kritische JavaScript-Deprecations für Administratoren – hilft bei der Vorbereitung auf Upgrades oder Fehlerbehebungen. | TRUE |
| warn_critical_js_deprecations_message | String | Benutzerdefinierte Nachricht, die an kritische JS-Deprecation-Warnungen angehängt wird, um die Benachrichtigungen informativer zu machen. | “” |
Einbettung
Erlauben oder beschränken Sie die Einbettung von Inhalten:
| Site-Einstellung | Typ | Beschreibung | Standardwert |
|---|---|---|---|
| embed_by_username | String | Benutzername, der für eingebettete Inhalte verwendet wird. | “” |
| embed_post_limit | Integer | Maximale Anzahl von Beiträgen, die aus einer externen Quelle eingebettet werden können. | 100 |
| embed_topic_limit_per_page | Integer | Maximale Anzahl von Themen, die pro Seite für eingebettete Themen angezeigt werden. | 200 |
| embed_title_scrubber | String | Regulärer Ausdruck, der verwendet wird, um Titel in eingebetteten Inhalten zu bereinigen oder zu modifizieren. | “” |
| blocked_embed_selectors | String | CSS-Selektoren, die Elemente angeben, die von eingebetteten Inhalten ausgeschlossen werden sollen. | “” |
| allowed_embed_classnames | String | Klassennamen, die in eingebetteten Inhalten erlaubt sind, hilft beim Filtern des Inhaltsstils. | “emoji” |
Sicherungen
Passen Sie Sicherungskonfigurationen an:
| Site-Einstellung | Typ | Beschreibung | Standardwert |
|---|---|---|---|
| include_s3_uploads_in_backups | Boolean | Bestimmt, ob in S3 gespeicherte Uploads in Site-Sicherungen enthalten sein sollen. | FALSE |
Suche
Optimieren Sie die Suchfunktionalität innerhalb Ihrer Discourse-Site:
| Site-Einstellung | Typ | Beschreibung | Standardwert |
|---|---|---|---|
| prioritize_exact_search_title_match | Boolean | Gibt Suchergebnissen Priorität, die die Suchbegriffe in Titeln exakt übereinstimmen. | TRUE |
| max_duplicate_search_index_terms | Integer | Legt die maximale Anzahl duplizierter Begriffe fest, die für die Suche indiziert werden. | 6 |
| use_pg_headlines_for_excerpt | Boolean | Aktiviert die Unterstützung von Postgres-Headlines zur Generierung von Suchauszügen. | FALSE |
| search_max_indexed_word_length | Integer | Maximale Länge der für die Suche indizierten Wörter. | 100 |
| search_ranking_normalization | String | Steuert die Normalisierung der Suchplatzierungen, um die Relevanz der Ergebnisse zu verbessern. | “0” |
| search_ranking_weights | String | Setzt die Gewichtungsfaktoren, die bei der Berechnung der Suchplatzierungen verwendet werden. | “” |
| search_recent_regular_posts_offset_post_id | Integer | Post-ID-Offset zum Abrufen aktueller Beiträge in Suchergebnissen. | 0 |
| search_enable_recent_regular_posts_offset_size | Integer | Bestimmt die Anzahl der aktuellen regulären Beiträge, die in der Suche berücksichtigt werden. | 200000 |
| category_search_priority_low_weight | Float | Setzt die niedrigere Gewichtung für die Priorisierung von Kategorien in Suchergebnissen. | 0.8 |
| category_search_priority_high_weight | Float | Setzt die höhere Gewichtung für die Priorisierung von Kategorien in Suchergebnissen. | 1.2 |
| search_page_size | Integer | Anzahl der Ergebnisse pro Seite in Suchanfragen. | 50 |
Nicht kategorisiert
Verschiedene Einstellungen, die nicht in andere Kategorien passen:
| Site-Einstellung | Typ | Beschreibung | Standardwert |
|---|---|---|---|
| has_login_hint | Boolean | Bestimmt, ob Login-Hinweise angezeigt werden sollen | FALSE |
| min_new_topics_time | Integer | Mindestzeit zwischen neuen Themen | 0 |
| general_category_id | Integer | ID für die allgemeine Kategorie | -1 |
| meta_category_id | Integer | ID für die Meta-Kategorie | -1 |
| staff_category_id | Integer | ID für die Personal-Kategorie | -1 |
| uncategorized_category_id | Integer | ID für die nicht kategorisierte Kategorie | -1 |
| backup_drafts_to_pm_length | Integer | Länge von Entwürfen in PMs, bevor eine Sicherung erforderlich ist | 0 |
| view_user_route | String | Standardabschnitt der Benutzerprofilseite | “summary” |
| tos_topic_id | Integer | ID für das Thema der Nutzungsbedingungen | -1 |
| guidelines_topic_id | Integer | ID für das Thema der Richtlinien | -1 |
| privacy_topic_id | Integer | ID für das Thema der Datenschutzrichtlinie | -1 |
| welcome_topic_id | Integer | ID für das Willkommens-Thema | -1 |
| admin_quick_start_topic_id | Integer | ID für das Thema des Admin-Schnellstartleitfadens | -1 |
| ios_app_id | String | App Store-ID für die iOS-App | “1173672076” |
| android_app_id | String | Play Store-ID für die Android-App | “com.discourse” |
| pwa_display_browser_regex | String | Regex zur Bestimmung, ob die PWA-Anzeige auf ‘browser’ gesetzt ist | “a^” |
| always_include_topic_excerpts | Boolean | Themenauszüge jedes Mal einschließen | FALSE |
| max_bulk_invites | Integer | Maximale Anzahl möglicher Massen-Einladungen | 50.000 |
| skip_email_bulk_invites | Boolean | Überspringen des Versands von E-Mails bei Massen-Einladungen | FALSE |
| max_api_invites | Integer | Maximale Anzahl von Einladungen pro API-Anfrage | 200 |
| overridden_robots_txt | String | Benutzerdefinierte Regeln für robots.txt | “” |
| show_category_definitions_in_topic_lists | Boolean | Kategoriedefinitionsbeiträge in Themenlisten anzeigen | FALSE |
| max_automatic_membership_email_domains | Integer | Maximale Anzahl möglicher automatischer Mitgliedschafts-E-Mail-Domains | 50 |
API
Verwalten Sie, wie die API innerhalb Ihrer Discourse-Instanz funktioniert:
| Site-Einstellung | Typ | Beschreibung | Standardwert |
|---|---|---|---|
| api_key_last_used_epoch | Integer | Verfolgt die zuletzt verwendete Epoch-Zeit für API-Schlüssel. Nicht direkt zugänglich oder bearbeitbar. | # Der Wert wird in einer Migration hinzugefügt |
| revoke_api_keys_maxlife_days | Integer | Anzahl der Tage, bevor ein API-Schlüssel automatisch widerrufen wird; auf 0 setzen, um dies niemals zu tun. | 0 |
Dashboard
Passen Sie an, welche Berichte im Admin-Dashboard angezeigt werden und wie heiße Themen definiert sind:
| Site-Einstellung | Typ | Beschreibung | Standardwert |
|---|---|---|---|
| verbose_user_stat_count_logging | Boolean | Aktiviert eine ausführliche Protokollierung für Aktualisierungen der Benutzerstatistik-Zählung. | FALSE |
| hot_topics_gravity | Float | Steuert die Gravitationseinstellung, die bei der Berechnung heißer Themen verwendet wird. | 1.2 |
| hot_topics_recent_days | Integer | Definiert die Anzahl der letzten Tage, die bei der Berechnung der Punktzahlen für heiße Themen berücksichtigt werden. | 7 |