CODE의 WOPI 호스트 검사 오류를 수정하려면 호스트 출처를 일치시키세요.

Collabora Online CODE에서 "승인되지 않은 WOPI 호스트" 오류가 발생하면 실제 파일 저장소 호스트(일반적으로 Nextcloud 오리진 서버)를 CODE의 WOPI 호스트 허용 목록에 추가하세요. 호스트는 Collabora 서버의 공개 URL이 아닌 WOPI 요청에서 CODE가 수신하는 오리진 서버 주소와 일치해야 합니다. Docker 환경에서는 일반적으로 aliasgroup1환경 변수를 사용하여 설정합니다.

CODE가 거부하는 것은 무엇입니까?

WOPI는 웹 애플리케이션 개방형 플랫폼 인터페이스의 약자로, 오피스 서버가 스토리지 플랫폼을 통해 파일을 열고 저장하는 데 사용하는 프로토콜입니다. WOPI 호스트는 Nextcloud와 같은 스토리지 플랫폼입니다. CODE는 WOPI 요청에 지정된 호스트를 신뢰하는 호스트 목록과 비교합니다. 요청에 지정된 호스트 cloud.example.com가 CODE가 특정 호스트만 신뢰하도록 설정되어 있는 경우 office.example.com, 에디터는 세션이 열리기 전에 거부할 수 있습니다.

자체 호스팅 환경의 경우, 요청의 호스트 이름은 nextcloud브라우저에 표시되는 호스트 이름이 아니라 Docker 내부 이름일 수 있습니다. 리버스 프록시, 다른 포트 또는 별도의 공용 및 내부 URL로 인해 원본이 달라질 수도 있습니다. "기본" 서버 이름처럼 보이는 것이 아니라 요청에서 실제로 사용하는 호스트 이름을 구성해야 합니다.

호스트 CODE가 거부하고 있습니다.

1. 오류를 한 번 재현한 다음, 해당 시점의 CODE 컨테이너 로그를 확인하십시오. Docker Compose를 사용하는 경우, `< service name>` 부분 을 서비스 이름으로 docker compose logs --since=10m collabora바꿔서 실행하십시오.collabora
2. 다음과 같은 메시지를 찾으세요 No acceptable WOPI hosts found matching the target host [cloud.example.com] in config. 괄호 안에 표시된 대상 호스트를 기록하세요. 전체 WOPI URL을 복사하거나 공유하지 마세요. 해당 URL에는 수명이 짧은 액세스 토큰이 포함될 수 있습니다.
3. 해당 호스트 이름과 스키마를 스토리지 통합이 CODE에 알리는 URL과 비교하십시오. Nextcloud의 문제 해결 가이드에서는 구성된 URL이 Nextcloud URL인지, 그리고 CODE에서 해당 URL에 접근할 수 있는지 확인하라고 권장합니다. WOPISrc통합 로그에서 호스트 정보를 확인할 수 있다면, 쿼리 문자열 토큰은 비공개로 유지하십시오.

코드에서 올바른 출처를 허용하세요

공식 CODE Docker 이미지의 경우, aliasgroup1신뢰할 수 있는 WOPI 오리진을 정확하게 설정하십시오. 단일 Nextcloud 설치의 경우, Compose 서비스에는 다음이 포함될 수 있습니다.

services:
  collabora:
    image: collabora/code
    environment:
      aliasgroup1: "https://cloud.example.com:443"

예제를 실제 Nextcloud 호스트와 WOPI 요청에 사용되는 스키마 및 포트로 교체하십시오. Compose 파일의 기존 이미지 태그, 관리자 설정, 네트워크 및 기타 서비스 옵션은 그대로 유지하십시오. 이 예제는 포트 443을 사용하는 HTTPS 오리진을 사용하지만, 다른 배포 환경에서는 다른 포트 또는 내부 오리진을 사용할 수 있습니다.

Compose 파일을 편집한 후, 업데이트된 환경을 받을 수 있도록 CODE 컨테이너를 다시 생성하십시오.

docker compose up -d --force-recreate collabora

