실험적 구성 설정#

plans-img 모든 플랜 에서 사용 가능

deployment-img 클라우드자체 호스팅 배포

제품 제품 메뉴 아이콘을 사용하여 채널과 협업 플레이북 간을 탐색하세요. 메뉴를 선택하고, 시스템 콘솔 을 선택한 다음 실험적 > 기능 을 선택하여 시스템 콘솔에서 다음 실험적 구성 옵션을 검토하고 관리하세요:

자체 호스팅 Mattermost 배포를 관리하는 시스템 관리자는 다음 표에 설명된 대로 config.json 파일을 편집할 수 있습니다. 아래의 각 구성 값에는 JSON 인식 도구를 사용하여 config.json 파일에서 프로그래밍 방식으로 값에 접근할 수 있는 JSON 경로가 포함되어 있습니다. 예를 들어, LoginButtonColor 값 중 하나는 LdapSettings 아래에 있습니다.

  • jq 와 같은 도구를 사용하는 경우 다음을 입력하세요: cat config/config.json | jq '.LdapSettings.LoginButtonColor'

  • config.json 파일을 수동으로 작업할 때는 LdapSettings 와 같은 객체를 찾은 다음, 해당 객체 내에서 LoginButtonColor 키를 찾으세요.


실험적 시스템 콘솔 구성 설정#

AD/LDAP 로그인 버튼 색상#

화이트 라벨링을 위해 AD/LDAP 로그인 버튼의 색상을 지정하세요. 코드 앞에 # 기호가 있는 16진수 코드를 사용하세요. 이 설정은 모바일 앱에만 적용됩니다.

이 기능의 config.json 설정은 문자열 입력이 있는 "LoginButtonColor": "" 입니다.

AD/LDAP 로그인 버튼 테두리 색상#

참고

plans-img-yellow Enterprise 및 Professional 플랜에서만 사용 가능

화이트 라벨링을 위해 AD/LDAP 로그인 버튼 테두리의 색상을 지정하세요. 코드 앞에 # 기호가 있는 16진수 코드를 사용하세요. 이 설정은 모바일 앱에만 적용됩니다.

이 기능의 config.json 설정은 문자열 입력이 있는 "LoginButtonBorderColor": "" 입니다.

AD/LDAP 로그인 버튼 텍스트 색상#

참고

plans-img-yellow Enterprise 및 Professional 플랜에서만 사용 가능

화이트 라벨링을 위해 AD/LDAP 로그인 버튼 텍스트의 색상을 지정하세요. 코드 앞에 # 기호가 있는 16진수 코드를 사용하세요. 이 설정은 모바일 앱에만 적용됩니다.

이 기능의 config.json 설정은 문자열 입력이 있는 "LoginButtonTextColor": "" 입니다.

인증 방법 변경#

참고

plans-img-yellow Enterprise 및 Professional 플랜에서만 사용 가능

True: 사용자는 프로필이나 API를 통해 서버에서 활성화된 모든 로그인 방법으로 변경할 수 있습니다.

False: 어떤 인증 옵션이 활성화되어 있든 사용자는 로그인 방법을 변경할 수 없습니다.

이 기능의 config.json 설정은 "ExperimentalEnableAuthenticationTransfer": true 이며 옵션은 truefalse 입니다.

이메일 일괄 처리 버퍼 크기#

단일 이메일에 일괄 처리되는 최대 알림 수를 지정하세요.

참고

  • Mattermost 로그에서 다음과 같은 오류가 발생하면 기본값에서 버퍼 크기를 늘리는 것을 권장합니다: Email batching job's receiving buffer was full. Please increase the EmailBatchingBufferSize. Falling back to sending immediate mail. 이 값을 늘리면 서버 성능에 영향을 주지 않고 이메일이 대기열에 추가됩니다.

  • 이메일 대기열이 구성된 email batching interval 을 초과하면 알림이 즉시 전송됩니다.

이 기능의 config.json 설정은 숫자 입력이 있는 EmailBatchingBufferSize: 256`` 입니다.

이메일 일괄 처리 간격#

일괄 처리 작업이 새 알림을 확인하는 최대 빈도(초)를 지정하세요.

참고

  • Mattermost 로그에서 다음과 같은 오류가 발생하면 기본값에서 이메일 일괄 처리 간격을 줄이는 것을 권장합니다: Email batching job's receiving buffer was full. Please increase the EmailBatchingBufferSize. Falling back to sending immediate mail..

  • 더 긴 일괄 처리 간격은 성능을 향상시킬 수 있습니다.

  • queue of emails 이 구성된 이메일 일괄 처리 간격을 초과하면 알림이 즉시 전송됩니다.

이 기능의 config.json 설정은 숫자 입력이 있는 EmailBatchingInterval": 30 입니다.

이메일 로그인 버튼 색상#

화이트 라벨링을 위해 이메일 로그인 버튼의 색상을 지정하세요. 코드 앞에 # 기호가 있는 16진수 코드를 사용하세요. 이 설정은 모바일 앱에만 적용됩니다.

이 기능의 config.json 설정은 문자열 입력이 있는 "LoginButtonColor": "" 입니다.

이메일 로그인 버튼 테두리 색상#

화이트 라벨링을 위해 이메일 로그인 버튼 테두리의 색상을 지정하세요. 코드 앞에 # 기호가 있는 16진수 코드를 사용하세요. 이 설정은 모바일 앱에만 적용됩니다.

이 기능의 config.json 설정은 문자열 입력이 있는 "LoginButtonBorderColor": "" 입니다.

이메일 로그인 버튼 텍스트 색상#

화이트 라벨링을 위해 이메일 로그인 버튼 텍스트의 색상을 지정하세요. 코드 앞에 # 기호가 있는 16진수 코드를 사용하세요. 이 설정은 모바일 앱에만 적용됩니다.

이 기능의 config.json 설정은 문자열 입력이 있는 "LoginButtonTextColor": "" 입니다.

계정 비활성화 활성화#

True: 사용자가 설정 > 고급 > 계정 비활성화 에서 자신의 계정을 비활성화할 수 있습니다. 사용자가 자신의 계정을 비활성화하면 비활성화 확인 이메일 알림을 받게 됩니다. 이메일/비밀번호 인증을 사용하도록 설정된 경우에만 사용 가능합니다. SAML 또는 AD/LDAP 인증을 사용하는 경우에는 사용할 수 없습니다.

False: 사용자가 자신의 계정을 비활성화할 수 있는 기능이 비활성화됩니다.

이 기능의 config.json 설정은 "EnableUserDeactivation": false 이며 옵션은 truefalse 입니다.

자동 응답 활성화#

True: 사용자가 설정 > 알림 에서 자동 응답을 활성화할 수 있습니다. 사용자는 다이렉트 메시지에 자동으로 전송될 사용자 정의 메시지를 설정할 수 있습니다.

False: 자동 다이렉트 메시지 응답 기능을 비활성화하고 설정 에서 숨깁니다.

이 기능의 config.json 설정은 "ExperimentalEnableAutomaticReplies": false 이며 옵션은 truefalse 입니다.

채널 조회 웹소켓 메시지 활성화#

이 설정은 클라이언트와 기기 간에 읽지 않은 알림을 동기화하는 channel_viewed WebSocket 이벤트가 전송되는지 여부를 결정합니다.

이 기능의 config.json 설정은 "EnableChannelViewedMessages": true 이며 옵션은 truefalse 입니다.

참고

