Collabora 편집 세션의 유휴 시간 제한을 설정하는 방법

Collabora Online에는 "유휴 시간 초과"처럼 들리는 설정이 몇 가지 있지만, 각각 다른 동작을 제어합니다. 사용자가 작업 중인 동안 편집기 화면이 흐려지거나 업데이트가 중지되는 경우, 보기별 비활성 설정을 조정하세요. 모든 사용자가 나간 후에도 문서가 로드된 상태로 남아 있는 경우, 문서별 시간 초과 설정을 조정하세요. 편집기 연결이 실제로 끊어진 경우에는 Collabora의 유휴 정책을 변경하기 전에 리버스 프록시의 WebSocket 시간 초과를 확인하세요.

현재 Collabora Online 구성 템플릿에는 보기당 15분의 유휴 시간 제한, 브라우저 탭에서 포커스가 해제될 경우 5분의 시간 제한, 그리고 유휴 문서가 언로드되기 전 1시간의 시간 제한이 설정되어 있습니다. 이러한 기본값은 릴리스 및 패키징에 따라 다를 수 있으므로 변경하기 전에 설치된 버전에 포함된 구성을 확인하십시오. 아래 값은 이 가이드에서 확인한 현재 템플릿을 기준으로 하며, 모든 CODE 또는 엔터프라이즈 배포 환경에서 동일하게 적용되는 것은 아닙니다.

원하는 동작에 따라 설정을 선택하세요.

Collabora는 현재 coolwsd 구성 템플릿 및 구성 참조 에서 각 항목의 의미와 기본값을 설명합니다 . 보기별 유휴 시간 초과는 계정을 닫거나 액세스 권한을 취소하는 것과는 다릅니다. 보기의 밝기를 낮추고 업데이트를 중지하는 기능입니다. 문서별 시간 초과는 유휴 문서 프로세스를 종료하는 것으로, 현재 활발하게 편집 중인 사용자를 종료하는 타이머가 아닙니다.

추천 시작점

• 사용자가 활성화한 탭이 너무 빨리 어두워지지 않도록 하려면 기본 설정값보다 짧은 간격(예: 1,800초(30분))으로 늘려 보세요 per_view.idle_timeout_secs. 이는 실용적인 시작점일 뿐, 모든 경우에 적용되는 권장 사항은 아닙니다.
• 사용자가 문서를 최신 상태로 유지하면서 탭을 전환할 수 있도록 하려면, 별도로 지연 시간을 늘리세요 per_view.out_of_focus_timeout_secs. 사용자가 현재 선택된 탭에서 활동하지 않는다는 이유만으로 지연 시간을 늘리지 마세요.
• 문서 사용이 중단된 후 메모리 사용량을 줄이려면 보기별 값은 그대로 두고, per_document.idle_timeout_secs문서가 실제로 사용되지 않고 저장 공간이 정상적으로 유지되는지 확인한 후 값을 낮추는 것을 고려하십시오.
• 고정 시간 연결 끊김 문제를 해결하려면 프록시, 인그레스 또는 로드 밸런서의 WebSocket 타임아웃을 확인하십시오. 뷰별 화면 밝기 조절 설정을 변경해도 프록시가 닫은 WebSocket 연결은 복구되지 않습니다.
• 잦은 저장을 유지하세요: 특별한 이유가 없는 한 유휴 저장 및 자동 저장 값은 현재 설정 그대로 두십시오.

coolwsd.xml 파일에서 설정을 변경하세요.

패키지 기반 설치의 경우, coolwsd.xml실행 중인 서비스에서 사용하는 활성 파일을 찾으십시오. 일반적인 위치는 다음과 같지만 /etc/coolwsd/coolwsd.xml, 배포판 및 이전 버전에 따라 경로가 다를 수 있습니다. 샘플 파일이나 사용되지 않는 마운트된 복사본을 편집한다고 해서 실행 중인 서비스가 변경될 것이라고 가정하지 마십시오.