`<code>` 대신 실제 Compose 서비스 이름을 사용하십시오 collabora. 단순히 재시작하는 것만으로는 변경된 컨테이너 환경 값이 로드되지 않을 수 있습니다. 서비스를 다시 생성해야 업데이트된 구성이 적용됩니다. XML 파일을 통해 CODE를 구성하는 경우, storage.wopi유효한 구성에서 별칭 그룹을 확인하십시오. Collabora SDK 공식 설명서에는 Docker 별칭 그룹 및 WOPI 호스트 별칭에 대한 내용이 나와 있습니다. 사용 중인 CODE 버전의 구문을 따르십시오.

두 개의 허용 목록을 별도로 유지하세요.

Collabora와 Nextcloud는 각각 WOPI 관련 제한을 적용할 수 있지만, 답변하는 질문은 서로 다릅니다.

Nextcloud의 소스 IP 허용 목록을 변경해도 CODE에서 호스트 이름을 거부하는 문제는 해결되지 않습니다. 반대로 CODE에 호스트 이름을 추가한다고 해서 Nextcloud에서 CODE의 소스 IP가 승인되는 것은 아닙니다. Nextcloud 설명서에서는 WOPI 요청을 Collabora 서버의 IP 주소로 제한할 것을 권장합니다. 컨테이너나 리버스 프록시가 사용되는 경우 Nextcloud에서 확인한 IP 주소가 달라질 수 있으므로, 이때는 Nextcloud에서 확인한 주소를 사용해야 합니다.

사건 종결 전 신속 확인

• 대상은 다음과 같이 말합니다 cloud.example.com. Nextcloud 호스트와 해당 오리진을 코드에서 허용하십시오.
• 대상은 다음과 같이 말합니다 nextcloud. "CODE가 Docker 네트워크 호스트 이름을 수신하고 있을 가능성이 높습니다. 해당 내부 출처가 의도된 것인지 판단한 다음, 해당 신뢰할 수 있는 호스트를 구성하고 DNS/네트워크 연결성을 확보하십시오."
• 대상은 일치하지만 동일한 거부 오류가 계속 발생합니다. 편집된 변수가 실행 중인 CODE 서비스에 속하는지, Compose가 컨테이너를 다시 생성했는지, 그리고 이후 환경 또는 XML 구성에서 해당 설정을 재정의하지 않았는지 확인하십시오.
• 로그가 DNS, TLS, 타임아웃 또는 CheckFileInfo 실패로 변경되었습니다. 호스트 권한 확인은 이제 통과되었을 수 있습니다. WOPI 호스트 목록을 확장하는 대신 이름 확인, 인증서 신뢰, 라우팅 또는 스토리지 통합의 파일 정보 응답을 조사하십시오.
• Nextcloud에서 승인되지 않은 요청 주소를 보고했습니다. Nextcloud의 소스 IP 허용 목록과 실제로 Nextcloud에서 감지한 클라이언트 IP를 검토하십시오.

프로덕션 환경에서 모든 호스트를 신뢰하거나 무제한 와일드카드를 사용하여 불일치를 해결하지 마십시오. 허용 ​​목록은 알려진 스토리지 출처로 제한해야 합니다. 여러 스토리지 호스트를 의도적으로 사용하는 경우, 와일드카드 동작을 추측하는 대신 설치된 CODE 버전에 맞는 문서화된 별칭 그룹을 구성하십시오.

수정 사항을 확인하세요

오류가 발생했던 Nextcloud 통합을 통해 문서를 엽니다. 그런 다음 최신 CODE 로그를 확인합니다. "허용 가능한 WOPI 호스트가 없습니다"라는 오류가 사라져 있어야 합니다. 문서가 로드되고 저장 가능한지 확인합니다. 새로운 오류가 발생하면 해당 메시지를 사용하여 다음 단계를 진행합니다. 두 가지 호스트 확인 및 Nextcloud 문제 해결 절차에 대한 자세한 내용은 Nextcloud Office 문제 해결 및 Nextcloud Office 구성 문서를 참조하십시오. CODE Docker 별칭 그룹에 대한 자세한 내용은 Collabora Online SDK 25.04 설명서를 참조하십시오 . 설치된 릴리스의 구성이 다른 경우 해당 릴리스의 설명서를 참조하십시오.