"서버에 연결할 수 없습니다. 서버 URL과 인터넷 연결을 확인하세요."라는 메시지가 계속 표시됩니다#

먼저 서버 URL에 오타가 없는지, 그리고 서버 배포 구성에 따라 http:// 또는 https://가 포함되어 있는지 확인하세요.

서버 URL이 올바른데도 문제가 발생한다면 SSL 인증서 구성에 문제가 있을 수 있습니다.

SSL 인증서 설정을 확인하려면 SSL Labs 같은 사이트에 방문하여 테스트해 보세요. 체인 또는 인증서 경로가 누락되었다는 오류가 표시된다면, 포함해야 할 중간 인증서가 누락되었을 가능성이 높습니다.

앱은 자체 서명된 인증서를 사용하는 서버에는 연결할 수 없으니 유의하세요. 대신 Let's Encrypt 사용을 고려하세요.

ADFS/Office365 로그인이 작동하지 않습니다#

Microsoft 가이드라인에 따라 WIA를 지원하지 않는 디바이스를 위한 인트라넷 폼 기반 인증 구성을 권장합니다.

메시지에 모바일 앱 로그를 첨부하려면 어떻게 해야 하나요?#

모바일 문제 해결 중 사용자가 메시지에 Mattermost 모바일 앱 로그를 첨부할 수 있도록 /mobile-logs를 사용하세요. /mobile-logs on을 실행하면 메시지 작성기의 첨부 파일 메뉴에 Attach app logs 옵션이 표시되어, 사용자가 관리자나 지원 엔지니어에게 메시지를 보낼 때 디바이스 측 로그를 포함할 수 있습니다. 사용자는 모바일 앱의 Report a problem 화면에서도 이 옵션을 켜거나 끌 수 있습니다. 이 명령어는 실행한 사용자에게만 표시되는 임시 메시지로 응답합니다.

• /mobile-logs on을 사용하여 자신의 Attach app logs를 활성화합니다.
• /mobile-logs off를 사용하여 자신의 Attach app logs를 비활성화합니다.
• /mobile-logs status를 사용하여 Attach app logs가 활성화되어 있는지 확인합니다.
• 시스템 관리자는 사용자 이름을 추가하여 다른 사용자의 설정을 관리할 수 있습니다. 예를 들어 /mobile-logs on @username, /mobile-logs off @username, /mobile-logs status @username과 같이 사용합니다.

"연결 중…" 표시줄이 사라지지 않습니다#

앱이 정상적으로 작동하고 있다면, 앱이 다시 연결된 후 회색 "연결 중…" 표시줄이 사라지거나 "연결됨"으로 표시되어야 합니다.

이 메시지가 계속 표시되고 인터넷 연결에는 문제가 없어 보인다면, 서버 관리자에게 서버가 NGINX나 다른 웹 서버를 리버스 프록시로 사용하고 있는지 문의하세요. 만약 그렇다면, APIv4 엔드포인트를 위한 웹소켓 연결 지원이 올바르게 구성되어 있는지 확인해야 합니다.

모든 아웃바운드 연결이 프록시를 통해야 합니다. Mattermost Hosted Push Notification Service에 어떻게 연결할 수 있나요?#

다음 단계에 따라 내부 서버를 설정하여 네트워크 외부로 연결을 프록시해서 Mattermost Hosted Push Notification Service(HPNS)에 연결할 수 있습니다.

1. 프록시 서버가 SSL을 지원하도록 올바르게 구성되어 있는지 확인하세요. https://www.digicert.com/help/ 에서 URL을 확인하여 작동하는지 확인합니다.
2. 요청을 https://push.mattermost.com으로 전달하도록 프록시를 설정하세요.
3. Mattermost에서 이전 버전은 System Console > Notification Settings > Mobile Push > Enable Push Notifications를, 5.12 이후 버전은 System Console > Environment > Push Notification Server > Enable Push Notifications를 "Manually enter Push Notification Service location"으로 설정합니다.
4. Push Notification Server 필드에 프록시의 URL을 입력합니다.

react-native bundle --platform android --dev false --entry-file index.js --bundle-output android/app/src/main/assets/index.android.bundle --assets-dest android/app/src/main/res/

그런 다음 다음을 사용하여 gradle 작업을 무시합니다.

./gradlew assembleRelease -x bundleReleaseJsAndAssets

모바일 앱에서 이미지 미리보기를 사용할 수 없습니다#