활성 파일을 백업한 다음 기존 섹션 아래의 관련 값만 편집합니다 <per_view>. <per_document>예를 들어, 다음 예시는 비활성 사용자 시간 제한 30분, 백그라운드 탭 시간 제한 15분, 유휴 문서 언로드 시간 2시간을 설정합니다.

<per_view>
    <idle_timeout_secs>1800</idle_timeout_secs>
    <out_of_focus_timeout_secs>900</out_of_focus_timeout_secs>
</per_view>
<per_document>
    <idle_timeout_secs>7200</idle_timeout_secs>
</per_document>

이것은 발췌본이며, 전체 구성을 대체하는 것이 아닙니다. 사용 중인 버전에 포함된 파일의 속성, 주석, 중첩 구조 및 기타 요소를 그대로 유지하십시오. 일부 빌드에서는 추가 XML 속성을 요구할 수 있습니다. 탭이 포커스된 상태일 때만 밝기 조절을 변경하려면 뷰별 유휴 시간 값만 편집하십시오. 뷰별 값과 문서 언로드 값을 동시에 높이면 어떤 설정이 문제를 해결했는지 파악하기 어려워집니다.

배포 환경에서 지원하는 구성 도구를 사용하여 XML의 유효성을 검사한 다음, 해당 패키지에 설명된 방법에 따라 Collabora를 다시 시작하거나 재로드하십시오. 시작 로그에서 구성 구문 분석 오류를 확인하고 실행 중인 프로세스가 의도한 파일을 로드했는지 확인하십시오. 활성 프로세스에 없는 설정 변경 사항은 적용되지 않습니다.

Docker 또는 Kubernetes에서 동일한 옵션을 설정하세요.

Collabora의 Docker 이미지에서 관리자는 일반적으로 옵션 구문을 extra_params사용 하여 구성 옵션을 전달합니다 --o:. 다음 Compose 스타일 값은 동일한 예시를 보여줍니다.

extra_params=--o:per_view.idle_timeout_secs=1800 --o:per_view.out_of_focus_timeout_secs=900 --o:per_document.idle_timeout_secs=7200

이미지와 배포 차트가 지원하는 경우에만 이 옵션을 사용하십시오 extra_params. Kubernetes, Helm 또는 오퍼레이터 관리 설치의 경우, 생성된 컨테이너 파일을 편집하는 대신 차트 또는 사용자 정의 리소스의 지원되는 구성 필드에 옵션을 추가하십시오. Compose에서 환경 변수를 변경할 때는 새 값이 컨테이너에 적용되도록 서비스를 다시 생성하거나 재배포해야 합니다. 단순히 재시작하면 기존 컨테이너 구성이 재사용될 수 있습니다.

마운트된 XML 파일과 환경 변수 등 충돌하는 위치에 동일한 옵션을 설정하기 전에 해당 릴리스의 우선 순위 규칙을 확인하십시오. 재배포 후 컨테이너 시작 로그와 활성 구성을 검사하십시오. 옵션 이름이나 컨테이너 동작이 다른 경우 Collabora 프로젝트의 소스 저장소 와 버전이 일치하는 배포 문서를 참조하십시오.

리버스 프록시 타임아웃은 별도로 확인하세요.

Collabora 편집기는 지속적인 브라우저 통신을 위해 WebSocket을 사용합니다. 프록시 서버는 Collabora 문서 및 보기 시간 제한이 훨씬 길게 설정되어 있더라도 유효한 WebSocket 연결을 끊을 수 있습니다. 이 경우 사용자는 연결이 끊어지거나, 다시 연결하라는 메시지가 표시되거나, 단순히 보기가 흐려지는 대신 편집기가 업데이트를 수신하지 못하게 될 수 있습니다.

프록시의 읽기/전송 타임아웃, 인그레스 또는 클라우드 로드 밸런서의 유휴 타임아웃, 그리고 Collabora에서 의도한 세션 동작을 비교하십시오. 타임아웃은 전체 경로에서 일관되어야 합니다. Collabora의 프록시 설정 가이드에는 WebSocket 프록시 구성 및 장기 연결 예제가 포함되어 있습니다. 사용 중인 프록시 및 릴리스 버전에 맞는 지침을 적용하십시오. 이전 Nginx 설정 블록을 다른 프록시나 관련 없는 경로에 그대로 복사하지 마십시오.

