Collabora의 "이건 정말 난감한 상황이네요" 오류 해결하기

먼저 브라우저, Nextcloud, Collabora가 모두 동일한 HTTP 또는 HTTPS 스키마를 통해 올바른 서버 URL에 연결할 수 있는지 확인하십시오. Nextcloud에서 Collabora의 엔드포인트를 테스트하고, /hosting/capabilities해당 /hosting/discovery엔드포인트에 응답은 있지만 문서 로딩에 여전히 실패하는 경우 리버스 프록시의 WebSocket 경로와 WOPI 허용 목록을 확인하십시오.

"이런, 난감한 상황이 발생했네요"라는 메시지는 일반적인 문서 열기 실패를 나타내는 것이며, 그 자체로 진단은 아닙니다. 원인은 연결할 수 없는 URL, TLS 또는 DNS 불일치, WebSocket 업그레이드를 차단하는 프록시, 또는 Collabora나 Nextcloud에서 신뢰하지 않는 WOPI 호스트일 수 있습니다. 아래 검사 예시에서는 Nextcloud 주소 https://cloud.example.com와 Collabora https://office.example.com주소를 사용하므로, 실제 호스트 이름으로 바꿔서 진행하십시오.

1. Collabora 엔드포인트가 제대로 로드되나요?

사용자와 동일한 네트워크에 있는 브라우저에서 Collabora 호스트 이름을 변경하여 다음 URL을 엽니다.

• https://office.example.com/hosting/capabilities
• https://office.example.com/hosting/discovery

브라우저 인증서 경고, 404 페이지 또는 역방향 프록시 오류가 아닌 Collabora 엔드포인트 데이터가 반환되어야 합니다. 검색 엔드포인트는 일반적으로 XML을 반환합니다. Nextcloud 호스트 또는 애플리케이션 컨테이너에서도 테스트할 수 있습니다.

curl -fsS https://office.example.com/hosting/capabilities
curl -fsS https://office.example.com/hosting/discovery

브라우저에서 오류가 발생하는 경우 공용 또는 LAN DNS, 방화벽, 인증서 또는 프록시 라우팅 문제일 수 있습니다. 브라우저에서는 성공했지만 Nextcloud 명령줄에서 오류가 발생하는 경우 서버 측 경로가 다르다는 의미입니다. 사용자의 브라우저와 Nextcloud 서버는 각각 Collabora에 대한 고유한 경로를 설정해야 합니다. Nextcloud의 최신 관리 설명서에서는 두 위치에서 모두 엔드포인트를 테스트하고 Collabora가 HTTP(S)를 통해 Nextcloud에 연결할 수 있는지 확인하는 것을 권장합니다.

2. 두 서비스가 호스트 이름과 프로토콜에 대해 일치합니까?

Nextcloud에서 설정 → 관리 → Office 로 이동하여 Collabora Online 서버 필드에 공개 또는 접근 가능한 Collabora URL이 포함되어 있는지 확인하십시오. https://서비스가 HTTPS로 구성된 경우 해당 URL을 사용하십시오. Nextcloud 설명서에 따르면 구성된 URL은 Collabora 설치와 동일한 프로토콜을 사용해야 하며 HTTPS를 권장합니다.

이제 반환 경로를 확인하세요. Collabora 호스트 또는 컨테이너에서 Nextcloud의 상태 엔드포인트를 요청합니다.

curl -fsS https://cloud.example.com/status.php

응답은 노트북뿐만 아니라 Collabora에서도 접근 가능해야 합니다. 서버가 Docker에 있는 경우 해당 컨테이너 또는 네트워크 네임스페이스에서 테스트하십시오. 호스트에서 확인되는 호스트 이름이 컨테이너 내부에서는 확인되지 않을 수 있습니다. 내장 CODE 서버의 경우 Nextcloud는 사용자가 브라우저에서 사용하는 것과 동일한 호스트 이름을 사용하여 자체에 접근할 수 있어야 합니다. 분할 DNS 또는 로컬 이름 확인으로 인해 이것이 불가능한 경우 localhost원격 서비스에 대한 호스트 이름을 입력하는 대신 DNS 또는 호스트 매핑을 수정하십시오.

3. 리버스 프록시가 웹소켓 트래픽을 전달합니까?

