자체 호스팅 서버에 대한 ONLYOFFICE 모바일 앱 연결 시간 초과 문제 해결

ONLYOFFICE Documents에서 자체 호스팅 서버 주소를 입력하고 [다음]을 탭하면 앱이 계속 로딩되다가 연결 시간 초과 오류가 발생합니다. 동일한 계정이 데스크톱 브라우저에서는 정상적으로 작동할 수 있으므로 앱 버그처럼 보일 수 있습니다. 하지만 실제로는 시간 초과 오류가 발생하는 이유는 일반적으로 휴대폰이 입력한 서비스 URL에 정확히 연결할 수 없거나, URL이 잘못된 ONLYOFFICE 구성 요소를 가리키거나, 네트워크 계층에서 요청을 차단했기 때문입니다.

먼저 서버에서 실제로 제공하는 기능이 무엇인지 파악하세요. ONLYOFFICE Docs 모바일 앱은 DocSpace 또는 Workspace와 같은 ONLYOFFICE 포털이나 Nextcloud, ownCloud 또는 다른 WebDAV 서비스와 같은 지원되는 타사 클라우드에 연결됩니다. ONLYOFFICE Docs(Document Server라고도 함)는 스토리지 플랫폼과 연동되는 편집 서비스이며, 사용자 포털이나 WebDAV 파일 계정과 동일한 것은 아닙니다. ONLYOFFICE의 Android 문서 개요 및 iOS 문서 개요에서 지원되는 계정 유형을 확인할 수 있습니다.

1. 모바일 앱에서 사용할 주소를 확인하세요.

모든 연결 필드에 문서 서버 URL을 붙여넣지 마십시오. 파일이 자체 호스팅 DocSpace 또는 Workspace 포털에 저장된 경우 해당 포털의 공개 주소를 사용하고 포털 계정으로 로그인하십시오. 파일이 Nextcloud 또는 ownCloud에 있는 경우 앱에서 해당 서비스를 선택하고 스토리지 서버의 WebDAV 주소와 계정 자격 증명을 입력하십시오. 일반 WebDAV 서비스를 사용하려면 앱에서 "기타 WebDAV" 옵션을 선택하십시오(사용 가능한 경우).

Nextcloud와 ownCloud의 경우 URL에 도메인 이후의 경로가 포함될 수 있습니다. 이전 튜토리얼에서 경로를 추측하는 대신 클라우드 계정 설정에 표시된 WebDAV 주소를 복사하세요. ONLYOFFICE의 모바일 연결 가이드에서는 Nextcloud 예시를 제공하며 프로토콜을 포함한 전체 URL을 붙여넣도록 안내합니다. 앱의 Android 설명서에서도 WebDAV 저장소에 연결하기 위해 연결 URL, 로그인 및 비밀번호를 제공하라고 안내합니다. 최신 연결 절차는 공식 Nextcloud 통합 가이드 또는 ownCloud 통합 가이드를 참조하세요.

• 포털 계정에는 편집기 서비스 주소가 아닌 포털 URL을 사용하십시오.
• Nextcloud, ownCloud 또는 다른 WebDAV 계정의 전체 WebDAV URL을 사용하십시오.
• 서버에 설정된 대로 포함 https://하거나 정확히 설정하십시오.http://
• /webdav또는 와 같이 검증되지 않은 접미사를 추가하지 마십시오 /remote.php/dav. 서버에 표시된 WebDAV URL을 복사하십시오.

2. 앱 외부에서 동일한 주소를 테스트해 보세요.

휴대폰에서 모바일 브라우저로 해당 주소를 엽니다. 포털 URL의 경우, 예상 결과는 로그인 페이지이거나 포털로 리디렉션되는 것입니다. WebDAV 엔드포인트의 경우, 브라우저는 일반 웹사이트 대신 로그인 프롬프트, 인증 응답 또는 오류 메시지를 표시할 수 있습니다. 중요한 것은 응답이 신속하고 브라우저가 호스트를 찾을 수 없거나 연결할 수 없다는 오류를 표시하지 않는다는 것입니다.

Wi-Fi와 모바일 데이터를 사용하여 각각 한 번씩 테스트를 반복하십시오. 한쪽 네트워크에서만 작동하는 경우, 앱 자체의 문제는 아닐 가능성이 높습니다. 문제가 발생하는 네트워크에서 라우터, VPN, DNS 필터링, 이동통신사 제한 또는 방화벽 정책을 확인하십시오. 양쪽 모두에서 문제가 발생하는 경우, 호스트 이름이 공개적으로 확인되는지, 그리고 리버스 프록시 또는 방화벽이 서비스의 HTTPS 트래픽을 의도한 백엔드로 전달하는지 확인하십시오.

일반적으로 사설 IP 주소를 통해서만 접근 가능한 서버는 192.168.x.x휴대폰이 로컬 네트워크에서 벗어나 있을 경우 VPN이나 ​​다른 보안 원격 접속 설정을 통해 연결되지 않는 한 접속할 수 없습니다. 앱 테스트를 위해 내부 서비스를 공용 인터넷에 노출하지 마십시오. 조직에서 승인한 원격 접속 방법을 사용하십시오.

