Nextcloud를 CODE Docker에 연결하기: 설정 및 장단점

Nextcloud를 Collabora CODE에 연결하려면 공식 collabora/code이미지를 실행하고, 포트를 호스트로 제한하고, HTTPS 오피스 서브도메인을 WebSocket 지원 리버스 프록시를 통해 라우팅한 다음, Nextcloud의 Collabora 통합에서 해당 공개 URL을 설정하십시오. Docker, DNS, TLS 및 프록시가 모두 준비된 경우에만 10분 안에 연결이 완료될 수 있습니다.

먼저 적합한 오피스 서비스를 선택하세요. 2026년 10월부터 Nextcloud는 Euro-Office 기반의 Nextcloud Office와 Collabora Online을 구분하여 제공합니다. CODE는 Collabora Online 개발자용 에디션이므로 Euro-Office 커넥터가 아닌 Collabora 통합 기능을 사용해야 합니다. 내장된 CODE 앱은 개인 용도로는 가장 빠르지만, Nextcloud는 속도가 느리고 확장성이 부족하다고 설명합니다. 별도의 컨테이너를 사용하면 독립적으로 관리하기는 쉽지만 프록시 및 업데이트 작업이 추가됩니다. CODE는 가정 및 테스트 용도에 적합하며, 기업 환경에서 운영 지원이 필요한 경우에는 지원되는 Collabora Online 배포 버전을 선택하세요.

시작하기 전에: 10분 코스

Nextcloud HTTPS 주소, 유효한 TLS가 설정된 별도의 회사 호스트 이름, 그리고 CODE 호스트에 대한 Docker 액세스 권한이 필요합니다. 회사 호스트 이름을 컨테이너로 라우팅할 수 있는 리버스 프록시로 연결하십시오. 사용자 브라우저와 Nextcloud 서버 모두 회사 URL에 접속할 수 있어야 합니다.

DNS 또는 TLS가 준비되지 않은 경우, 9980번 포트를 바로가기처럼 공개적으로 노출하지 마십시오. 루프백 인터페이스에 바인딩하고 프록시 설정을 먼저 완료하십시오.

1. CODE Docker 컨테이너를 시작합니다.

샘플 Nextcloud 호스트 이름을 사용자가 로그인할 때 사용하는 정확한 HTTPS 원본 호스트 이름으로 바꾸십시오. 이 aliasgroup1설정은 연결할 수 있는 WOPI 호스트(편집기에 문서를 제공하는 파일 서비스)를 제한합니다. 연결 실패를 숨기기 위해 와일드카드를 사용하지 마십시오.

docker pull collabora/code

docker run -t -d --name collabora-code -p 127.0.0.1:9980:9980 -e 'aliasgroup1=https://cloud.example.com:443' --restart unless-stopped --cap-add MKNOD collabora/code

바인딩을 사용하면 127.0.0.1포트가 비공개로 유지되는 동안 동일 호스트의 프록시가 해당 포트에 접근할 수 있습니다. 프록시가 다른 곳에 있는 경우, 신뢰할 수 있는 프록시만 9980번 포트에 연결할 수 있도록 허용하십시오.

컨테이너가 시작되었는지, 그리고 해당 검색 엔드포인트가 로컬에서 응답하는지 확인하십시오.

docker ps --filter name=collabora-code
docker logs --tail=50 collabora-code
curl -kfsS -o /dev/null -w 'Discovery HTTP %{http_code}\n' https://127.0.0.1:9980/hosting/discovery

-k이 기능은 로컬 자체 서명 인증서 검사에 대해서만 인증서 유효성 검사를 우회하며, 유효하지 않은 공개 인증서를 수정하지는 않습니다.

2. 공공기관 호스트 이름을 HTTPS 뒤에 배치하십시오.

https://office.example.com유효한 인증서를 사용하여 리버스 프록시에서 서비스를 제공 하고 요청을 CODE로 라우팅하세요. Collabora의 프록시 가이드에는 에디터 자산, 검색/기능 /cool/, WebSocket 포워딩에 대한 내용이 포함되어 있습니다. WebSocket 업그레이드를 하지 않으면 페이지는 로드되지만 에디터가 작동하지 않을 수 있습니다.

프록시 소프트웨어에 대해 유지 관리되는 구성을 사용하십시오. 프록시 소프트웨어가 CODE 이전에 TLS를 종료하는 경우, 문서화된 백엔드 TLS 설정을 따르십시오. 인증서 검사를 전역적으로 비활성화하지 마십시오.