대규모 배포에서 이 실험적 구성 설정을 비활성화하면 다음과 같은 영역에서 서버 성능이 향상될 수 있습니다:

  • 데이터베이스 부하 감소: channel_viewed 이벤트가 비활성화되면 서버가 더 이상 이러한 이벤트를 데이터베이스에 기록할 필요가 없습니다. 이는 쓰기 및 업데이트 작업 수를 줄여주며, 많은 사용자가 자주 채널을 전환하는 바쁜 서버에서 상당한 효과가 있을 수 있습니다.

  • 네트워크 트래픽 감소: 이러한 이벤트를 비활성화하면 서버와 클라이언트 간에 전송되는 메시지가 줄어듭니다. 이러한 네트워크 트래픽 감소는 지연 시간을 낮추고 서버의 전반적인 응답성을 향상시킬 수 있으며, 특히 연결 속도가 느린 사용자에게 도움이 됩니다.

  • 서버 CPU 사용량 감소: channel_viewed 이벤트 처리는 데이터베이스 트랜잭션과 네트워크 통신을 처리하기 위해 CPU 리소스가 필요합니다. 이러한 이벤트가 없으면 서버의 CPU를 다른 작업에 더 효율적으로 활용할 수 있어 전반적인 성능이 향상됩니다.

  • 향상된 사용자 경험: 서버 부하와 네트워크 트래픽이 감소하면 사용자는 더 빠른 로딩 시간과 애플리케이션과의 더 유동적인 상호작용을 경험할 수 있습니다.

  • 그러나 이 구성 설정을 비활성화하면 채널에서 읽은 메시지와 읽지 않은 메시지의 정확한 추적과 같은 일부 기능에 영향을 미칩니다. 성능 개선과 조직 및 사용자의 요구 사항 사이의 균형을 맞추는 것이 중요합니다.

기본 채널 퇴장/참여 시스템 메시지 활성화#

이 설정은 팀 퇴장/참여 시스템 메시지가 기본 town-square 채널에 게시되는지 여부를 결정합니다.

True: 기본 town-square 채널에서 퇴장/참여 시스템 메시지를 활성화합니다.

False: 기본 town-square 채널에서 퇴장/참여 메시지를 비활성화합니다. 이러한 시스템 메시지는 데이터베이스에도 추가되지 않습니다.

이 기능의 config.json 설정은 "ExperimentalEnableDefaultChannelLeaveJoinMessages": true 이며 옵션은 truefalse 입니다.

강화 모드 활성화#

True: 보안을 위해 사용자 경험을 조정하는 Mattermost의 강화 모드를 활성화합니다.

False: 강화 모드를 비활성화합니다.

강화 모드가 활성화되었을 때 변경되는 사항:

  • 로그인 실패 시 사용자 이름과 비밀번호에 대한 구체적인 메시지 대신 일반적인 오류 메시지를 반환합니다.

  • 다중 인증(MFA) 이 활성화된 경우, 사용자의 MFA 활성화 여부를 확인하는 경로는 항상 true를 반환합니다. 이로 인해 사용자가 MFA를 활성화하지 않은 경우에도 MFA 입력 화면이 표시됩니다. 사용자는 화면을 통과하기 위해 아무 값이나 입력할 수 있습니다. 강화 모드는 MFA가 강제 적용될 때 사용자 경험에 영향을 미치지 않습니다.

  • 비밀번호 재설정은 사용자에게 SSO 계정을 Mattermost를 통해 재설정할 수 없다는 사실을 알리지 않고, 대신 비밀번호 재설정 이메일을 보냈다고 알립니다.

  • Mattermost는 클라이언트에 반환되기 전에 모든 500 오류를 정리합니다. 제공된 request_id 를 사용하여 사용자에게 표시되는 오류를 서버 로그와 일치시킬 수 있습니다.

  • 사용자 이름과 비밀번호로 인증된 일반 사용자는 override_username 또는 override_icon_url 과 같은 통합용으로 예약된 게시물 속성을 사용할 수 없습니다.

이 기능의 config.json 설정은 "ExperimentalEnableHardenedMode": false 이며 옵션은 truefalse 입니다.

테마 선택 활성화#

참고

plans-img-yellow Enterprise 및 Professional 플랜에서만 사용 가능

True: 사용자가 테마를 선택할 수 있도록 설정표시 > 테마 탭을 활성화합니다.

False: 사용자는 다른 테마를 선택할 수 없습니다. 설정표시 > 테마 탭이 숨겨집니다.

이 기능의 config.json 설정은 "EnableThemeSelection": true 이며 옵션은 truefalse 입니다.

사용자 정의 테마 허용#

참고

plans-img-yellow Enterprise 및 Professional 플랜에서만 사용 가능

True: 설정표시 > 테마 > 사용자 정의 테마 섹션을 활성화합니다.

False: 사용자는 사용자 정의 테마를 사용할 수 없습니다. 설정표시 > 테마 > 사용자 정의 테마 섹션이 숨겨집니다.

이 기능의 config.json 설정은 "AllowCustomThemes": true 이며 옵션은 truefalse 입니다.

기본 테마#

참고

plans-img-yellow Enterprise 및 Professional 플랜에서만 사용 가능

시스템의 모든 새 사용자에게 적용되는 기본 테마를 설정합니다.

이 기능의 config.json 설정은 "DefaultTheme": "default" 이며 옵션은 "default", "organization", "mattermostDark", "windows10" 입니다.

튜토리얼 활성화#

True: 계정 생성 후 Mattermost를 처음 열 때 사용자에게 튜토리얼이 표시됩니다.

False: 튜토리얼이 비활성화됩니다. 계정 생성 후 Mattermost를 처음 열 때 사용자는 Town Square로 이동합니다.

이 기능의 config.json 설정은 "ServiceSettings.EnableTutorial": true 이며 옵션은 truefalse 입니다.

온보딩 흐름 활성화#

True: 새로운 Mattermost 사용자에게 초기 온보딩의 일부로 완료해야 할 주요 작업이 표시됩니다.

False: 사용자 온보딩 작업이 비활성화됩니다. 계정 생성 후 Mattermost를 처음 열 때 사용자는 Town Square로 이동합니다.

이 기능의 config.json 설정은 "ServiceSettings.EnableOnboardingFlow": true 이며 옵션은 truefalse 입니다.

사용자 입력 메시지 활성화#

이 설정은 웹 브라우저나 데스크톱 앱에서 Mattermost를 사용할 때 메시지 상자 아래에 “사용자가 입력 중…” 메시지가 표시되는지 여부를 결정합니다.

이 기능의 config.json 설정은 "EnableUserTypingMessages": true 이며 옵션은 truefalse 입니다.

참고

대규모 배포에서 이 실험적 구성 설정을 비활성화하면 다음과 같은 영역에서 서버 성능이 향상될 수 있습니다:

  • 서버 부하 감소: 입력 이벤트는 추가 웹소켓 트래픽을 생성합니다. 이를 비활성화하면 서버가 처리해야 하는 데이터 양을 줄여 전체 응답 시간을 개선하고 서버 부하를 감소시킬 수 있습니다.

  • 네트워크 트래픽 감소: 입력 이벤트가 활성화되면 모든 키 입력이 네트워크 이벤트를 생성합니다. 이는 특히 바쁜 채널에서 상당한 양의 네트워크 트래픽을 유발할 수 있습니다. 이러한 이벤트를 비활성화하면 네트워크를 통해 전송되는 정보의 양이 줄어듭니다.

  • 클라이언트 성능: 클라이언트 측에서 입력 이벤트 처리는 리소스가 필요합니다. 이러한 이벤트를 처리할 필요가 없으면 클라이언트가 더 반응적이고 메모리와 CPU를 덜 사용할 수 있습니다.

사용자 입력 타임아웃#

이 설정은 “사용자가 입력 중…” 메시지가 업데이트되는 빈도를 밀리초 단위로 정의합니다.

이 기능의 config.json 설정은 숫자 입력이 있는 "TimeBetweenUserTypingUpdatesMilliseconds": 5000 입니다.

사용자 상태 및 프로필 가져오기 폴링 간격#

이 설정은 사용자 상태와 프로필을 주기적으로 가져오는 사이의 대기 시간을 밀리초 단위로 구성합니다. 비활성화하려면 0 으로 설정하세요.

이 기능의 config.json 설정은 숫자 입력이 있는 "ExperimentalSettings.UsersStatusAndProfileFetchingPollIntervalMilliseconds": 3000 입니다.

참고