3. URL, 리디렉션 및 리버스 프록시를 확인하세요.

앱에 표시된 주소와 브라우저에서 정상적으로 작동하는 주소를 문자 단위로 비교하세요. 누락된 하위 디렉터리, 이전 호스트 이름, 잘못된 포트, 다른 서비스에서 복사한 경로, 또는 휴대폰이 확인할 수 없는 내부 호스트 이름으로의 리디렉션이 있는지 확인하세요. 서버가 리버스 프록시 뒤에 있는 경우, 공개 URL은 올바른 애플리케이션으로 연결되어야 하며, 전달된 스키마 및 호스트 정보는 사용자가 액세스하는 HTTPS 주소와 일치해야 합니다.

포털이나 WebDAV 서비스가 서브경로 아래에 게시된 경우, 프록시가 필수 경로를 유지하고 해당 애플리케이션으로 요청을 전달하는지 확인해야 합니다. 루트 URL에서 리버스 프록시 환영 페이지가 표시되는 것은 웹 서버가 응답했다는 것만 의미할 뿐, 앱의 포털이나 WebDAV 엔드포인트가 올바르게 라우팅되었다는 것을 의미하지는 않습니다. 가능하면 도메인 홈페이지뿐만 아니라 모바일 앱에 직접 복사한 정확한 URL을 테스트하십시오.

앱에서 시간 초과 오류가 발생했지만 브라우저가 로그인 페이지에 빠르게 도달하는 경우, 새 연결을 시도할 때 프록시 액세스 및 오류 로그를 확인하십시오. 502 또는 504 응답은 상위 서버 또는 프록시 시간 초과를 나타내고, 404는 일반적으로 경로 또는 라우팅 불일치를 나타냅니다. 401 또는 403은 엔드포인트에서 응답했지만 인증 또는 액세스가 거부되었음을 의미합니다. 이러한 상태 코드는 문제 해결 범위를 좁히는 데 도움이 되지만, 그 의미는 ONLYOFFICE 앞에 있는 프록시 및 클라우드 소프트웨어에 따라 달라질 수 있습니다.

4. HTTPS 및 인증서 체인을 검증합니다.

모바일 운영체제는 서버 인증서를 검증합니다. 만료되었거나, 다른 호스트 이름으로 발급되었거나, 중간 인증서가 없거나, 기기가 신뢰하지 않는 기관에서 서명한 인증서는 안전한 연결을 방해할 수 있습니다. 휴대폰에서 해당 HTTPS 주소를 열고 브라우저에 인증서 관련 경고 메시지가 표시되는지 확인하세요. 또한 기기의 날짜와 시간이 정확한지 확인하십시오. 시계가 잘못 설정되어 있으면 유효한 인증서도 만료되었거나 아직 유효하지 않은 것처럼 보일 수 있습니다.

공용 호스트 이름에 대해 발급된 인증서를 사용하고 전체 인증서 체인을 공용 프록시 또는 서버에 설치하십시오. ONLYOFFICE 설명서에는 문서 서버에 대한 HTTPS 구성 방법이 나와 있으며, 인증서는 클라이언트가 사용하는 URL과 일치해야 합니다. 인증서 확인을 비활성화하는 것은 영구적인 해결책이 될 수 없으므로 피하십시오. ONLYOFFICE는 통합 설명서에서 해당 옵션을 보안에 취약하다고 설명하고 있으며, 인증서 확인을 우회한 후에만 연결이 작동하는 경우에도 올바른 인증서 구성이 필요합니다.

5. 앱 로그인 문제와 에디터 연결 문제를 구분하세요.

사용자가 포털에 성공적으로 로그인했더라도 문서를 여는 데 문제가 발생할 수 있습니다. 이는 두 연결이 별개이기 때문입니다. 앱은 먼저 저장소 또는 포털에 연결해야 합니다. 파일을 열 때는 문서 서버와의 통합 과정도 필요할 수 있습니다. 따라서 모바일 로그인이 정상적으로 작동한다고 해서 편집기 서비스가 저장소 서버에 연결할 수 있거나 저장소 서버가 편집기에 연결할 수 있다는 것을 보장하는 것은 아닙니다.

파일을 연 후에만 시간 초과 오류가 발생하는 경우 관리자에게 서버 측에서 통합을 테스트해 달라고 요청하십시오. ONLYOFFICE의 Nextcloud 및 ownCloud 가이드에서는 제한된 네트워크 뒤에 설치된 경우 스토리지 서버에서 ONLYOFFICE Docs로, 그리고 ONLYOFFICE Docs에서 스토리지 서비스로의 요청에 대해 내부 주소를 구성해야 할 수 있다고 설명합니다. 공용 주소는 휴대폰 브라우저에서는 작동할 수 있지만 서버 간 트래픽은 여전히 ​​실패할 수 있습니다.

