ONLYOFFICE가 Nextcloud에 저장되지 않을 때 저장 콜백을 추적합니다.

가상 예시: 미나가 Nextcloud 폴더에서 ONLYOFFICE를 사용하여 프로젝트 계획을 편집합니다. 편집기가 열리고 변경 사항이 저장되지만, 나중에 Nextcloud에서 "문서를 저장할 수 없습니다."라는 메시지가 표시됩니다. 이 예시는 설명을 위한 것이며 실제 테스트 결과는 아닙니다. 이러한 상황에서는 편집기를 열어둔 상태로 저장되지 않은 작업의 로컬 복사본을 유지하고, ONLYOFFICE Docs가 Nextcloud의 저장 콜백에 직접 접근할 수 있는지 확인하십시오. 그런 다음 로그를 사용하여 콜백 라우팅 실패와 Nextcloud 저장소 또는 권한 문제를 구분하십시오.

1. 문제 해결 전에 Mina의 변경 사항을 보호하세요.

Nextcloud에 저장되지 않은 변경 사항이 남아 있는 동안에는 편집기를 닫거나 새로 고치지 마십시오. 편집기가 응답하는 상태라면 편집기의 " 다운로드" 옵션을 사용하여 로컬 복구 복사본을 만드십시오. 관리자가 로그와 대조할 수 있도록 저장 실패 시간과 파일 이름을 기록해 두십시오.

Nextcloud 표준 폴더에 작은 DOCX 파일을 저장해 보세요. 저장이 성공하면 원본 파일의 권한, 공유 상태, 저장 위치 또는 파일 형식을 점검하십시오. 모든 파일 저장이 실패하면 공유 콜백 경로와 서버 상태를 확인하는 것부터 시작하세요.

2. 서버 간 저장 콜백을 확인하세요.

ONLYOFFICE Docs는 Nextcloud 커넥터에서 제공하는 콜백 URL로 POST 요청을 보냅니다. 그러면 Nextcloud는 편집된 파일을 가져와 저장된 버전을 업데이트합니다. Document Server가 Nextcloud로 POST 요청을 보낼 수 없는 경우 편집기는 정상적으로 열리지만 저장에는 실패할 수 있습니다.

테스트 파일을 사용하여 문제를 재현한 다음, 해당 시점의 DocService 로그와 Nextcloud 로그를 비교하십시오. Linux에서는 ONLYOFFICE 로그가 에 있습니다. /var/log/onlyoffice/documentserver/Docker 환경에서는 컨테이너 로그 또는 마운트된 로그 디렉터리를 확인하십시오. Nextcloud의 기본 로그 파일은 nextcloud.log데이터 디렉터리에 있으며, 변경 사항이 있는 경우에는 해당 디렉터리에 저장 log_type됩니다 logfile.

• 301, 302 또는 308: 콜백 URL 리디렉션으로, 일반적으로 HTTP/HTTPS 또는 호스트 이름 간에 사용됩니다.
• 시간 초과 또는 DNS 오류: 문서 서버가 URL을 확인하거나 연결할 수 없습니다.
• 403 또는 404 오류: 프록시, 액세스 규칙, 경로 재작성 또는 호스트 설정으로 인해 요청이 거부되었을 수 있습니다.
• Nextcloud 스토리지 예외: 콜백이 도착했습니다. 할당량, 권한, 스토리지 상태 또는 잠금을 확인하십시오.

3. 콜백이 리디렉션될 때 URL 또는 프록시 경로를 수정하십시오.

Nextcloud에서 설정 > 관리 > ONLYOFFICE를 엽니다 . 공개 ONLYOFFICE Docs 주소가 사용자의 브라우저에서 로드해야 하는 URL인지 확인합니다. 두 서버가 공개 주소를 통해 서로 연결할 수 없는 경우, 문서에 설명된 내부 필드를 설정하십시오. 첫 번째 필드는 서버에서 내부 요청 시 사용할 ONLYOFFICE Docs 주소 이고 , 두 번째 필드는 문서 서버 에서 Nextcloud로 내부 요청 시 사용할 서버 주소입니다 . 첫 번째 필드는 Nextcloud에서 문서 서버로의 연결이 정상적으로 작동해야 하며, 두 번째 필드는 문서 서버에서 Nextcloud로의 연결이 정상적으로 작동해야 합니다.