이 구성 설정 값을 줄이면 Mattermost가 업데이트된 사용자 프로필 세부 정보를 확인하고 가져오는 빈도가 증가합니다. 이 값을 줄이면 오래되었거나 누락된 데이터로 인해 채널에서 사용자 이름이 Someone 으로 표시될 가능성을 줄이는 데 특히 도움이 될 수 있습니다.

주요 팀#

서버의 사용자가 구성원인 주요 팀입니다. 주요 팀이 설정되면 다른 팀에 참여하거나 주요 팀을 떠나는 옵션이 비활성화됩니다.

주요 팀의 팀 URL이 https://example.mattermost.com/myteam/ 인 경우 config.json 에서 값을 myteam 으로 설정하세요.

이 기능의 config.json 설정은 문자열 입력이 있는 "ExperimentalPrimaryTeam": "" 입니다.

SAML 로그인 버튼 색상#

참고

plans-img-yellow Enterprise 및 Professional 플랜에서만 사용 가능

화이트 라벨링 목적으로 SAML 로그인 버튼의 색상을 지정합니다. 코드 앞에 # 기호가 있는 16진수 코드를 사용하세요. 이 설정은 모바일 앱에만 적용됩니다.

이 기능의 config.json 설정은 문자열 입력이 있는 "LoginButtonColor": "" 입니다.

SAML 로그인 버튼 테두리 색상#

참고

plans-img-yellow Enterprise 및 Professional 플랜에서만 사용 가능

화이트 라벨링 목적으로 SAML 로그인 버튼 테두리의 색상을 지정합니다. 코드 앞에 # 기호가 있는 16진수 코드를 사용하세요. 이 설정은 모바일 앱에만 적용됩니다.

이 기능의 config.json 설정은 문자열 입력이 있는 "LoginButtonBorderColor": "" 입니다.

SAML 로그인 버튼 텍스트 색상#

참고

plans-img-yellow Enterprise 및 Professional 플랜에서만 사용 가능

화이트 라벨링 목적으로 SAML 로그인 버튼 텍스트의 색상을 지정합니다. 코드 앞에 # 기호가 있는 16진수 코드를 사용하세요. 이 설정은 모바일 앱에만 적용됩니다.

이 기능의 config.json 설정은 문자열 입력이 있는 "LoginButtonTextColor": "" 입니다.

이메일 알림에 채널 이름 사용#

True: 이메일 알림 제목 줄에 채널 및 팀 이름이 표시됩니다. 하나의 팀만 사용하는 서버에 유용합니다.

False: 이메일 알림 제목 줄에 팀 이름만 표시됩니다.

이 기능의 config.json 설정은 truefalse 옵션이 있는 "UseChannelInEmailNotifications": false 입니다.

사용자 자리 비움 상태 시간 초과#

이 설정은 사용자가 Mattermost를 사용하지 않을 때 사용자의 상태 표시가 “자리 비움” 으로 변경되는 시간(초)을 정의합니다.

이 기능의 config.json 설정은 숫자 입력이 가능한 "UserStatusAwayTimeout": 300 입니다.

브라우저 포커스 시 데이터 재가져오기 비활성화#

이 설정은 브라우저 포커스 시 채널 및 채널 멤버의 재가져오기를 비활성화합니다.

True: 브라우저가 포커스를 되찾을 때 Mattermost가 채널과 채널 멤버를 재가져오지 않습니다. 이는 많은 채널과 채널 멤버가 있는 사용자의 성능 향상으로 이어질 수 있습니다.

False: (기본값) 브라우저가 포커스를 되찾을 때 Mattermost가 채널과 채널 멤버를 재가져옵니다.

이 기능의 config.json 설정은 truefalse 옵션이 있는 "ExperimentalSettings.DisableRefetchingOnBrowserFocus": false 입니다.

절전 모드 해제 재연결 핸들러 비활성화#

이 설정은 컴퓨터가 절전 모드에서 해제되었을 때 데이터를 감지하고 재가져오는 시도를 비활성화합니다.

True: Mattermost가 컴퓨터가 절전 모드에서 해제되었을 때 데이터를 감지하고 재가져오려고 시도하지 않습니다. 이는 앱이 보내는 정기적인 네트워크 트래픽의 양을 줄일 수 있습니다.

False: (기본값) Mattermost는 컴퓨터가 절전 모드에서 해제되었을 때 데이터를 감지하고 새로고침하려고 시도합니다.

이 기능의 config.json 설정은 truefalse 옵션이 있는 "ExperimentalSettings.DisableWakeUpReconnectHandler": false 입니다.

채널 자동완성 지연#

이 설정은 메시지 작성 시 물결표(~)를 입력한 후 채널 링크 자동완성이 즉시 트리거되는지 여부를 제어합니다. 이 설정은 물결표 ~ 를 문장 부호로 사용하는 사용자에게 ~town-square 와 같은 채널 자동완성이 덜 방해가 되도록 합니다.

True: 사용자가 물결표와 그 뒤에 두 개 이상의 문자를 입력한 후에 자동완성이 나타납니다. 예를 들어, ~to 를 입력하면 자동완성이 표시되지만, ~ 만 입력하면 표시되지 않습니다.

False: (기본값) 사용자가 물결표를 입력하자마자 자동완성이 나타납니다. 예를 들어, ~ 를 입력하면 자동완성이 표시됩니다.

이 기능의 config.json 설정은 truefalse 옵션이 있는 "ExperimentalSettings.DelayChannelAutocomplete": false 입니다.

전용 내보내기 파일스토어 대상 활성화#

이 설정을 통해 Mattermost 대량 내보내기규정 준수 내보내기 를 위한 대체 파일스토어 대상을 지정할 수 있습니다.

True: 다음 구성 설정에 대한 새로운 구성 값을 사용하여 FileSettings 아래에 새로운 ExportFileBackend() 가 생성됩니다:

  • ExportDriverName

  • ExportDirectory

  • ExportAmazonS3AccessKeyId

  • ExportAmazonS3SecretAccessKey

  • ExportAmazonS3Bucket

  • ExportAmazonS3PathPrefix

  • ExportAmazonS3Region

  • ExportAmazonS3Endpoint

  • ExportAmazonS3SSL

  • ExportAmazonS3SignV2

  • ExportAmazonS3SSE

  • ExportAmazonS3Trace

  • ExportAmazonS3RequestTimeoutMilliseconds

  • ExportAmazonS3PresignExpiresSeconds

False: 표준 파일 스토리지 가 사용됩니다(또는 구성 설정이 생략된 경우).

대체 파일스토어 대상이 구성된 경우, Mattermost Cloud 관리자는 /exportlink [job-id|zip file|latest] 슬래시 명령을 사용하여 내보내기를 위한 S3 사전 서명된 URL을 생성할 수 있습니다. 자세한 내용은 Mattermost 데이터 마이그레이션 문서를 참조하세요. 또는 Cloud 및 자체 호스팅 관리자는 mmctl export generate-presigned-url 명령을 사용하여 mmctl에서 직접 사전 서명된 URL을 생성할 수 있습니다.

참고

S3 사전 서명된 URL을 생성하려면 기능 플래그 EnableExportDirectDownloadtrue 로 설정되어 있어야 하며, 스토리지는 S3 링크 생성과 호환되어야 하고, 이 실험적 구성 설정이 true 로 설정되어 있어야 합니다. 내보내기를 위한 사전 서명된 URL은 공유 스토리지가 있는 시스템에서는 지원되지 않습니다.

이 기능의 config.json 설정은 "ExperimentalSettings.DedicatedExportStore": false 이며 옵션은 truefalse 입니다.

YouTube 리퍼러 정책#

이 설정은 YouTube 동영상 미리보기가 사용할 수 없음으로 표시되는 문제를 해결합니다.

True: 임베드된 YouTube 동영상의 리퍼러 정책이 strict-origin-when-cross-origin 으로 설정됩니다.

