실험적 구성 설정
Mattermost v12.0요약
제품 메뉴 → System Console → Experimental > Features를 선택하여 System Console에서 다음 실험적 구성 옵션을 검토하고 관리하세요: 셀프 호스팅 Mattermost를 관리하는 시스템 관리자는 아래 표에 설명된 대로 config.json 파일을 편집할 수 있습니다.
사용 가능 플랜: Entry, Professional, Enterprise, Enterprise Advanced
제품 
메뉴 → System Console → Experimental > Features를 선택하여 System Console에서 다음 실험적 구성 옵션을 검토하고 관리하세요:
셀프 호스팅 Mattermost를 관리하는 시스템 관리자는 아래 표에 설명된 대로 config.json 파일을 편집할 수 있습니다. 각 구성 값에는 JSON 인식 도구를 사용하여 프로그래밍 방식으로 config.json 파일에서 값에 접근할 수 있는 JSON 경로가 포함됩니다. 예를 들어, LinkMetadataTimeoutMilliseconds 값은 ExperimentalSettings 아래에 있습니다.
- jq와 같은 도구를 사용하는 경우:
cat config/config.json | jq '.ExperimentalSettings.LinkMetadataTimeoutMilliseconds' config.json파일을 수동으로 편집할 때는ExperimentalSettings와 같은 객체를 찾은 뒤 그 안에서LinkMetadataTimeoutMilliseconds키를 찾으세요.
실험적 System Console 구성 설정#
인증 방법 변경#
True: 사용자가 프로필 또는 API를 통해 서버에서 활성화된 모든 로그인 방법으로 변경할 수 있습니다.
False: 활성화된 인증 옵션에 관계없이 사용자가 로그인 방법을 변경할 수 없습니다.
이 기능의 config.json 설정은 "ExperimentalEnableAuthenticationTransfer": true이며 옵션은 true와 false입니다. |
링크 메타데이터 타임아웃#
링크 메타데이터를 반환하는 요청에 대한 구성 가능한 타임아웃을 추가합니다. 타임아웃이 만료되기 전에 메타데이터가 반환되지 않으면 메타데이터 없이 메시지가 게시됩니다. 이 타임아웃은 끊어진 URL과 느린 네트워크 연결에서의 잘못된 콘텐츠 유형 실패 케이스를 처리합니다.
이 기능의 config.json 설정은 "LinkMetadataTimeoutMilliseconds: 5000``이며 숫자 입력을 사용합니다. |
자동 답장 활성화#
True: 사용자가 Settings > Notifications에서 자동 답장을 활성화할 수 있습니다. 다이렉트 메시지에 자동으로 발송될 사용자 정의 메시지를 설정합니다.
False: 자동 다이렉트 메시지 답장 기능을 비활성화하고 설정에서 숨깁니다.
이 기능의 config.json 설정은 "ExperimentalEnableAutomaticReplies": false이며 옵션은 true와 false입니다. |
기본 채널 나가기/참여 시스템 메시지 활성화#
이 설정은 팀 나가기/참여 시스템 메시지가 기본 town-square 채널에 게시될지 여부를 결정합니다.
True: 기본 town-square 채널에 나가기/참여 시스템 메시지를 활성화합니다.
False: 기본 town-square 채널의 나가기/참여 메시지를 비활성화합니다. 시스템 메시지는 데이터베이스에도 추가되지 않습니다.
이 기능의 config.json 설정은 "ExperimentalEnableDefaultChannelLeaveJoinMessages": true이며 옵션은 true와 false입니다. |
모바일 워터마크 활성화#
Mattermost v11.7부터 Enterprise Advanced에서 사용할 수 있습니다.
True: 인증된 Mattermost 모바일 세션에 사용자명, 서버 도메인, 현재 날짜(YYYY-MM-DD), 현재 시간(HH:mm)을 표시하는 워터마크 오버레이가 표시됩니다. 이 실험적 기능은 모바일 스크린샷 또는 화면 공유 캡처와 관련된 사용자, 서버, 시간을 식별하는 데 도움을 주어 데이터 손실 방지(DLP) 워크플로를 지원하기 위한 것입니다.
False: Mattermost 모바일 앱에 워터마크 오버레이가 표시되지 않습니다.
- 이는 실험적 설정입니다. 동작, 기본값 및 시각적 표현은 향후 릴리즈에서 변경될 수 있습니다.
- 이 설정은 Mattermost 모바일 앱에만 적용됩니다. Mattermost 웹 앱이나 데스크톱 앱에는 워터마크가 추가되지 않습니다.
- 워터마크 오버레이는 시각적 보조 수단이며 그 자체로 스크린샷, 화면 녹화, 파일 내보내기 또는 기타 형태의 데이터 추출을 방지하지 않습니다. 필요한 경우 스크린샷 및 화면 녹화 방지와 같은 다른 모바일 보안 제어와 함께 사용하세요.
이 기능의 config.json 설정은 "ExperimentalSettings.EnableWatermark": false이며 옵션은 true와 false입니다. |
사용자 상태 및 프로필 조회 폴링 간격#
이 설정은 사용자 상태 및 프로필을 주기적으로 조회하는 사이의 대기 시간(밀리초)을 구성합니다. 비활성화하려면 0으로 설정하세요.
이 기능의 config.json 설정은 "ExperimentalSettings.UsersStatusAndProfileFetchingPollIntervalMilliseconds": 3000이며 숫자 입력을 사용합니다. |
이 구성 설정 값을 줄이면 Mattermost가 업데이트된 사용자 프로필 정보를 더 자주 확인하고 가져옵니다. 값을 줄이면 오래되거나 누락된 데이터로 인해 채널에서 사용자명이 Someone으로 표시되는 경우를 줄이는 데 도움이 됩니다.
기본 팀#
서버 사용자가 속하는 기본 팀입니다. 기본 팀이 설정되면 다른 팀에 참여하거나 기본 팀에서 나가는 옵션이 비활성화됩니다.
기본 팀의 URL이 https://example.mattermost.com/myteam/인 경우, config.json에서 값을 myteam으로 설정하세요.
이 기능의 config.json 설정은 "ExperimentalPrimaryTeam": ""이며 문자열 입력을 사용합니다. |
브라우저 포커스 복귀 시 데이터 재조회 비활성화#
이 설정은 브라우저 포커스 복귀 시 채널 및 채널 멤버를 다시 조회하는 기능을 비활성화합니다.
True: 브라우저가 포커스를 다시 받을 때 Mattermost가 채널 및 채널 멤버를 재조회하지 않습니다. 채널 및 멤버가 많은 사용자의 성능이 향상될 수 있습니다.
False: (기본값) 브라우저가 포커스를 다시 받을 때 Mattermost가 채널 및 채널 멤버를 재조회합니다.
이 기능의 config.json 설정은 "ExperimentalSettings.DisableRefetchingOnBrowserFocus": false이며 옵션은 true와 false입니다. |
절전 모드 해제 재연결 핸들러 비활성화#
이 설정은 컴퓨터 절전 모드 해제 감지 및 데이터 재조회 시도를 비활성화합니다.
True: Mattermost가 컴퓨터 절전 모드 해제를 감지하거나 데이터를 재조회하려 하지 않습니다. 앱이 전송하는 일반적인 네트워크 트래픽을 줄일 수 있습니다.
False: (기본값) Mattermost가 컴퓨터 절전 모드 해제를 감지하고 데이터를 새로 고칩니다.
이 기능의 config.json 설정은 "ExperimentalSettings.DisableWakeUpReconnectHandler": false이며 옵션은 true와 false입니다. |
채널 자동 완성 지연#
이 설정은 메시지 작성 중 물결표(~) 입력 시 채널 링크 자동 완성이 즉시 실행될지 여부를 제어합니다. 이 설정은 문장 부호로 물결표 ~를 사용하는 사람들에게 ~town-square와 같은 채널 자동 완성을 덜 방해적으로 만듭니다.
True: 사용자가 물결표 다음에 두 글자 이상을 입력하면 자동 완성이 나타납니다. 예: ~to를 입력하면 자동 완성이 표시되지만 ~만 입력하면 표시되지 않습니다.
False: (기본값) 사용자가 물결표를 입력하면 즉시 자동 완성이 나타납니다. 예: ~를 입력하면 자동 완성이 표시됩니다.
이 기능의 config.json 설정은 "ExperimentalSettings.DelayChannelAutocomplete": false이며 옵션은 true와 false입니다. |
YouTube 참조 정책#
이 설정은 YouTube 동영상 미리보기가 사용 불가로 표시되는 문제를 해결합니다.
True: 임베드된 YouTube 동영상의 참조 정책이 strict-origin-when-cross-origin으로 설정됩니다.
False: (기본값) 참조 정책이 no-referrer로 설정되어 소스 URL을 공개하지 않아 사용자 개인 정보를 보호하지만, 분석 도구에서 사용자 참여 및 트래픽 소스 추적 기능이 제한됩니다.
이 기능의 config.json 설정은 "ExperimentalSettings.YoutubeReferrerPolicy": false이며 옵션은 true와 false입니다. |
실험적 Bleve 구성 설정#
사용 가능 플랜: Entry, Professional, Enterprise, Enterprise Advanced
Mattermost v11부터 Bleve 검색이 더 이상 사용되지 않습니다. 이 구성 설정들은 v11.0 이전 Mattermost 버전에서만 사용할 수 있습니다. v11.0 이상에서는 엔터프라이즈 검색 기능을 위해 Elasticsearch 또는 OpenSearch를 사용하세요.
System Console에서 Experimental > Bleve로 이동하거나 아래 표에 설명된 대로 config.json 파일을 편집하여 다음 구성 설정에 접근할 수 있습니다:
Bleve 인덱싱 활성화#
True: 새 게시물이 자동으로 인덱싱됩니다. 검색 쿼리에 Bleve 활성화가 활성화될 때까지 검색 쿼리에 Bleve 검색이 사용되지 않습니다.
False: 새 게시물이 자동으로 인덱싱되지 않습니다.
이 기능의 config.json 설정은 "EnableIndexing": false이며 옵션은 true와 false입니다. |
인덱스 디렉터리#
Bleve 인덱스를 저장하는 데 사용할 디렉터리 경로입니다.
Bleve 인덱스 디렉터리 경로는 반드시 mattermost 디렉터리 내에 있을 필요는 없습니다. mattermost 디렉터리 외부에 있는 경우, Mattermost 업그레이드 시 이 파일들을 보존하거나 재인덱싱하기 위한 추가 단계가 필요하지 않습니다. 자세한 내용은 Mattermost 서버 업그레이드 문서를 참조하세요.
이 기능의 config.json 설정은 "IndexDir": ""이며 문자열 입력을 사용합니다. |
즉시 대량 인덱싱#
지금 인덱싱을 선택하여 데이터베이스의 모든 사용자, 채널 및 게시물을 오래된 것부터 최신 순으로 인덱싱합니다. 인덱싱 중에도 Bleve를 사용할 수 있지만, 인덱싱 작업이 완료될 때까지 검색 결과가 불완전할 수 있습니다.
인덱스 삭제#
인덱스 삭제를 선택하여 Bleve 인덱스 디렉터리의 내용을 제거합니다. 기존 데이터베이스의 대량 인덱스가 재구성될 때까지 검색 결과가 불완전할 수 있습니다.
검색 쿼리에 Bleve 활성화#
True: 검색 쿼리에 Bleve 검색이 사용됩니다.
False: 검색 쿼리에 Bleve 검색이 사용되지 않습니다.
이 기능의 config.json 설정은 "EnableSearching": false이며 옵션은 true와 false입니다. |
자동 완성 쿼리에 Bleve 활성화#
True: 자동 완성 쿼리에 Bleve 검색이 사용됩니다.
False: 자동 완성 쿼리에 Bleve 검색이 사용되지 않습니다.
이 기능의 config.json 설정은 "EnableAutocomplete": false이며 옵션은 true와 false입니다. |
셀프 호스팅 배포 전용 실험적 구성 설정#
다음 셀프 호스팅 구성 설정은 아래 표에 설명된 대로 config.json 파일을 편집하여 접근합니다. 이 구성 설정은 System Console을 통해 접근할 수 없습니다.
각 구성 값에는 JSON 인식 도구를 사용하여 프로그래밍 방식으로 config.json 파일에서 값에 접근할 수 있는 JSON 경로가 포함됩니다. 예를 들어, SiteURL 값은 ServiceSettings 아래에 있습니다.
- jq와 같은 도구를 사용하는 경우:
cat config/config.json | jq '.ServiceSettings.SiteURL' config.json파일을 수동으로 편집할 때는ServiceSettings키를 찾은 뒤 그 객체 안에서SiteURL키를 찾으세요.
파일 위치#
사용 가능 플랜: Enterprise, Enterprise Advanced
이 설정은 System Console에서 사용할 수 없으며 config.json에서만 설정할 수 있습니다.
컴플라이언스 내보내기의 파일 위치를 설정합니다. 기본적으로 구성된 로컬 스토리지 디렉터리의 exports 하위 디렉터리에 기록됩니다.
이 기능의 config.json 설정은 "FileLocation": "export"이며 문자열 입력을 사용합니다. |
푸시 알림 버퍼#
이 설정은 System Console에서 사용할 수 없으며 config.json 에서만 설정할 수 있습니다.
전송 대기 중인 푸시 알림 메시지의 버퍼를 제어하는 데 사용됩니다. 메시지 수가 해당 수를 초과하면 여유 공간이 생길 때까지 푸시 알림을 만드는 요청이 차단됩니다.
이 기능의 config.json 설정은 "PushNotificationBuffer": 1000" 이며 숫자 입력을 사용합니다. |
시스템 관리자 제한#
이 설정은 System Console에서 사용할 수 없으며 config.json 에서만 설정할 수 있습니다.
True: (Cloud 배포의 기본값) 시스템 관리자가 System Console에서 서버 구성 설정의 일부를 보거나 수정하는 것을 제한합니다. 온프레미스 설치에는 권장하지 않습니다. 이는 사용자에게 시스템 관리자 역할을 부여하되 특정 작업을 Cloud 관리자만 수행할 수 있도록 Mattermost Private Cloud를 지원하기 위한 설정입니다.
False: (셀프 호스팅 배포의 기본값) 시스템 관리자 역할에 제한이 적용되지 않습니다.
이 기능의 config.json 설정은 "RestrictSystemAdmin": "false" 이며 옵션은 true 와 false 입니다. |
서버 구성 설정의 일부를 보거나 수정하는 것을 시스템 관리자에게 제한하는 기능은 현재 베타 상태입니다.
클라이언트 측 인증서 인증 활성화#
사용 가능 플랜: Enterprise, Enterprise Advanced
인증서 기반 인증은 Mattermost v11.0부터 더 이상 사용되지 않습니다. v11부터 서버를 시작하려면 이 설정을 false 로 설정해야 합니다. true 로 설정하면 서버가 시작되지 않습니다.
True: Mattermost 서버에 대한 클라이언트 측 인증서 인증을 활성화합니다. 자세한 내용은 문서를 참조하세요.
False: (기본값) 클라이언트 측 인증서 인증이 비활성화됩니다.
이 기능의 config.json 설정은 "ClientSideCertEnable": false 이며 옵션은 true 와 false 입니다. |
클라이언트 측 인증서 로그인 방법#
사용 가능 플랜: Enterprise, Enterprise Advanced
인증서 기반 인증은 Mattermost v11.0부터 더 이상 사용되지 않습니다. 이 설정은 Mattermost v11.0부터 더 이상 작동하지 않으며 기본값을 유지해야 합니다.
이 구성 설정은 ClientSideCertEnable 구성 설정과 함께 사용되며 다음과 같은 값을 가질 수 있습니다:
기본: 클라이언트 측 인증서가 확인된 후 인증서에서 사용자의 이메일이 검색되어 비밀번호 없이 로그인하는 데 사용됩니다.
Secondary: (기본값) 클라이언트 측 인증서가 확인된 후 인증서에서 사용자의 이메일이 검색되어 사용자가 제공한 이메일과 비교됩니다. 일치하면 사용자가 일반 이메일/비밀번호 자격 증명으로 로그인합니다.
이 기능의 config.json 설정은 "ClientSideCertCheck": "secondary" 이며 옵션은 "primary" 와 "secondary" 입니다. |
내보내기 출력 디렉터리#
이 설정은 System Console에서 사용할 수 없으며 config.json 에서만 설정할 수 있습니다.
내보낸 파일이 저장되는 디렉터리입니다. 경로는 FileSettings 디렉터리를 기준으로 상대 경로입니다. 기본적으로 내보내기는 ./data/export 에 저장됩니다.
이 기능의 config.json 설정은 ExportSettings 섹션 아래의 Directory: ./export 이며 문자열 입력을 사용합니다. |
내보내기 보존 기간(일)#
이 설정은 System Console에서 사용할 수 없으며 config.json 에서만 설정할 수 있습니다.
내보낸 파일을 삭제하기 전까지 보존하는 일수입니다.
이 기능의 config.json 설정은 ExportSettings 섹션 아래의 RetentionDays: 30 이며 숫자 입력을 사용합니다. |
최대 이미지 해상도#
이 설정은 System Console에서 사용할 수 없으며 config.json 에서만 설정할 수 있습니다.
메시지 첨부 파일의 최대 이미지 해상도(픽셀)입니다.
이 기능의 config.json 설정은 "MaxImageResolution": 33177600 이며 숫자 입력을 사용합니다. |
최대 이미지 디코더 동시성#
이 설정은 System Console에서 사용할 수 없으며 config.json 에서만 설정할 수 있습니다.
동시에 디코딩할 수 있는 이미지 수를 나타냅니다. 기본값 -1 은 Mattermost가 현재 CPU 수를 자동으로 사용하도록 구성합니다.
- 이 구성 설정은 서버의 총 메모리 소비에 영향을 줍니다. 단일 이미지의 최대 메모리는
MaxImageResolution * 24 bytes로 결정되며, 기본 최대 이미지 해상도 값은 33MB입니다. - 따라서
33MB * MaxImageDecoderConcurrency * 24가 서버의 총 메모리보다 작아야 한다는 것이 좋은 경험 법칙입니다. - 예를 들어, 4코어 서버의 경우 이미지 처리를 위해 최소
33 * 4 * 24 = 3168MB의 메모리를 남겨두어야 합니다. 그렇지 않으면 MaxImageResolution 구성 설정을 조정하여 이미지 처리에 필요한 메모리 양을 조절하세요.
이 기능의 config.json 설정은 "MaxImageDecoderConcurrency": "-1" 이며 숫자 입력을 사용합니다. |
초기 폰트#
이 설정은 System Console에서 사용할 수 없으며 config.json 에서만 설정할 수 있습니다.
색상 배경의 자동 생성 프로필 사진에 사용되는 폰트입니다.
이 기능의 config.json 설정은 "InitialFont": "luximbi.ttf" 이며 문자열 입력을 사용합니다. |
Amazon S3 서명 v2#
이 설정은 System Console에서 사용할 수 없으며 config.json 에서만 설정할 수 있습니다.
기본적으로 Mattermost는 AWS에 대한 API 호출에 서명하기 위해 Signature V4를 사용하지만, 특정 상황에서는 V2가 필요합니다. V2를 사용해야 하는 경우에 대한 자세한 내용은 https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_sigv.html 을 참조하세요.
True: 서명 버전 2 서명 프로세스를 사용합니다.
False: 서명 버전 4 서명 프로세스를 사용합니다.
이 기능의 config.json 설정은 "AmazonS3SignV2": false 이며 옵션은 true 와 false 입니다. |
Amazon S3 경로#
이 설정은 System Console에서 사용할 수 없으며 config.json 에서만 설정할 수 있습니다.
여러 배포에서 동일한 S3 버킷을 사용할 수 있습니다.
이 기능의 config.json 설정은 "AmazonS3PathPrefix: "" 이며 문자열 입력을 사용합니다. |
GitLab 범위#
이 설정은 System Console에서 사용할 수 없으며 config.json 에서만 설정할 수 있습니다.
OAuth 클라이언트와 공유되는 정보의 범위를 결정하는 OAuth 표준 설정입니다. 현재 GitLab OAuth에서는 지원되지 않습니다.
이 기능의 config.json 설정은 "Scope": "" 이며 문자열 입력을 사용합니다. |
Global Relay SMTP 서버 타임아웃#
사용 가능 플랜: Enterprise, Enterprise Advanced
이 설정은 System Console에서 사용할 수 없으며 config.json 에서만 설정할 수 있습니다.
SMTP 서버에 대한 연결 시도가 중단되기까지 경과할 수 있는 시간(초)입니다. 기본값은 1800초입니다. 이 설정은 현재 System Console에서 사용할 수 없으며 config.json 에서만 설정할 수 있습니다.
이 기능의 config.json 설정은 "GlobalRelaySettings.SMTPServerTimeout": "1800" 이며 숫자 입력을 사용합니다. |
Google 범위#
이 설정은 System Console에서 사용할 수 없으며 config.json 에서만 설정할 수 있습니다.
OAuth 클라이언트와 공유되는 정보의 범위를 결정하는 OAuth 표준 설정입니다. 권장 설정은 profile email 입니다.
이 기능의 config.json 설정은 "Scope": "profile email" 이며 문자열 입력을 사용합니다. |
가져오기 입력 디렉터리#
이 설정은 System Console에서 사용할 수 없으며 config.json 에서만 설정할 수 있습니다.
가져온 파일이 저장되는 디렉터리입니다. 경로는 FileSettings 디렉터리를 기준으로 상대 경로입니다. 기본적으로 가져오기는 ./data/import 에 저장됩니다.
이 기능의 config.json 설정은 ImportSettings 섹션 아래의 Directory: ./import 이며 문자열 입력을 사용합니다. |
가져오기 보존 기간(일)#
이 설정은 System Console에서 사용할 수 없으며 config.json 에서만 설정할 수 있습니다.
가져온 파일을 삭제하기 전까지 보존하는 일수입니다.
이 기능의 config.json 설정은 ImportSettings 섹션 아래의 RetentionDays: 30 이며 숫자 입력을 사용합니다. |
타임스탬프부터 내보내기#
사용 가능 플랜: Enterprise, Enterprise Advanced
이 설정은 System Console에서 사용할 수 없으며 config.json 에서만 설정할 수 있습니다.
데이터를 내보낼 Unix 타임스탬프(에포크 이후 초, UTC)를 설정합니다.
이 기능의 config.json 설정은 "ExportFromTimestamp": 0 이며 숫자 입력을 사용합니다. |
Entra ID 범위#
이 설정은 System Console에서 사용할 수 없으며 config.json 에서만 설정할 수 있습니다.
OAuth 클라이언트와 공유되는 정보의 범위를 결정하는 OAuth 표준 설정입니다. 권장 설정은 User.Read 입니다.
이 기능의 config.json 설정은 "Scope": "User.Read" 이며 문자열 입력을 사용합니다. |
플러그인 업로드 활성화#
이 설정은 System Console에서 사용할 수 없으며 config.json 에서만 설정할 수 있습니다.
True: 시스템 관리자가 플러그인 > 관리에서 플러그인을 업로드할 수 있습니다. 플러그인을 업로드할 계획이 없는 경우 false 로 설정하여 서버에 설치되는 플러그인을 제어하세요. 자세한 내용은 문서를 참조하세요.
False: Mattermost 서버에서 플러그인 업로드가 비활성화됩니다.
이 기능의 config.json 설정은 "EnableUploads": false 이며 옵션은 true 와 false 입니다. |
비보안 다운로드 URL 허용#
이 설정은 System Console에서 사용할 수 없으며 config.json 에서만 설정할 수 있습니다.
True: 원격 URL에서 플러그인을 다운로드하고 설치할 수 있습니다.
False: 원격 URL에서 플러그인 다운로드 및 설치가 비활성화됩니다.
이 기능의 config.json 설정은 "AllowInsecureDownloadUrl": false 이며 옵션은 true 와 false 입니다. |
플러그인 상태 확인 활성화#
이 설정은 System Console에서 사용할 수 없으며 config.json 에서만 설정할 수 있습니다.
True: 모든 플러그인이 주기적으로 모니터링되고 상태에 따라 재시작되거나 비활성화되도록 플러그인 상태 확인을 활성화합니다. 상태 확인은 30초마다 실행됩니다. 플러그인이 한 시간 내에 3번 실패하면 Mattermost 서버가 재시작을 시도합니다. 재시작이 연속 3번 실패하면 자동으로 비활성화됩니다.
False: Mattermost 서버에서 플러그인 상태 확인이 비활성화됩니다.
이 기능의 config.json 설정은 "EnableHealthCheck": true 이며 옵션은 true 와 false 입니다. |
플러그인 디렉터리#
이 설정은 System Console에서 사용할 수 없으며 config.json 에서만 설정할 수 있습니다.
플러그인 파일의 위치입니다. 비어 있으면 ./plugins 디렉터리에 저장됩니다. 설정한 경로가 존재해야 하며 Mattermost에 쓰기 권한이 있어야 합니다.
이 기능의 config.json 설정은 "Directory": "./plugins" 이며 문자열 입력을 사용합니다. |
클라이언트 플러그인 디렉터리#
이 설정은 System Console에서 사용할 수 없으며 config.json 에서만 설정할 수 있습니다.
클라이언트 플러그인 파일의 위치입니다. 비어 있으면 ./client/plugins 디렉터리에 저장됩니다. 설정한 경로가 존재해야 하며 Mattermost에 쓰기 권한이 있어야 합니다.
이 기능의 config.json 설정은 "ClientDirectory": "./client/plugins" 이며 문자열 입력을 사용합니다. |
범위 지정 IDP 공급자 ID#
이 설정은 System Console에서 사용할 수 없으며 config.json 에서만 설정할 수 있습니다.
인증된 사용자가 페더레이션된 Azure AD 서버의 초기 로그인 페이지를 건너뛰고 비밀번호만으로 로그인할 수 있습니다.
이 기능의 config.json 설정은 "ScopingIDPProviderId": "" 이며 문자열 입력을 사용합니다. |
범위 지정 IDP 공급자 이름#
이 설정은 System Console에서 사용할 수 없으며 config.json 에서만 설정할 수 있습니다.
사용자의 범위 지정 ID 공급자 ID와 연관된 이름을 추가합니다.
이 기능의 config.json 설정은 "ScopingIDPName": "" 이며 문자열 입력을 사용합니다. |
읽지 않은 채널 그룹화#
이 설정은 System Console에서 사용할 수 없으며 config.json 에서만 설정할 수 있습니다.
이 설정은 새 사이드바에만 적용됩니다. System Console에서 이 기능을 보거나 활성화하려면 레거시 사이드바 활성화 구성 설정을 비활성화해야 합니다.
기본값 꺼짐: 기본적으로 모든 사용자의 읽지 않은 채널 사이드바 섹션을 비활성화합니다. 사용자는 설정 > 사이드바 > 읽지 않은 채널 별도로 그룹화에서 활성화할 수 있습니다.
기본값 켜짐: 기본적으로 모든 사용자의 읽지 않은 채널 사이드바 섹션을 활성화합니다. 사용자는 설정 > 사이드바 > 읽지 않은 채널 별도로 그룹화에서 비활성화할 수 있습니다.
이 기능의 config.json 설정은 "ExperimentalGroupUnreadChannels": "default_off" 이며 옵션은 "default_off" 와 "default_on" 입니다. |
채널 카테고리 정렬 활성화#
Mattermost v10.10부터 이 실험적 기능이 활성화되면 사용자가 채널을 만들거나 이름을 바꿀 때 새 채널 카테고리 또는 기존 채널 카테고리에 채널을 할당할 수 있습니다.
이 구성 설정은 클라우드 기반 배포에만 적용됩니다.
True: 사용자가 채널을 만들거나 이름을 바꿀 때 새 채널 카테고리 또는 기존 채널 카테고리에 채널을 할당할 수 있습니다.
False: (기본값) 채널을 새 카테고리 또는 기존 카테고리에 자동으로 할당하는 기능을 비활성화합니다.
이 기능의 config.json 설정은 "ExperimentalEnableChannelCategorySorting": false 이며 옵션은 true 와 false 입니다. |
엄격한 CSRF 토큰 적용#
이 설정은 System Console에서 사용할 수 없으며 config.json 에서만 설정할 수 있습니다.
True: 현재 사용되는 사용자 정의 헤더에 비해 추가적인 강화를 위한 CSRF 보호 토큰을 활성화합니다. 사용자가 로그인하면 CSRF 토큰이 포함된 추가 쿠키가 생성됩니다.
False: CSRF 보호 토큰을 비활성화하고 하위 호환성을 위해 레거시 X-Requested-With 헤더 폴백을 활성화합니다.
이 기능의 config.json 설정은 "ExperimentalStrictCSRFEnforcement": false 이며 옵션은 true 와 false 입니다. |
개발자 플래그#
이 설정은 System Console에서 사용할 수 없으며 config.json 에서만 설정할 수 있습니다.
이 구성 설정은 Mattermost 웹 앱의 콘텐츠 보안 정책(CSP)을 설정하는 데 사용되는 플래그 문자열 목록을 지정합니다. 각 플래그는 flag=true 형식(예: unsafe-eval=true,unsafe-inline=true)이어야 합니다. 프로덕션 환경에서는 권장하지 않습니다.
현재 지원되는 값:
unsafe-eval: 루트 웹 앱에unsafe-evalCSP 지시문을 추가하여 개발자 환경에서 더 많은 디버깅을 허용합니다.unsafe-inline: 루트 웹 앱에unsafe-inlineCSP 지시문을 추가하여 개발자 환경에서 더 많은 디버깅을 허용합니다.
이 구성 설정은 기본적으로 비활성화되어 있으며 개발자 모드가 활성화되어야 합니다.
이 기능의 config.json 설정은 "DeveloperFlags": "" 이며 문자열 입력을 사용합니다. |
게시물 검색 활성화#
이 설정은 System Console에서 사용할 수 없으며 config.json 에서만 설정할 수 있습니다.
이 설정이 활성화되면 사용자가 Mattermost 인스턴스에서 메시지를 검색할 수 있습니다.
이 기능의 config.json 설정은 "EnablePostSearch": true 이며 옵션은 true 와 false 입니다. |
대규모 배포 환경에서 이 실험적 구성 설정을 비활성화하면 다음 영역에서 서버 성능이 향상될 수 있습니다:
- 데이터베이스 부하 감소: 게시물 검색이 활성화되면 모든 검색 쿼리가 데이터베이스에 추가 부하를 줍니다. 검색을 비활성화하면 이러한 쿼리가 줄어들어 데이터베이스 성능이 향상되고 다른 작업의 응답 시간이 단축됩니다.
- 메모리 사용량 감소: 검색 기능은 종종 메모리를 소비하는 게시물 인덱싱이 필요합니다. 검색을 비활성화하면 이 인덱스 유지에 필요한 메모리가 다른 용도로 사용될 수 있어 전체 시스템 성능이 향상됩니다.
- 빠른 쓰기 작업: 게시물 검색이 활성화되면 새 게시물, 편집 또는 삭제 시마다 인덱싱을 업데이트해야 합니다. 검색을 비활성화하면 이러한 오버헤드를 피할 수 있어 쓰기 작업이 더 빨라집니다.
- 성능 일관성: 검색 기능이 없으면 애플리케이션이 잠재적 성능 병목 현상을 피하고, 특히 게시물 수가 많은 고부하 시나리오에서 더 일관된 성능 수준을 유지할 수 있습니다.
- 시스템 유지 관리 간소화: 검색 인덱스 관리는 복잡하고 리소스 집약적일 수 있습니다. 검색을 비활성화하면 이 측면의 시스템 유지 관리가 간소화되어 검색 인덱스 손상이나 성능 저하와 관련된 성능 문제의 위험이 줄어들 수 있습니다.
- 단, Mattermost에서 메시지를 검색하는 기능은 많은 사용자에게 중요한 기능이며, 이 기능을 비활성화하면 사용자가 Mattermost 검색 상자를 사용하려 할 때 오류가 표시됩니다. 성능 향상과 조직 및 사용자의 요구 사항 사이에서 균형을 맞추는 것이 중요합니다.
사용자 상태 업데이트 활성화#
이 설정은 System Console에서 사용할 수 없으며 config.json 에서만 설정할 수 있습니다.
성능 향상을 위해 상태 업데이트를 끕니다. 상태 업데이트가 꺼지면 사용자는 메시지를 게시하는 짧은 시간 동안만, 그리고 메시지가 게시된 채널의 멤버들에게만 온라인으로 표시됩니다.
이 기능의 config.json 설정은 "EnableUserStatuses": true 이며 옵션은 true 와 false 입니다. |
WebSocket 보안 포트#
이 설정은 System Console에서 사용할 수 없으며 config.json 에서만 설정할 수 있습니다. 이 설정을 변경하면 서버를 재시작해야 적용됩니다.
(선택 사항) 이 설정은 wss 프로토콜을 사용하는 보안 WebSocket이 수신하는 포트를 정의합니다. 기본값은 443 입니다. 클라이언트가 WebSocket 연결을 시도할 때 먼저 페이지가 HTTPS로 로드되었는지 확인합니다. HTTPS이면 보안 WebSocket 연결을 사용하고, 그렇지 않으면 비보안 WebSocket 연결을 사용합니다. 프로덕션 배포는 HTTPS와 WSS에서만 운영하는 것을 강력히 권장합니다.
이 기능의 config.json 설정은 "WebsocketSecurePort": 443 이며 숫자 입력을 사용합니다. |
이는 클라이언트 전용 재정의이며 웹 서버 수신 주소 설정에 의해 제어되는 서버 프로세스의 수신 포트에 영향을 주지 않습니다.
WebSocket 포트#
이 설정은 System Console에서 사용할 수 없으며 config.json 에서만 설정할 수 있습니다. 이 설정을 변경하면 서버를 재시작해야 적용됩니다.
(선택 사항) 이 설정은 ws 프로토콜을 사용하는 비보안 WebSocket이 수신하는 포트를 정의합니다. 기본값은 80 입니다. 클라이언트가 WebSocket 연결을 시도할 때 먼저 페이지가 HTTPS로 로드되었는지 확인합니다. HTTPS이면 보안 WebSocket 연결을 사용하고, 그렇지 않으면 비보안 WebSocket 연결을 사용합니다. 프로덕션 배포는 HTTPS와 WSS에서만 운영하는 것을 강력히 권장합니다.
이 기능의 config.json 설정은 WebsocketPort": 80 이며 숫자 입력을 사용합니다. |
이는 클라이언트 전용 재정의이며 웹 서버 수신 주소 설정에 의해 제어되는 서버 프로세스의 수신 포트에 영향을 주지 않습니다.
mmctl 로컬 모드 활성화#
이 셀프 호스팅 배포 설정은 System Console에서 사용할 수 없으며 config.json 에서만 설정할 수 있습니다.
True: mmctl의 로컬 모드를 활성화합니다.
False: mmctl의 로컬 모드를 방지합니다.
이 기능의 config.json 설정은 "EnableLocalMode": false 이며 옵션은 true 와 false 입니다. |
mmctl에서 로컬 모드를 사용하려면 서버와 mmctl을 실행할 때 동일한 사용자를 사용하거나, 다른 사용자로 전환하기 전에 소켓 파일을 정리하세요. socket file "/var/tmp/mattermost_local.socket" doesn't exists, please check the server configuration for local mode 와 같은 오류가 발생하면 이 구성 설정을 true 로 설정하여 해결할 수 있습니다.
mmctl 로컬 모드 소켓 위치 활성화#
이 셀프 호스팅 배포 설정은 System Console에서 사용할 수 없으며 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" 이며 문자열 입력을 사용합니다. |
기본 채널#
이 설정은 System Console에서 사용할 수 없으며 config.json 에서만 설정할 수 있습니다.
새 팀에 참여한 후 모든 사용자가 자동으로 추가되는 기본 채널입니다. 공개 채널에만 적용되지만 서버의 모든 팀에 영향을 줍니다.
설정하지 않으면 모든 사용자가 기본적으로 town-square 채널에 추가됩니다.
town-square 가 목록에 없더라도 새 팀에 참여할 때 모든 사용자가 해당 채널에 자동으로 추가됩니다.
이 기능의 config.json 설정은 "ExperimentalDefaultChannels": [] 이며 ["announcement", "developers"] 와 같은 채널 이름으로 구성된 문자열 배열 입력을 사용합니다. |
실험적 작업 구성 설정#
셀프 호스팅 배포에서 데이터 보존이 활성화된 경우 오래된 게시물 삭제나 Elasticsearch를 통한 게시물 인덱싱 같은 주기적 작업을 Mattermost가 예약하고 완료하는 방식을 구성할 수 있습니다. 이 설정은 작업을 올바른 시간에 대기열에 넣는 서버인 스케줄러와 주어진 작업을 완료하는 서버인 워커로 지정되는 Mattermost 서버를 제어합니다.
단일 머신에서 Mattermost를 실행할 때는 RunJobs 와 RunScheduler 모두 활성화해야 합니다. 두 설정이 모두 활성화되지 않으면 Mattermost가 제대로 작동하지 않습니다.
고가용성(HA) 모드에서 Mattermost를 실행할 때는 일반적으로 하나 이상의 서버에서 RunJobs 를, 모든 서버에서 RunScheduler 를 활성화해야 합니다. 고가용성 클러스터 기반 배포에는 하나의 스케줄러와 하나 이상의 워커가 있습니다. 자세한 내용은 아래 섹션을 참조하세요.
작업 실행#
이 설정은 System Console에서 사용할 수 없으며 config.json 에서만 설정할 수 있습니다.
이 Mattermost 서버가 스케줄러가 생성한 작업을 처리할지 여부를 설정합니다. 단일 머신에서 Mattermost를 실행할 때는 항상 이 설정을 활성화해야 합니다.
고가용성 모드에서 Mattermost를 실행할 때는 하나 이상의 서버에서 이 설정을 활성화해야 합니다. 고가용성 클러스터 기반 배포에서는 이 설정이 활성화된 전용 워커 서버를 하나 이상 두고, 나머지 Mattermost 앱 서버에서는 비활성화하는 것을 권장합니다.
이 기능의 config.json 설정은 "RunJobs": true 이며 옵션은 true 와 false 입니다. |
스케줄러 실행#
이 설정은 System Console에서 사용할 수 없으며 config.json 에서만 설정할 수 있습니다.
이 Mattermost 서버가 워커에 의해 완료될 작업을 예약할지 여부를 설정합니다. 단일 머신에서 Mattermost를 실행할 때는 항상 이 설정을 활성화해야 합니다.
고가용성 모드에서 Mattermost를 실행할 때는 항상 이 설정을 활성화해야 합니다. 고가용성 클러스터 기반 배포에서는 중복 작업이 생성되지 않도록 한 번에 정확히 하나의 서버만 스케줄러로 지정됩니다. 자세한 내용은 고가용성 문서를 참조하세요.
이 설정을 기본값인 true 에서 변경하지 않는 것을 강력히 권장합니다. 변경하면 ClusterLeader 가 스케줄러를 실행할 수 없게 됩니다. 그 결과, LDAP 동기화, 컴플라이언스 내보내기, 데이터 보존 같은 반복 작업이 더 이상 예약되지 않습니다. 이전 Mattermost Server 버전과 이 문서에서는 작업 서버를 RunScheduler: false 로 실행하라고 안내했지만, 클러스터 설계가 발전하여 더 이상 그렇지 않습니다.
Mattermost v11.4부터 클러스터에서 특정 반복 작업(예약된 게시물, 게시물 알림, 방해 금지 상태 재설정)이 올바르게 실행되는지 확인하는 데 도움이 되는 디버그 수준 로그 메시지를 사용할 수 있습니다. 리더가 아닌 노드는 이러한 반복 작업 실행을 건너뛸 때 로그 메시지를 기록하여 리더 선출이 예상대로 작동하고 있음을 확인합니다. 이 디버그 메시지는 Elasticsearch 인덱싱, SAML 동기화, LDAP 동기화 같은 다른 작업 유형에는 적용되지 않습니다. 자세한 내용은 클러스터 작업 실행 디버그 메시지를 참조하세요.
이 기능의 config.json 설정은 "RunScheduler": true 이며 옵션은 true 와 false 입니다. |
오래된 데이터베이스 작업 정리#
이 설정은 System Console에서 사용할 수 없으며 config.json 에서만 설정할 수 있습니다.
완료된 오래된 데이터베이스 작업이 제거되는 임계값(일)을 정의합니다. 이 설정은 기본적으로 비활성화되어 있으며 활성화하려면 0 이상의 값으로 설정해야 합니다.
이 기능의 config.json 설정은 "JobSettings.CleanupJobsThresholdDays": -1 이며 숫자 입력을 사용합니다. |
오래된 데이터베이스 항목 정리#
이 설정은 데이터베이스의 구성에만 적용됩니다. System Console에서 사용할 수 없으며 mmctl을 통해 설정하거나 데이터베이스에서 직접 변경할 수 있습니다.
오래된 구성이 데이터베이스에서 제거되는 임계값(일)을 정의합니다.
이 기능의 config.json 설정은 "JobSettings.CleanupConfigThresholdDays": 30 이며 숫자 입력을 사용합니다. |