관리자는 두 서비스가 서로 구성된 호스트 이름을 제대로 확인하는지, 방화벽 규칙이 필요한 트래픽을 허용하는지, 그리고 JWT가 활성화된 경우 커넥터가 문서 서버에 구성된 것과 동일한 JWT 암호를 사용하는지 확인해야 합니다. 암호를 임의로 변경하거나 JWT를 비활성화하지 마십시오. 먼저 클라우드 플랫폼용 공식 통합 가이드를 참조하여 구성된 값을 비교하십시오.

6. 자격 증명 및 앱 상태를 다시 확인하세요.

연결 가능성과 인증서를 확인한 후, 동일한 포털 또는 스토리지 계정의 웹 인터페이스에서 사용자 이름과 암호를 확인하십시오. WebDAV 엔드포인트는 서버의 인증 정책에 따라 계정의 실제 자격 증명 또는 앱 암호를 요구할 수 있습니다. 다단계 인증이 활성화된 경우 해당 서버의 지침을 따르십시오. 일반 웹 로그인 암호가 모든 WebDAV 구현에서 허용되는 것은 아닙니다.

ONLYOFFICE Documents를 공식 앱 스토어에서 업데이트한 후 앱을 닫았다가 다시 열고 계정을 다시 추가해 보세요. 이전에 잘못된 주소로 계정이 저장된 경우, 해당 연결을 삭제하고 확인된 URL로 새 연결을 생성하세요. 이 작업은 서버의 파일을 삭제하지 않습니다. 모바일 앱에서 클라우드 계정 연결을 해제하면 로컬 연결 항목만 삭제되고 원격 저장소의 내용은 유지됩니다. 앱을 다시 설치하거나 데이터를 삭제하기 전에 동기화되지 않은 로컬 문서가 모두 저장되거나 백업되었는지 확인하세요.

7. 더 간단한 원인을 모두 배제한 후에만 서버를 점검하십시오.

여러 기기와 네트워크에서 특정 공개 URL에 대한 시간 초과 오류가 발생하는 경우, 서버 또는 네트워크 경로에 문제가 있을 가능성이 높습니다. 포털, 스토리지 서비스, 리버스 프록시 및 문서 서버가 실행 중인지 확인하십시오. Docker 설치의 경우 관리자는 다음과 같은 명령어를 사용하여 컨테이너 상태 및 최근 로그를 확인할 수 있습니다.

docker compose ps
docker compose logs --tail=100 <service-name>

배포의 Compose 파일에 있는 실제 서비스 이름을 사용하십시오. 서비스 이름은 설치 환경에 따라 다를 수 있습니다. 반복적인 재시작, DNS 오류, 업스트림 연결 오류, 리소스 부족 또는 인증서 갱신 문제를 확인하십시오. 로그를 수집하기 전에 모든 구성 요소를 재시작하지 마십시오. 재시작으로 인해 오류에 대한 유용한 증거가 사라질 수 있습니다.

특히 문서 서버의 경우, 공식 도움말 센터에는 /info/관리자가 서비스가 활성화되어 있고 접근 가능한지 확인할 수 있는 페이지가 안내되어 있습니다. 이 페이지는 문서 서버 진단 도구이며, 모바일 앱에 입력한 포털 또는 WebDAV 주소를 테스트하는 것을 대체하는 것은 아닙니다. 문서 서버 정보 페이지에 대한 자세한 내용은 ONLYOFFICE의 안내를 참조하십시오 .

휴대폰에서 수정 사항을 확인하세요.

다음 순서대로 점검하십시오. 휴대폰 브라우저에서 해당 포털 또는 WebDAV URL을 엽니다. Wi-Fi 및 모바일 데이터 환경에서 동일한 작업을 반복합니다. ONLYOFFICE Documents 앱에서 해당 서비스 유형으로 계정을 추가하고 로그인합니다. 폴더를 탐색하고 간단한 테스트 문서를 엽니다. 탐색은 되지만 편집이 되지 않으면 서버 측 ONLYOFFICE Docs 통합 문제를 조사하십시오. 브라우저와 앱 모두 시간 초과 오류가 발생하는 경우, 비밀번호를 반복적으로 변경하기보다는 DNS, 방화벽, 프록시 및 서버 점검을 진행하십시오.

정상적으로 로그인되어 작업하려는 네트워크 환경에서 폴더 목록이 제대로 표시되는 것이 성공적인 결과입니다. 중요한 문서를 저장하기 전에 중요하지 않은 파일을 열고 저장해 보는 테스트를 진행하십시오. 문제가 지속될 경우, 관리자에게 정확한 URL 유형(포털, WebDAV 또는 문서 서버), 휴대폰 운영 체제, 사용 중인 네트워크, 타임스탬프, HTTP 상태 또는 프록시 로그 항목을 알려주십시오. 지원 요청 시 비밀번호, 액세스 토큰 또는 문서 내용을 보내지 마십시오.