이는 Mattermost를 실행하는 서버의 mime 타입이 올바르게 설정되지 않은 경우 발생할 수 있습니다.

Linux를 실행하는 서버에서는 이 파일이 /etc/mime.types에 위치합니다. 이는 특정 OS와 배포판에 따라 다를 수 있습니다.

일부 배포판은 mailcap 없이 제공되기도 하는데, 이로 인해 mime 타입이 누락되거나 잘못 구성될 수 있습니다.

모바일 앱에서 이모지가 포함된 메시지가 전송되지 않습니다#

이는 Mattermost를 실행하는 서버가 잘못된 문자 세트로 구성된 경우 발생할 수 있습니다. 이 문제를 해결하려면 config.json 파일의 SqlSettings 아래에서 DataSource 키가 올바르게 구성되어 있는지 확인한 다음 Mattermost 서버를 재시작하세요.

예를 들면:

"SqlSettings": {
    "DataSource": "<user:pass>@<servername>/mattermost?charset=utf8mb4,utf8",
    [...]
  }

마스터 데이터베이스에 대한 연결 문자열을 구성하는 방법에 대한 자세한 내용은 Configuration Settings 문서를 참조하세요.

모바일 푸시 알림 테스트하기#

사전 빌드된 모바일 앱 또는 커스텀 빌드한 모바일 앱에 대해 푸시 알림을 구성해야 합니다.

그런 다음 다음 지침에 따라 푸시 알림이 올바르게 작동하는지 확인하세요.

1. Mattermost 서버의 계정으로 모바일 앱에 로그인합니다. 이 계정을 "Account A"라고 하겠습니다.
2. (iOS) 앱이 알림을 받을 것인지 묻는 경우, 알림을 받겠다고 확인합니다.



3. "Account A"에 대해 푸시 알림이 활성화되어 있는지 확인합니다.

A. 모바일 앱에서 알림 설정 메뉴로 이동합니다.

B. 모바일 푸시 알림이 전송되도록 설정되어 있는지 확인합니다.
4. "Account A"에서 앱을 백그라운드로 전환하거나 앱을 종료합니다.
5. 브라우저를 사용하여 동일한 Mattermost 서버에 "Account B"로 로그인합니다.
6. "Account A"와 다이렉트 메시지를 열고 메시지를 보냅니다.
7. "Account A"의 모바일 디바이스에 해당 메시지가 포함된 푸시 알림이 표시되어야 합니다.

푸시 알림 문제 해결하기#

푸시 알림을 테스트할 때 알림을 받지 못했다면, 다음 절차에 따라 문제를 해결하세요.

1. System Console > Environment > Logging > File Log Level에서 DEBUG를 선택하여 서버 로그에서 푸시 알림을 확인합니다.
2. 모바일 애플리케이션을 삭제한 다음 다시 설치합니다.
3. "Account A"로 로그인하고 모바일 앱에서 메시지가 표시되면 푸시 알림을 받겠다고 확인합니다.
4. Profile > Security > View and Logout of Active Sessions로 이동하여 로그인 시간과 일치하는 네이티브 모바일 앱 세션이 있는지 확인합니다.
5. 푸시 알림을 다시 테스트합니다.
6. 푸시 알림이 표시되지 않으면 System Console > Server Logs로 이동한 다음 Reload를 선택합니다. 로그 하단에서 다음과 유사한 메시지를 찾으세요.

[2016/04/21 03:16:44 UTC] [DEBG] Sending push notification to 608xyz0... wi msg of '@accountb: Hello'

• 로그 메시지가 표시되면 메시지가 HPNS 서버로 전송되었지만 모바일 앱에서 수신되지 않았다는 의미입니다. Mattermost 지원팀의 도움을 받으려면 제목을 "HPNS issue"로 하여 지원 티켓 생성을 해주세요.
• 로그 메시지가 표시되지 않으면 "Account A"에 모바일 푸시 알림이 전송되지 않았다는 의미입니다. 2단계부터 프로세스를 반복하고 각 단계를 다시 확인하세요.

모바일 디바이스에 푸시 알림이 전달되지 않는다면, Profile > Security > View and Log Out of Active Sessions를 통해 Native 모바일 앱 세션에 로그인되어 있는지 확인하세요. 그렇지 않으면 DeviceId가 Sessions 테이블에 등록되지 않아 알림이 전달되지 않습니다.