실패 패턴은 유용한 단서가 될 수 있습니다. 사용자가 비활성 보기만 흐릿하게 보이는 경우, 해당 부분을 살펴보십시오 per_view. 모든 사용자가 거의 동일한 경과 시간에 연결이 끊어지는 경우, 해당 시점의 프록시 및 로드 밸런서 로그를 검사하십시오. 모든 참여자가 나간 후에야 문서가 닫히는 경우, 문서별 시간 초과 설정이 더 중요합니다.

타임아웃은 한 번에 하나씩 테스트하세요.

1. 현재 구성에서 현재 값을 기록하고 Collabora 버전 및 배포 방법을 기록해 두십시오.
2. 두 명의 사용자 또는 두 개의 브라우저 세션으로 테스트 문서를 열어 활성 보기와 비활성 보기를 모두 관찰해 보세요.
3. 증상에 해당하는 타임아웃 값만 변경하십시오. 예를 들어, 집중되어 있지만 조용한 탭의 화면이 어두워지는 것을 방지하려면 해당 탭의 타임아웃 per_view.idle_timeout_secs값만 조정하십시오.
4. 지원되는 방법을 통해 재시작하거나 재배포한 다음, 활성 구성 또는 시작 로그에 새 값이 나타나는지 확인하십시오.
5. 이전 임계값을 넘어서 기다리세요. 화면이 계속 어두워지는지, 두 번째 사용자가 업데이트를 계속 받는지, 편집 내용이 계속 저장되는지 확인하세요.
6. 테스트 문서의 모든 보기를 닫고 유휴 문서가 의도한 범위 내에서 언로드되는지 확인합니다.
7. Collabora 및 프록시 로그에서 WebSocket 연결 종료, XML 구문 분석 오류, 저장 실패 또는 예기치 않은 프로세스 정리 여부를 확인하십시오.

저장되지 않은 프로덕션 문서에서 변경 사항을 테스트하지 마십시오. 유휴 문서 프로세스가 종료되기 전에 수정된 파일이 스토리지 백엔드에 저장되는지 확인하십시오. 문제가 저장되지 않은 변경 사항에서만 발생하는 경우, 타임아웃 시간을 늘리는 대신 자동 저장 및 스토리지 오류를 별도의 문제로 점검하십시오.

편의성, 자원 활용도, 신뢰성 사이의 균형을 유지하세요.

보기별 타임아웃 시간을 길게 설정하면 여러 브라우저 탭에서 작업하거나 작업을 잠시 멈추고 문서를 검토하는 팀에 적합합니다. 타임아웃 시간을 짧게 설정하면 비활성 보기의 업데이트가 더 빨리 중지되어 백그라운드 작업이 줄어들 수 있지만, 문서를 보고 있는 사용자의 작업을 방해할 수 있습니다. 문서별 타임아웃은 별도의 리소스 관리 옵션입니다. 타임아웃 시간을 길게 설정하면 사용하지 않는 문서가 더 오래 로드된 상태로 유지되는 반면, 짧게 설정하면 사용자가 다시 방문할 때 문서를 새로 로드해야 할 수 있습니다.

대부분의 배포 환경에서는 관찰된 동작과 일치하도록 필요한 최소한의 설정만 변경하십시오. 저장 간격은 그대로 유지하고, 팀별로 적절한 뷰별 비활성 시간을 설정하며, 백그라운드 탭 시간 제한은 의도적으로 설정하고, 로그나 타이밍 분석에서 연결 계층 문제가 나타나는 경우에만 프록시 WebSocket 제한을 조정하십시오. 업그레이드 후에는 기본값 및 지원되는 설정이 변경될 수 있으므로 설치된 버전의 구성 템플릿을 다시 확인하십시오.