Collabora CODE 업데이트 확인 및 원치 않는 연결 비활성화

Collabora Online Development Edition(CODE)의 예약된 버전 확인을 중지하려면 fetch_update_check및 0설정 allow_update_popup을 변경 false하십시오. 승인되지 않은 외부 서비스에 연결해서는 안 되는 배포 환경의 경우, 사용하지 않는 통합 기능을 비활성화하고 네트워크 경계에서 아웃바운드 허용 목록을 적용해야 합니다. 업데이트 알림을 숨기는 것만으로는 네트워크 트래픽을 차단할 수 없습니다.

어떤 기능을 비활성화하는지 정확히 알아두세요.

2026년 10월 현재, Collabora의 관리 coolwsd.xml.in문서에는 10시간 간격의 업데이트 확인 및 업데이트 알림에 대한 별도의 제어 기능이 명시되어 있습니다. 하지만 "원격 측정 비활성화"라는 이름의 통합 스위치는 문서에 포함되어 있지 않습니다. 업데이트 요청, 선택적 클라우드 지원 편집, 로컬 진단 로그, 그리고 문서 저장 서버와의 필수적인 WOPI 연결은 각각 별개의 요소입니다. 이러한 요소들을 하나의 설정으로 취급하면 연결이 활성화된 상태로 유지되거나 문서 편집 기능이 제대로 작동하지 않을 수 있습니다.

이 지침은 주로 독립형 collabora/codeDocker 배포에 적용됩니다. 패키지 설치도 동일한 구성 개념을 사용하지만 일반적으로 서비스를 편집 /etc/coolwsd/coolwsd.xml하고 다시 시작합니다 coolwsd. 다른 제품에서 관리하는 내장 CODE 설치의 경우 시작 옵션이 다시 생성될 수 있으므로 임시 파일을 수정하는 대신 관리 제품에서 변경하십시오.

1. 실행 중인 설정을 확인하고 롤백을 유지하세요.

먼저 CODE 서비스가 Docker Compose, 명령어 또는 네이티브 패키지를 통해 구성되었는지 확인하십시오 docker run. Docker를 사용하는 경우, 환경 변수에 자격 증명이 포함될 수 있으므로 출력을 공개적으로 게시하지 않고 컨테이너와 현재 환경을 검사하십시오.

docker ps --format 'table {{.Names}}	{{.Image}}'
docker inspect --format '{{range .Config.Env}}{{println .}}{{end}}' code

컨테이너 이름을 실제 이름으로 바꾸세요 code. 변경하기 전에 배포 파일 또는 기존 파일의 안전한 사본을 저장해 두세요 coolwsd.xml. Compose 구성에 이미 TLS 종료, WOPI 호스트 허용 또는 인증 매개변수가 포함되어 있는 경우 해당 값을 유지하세요.

2. 주기적 업데이트 연결을 비활성화합니다.

Docker Compose용

extra_paramsCODE 서비스 블록 아래의 기존 값에 다음 옵션을 추가하세요 environment. 이는 전체 Compose 파일을 대체하는 것이 아니라 일부만 발췌한 것입니다.

services:
  code:
    environment:
      extra_params: >-
        --o:fetch_update_check=0
        --o:allow_update_popup=false

기존 플래그를 덮어쓰지 말고 두 플래그를 기존 플래그와 병합하세요 . 그런 다음 실제 Compose 서비스 이름을 사용하여 extra_paramsCODE 서비스만 다시 생성합니다 . 배포 시 컨테이너를 다시 생성할 때 환경 변수 에 동일한 옵션을 포함하세요 .docker compose up -d --no-deps --force-recreate codedocker runextra_params

Linux 패키지용

편집 /etc/coolwsd/coolwsd.xml. 기존 요소를 찾아 원래 속성을 유지하면서 값을 변경합니다.

<fetch_update_check>0</fetch_update_check>
<allow_update_popup>false</allow_update_popup>

기존 요소에 속성이 포함되어 있으면 해당 속성을 유지하고 텍스트 값만 변경하십시오. 재시작하기 전에 파일이 유효한 XML인지 확인하십시오. 예를 들어, 설치되어 있다면 해당 명령어를 사용하십시오 xmllint --noout /etc/coolwsd/coolwsd.xml. xmllint명령어를 사용하여 재시작하십시오 sudo systemctl restart coolwsd.

중요: allow_update_popup=false 이 설정은 편집기의 업데이트 알림을 비활성화하는 것이며, 그 자체로 출구 제어 기능은 아닙니다. 이 fetch_update_check=0설정은 예약된 확인 작업에 대한 것입니다. 조직에서는 일반적인 유지 관리 프로세스를 통해 보안 업데이트를 계속 추적해야 합니다.

3. 다른 호스트와 통신할 수 있는 선택적 서비스를 끄세요.

원격 통합에 대한 활성 구성을 검토하십시오. 현재 상위 구성에서 원격 LanguageTool 또는 Duden 교정은 기본적으로 비활성화되어 있으며, 서버 전체 AI 및 DeepL 스위치도 기본적으로 비활성화되어 있는 것으로 문서화되어 있습니다. 관리자 또는 통합 담당자가 이러한 옵션을 활성화했을 수 있습니다. 설치된 CODE 버전에 이러한 옵션이 있는 경우, 필요하지 않다면 비활성화 상태를 유지하십시오.

--o:languagetool.enabled=false
--o:ai.enabled=false
--o:deepl.enabled=false