False: (기본값) 리퍼러 정책이 no-referrer 로 설정되어 소스 URL을 공개하지 않아 사용자 개인정보를 향상시키지만, 분석 도구에서 사용자 참여도와 트래픽 소스를 추적하는 기능이 제한됩니다.

이 기능의 config.json 설정은 "ExperimentalSettings.YoutubeReferrerPolicy": false 이며 옵션은 truefalse 입니다.


실험적 Bleve 구성 설정#

plans-img 모든 플랜 에서 사용 가능

deployment-img 자체 호스팅 배포

시스템 콘솔에서 실험적 > Bleve 로 이동하거나 다음 표에 설명된 대로 config.json 파일을 편집하여 다음 구성 설정에 액세스하세요:

Bleve 인덱싱 활성화#

True: 새 게시물의 인덱싱이 자동으로 발생합니다. 검색 쿼리에 Bleve 활성화 가 활성화될 때까지 검색 쿼리는 bleve 검색을 사용하지 않습니다.

False: 새 게시물의 인덱싱이 자동으로 발생하지 않습니다.

이 기능의 config.json 설정은 "EnableIndexing": false 이며 옵션은 truefalse 입니다.

인덱스 디렉토리#

bleve 인덱스를 저장하는 데 사용할 디렉토리 경로입니다.

bleve 인덱스 디렉토리 경로는 mattermost 디렉토리 내에 존재할 필요가 없습니다. mattermost 디렉토리 외부에 존재하는 경우 Mattermost 업그레이드의 일부로 이러한 파일을 보존하거나 재인덱싱하기 위한 추가 단계가 필요하지 않습니다. 자세한 내용은 Mattermost 서버 업그레이드 문서를 참조하세요.

이 기능의 config.json 설정은 문자열 입력이 있는 "IndexDir": "" 입니다.

지금 일괄 인덱싱#

지금 인덱싱 을 선택하여 데이터베이스의 모든 사용자, 채널 및 게시물을 가장 오래된 것부터 최신 순으로 인덱싱합니다. 인덱싱 중에는 Bleve를 사용할 수 있지만, 인덱싱 작업이 완료될 때까지 검색 결과가 불완전할 수 있습니다.

인덱스 삭제#

인덱스 삭제 를 선택하여 Bleve 인덱스 디렉토리의 내용을 제거합니다. 기존 데이터베이스의 일괄 인덱스가 재구축될 때까지 검색 결과가 불완전할 수 있습니다.

검색 쿼리에 Bleve 활성화#

True: 검색 쿼리가 bleve 검색을 사용합니다.

False: 검색 쿼리가 bleve 검색을 사용하지 않습니다.

이 기능의 config.json 설정은 "EnableSearching": false 이며 truefalse 옵션을 사용합니다.

자동완성 쿼리에 Bleve 활성화#

True: 자동완성 쿼리가 bleve 검색을 사용합니다.

False: 자동완성 쿼리가 bleve 검색을 사용하지 않습니다.

이 기능의 config.json 설정은 "EnableAutocomplete": false 이며 truefalse 옵션을 사용합니다.


실험적 감사 로깅 구성 설정 (베타)#

실험적 > 기능 으로 이동하거나 config.json 파일에서 다음 설정을 활성화하여 시스템 콘솔에 감사 이벤트를 출력합니다.

참고

시스템 콘솔에서 감사 로깅을 구성하려면 기능 플래그 ExperimentalAuditSettingsSystemConsoleUItrue 로 설정해야 합니다.

고급 로깅#

plans-img Enterprise 플랜에서만 사용 가능

deployment-img Cloud 배포에서만 사용 가능

Mattermost Cloud 배포를 위해 콘솔, 로컬 파일, syslog 및 TCP 소켓 대상의 조합으로 로그 및 감사 기록을 출력합니다. 로깅 옵션에 대한 자세한 내용은 고급 로깅 문서를 참조하세요.

감사 로깅 활성화#

plans-img Enterprise 플랜 에서 사용 가능

deployment-img 클라우드자체 호스팅 배포

자체 호스팅 인스턴스에서 감사 로깅이 활성화되면 아래에 정의된 대로 파일 순환을 관리하기 위한 크기, 백업 간격, 압축, 최대 수명 및 감사 로깅을 위한 타임스탬프를 지정할 수 있습니다. 감사 이벤트와 AD/LDAP 이벤트에 대해 이러한 설정을 독립적으로 지정할 수 있습니다.

True: 감사 로깅 파일이 활성화되고, 자체 호스팅 배포를 위해 감사 파일이 로컬 파일에 기록됩니다.

False: 감사 로깅 파일이 활성화되지 않고, 자체 호스팅 배포를 위해 감사 로그가 로컬 파일에 기록되지 않습니다.

이 기능의 config.json 설정은 ".ExperimentalAuditSettings.FileEnabled": false"이며 ``truefalse 옵션을 사용합니다.

파일 이름#

plans-img Enterprise 플랜 에서 사용 가능

deployment-img 자체 호스팅 배포

자체 호스팅 배포를 위한 감사 파일의 경로를 지정합니다.

이 기능의 config.json 설정은 사용자 정의 경로(예: /var/log/mattermost_audit.log)로 구성된 문자열 입력이 있는 ".ExperimentalAuditSettings.FileName": "" 입니다.

최대 파일 크기#

plans-img Enterprise 플랜 에서 사용 가능

deployment-img 자체 호스팅 배포

이는 자체 호스팅 배포에서 파일 순환을 트리거하기 전에 파일이 증가할 수 있는 최대 크기(메가바이트)입니다. 기본 설정은 100 입니다.

이 기능의 config.json 설정은 숫자 입력이 있는 ".ExperimentalAuditSettings.FileMaxSizeMB": 100 입니다.

최대 파일 수명#

plans-img Enterprise 플랜 에서 사용 가능

deployment-img 자체 호스팅 배포

이는 자체 호스팅 배포에서 파일 순환을 트리거하기 전에 파일이 도달할 수 있는 최대 수명(일)입니다. 기본값은 0 으로, 수명에 제한이 없음을 나타냅니다.

이 기능의 config.json 설정은 숫자 입력이 있는 ".ExperimentalAuditSettings.FileMaxAgeDays": 0 입니다.

최대 파일 백업 수#

plans-img Enterprise 플랜 에서 사용 가능

deployment-img 자체 호스팅 배포

이는 자체 호스팅 배포를 위해 유지되는 순환 파일의 최대 수입니다. 가장 오래된 파일이 먼저 삭제됩니다. 기본값은 0 으로, 백업 수에 제한이 없음을 나타냅니다.

이 기능의 config.json 설정은 숫자 입력이 있는 ".ExperimentalAuditSettings.FileMaxBackups": 0 입니다.

파일 압축#

plans-img Enterprise 플랜 에서 사용 가능

deployment-img 자체 호스팅 배포

true 인 경우, 자체 호스팅 배포에서 순환 파일이 gzip 을 사용하여 압축됩니다.

이 기능의 config.json 설정은 truefalse 옵션이 있는 ".ExperimentalAuditSettings.FileCompress": false 입니다.

최대 파일 큐#

plans-img Enterprise 플랜 에서 사용 가능

deployment-img 자체 호스팅 배포

이 설정은 자체 호스팅 배포에서 파일에 기록할 때 언제든지 대기/버퍼링할 수 있는 감사 기록의 수를 결정합니다. 기본값은 1000 개의 기록입니다. 서버 로그에서 감사 기록 실패가 발생하고 그에 따라 수를 조정해야 하는 경우가 아니라면 이 설정은 기본값으로 유지할 수 있습니다.

이 기능의 config.json 설정은 숫자 입력이 있는 ".ExperimentalAuditSettings.FileMaxQueueSize": 1000 입니다.

고급 로깅#

plans-img Enterprise 플랜 에서 사용 가능

deployment-img 자체 호스팅 배포

Mattermost 자체 호스팅 배포를 위해 콘솔, 로컬 파일, syslog, TCP 소켓 대상의 조합으로 로그와 감사 기록을 출력합니다. 로깅 옵션에 대한 자세한 내용은 고급 로깅 문서를 참조하세요.

