Mattermost 데스크톱 앱 설치

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

deployment-img Cloud 와 self-hosted 배포판

Mattermost 데스크톱 앱은 Linux, Mac 및 Windows 운영 체제용으로 제공됩니다. 데스크톱 앱은 웹 환경의 모든 기능을 지원하며 다음 기능을 추가로 제공합니다:

지원되는 운영 체제 및 릴리스에 대한 자세한 내용은 데스크톱 앱 소프트웨어 요구 사항 을 참조하십시오.

Mattermost 데스크톱 앱 설치 및 업데이트

다운로드 페이지 에서 데스크톱 앱을 직접 다운로드할 수 있습니다. 또한 Linux, Mac 및 Windows용 설치 가이드를 사용할 수도 있습니다.

Windows 10+이 필요합니다. 자동 앱 업데이트가 지원되고 활성화되어 있습니다. 데스크톱 앱의 새 버전이 출시되면 앱이 자동으로 업데이트됩니다.

Mattermost 데스크톱 앱 설치

  1. Mattermost 데스크톱 앱의 최신 버전을 다운로드하세요: 32/64비트 Windows용

  2. Downloads 폴더에서 파일 mattermost-desktop-setup-5.6.0-win.exe 에 마우스 오른쪽 버튼을 클릭한 다음, 앱의 설치 프로그램을 시작하려면 **열기**를 선택하세요. 설치가 완료되면 Mattermost 데스크톱 앱이 자동으로 열립니다.

MSI 설치 프로그램 및 그룹 정책 (베타)

다음과 같은 그룹 정책이 제공됩니다:

그룹 정책

설명

Mattermost 릴리스

설정

상태 옵션

서버 관리 활성화

비활성화되면 앱 설정에서 서버 관리가 비활성화.

v4.3 이상

EnableServerManagement

  • 구성되지 않음

기본 서버 목록 설정

하나 이상의 기본 영구 서버 정의.

v4.3 이상

DefaultServerList

  • 활성화

자동 업데이트 비활성화
비활성화되면 자동 데스크톱 앱 업데이트가

비활성화

v5.1 이상

EnableAutoUpdates

  • 비활성화

자동 업데이트 비활성화

지원되는 그룹 정책을 구성하여 자동 데스크톱 앱 업데이트를 비활성화할 수 있습니다. Mattermost를 재시작하여 그룹 정책에 대한 변경 사항이 적용되도록 해야 합니다.

데스크톱 앱으로 로그인

처음으로 데스크톱 앱을 사용하여 Mattermost에 로그인하면 데스크톱 앱 기능을 소개하는 스플래시 화면이 표시됩니다.

  1. 시작하기 를 선택하여 Mattermost 서버에 연결하세요.

  2. 서버 URL 과 서버 표시 이름 을 입력한 후 연결 을 선택하세요.

Tip

Mattermost 서버 URL을 찾을 수 없는 경우 회사의 IT 부서 또는 Mattermost 시스템 관리자에게 조직의 Mattermost 사이트 URL 을 문의하세요. 이는 https://example.com/company/mattermost, mattermost.yourcompanydomain.com , 또는 chat.yourcompanydomain.com 과 유사합니다. 이러한 URL은 .net 으로 끝날 수도 있습니다.

추가 문서 자료

다음 추가 문서 자료도 Mattermost 데스크톱 앱을 위해 제공됩니다:

데스크톱 앱 설치 문제 해결

로컬에 구성이 저장된 위치는 어디인가요?

Mattermost 데스크톱 앱 구성 파일의 위치는 Mattermost를 실행하는 플랫폼에 따라 다릅니다 (macOS의 경우 앱 설치 방법에도 영향을 받음):

  • Windows: Users\<username>\AppData\Roaming\Mattermost

  • macOS 설치 프로그램: /Users/<username>/Library/Application Support/Mattermost

  • macOS App Store: /Users/<username>/Library/Containers/Mattermost/Data/Library/Application Support/Mattermost

  • Linux: ~/.config/Mattermost

