::orphan: :nosearch:

‘System Console > Environment > File Storage’ 로 이동하여 또는 다음 표에 설명된대로 config.json 파일을 편집하여 파일 저장 설정을 구성합니다.

Mattermost Academy Learn about file storage

Note

Mattermost는 현재 로컬 파일 시스템 및 Amazon S3 또는 호환되는 S3에 파일을 저장하는 것을 지원합니다. Mattermost는 MinIO 및 Digital Ocean Spaces 제품과 테스트되었으나 시장에서 모든 호환되는 S3 컨테이너를 테스트한 것은 아닙니다. 기타 호환되는 S3 컨테이너를 사용하려면 직접 테스트를 완료하는 것을 권장합니다.

파일 저장 시스템

이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.

사용되는 파일 저장 시스템의 유형입니다. 로컬 파일 시스템 또는 Amazon S3일 수 있습니다.

  • local : (기본값) 파일 및 이미지는 지정된 로컬 파일 디렉터리에 저장됩니다.

  • amazons3 : 제공된 액세스 키, 버킷 및 지역 필드에 기반하여 파일 및 이미지가 Amazon S3에 저장됩니다. 이 드라이버는 MinIO (베타) 및 Digital Ocean Spaces와 호환됩니다.

  • 시스템 구성 경로: 환경 > 파일 저장

  • config.json 설정: ".FileSettin gs.DriverName: local”,

  • 환경 변수: MM_FILESETTINGS_DRIVERNAME

로컬 저장소 디렉터리

이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.

파일 저장 시스템 이 로컬 로 설정된 경우 파일이 쓰여지는 로컬 디렉터리입니다. Mattermost가 실행 중인 사용자가 쓰기 가능한 어떤 디렉터리든 관계없으며 Mattermost가 설치된 디렉터리를 기준으로 상대적입니다.

기본값은 .data 입니다.

  • 시스템 구성 경로: 환경 > 파일 저장

  • config.json 설정: ".FileSettings.Directory”,

  • 환경 변수: MM_FILESETTINGS_DIRECTORY

참고 : 파일 저장 시스템 이 amazons3 로 설정된 경우, 이 설정은 영향을 미치지 않습니다.

최대 파일 크기

이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.

메시지 첨부 파일의 최대 파일 크기입니다. 이 값은 시스템 콘솔에서 메가바이트로 지정해야 하며 config.json 파일에서는 바이트로 지정해야 합니다.

기본값은 104857600 바이트 ( 1 메가바이트)입니다.

  • 시스템 구성 경로: 환경 > 파일 저장

  • config.json 설정: ".FileSettings .MaxFileSize: 104857600",

  • 환경 변수: MM_FILESETTINGS_MAXFILESIZE

경고 : 서버 메모리가 설정 선택을 지원할 수 있는지 확인하세요. 대용량 파일 크기는 서버 충돌 및 네트워크 중단으로 인한 업로드 실패 위험을 증가시킵니다.

참고 : Mattermost 앞에 프록시 또는 로드 밸런서를 사용하는 경우 다음 프록시 설정을 해당되는 대로 조정해야 합니다:

  • NGINX의 경우,

client_max_body_size를

사용하세요.

  • Apache의 경우, LimitRequestBody를 사용하세요.

컨텐츠별 문서 검색 활성화

이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.

사용자들이 메시지에 첨부된 문서의 내용을 검색할 수 있도록 활성화합니다.

  • true : (기본값) 문서의 내용으로 검색할 수 있습니다.

  • false : 문서의 내용으로 검색할 수 없습니다. 문서 내용 검색이 비활성화된 경우 사용자는 파일 이름으로만 파일을 검색할 수 있습니다.

  • 시스템 구성 경로: 환경 > 파일 저장

  • config.json 설정: ".FileSetting s.ExtractContent: true",

  • 환경 변수: MM_FILESETTINGS_EXTRACTCONTENT

참고 : Mattermost Server v5.35로 업그레이드하기 전에 메시지로 공유된 파일에 대한 문서 내용 검색 결과가 부족할 수 있으며, mmctl 을 사용하여 추출 명령을 실행하기 전까지 완전하지 않을 수 있습니다. 이 명령을 실행하지 않으면 사용자는 이전 파일을 파일 이름을 기반으로 검색할 수 있습니다.