설치된 버전에서 지원하는 옵션만 포함하고, extra_params두 번째 충돌하는 값을 설정하는 대신 해당 옵션들을 병합하십시오. 동일한 효과는 네이티브 XML 설치의 해당 <languagetool>, <ai>, 섹션에서 구성할 수 있습니다.<deepl>

삭제하기 전에 해당 설정을 확인하십시오 remote_config.remote_url. remote_font_config.url원격 구성 URL이 비어 있으면 선택적 구성 가져오기가 생략됩니다. 원격 글꼴 URL은 Nextcloud 설치 위치를 가리킬 수 있습니다. 이를 제거하면 문서의 서체에 영향을 줄 수 있으므로 글꼴 서비스가 승인되고 필요한 경우 유지하십시오. 또한 배포 환경에 따라 구성된 모니터링 WebSocket 주소와 인용 관리자 등의 추가 플러그인도 검토하십시오.

로깅은 별도의 개인정보 보호 문제이며 외부 원격 측정의 증거가 아닙니다. 진단에서 로컬 식별자를 제한하려면 logging.docstats, logging.userstats, 및 를 검토 logging.anonymize.anonymize_user_data하십시오. 문제 해결을 위해 충분한 보안 및 운영 로깅을 유지하십시오. 로그 상세 수준을 변경해도 외부 소켓이 차단되지는 않습니다.

4. WOPI를 위반하지 않고 아웃바운드 트래픽을 제한합니다.

설정 변경만으로는 예기치 않은 외부 연결을 완전히 차단할 수 없습니다. CODE를 배포에 필요한 특정 대상 및 포트를 허용하는 방화벽 또는 이그레스 프록시 뒤에 배치하십시오. 일반적으로 이는 승인된 WOPI 스토리지 호스트, 실제로 사용하는 내부 글꼴 또는 ID 서비스, 그리고 내부 DNS와 같은 필수 인프라를 의미합니다. 승인되지 않은 업데이트 엔드포인트를 포함한 다른 인터넷 대상은 CODE 워크로드에서 차단하십시오.

네트워크 연결을 무턱대고 비활성화하거나 Docker 네트워크 설정을 다음과 같이 지정하지 마십시오 internal: true. 아키텍처에 따라 CODE가 WOPI 서버에 연결하지 못하거나 필요한 통합 기능이 작동하지 않을 수 있습니다. 또한 사용자의 브라우저가 에디터 리소스를 로드하고 CODE 서버와는 별개로 요청을 보낼 수 있다는 점을 기억하십시오. 서버 방화벽 규칙은 브라우저에 적용되지 않습니다.

iptables 백엔드를 사용하는 Docker Engine 설치의 경우, Docker는 DOCKER-USER관리자 포워딩 규칙을 위한 최적의 위치로 해당 체인을 명시하고 있습니다. nftables 백엔드를 사용하는 경우에는 기본 체인이 DOCKER-USER존재한다고 가정하지 말고 별도의 기본 체인을 구현해야 합니다. 실제 브리지 또는 컨테이너 네트워크, IPv4 및 IPv6, DNS, 연결 상태, 그리고 정상적인 WOPI 트래픽에 대한 규칙을 설계하십시오. 일반적인 규칙을 복사해서 붙여넣으면 오프라인에서 편집해야 할 수 있습니다. 정책을 적용하기 전에 Docker의 iptables 지침 과 nftables 지침을DROP 참조하십시오 .

5. 실제 네트워크 활동을 포함하여 변경 사항을 확인합니다.

컨테이너를 재시작하거나 재구성한 후에는 시작 로그에서 구성 오류를 확인하고, 일반적인 스토리지 통합을 통해 문서를 열고 편집하고 저장하는 기능을 테스트하십시오. 편집기가 정상적으로 작동하는 것만으로는 승인되지 않은 요청이 모두 중단되었다는 것을 의미하지 않습니다. 실행 중인 시작 매개변수를 확인한 다음, 시작 및 문서 편집 중에 방화벽, 이그레스 프록시 또는 컨테이너 네트워크의 DNS 및 아웃바운드 연결 로그를 검토하십시오.

docker logs --since 10m code
# Check configured flags without exposing unrelated environment secrets:
docker inspect --format '{{range .Config.Env}}{{println .}}{{end}}' code | grep '^extra_params='

네이티브 설치 환경에서는 sudo journalctl -u coolwsd --since '10 minutes ago'로컬 XML을 사용하고 검사하십시오. 브라우저 환경에서는 브라우저의 개발자 도구를 열고 문서를 연 상태에서 네트워크 탭을 검토하십시오. 자체 CODE 및 WOPI 호스트에 대한 요청과 타사 대상에 대한 요청을 구분하십시오.

성공 기준: CODE가 문서를 정상적으로 로드하고 저장하는지, 업데이트 확인 옵션이 0으로 설정되어 있는지, 명시적으로 승인되지 않는 한 선택적 클라우드 통합이 비활성화되어 있는지, 그리고 관찰 기간 동안 네트워크 모니터링에 허용된 대상만 표시되는지 확인합니다. 트래픽 필터링 후 문서 로드가 실패하는 경우, TLS 인증서 확인을 비활성화하거나 무제한 트래픽 출력을 허용하는 대신, 승인된 WOPI 및 인프라 목록을 기준으로 거부된 대상을 일시적으로 검토하십시오.

주요 참조 자료: Collabora에서 관리하는 서버 구성 템플릿 , Nextcloud All-in-One CODE 컨테이너 구성 , 공식 CODE Docker 이미지 설명 . 이러한 자료들은 관련 설정 및 배포 패턴을 설명하지만, 사용자의 특정 설치 환경에 대한 네트워크 진단을 대체하는 것은 아닙니다.