Note

  • 로컬 구성 데이터는 데스크톱 앱을 제거할 때 자동으로 제거되지 않습니다. 모든 데이터를 제거하려면 위에 나온 해당 위치의 파일을 수동으로 제거해야 합니다.

  • 제거하기 전에 모든 활성 세션에서 로그아웃할 수 있습니다. 프로필 > 보안 > 활성 세션 보기 및 로그아웃 에서 활성 세션을 종료한 후 로그아웃 을 선택할 수 있습니다. 데스크톱 앱 세션은 Native Desktop App 으로 표시됩니다.

로그에 어떻게 접근하나요?

Mattermost 데스크톱 v5.3부터 도움말 > 로그 표시 를 통해 로그에 접근할 수 있으며, 이는 로그 파일의 위치를 보여주는 파일 관리자 창을 엽니다.

앱 진단을 어떻게 다운로드하나요?

Mattermost 데스크톱 v5.3부터 도움말 > 진단 실행 을 통해 지원 티켓에 첨부할 수 있는 진단 텍스트 파일을 다운로드할 수 있습니다.

“설치에 실패했습니다” 대화 상자

앱 데이터가 손상된 가능성이 있습니다. %LOCALAPPDATA%\mattermost 의 모든 파일을 제거한 후 앱을 다시 설치해 보세요.

“”Mattermost” 애플리케이션을 여는 데 문제가 발생했습니다” 대화 상자

macOS 카탈리나에서 Mac Archive 유틸리티가 파일의 압축을 푸는 기본 방법으로 설정된 경우, 문제가 해결될 수 있도록 Keka 나 Unarchiver 와 같은 타사 도구를 사용하세요.

데스크톱 앱 창이 검정색이며 페이지가 로드되지 않습니다

  1. 먼저 최신 데스크톱 앱 버전이 설치되어 있는지 확인하세요.

  2. 캐시를 지우고 보기 > 캐시 지우고 다시 로드 를 선택하거나 Windows 또는 Linux의 경우 Ctrl Shift R, macOS의 경우 ⌘ ⇧ R 를 눌러 앱을 다시로드하세요.

  3. 앱을 종료한 후 다시 시작하여 문제가 해결되는지 확인하세요.

  4. Windows 및 Linux의 경우 파일 > 설정 또는 macOS의 경우 Mattermost > 설정 에서 GPU 하드웨어 가속 사용 을 선택 취소하여 GPU 하드웨어 가속을 비활성화하세요.

  5. Optimus와 같은 특별한 비디오 드라이버를 사용하고 있다면, 문제가 해결되는지 확인하기 위해 비활성화해 보세요.

위의 단계들로 문제가 해결되지 않는 경우, Mattermost 문제 해결 포럼 에 새 티켓을 열어 주세요.

데스크톱 앱이 보이지 않지만 작업 표시줄에 Mattermost 아이콘이 있습니다

이 문제는 윈도우에서 다중 모니터 설정에서 발생할 수 있습니다. Mattermost가 표시된 모니터를 분리하면 Mattermost는 더 이상 존재하지 않는 화면 좌표에 계속 표시됩니다.

이 문제를 해결하려면, 데스크톱 앱 화면 위치 파일을 삭제하여 데스크톱 앱 화면 위치를 재설정할 수 있습니다. 파일이 존재하지 않을 때, 데스크톱 앱은 기본적으로 주 모니터에 표시됩니다.

데스크톱 앱 화면 위치를 재설정하는 방법:

  1. 데스크톱 앱이 실행 중이라면, 작업 표시줄에서 Mattermost 아이콘을 마우스 오른쪽 버튼으로 클릭한 다음, **창 닫기**를 선택합니다.

  2. 윈도우 파일 탐색기를 열고, %APPDATA%\\Mattermost 폴더로 이동합니다.

  3. bounds-info.json 파일을 삭제합니다.

데스크톱 앱이 페이지를 지속적으로 새로 고침합니다