PDF, DOCX 및 ODT 이외의 파일 형식(PDF, DOCX 및 ODT 포함)을 Mattermost에서 내용 검색 지원을 확장하려면 다음 의존 성 을 선택적으로 설치할 수 있습니다:

  • tidy : HTML 문서의 내용을 검색하는 데 사용됩니다.

  • wv : DOC 문서의 내용을 검색하는 데 사용됩니다.

  • popplerutils : PDF 문서의 내용을 추출할 때 서버 성능을 크게 향상시키는 데 사용됩니다.

  • unrtf : RTF 문서의 내용을 검색하는 데 사용됩니다.

  • JusText : HTML 문서의 내용을 검색하는 데 사용됩니다.

이러한 의존성을 설치하지 않을 경우, 추출할 수 없는 문서에 대한 로그 항목이 표시됩니다. 추출할 수 없는 문서는 건너뛰고 내용 추출이 진행됩니다.

압축된 파일 안 문서 내용 검색 활성화

이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.

메시지에 첨부된 압축된 ZIP 파일의 내용을 검색할 수 있게 합니다.

  • true : ZIP 파일 내 문서의 내용이 검색 결과에 반환됩니다. 큰 파일의 경우 서버 성능에 영향을 미칠 수 있습니다.

  • false : (기본값) ZIP 파일 내 문서의 내용이 검색 결과에 반환되지 않습니다.

  • 시스템 구성 경로: 환경 > 파일 저장

  • config.json 설정: ".FileSettings. ArchiveRecursion: false",

  • 환경 변수:

MM_FILESETTINGS_ARCHIVERECURSION

참고 : ZIP 파일 내 문서 내용 검색은 모바일 지원이 곧 제공됩니다. 문서 내용 검색은 서버에 부하를 추가합니다. 대규모 배포나 많은 대용량 텍스트 문서를 공유하는 팀의 경우, 프로덕션 환경에서 활성화하기 전에 스테이징 환경에서 이 기능을 활성화하고 하드웨어 요구 사항을 검토하는 것을 권장합니다. 하드웨어 요구 사항 을 확인하고 테스트해 주세요.

Amazon S3 버킷

이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.

S3 호환 객체 저장소 인스턴스의 버킷 이름입니다.

S3 호환 버킷 이름을 포함하는 문자열입니다.

  • 시스템 구성 경로: 환경 > 파일 저장

  • config.json 설정:

".FileSettings.AmazonS3Bucket", - 환경 변수:

MM_FILESETTINGS_AMAZONS3BUCKET

Amazon S3 경로 접두어

이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.

Amazon S3 버킷 에서 선택한 접두어입니다.

경로 접두어를 포함하는 문자열입니다.

  • 시스템 구성 경로: N/A

  • config.json 설정: ".FileSetti ngs.AmazonS3PathPrefix",

  • 환경 변수: MM_FILESETT INGS_AMAZONS3PATHPREFIX

Amazon S3 지역

이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.

AWS에서 Amazon S3 버킷 을 생성할 때 선택한 지역입니다.

버킷을 포함하는 AWS 지역을 나타내는 문자열입니다. 지역이 설정되지 않으면 Mattermost는 적절한 지역을 AWS에서 가져오려 시도하고 발견하지 못할 경우 us-east-1 로 설정합니다.

  • 시스템 구성 경로: 환경 > 파일 저장

  • config.json 설정: :literal:

".FileSettings.AmazonS3Region", - 환경 변수:

MM_FILESETTINGS_AMAZONS3REGION

참고 : MinIO 또는 Digital Ocean Spaces의 경우, 이 설정을 비워 두세요.

Amazon S3 액세스 키 ID

이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.

S3 호환 저장소 인스턴스의 액세스 키를 나타내는 문자열입니다. EC2 관리자가 액세스 키 ID를 제공할 수 있습니다.

  • 시스템 구성 경로: 환경 > 파일 저장

  • config.json 설정: ".FileSettings. AmazonS3AccessKeyId",

  • 환경 변수: MM_FILESETTI NGS_AMAZONS3ACCESSKEYID

참고 : Amazon S3 IAM 역할 또는 Amazon S3와 함께 스위치 역할을 사용하는 경우 를 제외하고 액세스에는 이것이 필요합니다.

Amazon S3 엔드포인트

이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.

S3 호환 인스턴스의 호스트 이름입니다.

S3 호환 스토리지 인스턴스의 호스트 이름을 나타내는 문자열입니다. 기본값은 s3.amazonaws.com 입니다.