미나의 가상 설정에서 콜백은 http://cloud.example.comHTTPS를 사용하고 해당 주소로 리디렉션합니다. 최종 HTTPS 주소를 직접 구성한 다음 DNS, 방화벽 규칙 및 인증서 신뢰 설정을 통해 Document Server가 해당 주소에 접근할 수 있도록 해야 합니다. 프록시는 콜백의 스키마, 호스트 이름 또는 경로를 리디렉션하지 않고 Nextcloud로 전달해야 합니다. 예시 호스트 이름은 실제 설치에 사용되는 것이 아닙니다.

ONLYOFFICE의 연결 확인 기능을 사용하면 구성된 서비스 주소를 확인할 수 있습니다.

sudo -u www-data php occ onlyoffice:documentserver --check

Nextcloud 디렉터리에서 적절한 웹 서버 계정으로 실행하십시오. 확인이 성공했다고 해서 콜백 POST가 제대로 작동한다는 것을 보장하는 것은 아닙니다. 동일한 호스트 이름으로 수동 HEAD 요청을 보내거나 브라우저 페이지를 보는 것도 작동을 증명하는 것은 아닙니다.

4. 증거를 따라 Nextcloud 저장소로 이동합니다.

콜백이 Nextcloud에 도달했지만 파일이 여전히 업데이트되지 않으면 Nextcloud 로그에서 해당 요청을 확인하십시오. 사용자에게 편집 권한이 있는지, 스토리지 마운트가 가능한지, 계정 할당량을 초과하지 않았는지, 데이터 볼륨에 여유 공간과 inode가 충분한지 확인하십시오. 문제가 공유 파일에 영향을 미치는 경우 다른 사용자 또는 동기화 클라이언트가 동시에 해당 파일을 변경하고 있는지 확인한 후 개인 폴더에 복사본을 만들어 테스트해 보십시오.

Nextcloud의 트랜잭션 파일 잠금은 쓰기 작업을 조정하므로, 임시방편으로 이 기능을 비활성화하지 마십시오. 로그에 잠금 또는 데이터베이스 오류가 표시되면 잠금 백엔드와 Redis 또는 Valkey 서비스를 확인하십시오. oc_file_locks활성 쓰기 작업을 방해할 수 있으므로 행을 삭제하거나 파일을 잠그지 마십시오.

표준 폴더 테스트는 성공하지만 외부 저장소에 저장된 파일 테스트에 실패하는 경우, 해당 마운트의 가용성 및 인증 모드를 확인하십시오. ONLYOFFICE 문서에는 일부 외부 저장소 모드에 대한 제한 사항이 명시되어 있으므로, 마운트 문제를 해결하기 전까지는 자격 증명을 변경하지 마십시오.

5. 전체 저장 경로를 확인하십시오.

설정을 하나 변경한 후, 작은 테스트 문서에서 특정 부분을 수정하고 저장이 완료될 때까지 기다린 다음 Nextcloud에서 문서를 닫았다가 다시 엽니다. 수정 내용이 유지되는지, 그리고 해당 로그에 리디렉션, 연결 실패 또는 스토리지 예외 오류가 없는지 확인합니다.

테스트는 성공했지만 원본 파일이 여전히 실패하는 경우, 권한, 외부 마운트 또는 동시 편집 여부를 확인하십시오. 모든 콜백이 실패하면 로컬 복사본을 보존하고 타임스탬프, HTTP 상태, 버전 및 개인 정보가 삭제된 로그와 함께 문제를 상위 관리자에게 보고하십시오. JWT, 쿠키, 서명된 URL 및 개인 파일 이름은 삭제하십시오.

이러한 단계는 저장 오류의 일반적인 콜백, 라우팅 및 스토리지 원인을 해결합니다. 정확한 해결 방법은 로그에서 처음 오류가 발생한 지점에 따라 달라지며, 연결 확인만으로는 전체 저장 워크플로가 정상임을 보장할 수 없습니다.

공식 참조

• ONLYOFFICE Nextcloud 연동: 서버 주소, 콜백 흐름 및 연결 확인
• ONLYOFFICE Docs 문제 해결: 저장 오류 및 콜백 연결 가능성
• Nextcloud 35 관리 설명서: 트랜잭션 파일 잠금
• Nextcloud 관리 설명서: 로깅 구성

본 문서는 2026년 10월 9일에 확인되었습니다. 커넥터 필드 및 로그 대상은 설치된 앱 버전 및 배포 구성에 따라 다를 수 있습니다.