자체 호스팅 배포 전용 실험적 구성 설정#

참고

deployment-img-yellow 자체 호스팅 배포에서만 사용 가능

다음 표에 설명된 대로 config.json 파일을 편집하여 자체 호스팅 구성 설정에 접근합니다. 이러한 구성 설정은 시스템 콘솔을 통해 접근할 수 없습니다.

아래의 각 구성 값에는 JSON 인식 도구를 사용하여 config.json 파일에서 프로그래밍 방식으로 값에 접근하기 위한 JSON 경로가 포함되어 있습니다. 예를 들어, SiteURL 값은 ServiceSettings 아래에 있습니다.

  • jq 와 같은 도구를 사용하는 경우 다음을 입력합니다: cat config/config.json | jq '.ServiceSettings.SiteURL'

  • config.json 파일을 수동으로 작업할 때는 ServiceSettings 키를 찾은 다음, 해당 객체 내에서 SiteURL 키를 찾으세요.

허용된 테마#

참고

plans-img-yellow Enterprise 및 Professional 플랜에서만 사용 가능

이 설정은 시스템 콘솔에서 사용할 수 없으며 config.json 에서만 설정할 수 있습니다.

EnableThemeSelectiontrue 로 설정되었을 때 사용자가 선택할 수 있는 테마를 선택합니다.

이 기능의 config.json 설정은 "default", "organization", "mattermostDark", "windows10" 옵션으로 구성된 문자열 배열 입력이 있는 "AllowedThemes": [] 입니다. 예: ["mattermostDark", "windows10"]

통계 최대 사용자 수#

참고

plans-img-yellow Enterprise 및 Professional 플랜에서만 사용 가능

이 설정은 시스템 콘솔에서 사용할 수 없으며 config.json 에서만 설정할 수 있습니다.

총 게시물, 총 해시태그 게시물, 총 파일 게시물, 일일 게시물 및 일일 게시물이 있는 활성화된 사용자에 대한 통계가 비활성화되기 전의 서버 최대 사용자 수를 설정합니다.

이 설정은 대규모 Enterprise 배포의 성능을 최대화하는 데 사용됩니다.

이 기능의 config.json 설정은 숫자 입력이 있는 "MaxUsersForStatistics": 2500 입니다.

배치 크기#

참고

plans-img-yellow Enterprise 플랜에서만 사용 가능

이 설정은 시스템 콘솔에서 사용할 수 없으며 config.json 에서만 설정할 수 있습니다.

규정 준수 내보내기 파일에 함께 배치되는 새 게시물의 수를 결정합니다.

이 기능의 config.json 설정은 숫자 입력이 있는 "BatchSize": 10000 입니다.

파일 위치#

참고

plans-img-yellow Enterprise 플랜에서만 사용 가능

이 설정은 시스템 콘솔에서 사용할 수 없으며 config.json 에서만 설정할 수 있습니다.

규정 준수 내보내기의 파일 위치를 설정합니다. 기본적으로 구성된 로컬 스토리지 디렉토리exports 하위 디렉토리에 기록됩니다.

이 기능의 config.json 설정은 문자열 입력이 있는 "FileLocation": "export" 입니다.

푸시 알림 버퍼#

이 설정은 시스템 콘솔에서 사용할 수 없으며 config.json 에서만 설정할 수 있습니다.

전송할 푸시 알림 메시지의 버퍼를 제어하는 데 사용됩니다. 메시지 수가 해당 숫자를 초과하면 공간이 생길 때까지 푸시 알림을 만드는 요청이 차단됩니다.

이 기능의 config.json 설정은 숫자 입력이 있는 "PushNotificationBuffer": 1000 입니다.

시스템 관리자 제한#

이 설정은 시스템 콘솔에서 사용할 수 없으며 config.json 에서만 설정할 수 있습니다.

True: (클라우드 배포의 기본값) 시스템 관리자가 시스템 콘솔에서 서버 구성 설정의 하위 집합을 보고 수정하는 것을 제한합니다. 온프레미스 설치에는 권장되지 않습니다. 이는 Mattermost Private Cloud가 사용자에게 시스템 관리자 역할을 부여하면서도 특정 작업을 Cloud 관리자에게만 제한하도록 지원하기 위한 것입니다.

False: (자체 호스팅 배포의 기본값) 시스템 관리자 역할에 제한이 적용되지 않습니다.

이 기능의 config.json 설정은 truefalse 옵션이 있는 "RestrictSystemAdmin": "false" 입니다.

클라이언트 측 인증서 활성화#

참고

plans-img-yellow Enterprise 플랜에서만 사용 가능

True: Mattermost 서버에 대한 클라이언트 측 인증서를 활성화합니다. 자세한 내용은 문서 를 참조하세요.

False: 클라이언트 측 인증서가 비활성화됩니다.

이 기능의 config.json 설정은 truefalse 옵션이 있는 "ClientSideCertEnable": false 입니다.

클라이언트 측 인증서 로그인 방법#

참고

plans-img-yellow Enterprise 플랜에서만 사용 가능

ClientSideCertEnable 구성 설정과 함께 사용됩니다.

Primary: 클라이언트 측 인증서가 확인된 후, 사용자의 이메일이 인증서에서 검색되어 비밀번호 없이 로그인하는 데 사용됩니다.

Secondary: 클라이언트 측 인증서가 확인된 후, 사용자의 이메일이 인증서에서 검색되어 사용자가 제공한 이메일과 일치하는지 확인합니다. 일치하는 경우 사용자는 일반 이메일/비밀번호 자격 증명으로 로그인합니다.

이 기능의 config.json 설정은 "primary""secondary" 옵션이 있는 "ClientSideCertCheck": "secondary" 입니다.

내보내기 출력 디렉토리#

이 설정은 시스템 콘솔에서 사용할 수 없으며 config.json 에서만 설정할 수 있습니다.

내보낸 파일이 저장되는 디렉토리입니다. 경로는 FileSettings 디렉토리를 기준으로 합니다. 기본적으로 내보내기는 ./data/export 아래에 저장됩니다.

이 기능의 ExportSettings 섹션 아래 config.json 설정은 문자열 입력이 있는 Directory: ./export 입니다.

내보내기 보관 기간#

이 설정은 시스템 콘솔에서 사용할 수 없으며 config.json 에서만 설정할 수 있습니다.

내보낸 파일을 삭제하기 전에 보관할 일수입니다.

이 기능의 ExportSettings 섹션 아래 config.json 설정은 숫자 입력이 있는 RetentionDays: 30 입니다.

최대 이미지 해상도#

이 설정은 시스템 콘솔에서 사용할 수 없으며 config.json 에서만 설정할 수 있습니다.

메시지 첨부 파일의 최대 이미지 해상도 크기(픽셀)입니다.

이 기능의 config.json 설정은 숫자 입력이 있는 "MaxImageResolution": 33177600 입니다.

최대 이미지 디코더 동시성#

이 설정은 시스템 콘솔에서 사용할 수 없으며 config.json 에서만 설정할 수 있습니다.

한 번에 동시에 디코딩할 수 있는 이미지 수를 나타냅니다. 기본값 -1 은 Mattermost가 자동으로 사용 가능한 CPU 수를 사용하도록 구성합니다.

참고

  • 이 구성 설정은 서버의 총 메모리 사용량에 영향을 미칩니다. 단일 이미지의 최대 메모리는 MaxImageResolution * 24 bytes 에 의해 결정되며, 여기서 기본 최대 이미지 해상도 값은 33MB입니다.

  • 따라서 좋은 경험 법칙은 33MB * MaxImageDecoderConcurrency * 24 가 서버의 총 메모리보다 작아야 한다는 것입니다.

  • 예를 들어, 4코어 서버가 있는 경우 이미지 처리를 위해 최소 33 * 4 * 24 = 3168MB 메모리를 남겨두어야 합니다. 그렇지 않으면 MaxImageResolution 구성 설정을 조정하여 이미지 처리에 필요한 메모리 양을 조정하세요.