이 문제는 ``localStorage``가 예상치 못한 상태일 때 발생할 수 있습니다. 문제를 해결하려면:

  • 윈도우: 윈도우 파일 탐색기를 열고, %APPDATA%\Mattermost 폴더로 이동한 다음, Local Storage 폴더를 삭제합니다.

  • 맥: Finder를 열고, ~/Library/Application Support/Mattermost 폴더로 이동한 다음, Local Storage 폴더를 삭제합니다.

  • 리눅스: 파일 관리자를 열고, ~/.config/Mattermost 폴더로 이동한 다음, Local Storage 폴더를 삭제합니다. 리눅스 파일 관리자는 기본적으로 점으로 시작하는 폴더를 숨길 수 있습니다. 터미널을 사용하여 ``rm -rf ~/.config/Mattermost``로 삭제할 수 있습니다.

데스크톱 앱이 지속적으로 Mattermost 서버에 로그인하라고 요청합니다

이 문제는 데스크톱 앱이 충돌하거나 예기치 않은 종료로 인해 앱 데이터가 손상된 후 발생할 수 있습니다. 문제를 해결하려면:

  • 윈도우: 윈도우 파일 탐색기를 열고, %APPDATA%\\Mattermost 폴더로 이동한 다음, IndexedDB 폴더와 Cookies 및 Cookies-journal 파일을 삭제합니다.

  • 맥: Finder를 열고, ~/Library/Application Support/Mattermost 폴더로 이동한 다음, IndexedDB 폴더와 Cookies 및 Cookies-journal 파일을 삭제합니다.

  • 리눅스: 파일 관리자를 열고, ~/.config/Mattermost 폴더로 이동한 다음, IndexedDB 폴더와 Cookies 및 Cookies-journal 파일을 삭제합니다. 리눅스 파일 관리자는 기본적으로 점으로 시작하는 폴더를 숨길 수 있습니다.

“내부 오류: BrowserWindow ‘응답 없음’ 이벤트가 발생했습니다”

대화 상자에서 세부 정보 보기 를 선택하면 로그를 제공합니다. 문제를 해결하는 방법:

  1. 보기 > 캐시 지우기 및 새로 고침 을 통해 캐시를 지우거나 윈도우 또는 리눅스에서는 :kbd:Ctrl :kbd:Shift :kbd:R, 맥에서는 :kbd:⌘ :kbd:⇧ :kbd:R을 누릅니다.

  2. 파일 > 설정 을 통해 앱 설정으로 이동하거나 윈도우 또는 리눅스에서는 Ctrl , 맥에서는 ⌘ , 를 눌러 하드웨어 가속을 선택 해제합니다.

데스크톱 앱이 Citrix Virtual Apps 또는 데스크탑 환경 내에서 반응하지 않음

레지스트리 키 HKLM\SYSTEM\CurrentControlSet\Services\CtxUvi\UviProcessExcludes 에 Mattermost.exe; 를 추가하고 시스템을 재부팅하세요.

추가 지원이 필요한 경우, 이전에 보고된 오류에 대해 문제 해결 포럼 <https://forum.mattermost.com/c/trouble-shoot>`__을 검토하거나, 문제 해결을 위해 `Mattermost 사용자 커뮤니티에 가입하세요 .

데스크톱 앱 문제 보고

Mattermost 데스크톱 앱에서 발견된 문제를 보고할 때는, 개발자 도구 콘솔의 내용과 이 페이지의 정보 를 포함하는 것이 도움이 됩니다.

개발자 도구 콘솔에 접근하는 방법:

  1. 메뉴 바에서 보기 > 현재 탭의 개발자 도구 로 이동합니다.

  2. 콘솔 탭을 선택합니다.

  3. 로그 항목을 마우스 오른쪽 버튼으로 클릭한 다음, 다른 이름으로 저장 을 선택합니다.

  4. 파일을 저장한 다음, 문제에 대한 설명과 함께 보냅니다.

  5. 개발자 도구를 비활성화하려면 콘솔을 닫습니다.

데스크톱 앱에 추가한 각 서버마다 추가 개발자 도구 세트를 열 수 있습니다. 위에서 설명한 단계로 열었던 개발자 도구 콘솔에 이 명령을 붙여넣어 도구를 열 수 있습니다:

document.getElementsByTagName("webview")[0].openDevTools();

이 문서의 개선이나 정정을 제출하려면, 이 페이지 상단의 편집 을 선택하세요.