これは利用可能なすべての「非表示サイト設定」を説明するための#リファレンスガイドです。
必要なユーザーレベル:管理者
Discourse の非表示サイト設定は、標準的な管理インターフェースからは利用できない高度な構成オプションです。これにより、Discourse インスタンスの機能をさらに柔軟にカスタマイズできます。
非表示サイト設定の変更に関する追加情報については、非表示サイト設定の有効化 をご覧ください。
以下は、Discourse で利用可能なすべての非表示サイト設定のリファレンス表です。
基本
Discourse インスタンスの基本的な側面を調整するための設定:
| サイト設定 | タイプ | 説明 | デフォルト値 |
|---|---|---|---|
| max_category_nesting | integer | 許可されるカテゴリのネストレベルの最大数を設定します。 | 2 |
| enable_mobile_theme | boolean | モバイル専用のテーマを有効にします。すべてのデバイスでレスポンシブスタイルシートを使用する場合は無効にしてください。 | TRUE |
| enable_upload_debug_mode | boolean | アップロードの詳細ログを有効にします。アップロードの問題のデバッグに役立ちます。 | FALSE |
| default_theme_id | integer | 新規ユーザーと匿名ユーザーに使用されるデフォルトのテーマ ID。 | -1 |
| enable_badge_sql | boolean | 管理インターフェース内で直接 SQL を使用してバッジクエリを定義することを許可します。 | FALSE |
| vapid_public_key_bytes | string | Web プッシュ通知の送信に必要な VAPID 認証で使用される公開鍵を保存します。 | “” |
| vapid_public_key | string | Web プッシュ通知の VAPID 認証で使用される公開鍵。 | “” |
| vapid_private_key | string | Web プッシュ通知の VAPID 認証で使用される秘密鍵。 | “” |
| vapid_base_url | string | Web プッシュ通知でサーバー ID を主張するために VAPID で設定されるベース URL。 | “” |
| enable_passkeys | boolean | パスワードなしで安全なユーザー認証を行う WebAuthn ベースのパスキーの使用を有効にします。 | TRUE |
| verbose_upload_logging | boolean | アップロードプロセスの詳細なログを有効にします。ファイルアップロードの問題の特定と診断に役立ちます。 | FALSE |
| verbose_auth_token_logging | boolean | 認証トークンプロセスの詳細なログを有効にします。 | FALSE |
| max_suspicious_distance_km | integer | ログインが疑わしいと見なされる、連続する IP アドレス間の最大距離(キロメートル)を定義します。 | 100 |
| discourse_connect_csrf_protection | boolean | DiscourseConnect 認証に対する CSRF 保護を有効にします。 | TRUE |
| invites_per_page | integer | 招待ページに表示される招待数。 | 40 |
| max_notifications_per_user | integer | 古い通知が自動的に削除される前に、ユーザーが保持できる通知の最大数。 | 10000 |
| max_bookmarks_per_user | integer | ユーザーが作成できるブックマークの最大数。 | 2000 |
投稿
Discourse インスタンス内の投稿機能をカスタマイズします:
| サイト設定 | タイプ | 説明 | デフォルト値 |
|---|---|---|---|
| show_copy_button_on_codeblocks | boolean | コードブロックにクリップボードへのコピーボタンを追加します。 | TRUE |
| disable_watched_word_checking_in_user_fields | boolean | ユーザーフィールドにおける監視ワードチェックを無効にします。 | FALSE |
| max_draft_length | integer | 下書きで許可される最大長を設定します。 | 150000 |
| max_drafts_per_user | integer | ユーザーが保持できる下書きの最大数。 | 10000 |
| group_pm_user_limit | integer | グループ PM に含めることができるユーザーの最大数 | 1000 |
メール
Discourse プラットフォームから送受信されるメールを管理します:
| サイト設定 | タイプ | 説明 | デフォルト値 |
|---|---|---|---|
| bounce_score_erode_on_send | float | メールが送信されるたびにバウンススコアを減少させ、バウンスからの回復を迅速に行えるようにします。 | 0.1 |
| email_custom_template | string | メール用のカスタム HTML テンプレート。デフォルトを上書きする必要がある場合に使用されます。 | “” (空) |
| email_custom_css | string | メールのスタイル設定用のカスタム CSS。デフォルトを上書きする必要がある場合に使用されます。 | “” (空) |
| email_custom_css_compiled | string | メール用のカスタム CSS のコンパイル済みバージョン。 | “” (空) |
| enable_secondary_emails | boolean | ユーザーがプロフィールに追加メールアドレスを追加することを許可します。 | TRUE |
| max_participant_names | integer | グループメッセージのメール通知に表示される参加者名の最大数。 | 10 |
ファイル
ファイルとアップロードの管理方法を定義します:
| サイト設定 | タイプ | 説明 | デフォルト値 |
|---|---|---|---|
| max_export_file_size_kb | integer | エクスポートファイルの最大サイズ(キロバイト)を指定します。 | 50000 |
| export_authorized_extensions | string | エクスポートで許可されるファイル拡張子を指定します。 | “zip” |
| secure_uploads_pm_only | boolean | true の場合、安全なアップロードはプライベートメッセージでのみ有効になります。 | FALSE |
| enable_s3_transfer_acceleration | boolean | true の場合、Amazon S3 Transfer Acceleration を有効にします。 | FALSE |
| s3_http_continue_timeout | integer | リクエストペイロードを送信する前に S3 から 100 Continue 応答を待つ時間(秒)。 | 1 |
| s3_install_cors_rule | boolean | true の場合、S3 に任意のドメインからのリクエストを許可する CORS ルールをインストールします。 | TRUE |
| s3_presigned_get_url_expires_after_seconds | integer | S3 オブジェクトの署名付き URL が有効期限を迎えるまでの時間(秒)。 | 300 |
| decompressed_theme_max_file_size_mb | integer | テーマファイルを解凍後の最大ファイルサイズ(メガバイト)。 | 1000 |
| decompressed_backup_max_file_size_mb | integer | バックアップファイルを解凍後の最大ファイルサイズ(メガバイト)。 | 100000 |
| composer_media_optimization_image_resize_pre_multiply | boolean | キャンバス操作でアルファを事前乗算して画像処理を最適化し、画像リサイズ品質を向上させます。 | FALSE |
| composer_media_optimization_image_encode_quality | integer | 画像最適化のための再エンコードプロセスで使用される JPG エンコード品質。 | 0 |
| composer_media_optimization_image_resize_linear_rgb | boolean | リサイズ時に線形 RGB を使用して、リサイズされた画像の品質を向上させます。 | FALSE |
| composer_ios_media_optimisation_image_enabled | boolean | iOS デバイスでのパフォーマンス向上のために、特定の画像最適化戦略を有効にします。 | TRUE |
| video_thumbnails_enabled | boolean | フォーラムにアップロードされた動画ファイルのサムネイル生成を有効にします。 | TRUE |
セキュリティ
フォーラムのニーズに合わせてセキュリティ機能を調整します:
| サイト設定 | タイプ | 説明 | デフォルト値 |
|---|---|---|---|
| allow_indexing_non_canonical_urls | boolean | 正規化されていない URL のインデックス作成を許可します。 | TRUE |
| non_crawler_user_agents | list | クローラーではないと見なされるユーザーエージェントのリスト。 | "trident |
| crawler_user_agents | list | クローラーと見なされるユーザーエージェントのリスト。 | "rss |
| browser_update_user_agents | list | 更新メッセージを表示する古いブラウザのユーザーエージェント。 | "MSIE 6 |
| crawler_check_bypass_agents | string | クローラーチェックをバイパスできるユーザーエージェント。 | “cubot” |
| keep_old_ip_address_count | integer | 各ユーザーのために保持する古い IP アドレスの数。 | 0 |
| content_security_policy_collect_reports | boolean | CSP 違反レポートの収集を有効にします。 | FALSE |
| allow_embedding_site_in_an_iframe | boolean | 他のサイト内の iframe にサイトを埋め込むことを許可します。 | FALSE |
| send_old_credential_reminder_days | integer | 古い資格情報に関するリマインダーを送信する日数。0 に設定するとリマインダーは無効になります。 | 0 |
| disable_onebox_media_download_controls | boolean | Onebox 内のオーディオ/ビデオ埋め込みでのメディアダウンロードコントロールを無効にします。 | FALSE |
| cross_origin_opener_policy_header | string | Cross-Origin-Opener-Policy ヘッダーを設定します。利用可能な選択肢:unsafe-none、same-origin、same-origin-allow-popups。 | “same-origin-allow-popups” |
Onebox
Onebox の処理方法を制御します:
| サイト設定 | タイプ | 説明 | デフォルト値 |
|---|---|---|---|
| force_get_hosts | list | HEAD リクエストの問題により GET リクエストが強制されるドメイン | us.battle.net news.yahoo.com *.medium.com |
| onebox_user_agent | string | Onebox システムが HTTP リクエストを行う際に使用するユーザーエージェント文字列を定義します。設定が空の場合、Onebox.options.user_agent で定義されたデフォルトのユーザーエージェントにフォールバックします。 |
“” |
| inline_onebox_user_agent | string | 指定されている場合、インライン Onebox 応答の取得に使用されるカスタムユーザーエージェント。 | “” |
レート制限
レート制限を通じてリソースとセキュリティを管理します:
| サイト設定 | タイプ | 説明 | デフォルト値 |
|---|---|---|---|
| rate_limit_search_anon_global_per_minute | integer | 匿名検索リクエストのグローバルレート制限(1 分あたり) | 150 |
| rate_limit_search_anon_user_per_minute | integer | 匿名検索リクエストのユーザーごとのレート制限(1 分あたり) | 15 |
| rate_limit_search_anon_global_per_second | integer | 匿名検索リクエストのグローバルレート制限(1 秒あたり) | 8 |
| rate_limit_search_anon_user_per_second | integer | 匿名検索リクエストのユーザーごとのレート制限(1 秒あたり) | 2 |
| rate_limit_search_user | integer | ログインユーザーによる検索リクエストのユーザーごとのレート制限(1 分あたり) | 30 |
| max_allowed_secondary_emails | integer | ユーザーが保持できる追加メールアドレスの最大数 | 10 |
| max_batch_presign_multipart_per_minute | integer | ユーザーが 1 分以内に開始できるバッチ署名付きマルチパート操作の最大数 | 20 |
| max_presigned_put_per_minute | integer | ユーザーが 1 分以内に開始できる署名付き PUT 操作の最大数 | 10 |
| max_create_multipart_per_minute | integer | ユーザーが 1 分以内に開始できるマルチパート作成の最大数 | 10 |
| max_complete_multipart_per_minute | integer | ユーザーが 1 分以内に開始できるマルチパート完了の最大数 | 10 |
| max_uploads_per_minute | integer | ユーザーが 1 分以内に開始できるアップロード操作の最大数 | 10 |
開発者
開発環境を調整します:
| サイト設定 | タイプ | 説明 | デフォルト値 |
|---|---|---|---|
| force_hostname | string | サイトに対して特定のホスト名を強制します。 | “” |
| port | integer | サーバーがリッスンするポート番号を設定します。 | “” |
| enable_chunked_encoding | boolean | サーバーによるチャンクエンコーディング応答を有効にします。応答をバッファリングするプロキシの処理に役立つ可能性があります。 | TRUE |
| long_polling_base_url | string | ロングポーリングに使用するベース URL。CDN トラフィックと直接サイトのインタラクションを分離するのに役立ちます。 | “/” |
| background_polling_interval | integer | クライアントによるバックグラウンドポーリングの頻度(ミリ秒)。 | 60000 |
| polling_interval | integer | ログインクライアントによるアクティブなポーリングの頻度(ミリ秒)。 | 3000 |
| anon_polling_interval | integer | 匿名クライアントによるサーバーポーリングの頻度(ミリ秒)。 | 25000 |
| rebake_old_posts_count | integer | バックグラウンドで実行される自動タスクによって再焼成される投稿数。 | 80 |
| migrate_to_new_scheme | boolean | 古いアップロードを新しいストレージスキームにマイグレーションするかどうかを切り替えます。主に更新時に使用されます。 | FALSE |
| max_new_topics | integer | スパムやシステム過負荷を防ぐために、ユーザーが作成できる新規トピックの最大数。 | 500 |
| wizard_enabled | boolean | インストール後に表示されるセットアップウィザードを有効または無効にします。 | TRUE |
| bypass_wizard_check | boolean | セットアップウィザードの完了チェックをバイパスすることを許可します。開発者や自動化されたセットアップに役立ちます。 | FALSE |
| logging_provider | enum | アプリケーションのログ記録フレームワークを決定します。「default」またはサポートされている代替フレームワークを指定できます。 | “default” |
| bootstrap_error_pages | boolean | ブートストラップされたスタイル付きエラーページを有効または無効にします。エラーページでのスタイルの一貫性を維持するのに役立ちます。 | FALSE |
| include_associated_account_ids | boolean | 特定の出力に関連するアカウントの ID を含めます。より連携されたアカウントデータの処理に役立ちます。 | FALSE |
| max_sidebar_section_links | integer | サイドバーセクションあたりのリンクの最大数。UI のごたごたとパフォーマンスを制御します。 | 50 |
| instrument_gc_stat_per_request | boolean | 各 HTTP リクエストごとにガベージコレクションの統計を収集してログに記録するかどうか。パフォーマンスチューニングに役立ちます。 | FALSE |
| warn_critical_js_deprecations | boolean | 管理者向けに重要な JavaScript の非推奨に関する警告を有効にします。アップグレードや修正の準備に役立ちます。 | TRUE |
| warn_critical_js_deprecations_message | string | 重要な JS 非推奨警告に追加されるカスタムメッセージ。通知をより情報豊かにします。 | “” |
埋め込み
コンテンツの埋め込みを許可または制限します:
| サイト設定 | タイプ | 説明 | デフォルト値 |
|---|---|---|---|
| embed_by_username | string | 埋め込まれたコンテンツに使用するユーザー名。 | “” |
| embed_post_limit | integer | 外部ソースから埋め込むことができる投稿の最大数。 | 100 |
| embed_topic_limit_per_page | integer | 埋め込まれたトピックのページあたりに表示されるトピックの最大数。 | 200 |
| embed_title_scrubber | string | 埋め込まれたコンテンツのタイトルをクリーンアップまたは修正するために使用される正規表現。 | “” |
| blocked_embed_selectors | string | 埋め込まれたコンテンツから除外する要素を指定する CSS セレクター。 | “” |
| allowed_embed_classnames | string | 埋め込まれたコンテンツで許可されるクラス名。コンテンツスタイルのフィルタリングに役立ちます。 | “emoji” |
バックアップ
バックアップ設定をカスタマイズします:
| サイト設定 | タイプ | 説明 | デフォルト値 |
|---|---|---|---|
| include_s3_uploads_in_backups | boolean | S3 に保存されたアップロードをサイトバックアップに含めるかどうかを決定します。 | FALSE |
検索
Discourse サイト内の検索機能を最適化します:
| サイト設定 | タイプ | 説明 | デフォルト値 |
|---|---|---|---|
| prioritize_exact_search_title_match | boolean | タイトルで検索語と完全に一致する検索結果に優先順位を付けます。 | TRUE |
| max_duplicate_search_index_terms | integer | 検索用にインデックスされる重複用語の最大数を設定します。 | 6 |
| use_pg_headlines_for_excerpt | boolean | 検索抜粋の生成に Postgres の見出しサポートを有効にします。 | FALSE |
| search_max_indexed_word_length | integer | 検索用にインデックスされる単語の最大長。 | 100 |
| search_ranking_normalization | string | 検索結果の関連性を向上させるために検索ランキングの正規化を制御します。 | “0” |
| search_ranking_weights | string | 検索ランキング計算で使用される重み付け因子を設定します。 | “” |
| search_recent_regular_posts_offset_post_id | integer | 検索結果で最近の投稿を取得するための投稿 ID オフセット。 | 0 |
| search_enable_recent_regular_posts_offset_size | integer | 検索で考慮する最近の通常の投稿の数を決定します。 | 200000 |
| category_search_priority_low_weight | float | 検索結果でカテゴリに優先順位を付けるための低い重み付けを設定します。 | 0.8 |
| category_search_priority_high_weight | float | 検索結果でカテゴリに優先順位を付けるための高い重み付けを設定します。 | 1.2 |
| search_page_size | integer | 検索クエリあたりの結果数。 | 50 |
カテゴリ未分類
他のカテゴリに分類されない各種設定:
| サイト設定 | タイプ | 説明 | デフォルト値 |
|---|---|---|---|
| has_login_hint | boolean | ログインヒントを表示するかどうかを決定します | FALSE |
| min_new_topics_time | integer | 新規トピック間の最小時間 | 0 |
| general_category_id | integer | 一般カテゴリの ID | -1 |
| meta_category_id | integer | メタカテゴリの ID | -1 |
| staff_category_id | integer | スタッフカテゴリの ID | -1 |
| uncategorized_category_id | integer | カテゴリ未分類のカテゴリの ID | -1 |
| backup_drafts_to_pm_length | integer | バックアップが必要になる前の PM 内の下書きの長さ | 0 |
| view_user_route | string | デフォルトのユーザープロフィールページセクション | “summary” |
| tos_topic_id | integer | 利用規約トピックの ID | -1 |
| guidelines_topic_id | integer | ガイドライントピックの ID | -1 |
| privacy_topic_id | integer | プライバシーポリシートピックの ID | -1 |
| welcome_topic_id | integer | ウェルカムトピックの ID | -1 |
| admin_quick_start_topic_id | integer | 管理者クイックスタートガイドトピックの ID | -1 |
| ios_app_id | string | iOS アプリの App Store ID | “1173672076” |
| android_app_id | string | Android アプリの Play Store ID | “com.discourse” |
| pwa_display_browser_regex | string | PWA 表示が「ブラウザ」に設定されているかを判断する正規表現 | “a^” |
| always_include_topic_excerpts | boolean | 毎回トピックの抜粋を含めます | FALSE |
| max_bulk_invites | integer | 可能な一括招待の最大数 | 50,000 |
| skip_email_bulk_invites | boolean | 一括招待でのメール送信をスキップします | FALSE |
| max_api_invites | integer | API リクエストあたりの招待の最大数 | 200 |
| overridden_robots_txt | string | robots.txt のカスタムルール | “” |
| show_category_definitions_in_topic_lists | boolean | トピックリストにカテゴリ定義投稿を表示します | FALSE |
| max_automatic_membership_email_domains | integer | 可能な自動メンバーシップドメインの最大数 | 50 |
API
Discourse インスタンス内の API の動作を管理します:
| サイト設定 | タイプ | 説明 | デフォルト値 |
|---|---|---|---|
| api_key_last_used_epoch | integer | API キーの最終使用エポック時刻を追跡します。直接アクセスまたは編集はできません。 | # 値はマイグレーションで追加されます |
| revoke_api_keys_maxlife_days | integer | API キーが自動的に失効するまでの日数。0 に設定すると失効しません。 | 0 |
ダッシュボード
管理者ダッシュボードに表示されるレポートと、ホットトピックの定義方法を調整します:
| サイト設定 | タイプ | 説明 | デフォルト値 |
|---|---|---|---|
| verbose_user_stat_count_logging | boolean | ユーザー統計カウント更新の詳細なログを有効にします。 | FALSE |
| hot_topics_gravity | float | ホットトピックの計算に使用されるグラビティ設定を制御します。 | 1.2 |
| hot_topics_recent_days | integer | ホットトピックスコアの計算に考慮する最近の日数を定義します。 | 7 |