非表示サイト設定リファレンスガイド

:bookmark: これは利用可能なすべての「非表示サイト設定」を説明するための#リファレンスガイドです。

:person_raising_hand: 必要なユーザーレベル:管理者

Discourse の非表示サイト設定は、標準的な管理インターフェースからは利用できない高度な構成オプションです。これにより、Discourse インスタンスの機能をさらに柔軟にカスタマイズできます。

:information_source: 非表示サイト設定の変更に関する追加情報については、非表示サイト設定の有効化 をご覧ください。

以下は、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
「いいね!」 10