3. Nextcloud에서 Collabora 통합을 연결합니다.

Nextcloud에서 사용 중인 릴리스에 맞는 Collabora 통합 앱을 활성화하거나 설치합니다. 그런 다음 Office 관리 영역을 열고 공개 Collabora URL을 입력합니다 https://office.example.com. 최신 설명서에서는 이 설정을 "Collabora 온라인 서버"라고 표시하고 있지만, 특히 Nextcloud에 Euro-Office 옵션이 추가됨에 따라 릴리스별로 용어 및 앱 이름이 다를 수 있습니다. 이 CODE 서버에 대해 Collabora Online을 선택합니다. Nextcloud 자체가 동일한 호스트에서 실행되고 해당 주소가 구성된 서비스 엔드포인트인 경우가 아니면 컨테이너 전용 주소를 입력하지 마십시오 https://127.0.0.1:9980. 권장 프록시 설정에서는 공개 사무실 호스트 이름을 사용하십시오.

설정을 저장하고, 사용 중인 릴리스에 내장된 연결 확인 기능이 있다면 실행하세요. 연결 확인에 실패하면, Nextcloud 오리진의 정확한 위치를 확인하고 aliasgroup1, Nextcloud와 브라우저 모두 사무실 호스트 이름을 확인하고 연결할 수 있는지 확인한 후, 리버스 프록시 로그에서 경로 차단 또는 WebSocket 오류가 있는지 검사하세요.

4. 편집 내용을 확인한 후 코드가 적합한지 선택하세요.

Nextcloud에서 간단한 테스트 문서를 열고 브라우저 편집기에서 제대로 열리는지, 변경 사항을 적용하고 저장한 후 변경 내용이 그대로 유지된 채 다시 열리는지 확인하십시오. 일반 사용자 계정과 관리자 계정 모두에서 테스트하십시오. 검색 검사가 정상적으로 작동하는 것만으로는 CODE가 응답한다는 것을 확인할 수 있지만, WOPI 인증, 프록시 웹소켓, 문서 저장 작업이 모두 정상적으로 작동한다는 것을 증명하는 것은 아닙니다.

개인 서버나 소규모 팀의 경우, CODE Docker를 사용하면 편집기를 Nextcloud의 PHP 스택에서 분리할 수 있습니다. 또한 프록시, 재시작, 호환성 검사 및 이미지 업데이트도 직접 관리할 수 있습니다. 내장된 CODE 앱은 더 간단하지만 호스트를 공유하며 확장성 기능이 부족합니다. 매일 편집 작업을 해야 하는 조직의 경우, CODE를 프로덕션 환경에 그대로 적용하기보다는 Collabora Online에서 지원하는 서비스를 검토해 보는 것이 좋습니다.

CODE를 업데이트할 준비가 되면 새 이미지를 가져와 동일한 옵션으로 컨테이너를 다시 생성하세요. 사용자가 의존하는 서비스를 업데이트하기 전에 릴리스 노트를 검토하고 문서 열기 및 저장을 테스트하세요. 태그는 latest이동할 수 있습니다. 반복적인 배포가 중요한 경우 특정 이미지 버전을 고정하세요.

검증

공용 사무실 호스트 이름에 유효한 인증서가 표시되고, Nextcloud 연결 확인이 성공하며, 테스트 문서가 편집기를 통해 열리고 저장되고 다시 열리는 경우 설정이 정상적으로 작동하는 것입니다. 사무실 랜딩 페이지는 로드되지만 편집이 멈추는 경우 WebSocket 포워딩을 확인하십시오. Nextcloud에서 호스트가 허용되지 않는다고 보고하는 경우 aliasgroup1실제 Nextcloud 오리진과 일치하도록 수정하십시오. CODE가 로컬에서는 응답하지만 사용자 브라우저에서는 응답하지 않는 경우 공용 DNS, 방화벽 라우팅 및 리버스 프록시를 확인하십시오.

참고 자료: Nextcloud Docker 설치 예제 ; Nextcloud Office 설치 옵션 ; Nextcloud Collabora 구성 ; Collabora 역방향 프록시 설정 ; 공식 CODE Docker 이미지 세부 정보 ; Nextcloud Hub 26 Summer Office 옵션 .