검색 URL은 로드되지만 편집기 창이 비어 있거나, 로딩 중이거나, 연결이 끊어지는 경우 Collabora 앞에 있는 프록시를 점검하십시오. 편집에는 영구적인 WebSocket 연결이 사용되므로 프록시는 Collabora의 현재 /cool/…/ws엔드포인트를 Collabora 서비스로 라우팅하고 HTTP/1.1 업그레이드 헤더를 전달해야 합니다. 사용 중인 프록시 소프트웨어 및 버전에 맞는 최신 Collabora 프록시 예제를 확인하십시오. 이전 구성을 변경하지 않고 붙여넣지 마십시오.

이전 설치 환경에서는 여전히 와 같은 경로를 사용할 수 있습니다 . Collabora의 마이그레이션 가이드에는 에서 로 , 에서 로의 /lool변경 사항이 명시되어 있습니다 . 이전 경로에 남아 있는 프록시는 기본 도메인이 열려 있더라도 404 오류를 반환할 수 있습니다. 프록시 파일을 편집한 후에는 해당 서버의 테스트 명령으로 구문을 검증하고, 서버를 다시 로드한 다음, 검색 URL을 다시 테스트하고 문서를 열어 보십시오.loolcoolloleafletbrowser

실패한 시도와 동일한 시점의 액세스 및 오류 로그를 확인하십시오. 404 오류는 경로 라우팅 문제를 시사 /browser하며 /cool, WebSocket 업그레이드 실패는 업그레이드 처리 누락 또는 시간 초과를 나타냅니다. 502 오류는 일반적으로 프록시가 Collabora 업스트림에 연결할 수 없음을 의미합니다. 이러한 정보는 단서일 뿐 확정적인 진단은 아니므로 Collabora 자체 로그와 비교하여 확인하십시오.

4. WOPI 호스트가 허용됩니까?

WOPI(Web Application Open Platform Interface)는 Nextcloud와 Collabora가 문서 접근 요청을 교환하는 데 사용하는 프로토콜입니다. Collabora 로그에 "허용 가능한 WOPI 호스트를 찾을 수 없습니다" 또는 승인되지 않은 WOPI 호스트가 보고되는 경우, Collabora가 자체 Collabora 호스트 이름이 아닌 Nextcloud 호스트 이름을 신뢰하도록 구성되었는지 확인하십시오. Docker 이미지의 경우, 컨테이너의 시작 구성 및 로그를 검사하십시오.

docker ps
 docker logs --tail=100 CONTAINER_NAME

<container_name> 부분을 Collabora 컨테이너의 실제 이름으로 바꾸십시오 CONTAINER_NAME. 네이티브 패키지 설치의 경우, 서비스 로그를 확인하십시오 sudo journalctl -u coolwsd --since "15 minutes ago". 설치 방법에 따라 WOPI 호스트 구성 지침을 따르십시오. 광범위한 와일드카드 허용 규칙은 사용하지 마십시오.

Nextcloud Office에는 별도의 WOPI 허용 목록이 있습니다. 이 목록은 Nextcloud에서 파일을 요청할 수 있는 Collabora 서버 IP 주소를 제한합니다. Docker 네트워킹이나 리버스 프록시가 사용되는 경우 다를 수 있는 Nextcloud에서 실제로 인식하는 Collabora의 소스 IP 주소를 추가하십시오. 0.0.0.0오류를 숨기기 위해 제한을 추가하거나 비활성화하지 마십시오. Nextcloud는 WOPI 요청을 예상되는 Collabora 서버 주소로 제한하는 것을 권장합니다.

수정 사항을 확인하세요

사용자 브라우저와 Nextcloud 서버에서 다시 테스트하십시오. 검색 및 기능 엔드포인트가 응답해야 하고, Nextcloud는 구성된 Collabora URL에 연결되어야 하며, Collabora는 Nextcloud의 상태 엔드포인트에 연결되어야 합니다. 그런 다음 간단한 테스트 문서를 여십시오. 여전히 실패하는 경우 타임스탬프, 영향을 받은 문서 작업, 프록시 로그의 HTTP 또는 WebSocket 상태, 그리고 해당 Nextcloud 및 Collabora 로그 항목을 기록하십시오. 이러한 증거는 네트워크 경로 오류와 WOPI 인증 문제를 구분하는 데 도움이 됩니다.

공식 참조

• Nextcloud Office 문제 해결 점검 및 연결 오류
• Nextcloud Office URL 및 WOPI 구성
• Nextcloud의 Collabora 엔드포인트 경로 변경 관련 안내
• Collabora Online 리버스 프록시 설정