참고 : Digital Ocean Spaces의 경우, 호스트 이름을 <region>.digitaloceanspaces.com 으로 설정해야 합니다. 여기서 <region> 은 Space 설정 시 선택한 지역의 약어입니다. nyc3 , ams3 , 또는 sgp1 일 수 있습니다.

Amazon S3 시크릿 액세스 키

이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.

Your Amazon S3 Access Key ID와 연결된 시크릿 액세스 키입니다.

S3 호환 스토리지 인스턴스의 시크릿 액세스 키를 나타내는 문자열입니다.

  • 시스템 구성 경로: 환경 > 파일 저장

  • config.json 설정: ".FileSettings.Amaz onS3SecretAccessKey",

  • 환경 변수: MM_FILESETTINGS_ AMAZONS3SECRETACCESSKEY

안전한 Amazon S3 연결 활성화

이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.

Amazon S3 연결을 안전하게 활성화하거나 비활성화합니다.

  • true : (기본값) 안전한 Amazon S3 연결만 가능합니다.

  • false : Amazon S3와의 안전하지 않은 연결을 허용합니다.

  • 시스템 구성 경로: 환경 > 파일 저장

  • config.json 설정: ".FileSettings.Ama zonS3SSL: true",

  • 환경 변수: MM_FILESETTINGS_AMAZONS3SSL

Amazon S3 서명 v2

이전 엔터프라이즈 에디션 E10/E20에서 사용 불가

Mattermost는 기본적으로 AWS에 대한 API 호출에 Signature v4를 사용하지만, 특정 상황에서는 v2가 필요할 수 있습니다.

  • true : 서명 v2 서명 프로세스를 사용합니다.

  • false : (기본값) 서명 v4 서명 프로세스를 사용합니다.

  • 시스템 구성 경로: 해당 없음

  • config.json 설정: ".FileSettings.Amazo nS3SignV2: false",

  • 환경 변수:

MM_FILESETTINGS_AMAZONS3SIGNV2

Amazon S3 서명 v2 서명 프로세스를 사용해야 하는 경우에 대한 자세한 정보는 AWS 문서 를 참조하십시오.

Amazon S3를 위한 서버 측 암호화 활성화

이전 엔터프라이즈 에디션 E20에서 사용 가능

Amazon S3를 위한 서버 측 암호화를 활성화하거나 비활성화합니다.

  • true : Amazon S3의 파일을 Amazon S3 관리 키를 사용하여 서버 측 암호화합니다.

  • false : (기본값) Amazon S3의 파일을 암호화하지 않습니다.

  • 시스템 구성 경로: 환경 > 파일 저장

  • config.json 설정: ".FileSettings. AmazonS3SSE: false",

  • 환경 변수: MM_FILESETTINGS_AMAZONS3SSE

Amazon S3 디버깅 활성화

이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.

Amazon S3 디버깅을 활성화하거나 비활성화하여 시스템 로그에서 추가 디버깅 정보를 캡처합니다.

  • true : 시스템 로그에 추가 디버깅 정보가 기록됩니다.

  • false : (기본값) 시스템 로그에 Amazon S3 디버깅 정보가 포함되지 않습니다. 일반적으로 운영 환경에서는 false 로 설정합니다.

  • 시스템 구성 경로: 환경 > 파일 저장

  • config.json 설정: ".FileSettings.Ama zonS3Trace: false",

  • 환경 변수:

MM_FILESETTINGS_AMAZONS3TRACE

시스템 콘솔에서 연결 테스트 버튼을 선택하여 설정을 유효성 검사하고 사용자가 서버에 액세스할 수 있는지 확인합니다.

이니셜 글꼴

이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.

자동 생성된 프로필 사진에서 사용되는 글꼴로, 색상 배경과 사용자 이니셜이 있습니다.

글꼴 파일 이름을 포함한 문자열입니다. 기본값은 nunito-bold.ttf 입니다.

  • 시스템 설정 경로: N/A

  • config.json 설정: ".FileSettings.InitialFo nt: nunito-bold.ttf",

  • 환경 변수: MM_FILESETTINGS_INITIALFONT

아마존 S3 요청 시간 초과

아마존 S3 저장소로의 요청이 타임아웃되기 전의 밀리초 단위 시간입니다.

기본값은 30000 (30초)입니다.

  • 시스템 설정 경로: N/A

  • config.json 설정: ".FileSettings.AmazonS3RequestT imeoutMilliseconds: 30000

  • 환경 변수: MM_FILESETTINGS_AMAZONS 3REQUESTTIMEOUTMILLISECONDS