이 기능의 config.json 설정은 숫자 입력이 있는 "MaxImageDecoderConcurrency": "-1" 입니다.

초기 글꼴#

이 설정은 시스템 콘솔에서 사용할 수 없으며 config.json 에서만 설정할 수 있습니다.

색상이 있는 배경의 자동 생성 프로필 사진에 사용되는 글꼴입니다.

이 기능의 config.json 설정은 문자열 입력이 있는 "InitialFont": "luximbi.ttf" 입니다.

Amazon S3 서명 v2#

이 설정은 시스템 콘솔에서 사용할 수 없으며 config.json 에서만 설정할 수 있습니다.

기본적으로 Mattermost는 AWS API 호출에 서명 V4를 사용하지만, 일부 상황에서는 V2가 필요합니다. V2 사용 시기에 대한 자세한 내용은 https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_sigv.html을 참조하세요.

True: 서명 버전 2 서명 프로세스를 사용합니다.

False: 서명 버전 4 서명 프로세스를 사용합니다.

이 기능의 config.json 설정은 truefalse 옵션이 있는 "AmazonS3SignV2": false 입니다.

Amazon S3 경로#

이 설정은 시스템 콘솔에서 사용할 수 없으며 config.json 에서만 설정할 수 있습니다.

여러 배포에 동일한 S3 버킷을 사용할 수 있습니다.

이 기능의 config.json 설정은 문자열 입력이 있는 "AmazonS3PathPrefix: "" 입니다.

GitLab 범위#

이 설정은 시스템 콘솔에서 사용할 수 없으며 config.json 에서만 설정할 수 있습니다.

OAuth 클라이언트와 공유되는 정보의 범위를 결정하는 OAuth의 표준 설정입니다. 현재 GitLab OAuth에서 지원하지 않습니다.

이 기능의 config.json 설정은 문자열 입력이 있는 "Scope": "" 입니다.

글로벌 릴레이 SMTP 서버 타임아웃#

참고

plans-img-yellow Enterprise 플랜에서만 사용 가능

이 설정은 시스템 콘솔에서 사용할 수 없으며 config.json 에서만 설정할 수 있습니다.

SMTP 서버에 대한 연결 시도가 중단되기 전까지 경과할 수 있는 시간(초)입니다. 기본값은 1800초입니다. 이 설정은 현재 시스템 콘솔에서 사용할 수 없으며 config.json 에서만 설정할 수 있습니다.

이 기능의 config.json 설정은 숫자 입력이 있는 "GlobalRelaySettings.SMTPServerTimeout": "1800" 입니다.

Google 범위#

참고

plans-img-yellow Enterprise 및 Professional 플랜에서만 사용 가능

이 설정은 시스템 콘솔에서 사용할 수 없으며 config.json 에서만 설정할 수 있습니다.

OAuth 클라이언트와 공유되는 정보의 범위를 결정하는 OAuth의 표준 설정입니다. 권장 설정은 profile email 입니다.

이 기능의 config.json 설정은 문자열 입력이 있는 "Scope": "profile email" 입니다.

가져오기 입력 디렉토리#

이 설정은 시스템 콘솔에서 사용할 수 없으며 config.json 에서만 설정할 수 있습니다.

가져온 파일이 저장되는 디렉토리입니다. 경로는 FileSettings 디렉토리를 기준으로 합니다. 기본적으로 가져오기는 ./data/import 아래에 저장됩니다.

이 기능의 config.json 설정은 ImportSettings 섹션 아래에 문자열 입력이 있는 Directory: ./import 입니다.

가져오기 보관 일수#

이 설정은 시스템 콘솔에서 사용할 수 없으며 config.json 에서만 설정할 수 있습니다.

가져온 파일을 삭제하기 전에 보관할 일수입니다.

이 기능의 config.json 설정은 ImportSettings 섹션 아래에 숫자 입력이 있는 RetentionDays: 30 입니다.

타임스탬프부터 내보내기#

참고

plans-img-yellow Enterprise 플랜에서만 사용 가능

이 설정은 시스템 콘솔에서 사용할 수 없으며 config.json 에서만 설정할 수 있습니다.

데이터를 내보낼 Unix 타임스탬프(epoch 이후 초, UTC)를 설정합니다.

이 기능의 config.json 설정은 숫자 입력이 있는 "ExportFromTimestamp": 0 입니다.

블록 프로필 비율#

이 설정은 시스템 콘솔에서 사용할 수 없으며 config.json 에서만 설정할 수 있습니다. 이 설정을 변경하려면 서버를 재시작해야 적용됩니다.

블로킹 프로필 에서 보고되는 고루틴 블로킹 이벤트의 비율을 제어하는 값입니다.

프로파일러는 차단된 시간당 평균 하나의 블로킹 이벤트를 샘플링하는 것을 목표로 합니다.

프로파일에 모든 블로킹 이벤트를 포함하려면 비율을 1 로 설정하세요. 프로파일링을 완전히 끄려면 비율을 0 으로 설정하세요.

이 기능의 config.json 설정은 01 옵션이 있는 "BlockProfileRate": 0 입니다.

Entra ID 범위#

참고

plans-img-yellow Enterprise 및 Professional 플랜에서만 사용 가능

이 설정은 시스템 콘솔에서 사용할 수 없으며 config.json 에서만 설정할 수 있습니다.

OAuth 클라이언트와 공유되는 정보의 범위를 결정하는 OAuth의 표준 설정입니다. 권장 설정은 User.Read 입니다.

이 기능의 config.json 설정은 문자열 입력이 있는 "Scope": "User.Read" 입니다.

플러그인 업로드 활성화#

이 설정은 시스템 콘솔에서 사용할 수 없으며 config.json 에서만 설정할 수 있습니다.

True: 플러그인 > 관리 에서 시스템 관리자가 플러그인을 업로드할 수 있게 합니다. 플러그인을 업로드할 계획이 없다면 서버에 설치되는 플러그인을 제어하기 위해 false 로 설정하세요. 자세한 내용은 문서 를 참조하세요.

False: Mattermost 서버에서 플러그인 업로드를 비활성화합니다.

이 기능의 config.json 설정은 truefalse 옵션이 있는 "EnableUploads": false 입니다.

안전하지 않은 다운로드 URL 허용#

이 설정은 시스템 콘솔에서 사용할 수 없으며 config.json 에서만 설정할 수 있습니다.

True: 원격 URL에서 플러그인을 다운로드하고 설치할 수 있게 합니다.

False: 원격 URL에서 플러그인을 다운로드하고 설치하는 것을 비활성화합니다.

이 기능의 config.json 설정은 truefalse 옵션이 있는 "AllowInsecureDownloadUrl": false 입니다.

플러그인 상태 확인 활성화#

이 설정은 시스템 콘솔에서 사용할 수 없으며 config.json 에서만 설정할 수 있습니다.

True: 모든 플러그인이 주기적으로 모니터링되고 상태에 따라 재시작되거나 비활성화되도록 플러그인 상태 확인을 활성화합니다. 상태 확인은 30초마다 실행됩니다. 플러그인이 1시간 내에 3번 실패하면 Mattermost 서버가 재시작을 시도합니다. 재시작이 연속 3번 실패하면 자동으로 비활성화됩니다.

False: Mattermost 서버에서 플러그인 상태 확인을 비활성화합니다.

이 기능의 config.json 설정은 truefalse 옵션이 있는 "EnableHealthCheck": true 입니다.

플러그인 디렉토리#

이 설정은 시스템 콘솔에서 사용할 수 없으며 config.json 에서만 설정할 수 있습니다.

플러그인 파일의 위치입니다. 비어 있으면 ./plugins 디렉토리에 저장됩니다. 설정한 경로가 존재해야 하며 Mattermost가 해당 경로에 쓰기 권한을 가져야 합니다.

이 기능의 config.json 설정은 문자열 입력이 가능한 "Directory": "./plugins" 입니다.

클라이언트 플러그인 디렉토리#

