이는 사용 가능한 모든 숨겨진 사이트 설정을 설명하기 위한 #참고 가이드입니다.
필요한 사용자 권한: 관리자
Discourse의 숨겨진 사이트 설정은 표준 관리자 인터페이스에서 사용할 수 없는 고급 구성 옵션입니다. 이는 Discourse 인스턴스의 기능을 사용자 정의하는 데 추가적인 유연성을 제공합니다.
숨겨진 사이트 설정 수정에 대한 추가 정보는 다음을 참조하십시오: Enable Hidden Site Settings.
아래는 Discourse에서 사용할 수 있는 모든 숨겨진 사이트 설정의 참고 테이블입니다.
기본
Discourse 인스턴스의 기본 요소를 조정하는 데 도움이 되는 설정:
| 사이트 설정 | 유형 | 설명 | 기본값 |
|---|---|---|---|
| max_category_nesting | 정수 | 허용되는 최대 카테고리 중첩 수준을 설정합니다. | 2 |
| enable_mobile_theme | 부울 | 모바일 전용 테마를 활성화합니다. 모든 디바이스에서 반응형 스타일시트를 사용하려면 비활성화하십시오. | TRUE |
| enable_upload_debug_mode | 부울 | 업로드 문제를 디버깅하는 데 유용한 상세한 업로드 로깅을 활성화합니다. | FALSE |
| default_theme_id | 정수 | 새 사용자 및 익명 사용자에게 사용되는 기본 테마 ID입니다. | -1 |
| enable_badge_sql | 부울 | 관리자 인터페이스 내에서 SQL을 사용하여 배지 쿼리를 직접 정의할 수 있도록 허용합니다. | FALSE |
| vapid_public_key_bytes | 문자열 | 웹 푸시 알림 전송에 필요한 VAPID 인증에 사용되는 공개 키를 저장합니다. | “” |
| vapid_public_key | 문자열 | 웹 푸시 알림을 위한 VAPID 인증에 사용되는 공개 키입니다. | “” |
| vapid_private_key | 문자열 | 웹 푸시 알림을 위한 VAPID 인증에 사용되는 비밀 키입니다. | “” |
| vapid_base_url | 문자열 | 웹 푸시 알림에서 서버 신원을 주장하기 위해 VAPID에 구성된 기본 URL입니다. | “” |
| enable_passkeys | 부울 | 비밀번호 없이 WebAuthn 기반 패스키를 사용하여 안전한 사용자 인증을 활성화합니다. | TRUE |
| verbose_upload_logging | 부울 | 파일 업로드 문제의 식별 및 진단에 도움이 되는 업로드 프로세스 활동에 대한 상세한 로그를 활성화합니다. | FALSE |
| verbose_auth_token_logging | 부울 | 인증 토큰 프로세스에 대한 상세한 로깅을 활성화합니다. | FALSE |
| max_suspicious_distance_km | 정수 | 로그인이 의심스러운 것으로 간주되기 위한 연속된 IP 주소 간의 최대 거리(킬로미터)를 정의합니다. | 100 |
| discourse_connect_csrf_protection | 부울 | DiscourseConnect 인증에 대한 CSRF 보호를 활성화합니다. | TRUE |
| invites_per_page | 정수 | 초대 페이지에서 페이지당 표시되는 초대 수입니다. | 40 |
| max_notifications_per_user | 정수 | 오래된 알림이 자동으로 삭제되기 전에 사용자가 가질 수 있는 최대 알림 수입니다. | 10000 |
| max_bookmarks_per_user | 정수 | 사용자가 생성할 수 있는 최대 북마크 수입니다. | 2000 |
게시
Discourse 인스턴스 내에서 게시 기능이 작동하는 방식을 사용자 정의합니다:
| 사이트 설정 | 유형 | 설명 | 기본값 |
|---|---|---|---|
| show_copy_button_on_codeblocks | 부울 | 코드 블록에 버튼 추가하여 블록 내용을 사용자의 클립보드에 복사합니다 | TRUE |
| disable_watched_word_checking_in_user_fields | 부울 | 사용자 필드에서 감시 단어 검사를 비활성화합니다 | FALSE |
| max_draft_length | 정수 | 초안에 허용되는 최대 길이를 설정합니다 | 150000 |
| max_drafts_per_user | 정수 | 사용자가 가질 수 있는 최대 초안 수입니다 | 10000 |
| group_pm_user_limit | 정수 | 그룹 PM에 포함될 수 있는 최대 사용자 수입니다 | 1000 |
이메일
Discourse 플랫폼에서 이메일이 전송되고 수신되는 방식을 관리합니다:
| 사이트 설정 | 유형 | 설명 | 기본값 |
|---|---|---|---|
| bounce_score_erode_on_send | 실수 | 이메일이 전송될 때마다 바운스 점수를 감소시켜 바운스에서 더 빠른 회복을 허용합니다. | 0.1 |
| email_custom_template | 문자열 | 이메일용 사용자 정의 HTML 템플릿입니다. 기본값을 오버라이드해야 하는 경우 사용됩니다. | “” (비어 있음) |
| email_custom_css | 문자열 | 이메일 스타일링을 위한 사용자 정의 CSS입니다. 기본값을 오버라이드해야 하는 경우 사용됩니다. | “” (비어 있음) |
| email_custom_css_compiled | 문자열 | 이메일용 사용자 정의 CSS의 컴파일된 버전입니다. | “” (비어 있음) |
| enable_secondary_emails | 부울 | 사용자가 프로필에 보조 이메일 주소를 추가할 수 있도록 허용합니다. | TRUE |
| max_participant_names | 정수 | 그룹 메시지의 이메일 알림에 표시되는 참가자 이름의 최대 수입니다. | 10 |
파일
파일 및 업로드가 관리되는 방식을 정의합니다:
| 사이트 설정 | 유형 | 설명 | 기본값 |
|---|---|---|---|
| max_export_file_size_kb | 정수 | 킬로바이트 단위로 내보내기 파일의 최대 크기를 지정합니다. | 50000 |
| export_authorized_extensions | 문자열 | 내보내기에 허용되는 파일 확장자를 지정합니다. | “zip” |
| secure_uploads_pm_only | 부울 | 참인 경우, 보안 업로드는 개인 메시지만에 활성화됩니다. | FALSE |
| enable_s3_transfer_acceleration | 부울 | 참인 경우, Amazon S3 전송 가속을 활성화합니다. | FALSE |
| s3_http_continue_timeout | 정수 | S3에서 요청 페이로드를 보내기 전에 100 Continue 응답을 기다릴 시간(초)입니다. | 1 |
| s3_install_cors_rule | 부울 | 참인 경우, S3에 CORS 규칙을 설치하여 모든 도메인에서 요청을 허용합니다. | TRUE |
| s3_presigned_get_url_expires_after_seconds | 정수 | S3 객체의 사전 서명 URL이 만료되는 시간(초)입니다. | 300 |
| decompressed_theme_max_file_size_mb | 정수 | 압축 해제 후 테마 파일의 최대 파일 크기(메가바이트)입니다. | 1000 |
| decompressed_backup_max_file_size_mb | 정수 | 압축 해제 후 백업 파일의 최대 파일 크기(메가바이트)입니다. | 100000 |
| composer_media_optimization_image_resize_pre_multiply | 부울 | 캔버스 조작에서 알파를 사전 곱셈하여 이미지 리사이즈 품질을 향상시킴으로써 이미지 처리를 최적화합니다. | FALSE |
| composer_media_optimization_image_encode_quality | 정수 | 이미지 최적화를 위한 재인코딩 과정에서 사용되는 JPG 인코딩 품질입니다. | 0 |
| composer_media_optimization_image_resize_linear_rgb | 부울 | 리사이즈 시 리사이즈된 이미지의 품질을 향상시키기 위해 선형 RGB를 사용합니다. | FALSE |
| composer_ios_media_optimisation_image_enabled | 부울 | 성능 향상을 위해 iOS 디바이스에서 특정 이미지 최적화 전략을 활성화합니다. | TRUE |
| video_thumbnails_enabled | 부울 | 포럼에 업로드된 비디오 파일의 썸네일 생성을 활성화합니다. | TRUE |
보안
포럼의 필요에 맞게 보안 기능을 조정합니다:
| 사이트 설정 | 유형 | 설명 | 기본값 |
|---|---|---|---|
| allow_indexing_non_canonical_urls | 부울 | 비정규 URL의 색인화를 허용합니다. | TRUE |
| non_crawler_user_agents | 목록 | 크롤러로 간주되지 않는 사용자 에이전트 목록입니다. | "trident |
| crawler_user_agents | 목록 | 크롤러로 간주되는 사용자 에이전트 목록입니다. | "rss |
| browser_update_user_agents | 목록 | 업데이트 메시지를 표시하기 위한 구형 브라우저의 사용자 에이전트입니다. | "MSIE 6 |
| crawler_check_bypass_agents | 문자열 | 크롤러 검사를 우회할 수 있는 사용자 에이전트입니다. | “cubot” |
| keep_old_ip_address_count | 정수 | 각 사용자를 위해 유지할 구형 IP 주소의 수입니다. | 0 |
| content_security_policy_collect_reports | 부울 | CSP 위반 보고서 수집을 활성화합니다. | FALSE |
| allow_embedding_site_in_an_iframe | 부울 | 사이트가 다른 사이트의 iframe 내에서 임베드될 수 있도록 허용합니다. | FALSE |
| send_old_credential_reminder_days | 정수 | 구형 자격 증명을 상기시키는 일 수입니다. 0으로 설정하면 상기 알림이 비활성화됩니다. | 0 |
| disable_onebox_media_download_controls | 부울 | 원박스 오디오/비디오 임베드에서 미디어 다운로드 컨트롤을 비활성화합니다. | FALSE |
| cross_origin_opener_policy_header | 문자열 | Cross-Origin-Opener-Policy 헤더를 설정합니다. 선택 가능한 항목: unsafe-none, same-origin, same-origin-allow-popups. | “same-origin-allow-popups” |
원박스
원박스가 처리되는 방식을 제어합니다:
| 사이트 설정 | 유형 | 설명 | 기본값 |
|---|---|---|---|
| force_get_hosts | 목록 | HEAD 요청 문제로 인해 GET 요청이 강제되는 도메인 | us.battle.net news.yahoo.com *.medium.com |
| onebox_user_agent | 문자열 | Onebox 시스템이 HTTP 요청을 수행할 때 사용되는 사용자 에이전트 문자열을 정의합니다. 설정이 비어 있으면 Onebox.options.user_agent에 정의된 기본 사용자 에이전트로 되돌아갑니다. |
“” |
| inline_onebox_user_agent | 문자열 | 지정된 경우 인라인 원박스 응답을 가져올 때 사용되는 사용자 정의 사용자 에이전트입니다 | “” |
속도 제한
속도 제한을 통해 리소스와 보안을 관리합니다:
| 사이트 설정 | 유형 | 설명 | 기본값 |
|---|---|---|---|
| rate_limit_search_anon_global_per_minute | 정수 | 분당 익명 검색 요청의 전역 속도 제한 | 150 |
| rate_limit_search_anon_user_per_minute | 정수 | 분당 익명 검색 요청의 사용자별 속도 제한 | 15 |
| rate_limit_search_anon_global_per_second | 정수 | 초당 익명 검색 요청의 전역 속도 제한 | 8 |
| rate_limit_search_anon_user_per_second | 정수 | 초당 익명 검색 요청의 사용자별 속도 제한 | 2 |
| rate_limit_search_user | 정수 | 로그인된 사용자의 분당 검색 요청 사용자별 속도 제한 | 30 |
| max_allowed_secondary_emails | 정수 | 사용자가 가질 수 있는 최대 보조 이메일 수 | 10 |
| max_batch_presign_multipart_per_minute | 정수 | 사용자가 분당 시작할 수 있는 최대 배치 사전 서명 멀티파트 작업 수 | 20 |
| max_presigned_put_per_minute | 정수 | 사용자가 분당 시작할 수 있는 최대 사전 서명 PUT 작업 수 | 10 |
| max_create_multipart_per_minute | 정수 | 사용자가 분당 시작할 수 있는 최대 멀티파트 생성 수 | 10 |
| max_complete_multipart_per_minute | 정수 | 사용자가 분당 시작할 수 있는 최대 멀티파트 완료 수 | 10 |
| max_uploads_per_minute | 정수 | 사용자가 분당 시작할 수 있는 최대 업로드 작업 수 | 10 |
개발자
개발 환경을 맞춤 설정합니다:
| 사이트 설정 | 유형 | 설명 | 기본값 |
|---|---|---|---|
| force_hostname | 문자열 | 사이트에 특정 호스트 이름을 강제합니다. | “” |
| port | 정수 | 서버가 경청할 포트 번호를 구성합니다. | “” |
| enable_chunked_encoding | 부울 | 서버의 청크 인코딩 응답을 활성화하여 응답을 버퍼링하는 프록시에 도움이 될 수 있습니다. | TRUE |
| long_polling_base_url | 문자열 | 장시간 폴링에 사용할 기본 URL입니다. CDN 트래픽과 직접적인 사이트 상호 작용을 분리하는 데 유용합니다. | “/” |
| background_polling_interval | 정수 | 클라이언트가 백그라운드에서 폴링하는 빈도(밀리초). | 60000 |
| polling_interval | 정수 | 로그인된 클라이언트가 능동적으로 폴링하는 빈도(밀리초). | 3000 |
| anon_polling_interval | 정수 | 익명 클라이언트가 서버를 폴링하는 빈도(밀리초). | 25000 |
| rebake_old_posts_count | 정수 | 백그라운드에서 실행되는 자동화 작업을 통해 다시 베이킹되는 게시물의 수. | 80 |
| migrate_to_new_scheme | 부울 | 주로 업데이트 중에 사용되는 구형 업로드를 새 저장소 스키마로 마이그레이션할지 여부를 전환합니다. | FALSE |
| max_new_topics | 정수 | 스팸이나 시스템 과부하를 방지하기 위해 사용자가 생성할 수 있는 최대 새 주제 수. | 500 |
| wizard_enabled | 부울 | 설치 후 표시되는 설정 마법사를 활성화하거나 비활성화합니다. | TRUE |
| bypass_wizard_check | 부울 | 개발자나 자동화된 설정에 유용한 설정 마법사 완료 검사를 우회할 수 있도록 허용합니다. | FALSE |
| logging_provider | 열거형 | 애플리케이션의 로깅 프레임워크를 결정합니다. ‘default’ 또는 지원되는 대체 프레임워크일 수 있습니다. | “default” |
| bootstrap_error_pages | 부울 | 부트스트랩된 스타일링된 오류 페이지를 활성화하거나 비활성화합니다. 오류 페이지에서 스타일 일관성을 유지하는 데 유용합니다. | FALSE |
| include_associated_account_ids | 부울 | 특정 출력에 연결된 계정의 ID를 포함합니다—더 연결된 계정 데이터 처리에 유용합니다. | FALSE |
| max_sidebar_section_links | 정수 | 사이드바 섹션별 최대 링크 수로, UI 혼란과 성능을 제어합니다. | 50 |
| instrument_gc_stat_per_request | 부울 | 각 HTTP 요청마다 가비지 컬렉션 통계를 수집하고 로그에 기록할지 여부—성능 튜닝에 유용합니다. | FALSE |
| warn_critical_js_deprecations | 부울 | 관리자에게 중요한 JavaScript 비권장 사용 경고 활성화—업그레이드나 수정 준비에 도움이 됩니다. | TRUE |
| warn_critical_js_deprecations_message | 문자열 | 중요한 JS 비권장 사용 경고에 추가되는 사용자 정의 메시지로, 알림을 더 정보적으로 만듭니다. | “” |
임베딩
콘텐츠 임베딩을 허용하거나 제한합니다:
| 사이트 설정 | 유형 | 설명 | 기본값 |
|---|---|---|---|
| embed_by_username | 문자열 | 임베드된 콘텐츠에 사용할 사용자 이름입니다. | “” |
| embed_post_limit | 정수 | 외부 소스에서 임베드할 최대 게시물 수입니다. | 100 |
| embed_topic_limit_per_page | 정수 | 임베드된 주제에서 페이지당 표시되는 최대 주제 수입니다. | 200 |
| embed_title_scrubber | 문자열 | 임베드된 콘텐츠의 제목을 정리하거나 수정하는 데 사용되는 정규식입니다. | “” |
| blocked_embed_selectors | 문자열 | 임베드된 콘텐츠에서 제외할 요소를 지정하는 CSS 셀렉터입니다. | “” |
| allowed_embed_classnames | 문자열 | 임베드된 콘텐츠에서 허용되는 클래스 이름으로, 콘텐츠 스타일 필터링에 도움이 됩니다. | “emoji” |
백업
백업 구성을 사용자 정의합니다:
| 사이트 설정 | 유형 | 설명 | 기본값 |
|---|---|---|---|
| include_s3_uploads_in_backups | 부울 | S3에 저장된 업로드를 사이트 백업에 포함할지 여부를 결정합니다. | FALSE |
검색
Discourse 사이트 내에서 검색 기능을 최적화합니다:
| 사이트 설정 | 유형 | 설명 | 기본값 |
|---|---|---|---|
| prioritize_exact_search_title_match | 부울 | 제목에서 검색어와 정확히 일치하는 검색 결과에 우선순위를 부여합니다. | TRUE |
| max_duplicate_search_index_terms | 정수 | 검색을 위해 색인화된 중복 용어의 최대 수를 설정합니다. | 6 |
| use_pg_headlines_for_excerpt | 부울 | 검색 발췌 생성을 위해 Postgres 헤드라인 지원을 활성화합니다. | FALSE |
| search_max_indexed_word_length | 정수 | 검색을 위해 색인화된 단어의 최대 길이입니다. | 100 |
| search_ranking_normalization | 문자열 | 결과 관련성을 향상시키기 위해 검색 랭킹 정규화를 제어합니다. | “0” |
| search_ranking_weights | 문자열 | 검색 랭킹 계산에 사용되는 가중 인자를 설정합니다. | “” |
| search_recent_regular_posts_offset_post_id | 정수 | 검색 결과에서 최근 게시물을 검색하기 위한 게시물 ID 오프셋입니다. | 0 |
| search_enable_recent_regular_posts_offset_size | 정수 | 검색에서 고려할 최근 일반 게시물의 수를 결정합니다. | 200000 |
| category_search_priority_low_weight | 실수 | 검색 결과에서 카테고리 우선순위를 위한 하위 가중치를 설정합니다. | 0.8 |
| category_search_priority_high_weight | 실수 | 검색 결과에서 카테고리 우선순위를 위한 상위 가중치를 설정합니다. | 1.2 |
| search_page_size | 정수 | 검색 쿼리에서 페이지당 결과 수입니다. | 50 |
기타
다른 범주에 속하지 않는 다양한 설정:
| 사이트 설정 | 유형 | 설명 | 기본값 |
|---|---|---|---|
| has_login_hint | 부울 | 로그인 힌트가 표시되어야 하는지 결정합니다 | FALSE |
| min_new_topics_time | 정수 | 새 주제 사이의 최소 시간입니다 | 0 |
| general_category_id | 정수 | 일반 카테고리의 ID입니다 | -1 |
| meta_category_id | 정수 | 메타 카테고리의 ID입니다 | -1 |
| staff_category_id | 정수 | 스태프 카테고리의 ID입니다 | -1 |
| uncategorized_category_id | 정수 | 미분류 카테고리의 ID입니다 | -1 |
| backup_drafts_to_pm_length | 정수 | 백업이 필요한 PM 내 초안의 길이입니다 | 0 |
| view_user_route | 문자열 | 기본 사용자 프로필 페이지 섹션입니다 | “summary” |
| tos_topic_id | 정수 | 서비스 약관 주제의 ID입니다 | -1 |
| guidelines_topic_id | 정수 | 가이드라인 주제의 ID입니다 | -1 |
| privacy_topic_id | 정수 | 개인정보 처리방침 주제의 ID입니다 | -1 |
| welcome_topic_id | 정수 | 환영 주제의 ID입니다 | -1 |
| admin_quick_start_topic_id | 정수 | 관리자 빠른 시작 가이드 주제의 ID입니다 | -1 |
| ios_app_id | 문자열 | iOS 앱의 App Store ID입니다 | “1173672076” |
| android_app_id | 문자열 | Android 앱의 Play Store ID입니다 | “com.discourse” |
| pwa_display_browser_regex | 문자열 | PWA 표시가 'browser’로 설정되었는지 결정하는 정규식입니다 | “a^” |
| always_include_topic_excerpts | 부울 | 항상 주제 발췌를 포함합니다 | FALSE |
| max_bulk_invites | 정수 | 가능한 최대 일괄 초대 수입니다 | 50,000 |
| skip_email_bulk_invites | 부울 | 일괄 초대에서 이메일 전송을 건너뜁니다 | FALSE |
| max_api_invites | 정수 | API 요청당 최대 초대 수입니다 | 200 |
| overridden_robots_txt | 문자열 | robots.txt의 사용자 정의 규칙입니다 | “” |
| show_category_definitions_in_topic_lists | 부울 | 주제 목록에 카테고리 정의 게시물을 표시합니다 | FALSE |
| max_automatic_membership_email_domains | 정수 | 가능한 최대 자동 멤버십 이메일 도메인 수입니다 | 50 |
API
Discourse 인스턴스 내에서 API가 작동하는 방식을 관리합니다:
| 사이트 설정 | 유형 | 설명 | 기본값 |
|---|---|---|---|
| api_key_last_used_epoch | 정수 | API 키의 마지막 사용 에포크 시간을 추적합니다. 직접 접근하거나 편집할 수 없습니다. | # 값은 마이그레이션에서 추가됨 |
| revoke_api_keys_maxlife_days | 정수 | API 키가 자동으로 폐기되기 전의 일 수이며, 영원히 유지하려면 0으로 설정합니다. | 0 |
대시보드
관리자 대시보드에 표시되는 보고서를 조정하고 인기 있는 주제가 정의되는 방식을 설정합니다:
| 사이트 설정 | 유형 | 설명 | 기본값 |
|---|---|---|---|
| verbose_user_stat_count_logging | 부울 | 사용자 통계 카운트 업데이트에 대한 상세한 로깅을 활성화합니다. | FALSE |
| hot_topics_gravity | 실수 | 인기 주제 계산에 사용되는 중력 설정을 제어합니다. | 1.2 |
| hot_topics_recent_days | 정수 | 인기 주제 점수를 계산하기 위해 고려할 최근 일 수를 정의합니다. | 7 |