이 설정은 시스템 콘솔에서 사용할 수 없으며 config.json 에서만 설정할 수 있습니다.

클라이언트 플러그인 파일의 위치입니다. 비어 있으면 ./client/plugins 디렉토리에 저장됩니다. 설정한 경로가 존재해야 하며 Mattermost가 해당 경로에 쓰기 권한을 가져야 합니다.

이 기능의 config.json 설정은 문자열 입력이 가능한 "ClientDirectory": "./client/plugins" 입니다.

스코핑 IDP 제공자 ID#

참고

plans-img-yellow Enterprise 및 Professional 플랜에서만 사용 가능

이 설정은 시스템 콘솔에서 사용할 수 없으며 config.json 에서만 설정할 수 있습니다.

인증된 사용자가 페더레이션된 Azure AD 서버의 초기 로그인 페이지를 건너뛰고 비밀번호만으로 로그인할 수 있게 합니다.

이 기능의 config.json 설정은 문자열 입력이 가능한 "ScopingIDPProviderId": "" 입니다.

스코핑 IDP 제공자 이름#

참고

plans-img-yellow Enterprise 및 Professional 플랜에서만 사용 가능

이 설정은 시스템 콘솔에서 사용할 수 없으며 config.json 에서만 설정할 수 있습니다.

사용자의 스코핑 IDP ID와 연결된 이름을 추가합니다.

이 기능의 config.json 설정은 문자열 입력이 가능한 "ScopingIDPName": "" 입니다.

읽지 않은 채널 그룹화#

이 설정은 시스템 콘솔에서 사용할 수 없으며 config.json 에서만 설정할 수 있습니다.

이 설정은 새 사이드바에만 적용됩니다. 시스템 콘솔에서 이 기능을 보고 활성화하려면 Enable Legacy Sidebar 설정을 비활성화해야 합니다.

기본 꺼짐: 기본적으로 모든 사용자의 읽지 않은 채널 사이드바 섹션을 비활성화합니다. 사용자는 설정 > 사이드바 > 읽지 않은 채널 별도 그룹화 에서 활성화할 수 있습니다.

기본 켜짐: 기본적으로 모든 사용자의 읽지 않은 채널 사이드바 섹션을 활성화합니다. 사용자는 설정 > 사이드바 > 읽지 않은 채널 별도 그룹화 에서 비활성화할 수 있습니다.

이 기능의 config.json 설정은 "default_off""default_on" 옵션이 있는 "ExperimentalGroupUnreadChannels": "default_off" 입니다.

엄격한 CSRF 토큰 적용#

이 설정은 시스템 콘솔에서 사용할 수 없으며 config.json 에서만 설정할 수 있습니다.

: 현재 사용 중인 사용자 정의 헤더와 비교하여 추가적인 보안 강화를 위한 CSRF 보호 토큰을 활성화합니다. 사용자가 로그인하면 CSRF 토큰이 포함된 추가 쿠키가 생성됩니다.

거짓: CSRF 보호 토큰을 비활성화합니다.

이 기능의 config.json 설정은 truefalse 옵션이 있는 "ExperimentalStrictCSRFEnforcement": false 입니다.

개발자 플래그#

이 설정은 시스템 콘솔에서 사용할 수 없으며 config.json 에서만 설정할 수 있습니다.

이 설정은 Mattermost 웹 앱의 콘텐츠 보안 정책(CSP)을 설정하는 데 사용되는 플래그 문자열 목록을 지정합니다. 각 플래그는 flag=true 형식이어야 합니다(예: unsafe-eval=true,unsafe-inline=true). 프로덕션 환경에서는 권장되지 않습니다.

현재 지원되는 값은 다음과 같습니다:

  • unsafe-eval: 루트 웹앱에 unsafe-eval CSP 지시문을 추가하여 개발자 환경에서 디버깅 기능을 향상시킵니다.

  • unsafe-inline: 루트 웹앱에 unsafe-inline CSP 지시문을 추가하여 개발자 환경에서 디버깅 기능을 향상시킵니다.

이 설정은 기본적으로 비활성화되어 있으며 개발자 모드 를 활성화해야 합니다.

이 기능의 config.json 설정은 문자열 입력이 있는 "DeveloperFlags": "" 입니다.

게시물 검색 활성화#

이 설정은 시스템 콘솔에서 사용할 수 없으며 config.json 에서만 설정할 수 있습니다.

이 설정이 활성화되면 사용자는 Mattermost 인스턴스에서 메시지를 검색할 수 있습니다.

이 기능의 config.json 설정은 truefalse 옵션이 있는 "EnablePostSearch": true 입니다.

참고

대규모 배포에서 이 실험적 구성 설정을 비활성화하면 다음과 같은 영역에서 서버 성능이 향상될 수 있습니다:

  • 데이터베이스 부하 감소: 게시물 검색이 활성화되면 모든 검색 쿼리가 데이터베이스에 추가 부하를 줍니다. 검색을 비활성화하면 이러한 쿼리가 줄어들어 데이터베이스 성능이 향상되고 다른 작업의 응답 시간이 단축됩니다.

  • 메모리 사용량 감소: 검색 기능은 종종 메시지 색인화가 필요하며 이는 메모리를 소모합니다. 검색을 비활성화하면 이러한 색인을 유지하는 데 필요한 메모리가 다른 용도로 해제되어 전체 시스템 성능이 향상됩니다.

  • 빠른 쓰기 작업: 게시물 검색이 활성화되면 모든 새 게시물, 편집 또는 삭제에 대해 색인을 업데이트해야 합니다. 검색을 비활성화하면 이러한 오버헤드를 피하여 더 빠른 쓰기 작업이 가능해집니다.

  • 성능 일관성: 검색 기능이 없으면 애플리케이션은 잠재적인 성능 병목 현상을 피하고 특히 많은 수의 게시물이 있는 높은 사용량 시나리오에서 더 일관된 성능 수준을 유지할 수 있습니다.

  • 단순화된 시스템 유지 관리: 검색 색인 관리는 복잡하고 리소스 집약적일 수 있습니다. 검색을 비활성화하면 시스템 유지 관리의 이 측면이 단순화되어 검색 색인 손상이나 성능 저하와 관련된 성능 문제의 위험이 줄어들 수 있습니다.

  • 그러나 Mattermost에서 메시지를 검색하는 기능은 많은 사용자에게 중요한 기능이며, 이 기능을 비활성화하면 사용자가 Mattermost 검색 상자를 사용하려고 할 때 오류가 표시됩니다. 성능 개선과 조직 및 사용자의 요구 사항 사이의 균형을 맞추는 것이 중요합니다.

사용자 상태 업데이트 활성화#

이 설정은 시스템 콘솔에서 사용할 수 없으며 config.json 에서만 설정할 수 있습니다.

성능 향상을 위해 상태 업데이트를 끕니다. 상태 업데이트가 꺼져 있으면 사용자는 메시지를 게시할 때만 짧은 시간 동안 온라인으로 표시되며, 메시지가 게시된 채널의 구성원에게만 표시됩니다.

이 기능의 config.json 설정은 "EnableUserStatuses": true 이며 truefalse 옵션을 사용합니다.

WebSocket 보안 포트#

이 설정은 시스템 콘솔에서 사용할 수 없으며 config.json 에서만 설정할 수 있습니다. 이 설정을 변경하려면 서버를 재시작해야 적용됩니다.

(선택 사항) 이 설정은 wss 프로토콜을 사용하여 보안 WebSocket이 수신 대기하는 포트를 정의합니다. 기본값은 443 입니다. 클라이언트가 WebSocket 연결을 시도할 때 먼저 페이지가 HTTPS로 로드되었는지 확인합니다. 그렇다면 보안 WebSocket 연결을 사용하고, 그렇지 않으면 비보안 WebSocket 연결을 사용합니다. 프로덕션 배포는 HTTPS와 WSS에서만 작동하는 것이 매우 권장됩니다.

이 기능의 config.json 설정은 숫자 입력이 있는 "WebsocketSecurePort": 443 입니다.

참고

이는 Web server listen address 설정으로 제어되는 서버 프로세스의 수신 포트에 영향을 미치지 않는 클라이언트 전용 재정의입니다.

WebSocket 포트#

이 설정은 시스템 콘솔에서 사용할 수 없으며 config.json 에서만 설정할 수 있습니다. 이 설정을 변경하려면 서버를 재시작해야 적용됩니다.

(선택 사항) 이 설정은 ws 프로토콜을 사용하여 비보안 WebSocket이 수신 대기하는 포트를 정의합니다. 기본값은 80 입니다. 클라이언트가 WebSocket 연결을 시도할 때 먼저 페이지가 HTTPS로 로드되었는지 확인합니다. 그렇다면 보안 WebSocket 연결을 사용하고, 그렇지 않으면 비보안 WebSocket 연결을 사용합니다. 프로덕션 배포는 HTTPS와 WSS에서만 작동하는 것이 매우 권장됩니다.

이 기능의 config.json 설정은 숫자 입력이 있는 WebsocketPort": 80 입니다.

참고

이는 Web server listen address 설정으로 제어되는 서버 프로세스의 수신 포트에 영향을 미치지 않는 클라이언트 전용 재정의입니다.

mmctl의 로컬 모드 활성화#

이 설정은 시스템 콘솔에서 사용할 수 없으며 config.json 에서만 설정할 수 있습니다.

True: mmctl의 로컬 모드를 활성화합니다.

False: mmctl의 로컬 모드를 방지합니다.

이 기능의 config.json 설정은 truefalse 옵션이 있는 "EnableLocalMode": false 입니다.

mmctl에서 로컬 모드를 사용하려고 할 때, 서버와 mmctl을 실행할 때 동일한 사용자를 사용하거나 새 사용자로 전환하기 전에 소켓 파일을 정리하세요. socket file "/var/tmp/mattermost_local.socket" doesn't exists, please check the server configuration for local mode 와 같은 오류가 발생하면 이 구성 설정을 true 로 설정하여 해결할 수 있습니다.

Enable local mode socket location#

이 설정은 시스템 콘솔에서 사용할 수 없으며 config.json 에서만 설정할 수 있습니다.

서버가 mmctl이 로컬 모드를 통해 연결하고 통신하기 위해 생성할 소켓의 경로입니다. 이 키의 기본값이 변경되면 로컬 모드에서 --local 플래그에 추가하여 --local-socket-path /new/path/to/socket 플래그를 사용하여 mmctl을 새 소켓 경로로 지정해야 합니다.

아무것도 지정되지 않은 경우, 서버와 mmctl 모두가 가정하는 기본 경로는 /var/tmp/mattermost_local.socket 입니다.

이 기능의 config.json 설정은 문자열 입력이 있는 "LocalModeSocketLocation": "/var/tmp/mattermost_local.socket" 입니다.

기본 채널#

이 설정은 시스템 콘솔에서 사용할 수 없으며 config.json 에서만 설정할 수 있습니다.

새 팀에 참여한 후 모든 사용자가 자동으로 추가되는 기본 채널입니다. 공개 채널에만 적용되지만 서버의 모든 팀에 영향을 미칩니다.

설정되지 않은 경우, 모든 사용자는 기본적으로 town-square 채널에 추가됩니다.

참고

town-square 가 목록에 없더라도 새 팀에 참여할 때 모든 사용자가 자동으로 해당 채널에 추가됩니다.

이 기능의 config.json 설정은 ["announcement", "developers"] 와 같은 채널 이름으로 구성된 문자열 배열 입력이 있는 "ExperimentalDefaultChannels": [] 입니다.


실험적 작업 구성 설정#

plans-img 모든 플랜 에서 사용 가능

deployment-img 자체 호스팅 배포

데이터 보존이 활성화된 이전 게시물 삭제나 Elasticsearch를 사용한 게시물 인덱싱과 같은 주기적 작업을 Mattermost가 예약하고 완료하는 방법을 구성하는 설정입니다. 이러한 설정은 어떤 Mattermost 서버가 올바른 시간에 작업을 대기열에 넣는 스케줄러로 지정되고, 주어진 작업을 완료하는 워커로 지정되는지 제어합니다.

단일 머신에서 Mattermost를 실행할 때는 RunJobsRunScheduler 모두 활성화되어야 합니다. 이 두 가지가 모두 활성화되지 않으면 Mattermost가 제대로 작동하지 않습니다.

고가용성 모드에서 Mattermost를 실행할 때는 RunJobs 가 하나 이상의 서버에서 활성화되어야 하며, RunScheduler 는 일반적으로 모든 서버에서 활성화되어야 합니다. 고가용성 클러스터 기반 배포에는 하나의 스케줄러와 하나 이상의 워커가 있습니다. 자세한 내용은 아래 섹션을 참조하세요.

작업 실행#

이 설정은 시스템 콘솔에서 사용할 수 없으며 config.json 에서만 설정할 수 있습니다.

이 Mattermost 서버가 스케줄러가 생성한 작업을 처리할지 여부를 설정합니다. 단일 머신에서 Mattermost를 실행할 때는 이 설정이 항상 활성화되어야 합니다.

고가용성 모드 에서 Mattermost를 실행할 때는 하나 이상의 서버에서 이 설정이 활성화되어야 합니다. 고가용성 클러스터 기반 배포에서는 이 설정이 활성화된 하나 이상의 전용 워커를 두고 나머지 Mattermost 앱 서버에서는 비활성화하는 것을 권장합니다.

이 기능의 config.json 설정은 truefalse 옵션이 있는 "RunJobs": true 입니다.

스케줄러 실행#

이 설정은 시스템 콘솔에서 사용할 수 없으며 config.json 에서만 설정할 수 있습니다.

이 Mattermost 서버가 워커가 완료할 작업을 예약할지 여부를 설정합니다. 단일 머신에서 Mattermost를 실행할 때는 이 설정이 항상 활성화되어야 합니다.

고가용성 모드 에서 Mattermost를 실행할 때는 이 설정이 항상 활성화되어야 합니다. 고가용성 클러스터 기반 배포에서는 중복 작업이 생성되지 않도록 한 번에 정확히 하나의 서버만 스케줄러로 지정됩니다. 자세한 내용은 고가용성 문서 를 참조하세요.

경고

ClusterLeader 가 스케줄러를 실행할 수 없게 되므로 기본 설정인 true 에서 이 설정을 변경하지 않는 것을 강력히 권장합니다. 결과적으로 LDAP 동기화, 규정 준수 내보내기, 데이터 보존과 같은 반복 작업이 더 이상 예약되지 않습니다. 이전 Mattermost 서버 버전과 이 문서에서는 RunScheduler: false 로 작업 서버를 실행하도록 지시했지만, 클러스터 설계가 발전하여 더 이상 그렇지 않습니다.

이 기능의 config.json 설정은 truefalse 옵션이 있는 "RunScheduler": true 입니다.

이전 데이터베이스 작업 정리#

이 설정은 시스템 콘솔에서 사용할 수 없으며 config.json 에서만 설정할 수 있습니다.

이전에 완료된 데이터베이스 작업이 제거되는 일수 임계값을 정의합니다. 이 설정은 기본적으로 비활성화되어 있으며, 활성화하려면 0 보다 크거나 같은 값으로 설정해야 합니다.

이 기능의 config.json 설정은 숫자 입력이 있는 "JobSettings.CleanupJobsThresholdDays": -1 입니다.

오래된 데이터베이스 항목 정리#

이 설정은 데이터베이스의 구성에만 적용됩니다. 시스템 콘솔에서는 사용할 수 없으며 mmctl을 통해 설정하거나 데이터베이스에서 변경할 수 있습니다.

오래된 구성이 데이터베이스에서 제거되는 일수 임계값을 정의합니다.

이 기능의 config.json 설정은 숫자 입력이 있는 "JobSettings.CleanupConfigThresholdDays": 30 입니다.