Nextcloud '일부 파일이 무결성 검사를 통과하지 못했습니다' 경고 해결 방법

업데이트 또는 수동 변경 후 Nextcloud 관리자 개요를 열면 "일부 파일의 무결성 검사를 통과하지 못했습니다."라는 메시지가 표시될 수 있습니다. 이 경고는 불안감을 줄 수 있지만, 모든 경우에 공통적으로 발생하는 오류를 나타내는 것은 아닙니다. Nextcloud는 설치된 서버 및 앱 코드가 서명된 파일과 일치하는지 확인합니다. 파일이 변경되었거나 누락된 경우, 예상치 못한 파일이 있는 경우, 또는 앱 서명에 문제가 있는 경우 이 경고가 발생할 수 있습니다. 재검사를 실행하면 현재 상태가 보고되지만, 파일을 복구하지는 않습니다.

Nextcloud 공식 다운로드 페이지에는 작성 시점을 기준으로 최신 릴리스가 2026년 9월 16일에 출시된 서버 35.0.0으로 표시되어 있습니다. 현재 관리자 문서에서는 여전히 관리자에게 유효하지 않은 파일 보고서를 확인하고, 특정 원인을 해결한 후 다시 검사하도록 안내하고 있습니다. 아래 단계는 이러한 기존 프로세스를 따르며, 정확한 메뉴 문구는 릴리스 또는 호스팅 패키지에 따라 다를 수 있습니다.

1. 변경하기 전에 잘못된 파일 보고서를 읽으십시오.

관리자 계정으로 로그인한 다음 관리 설정 > 개요를 엽니다 . 무결성 경고에서 " 유효하지 않은 파일 목록…"을 선택합니다 (레이블은 약간 다를 수 있습니다). 복구 후 비교할 수 있도록 보고서를 안전한 곳에 저장하거나 복사해 두세요. 이 보고서는 앱 또는 코어 영역을 식별하고 INVALID_HASH, MISSING_FILE, EXTRA_FILE, 와 같은 상태를 나열합니다 EXCEPTION.

서버 파일을 교체하기 전에 Nextcloud 구성, 데이터베이스 및 모든 사용자 지정 앱 코드를 백업하십시오. signature.json경고를 없애기 위해 파일을 편집하거나, 대체 서명을 생성하거나, 보고서에 이름이 나타난다는 이유만으로 파일을 삭제하지 마십시오. 이 검사는 코드의 진위 여부를 보호하고 조사해야 할 예상치 못한 파일을 발견하는 데 도움이 됩니다.

2. 오류 유형에 맞는 해결 방법을 선택하세요.

이러한 레이블은 진단 단서일 뿐, 공격의 증거 또는 설치의 안전성을 입증하는 것은 아닙니다. 개발자의 로컬 편집, 복사된 백업 파일, 불완전한 배포, 승인되지 않은 코드 등으로 인해 결과가 다르게 나타날 수 있습니다. 예상치 못한 PHP 파일이나 변경된 코어 파일의 원인을 알 수 없는 경우, 보고서를 보존하고 삭제하거나 덮어쓰기 전에 조사하십시오.

3. 정확한 Nextcloud 릴리스에서 핵심 파일을 복원합니다.

보고서에 또는 core와 같은 하위 파일 이름이 표시되는 경우, 먼저 업그레이드가 도중에 중단되었거나 배포 프로세스에서 코드가 변경되었는지 확인하십시오. 관리자 개요 또는 일반 배포 기록에서 설치된 버전을 확인하십시오. 다른 Nextcloud 버전의 파일을 복사하지 마십시오. 해당 파일의 해시값이 서버에 설치된 릴리스와 일치하지 않습니다.index.phpversion.php

가능한 경우 지원되는 업데이트 프로그램을 사용하여 중단된 업그레이드를 완료하십시오. 파일을 수동으로 복원해야 하는 경우 Nextcloud 공식 다운로드 페이지에서 해당 서버 아카이브를 다운로드하고, 게시된 체크섬 또는 PGP 서명을 사용하여 아카이브를 확인한 다음, Nextcloud의 업그레이드 지침에 따라 영향을 받는 애플리케이션 코드 파일만 교체하십시오. config/데이터 디렉터리와 로컬에서 유지 관리되는 앱 또는 테마는 보존하십시오. 설치 방법에 따른 백업 및 유지 관리 모드 절차를 따르십시오. Docker, Snap, 어플라이언스 및 관리형 호스팅의 경우 별도의 업데이트 프로세스가 필요할 수 있습니다.

Nextcloud의 무결성 가이드에서는 코어 해시가 유효하지 않은 경우에도 동일한 원칙을 적용하라고 안내합니다. 즉, 올바른 파일을 복원한 후 다시 스캔하라는 것입니다. FTP를 통해 파일을 전송할 경우, 가이드에서는 특히 바이너리 전송 모드를 사용하라고 권고합니다. 서명 검증을 비활성화한 상태로 업데이트를 실행하는 것은 지름길로 삼지 마십시오. 검증되지 않은 상태로 수동으로 설치된 아카이브는 새로운 무결성 및 보안 문제를 야기할 수 있습니다.

4. 추가 파일과 사용자 지정 변경 사항을 꼼꼼히 검토하십시오.

해당 EXTRA_FILE항목은 임시 파일, 편집기 백업, 사용자 지정 스크립트 또는 알 수 없는 파일일 수 있습니다. 전체 경로, 타임스탬프, 소유자 및 배포 기록을 확인하십시오. 정상적인 사용자 지정 도구인 경우, Nextcloud 코드 디렉터리 외부로 이동하고 적절한 경우 지원되는 앱이나 별도의 서비스를 통해 접근 가능하도록 하십시오. 더 이상 사용하지 않는 백업 파일인 경우, 필요한 데이터를 보존한 후에만 삭제하십시오. 최근에 원인을 알 수 없는 실행 파일이나 PHP 파일이 나타났다면, 단순히 경고를 삭제하는 대신 보안 조사로 간주하여 증거를 보존하고, 접근 및 웹 서버 로그를 검토하고, 사고 대응 절차를 따르십시오.

의도적으로 편집한 코어 파일에서 오류가 발생한 경우 INVALID_HASH, 지속 가능한 해결 방법은 서명된 코어 파일을 복원하고 사용자 지정 동작을 지원되는 앱, 테마 또는 문서화된 확장 지점으로 이동하는 것입니다. 검사를 통과시키기 위해 예상 해시 값을 변경하거나 릴리스 메타데이터를 수정하지 마십시오. 사용자 지정 Nextcloud 배포판은 코드 서명 문서에서 별도의 릴리스 브랜치 고려 사항을 다룹니다. 해당 설정을 변경하는 것은 사용자 지정 배포판 관리자의 역할이며, 표준 설치에 대한 일반적인 복구 방법이 아닙니다.

5. 앱 서명 또는 앱 파일 복구

보고서에 앱 디렉터리 이름이 표시되면 해당 앱 ID를 확인하고 앱이 업데이트되었는지, 수동으로 복사되었는지, 또는 로컬에서 수정되었는지 판단하세요. Nextcloud 앱 인터페이스 또는 배포 방법을 사용하여 신뢰할 수 있는 소스에서 호환되는 릴리스를 업데이트하거나 다시 설치하세요. 먼저 앱별 데이터와 구성을 백업하고 Nextcloud 주요 버전과의 호환성을 확인하세요. 사용자 지정 앱이나 자체 개발 앱의 경우, 해당 앱 관리자에게 서명된 패키지 또는 수정된 릴리스를 요청하세요. Nextcloud는 앱 스토어를 통해 게시된 앱에 코드 서명을 요구합니다. 다른 앱 카테고리의 경우 서명 요구 사항 및 적용 방식이 다를 수 있으므로 로컬 서명을 직접 생성하기보다는 관련 개발자 문서를 참조하세요.

앱 디렉터리를 임의의 압축 파일로 덮어쓰거나 다른 버전의 파일을 복사하지 마십시오 signature.json. 시그니처는 특정 코드를 나타내므로, 서로 다른 릴리스의 파일을 혼합하면 추가 오류가 발생할 수 있습니다. 앱을 제거해야 하는 경우, 지원되는 앱 관리 프로세스를 사용하고 제거로 인해 조직에 필요한 데이터가 손실되지 않는지 확인하십시오.

6. 새로운 무결성 검사를 실행합니다.

보고된 파일을 복구한 후 관리 설정 > 개요로 돌아가서 다시 검사… 를 선택하십시오 . 검사가 완료될 때까지 기다린 다음, 잘못된 파일 목록을 다시 여십시오. SSH를 통해 서버를 관리하는 경우, Nextcloud 35는 Nextcloud 설치 디렉터리에서 이러한 명령어를 제공합니다.

sudo -E -u www-data php occ integrity:check-core
sudo -E -u www-data php occ integrity:check-app calendar
sudo -E -u www-data php occ integrity:check-app --all

calendar보고서에 표시된 앱 ID로 교체하십시오 . 해당 www-data계정은 Debian 또는 Ubuntu 기반 설치에서 일반적으로 사용되지만 웹 서버 사용자 및 PHP 실행 파일은 다를 수 있습니다. 시스템에 맞는 올바른 계정과 PHP 환경을 사용하십시오. 컨테이너 설치의 경우 해당 컨테이너 내부에서 동일한 명령을 실행하십시오. 최신 OCC 설명서에 따르면 앱 검사가 성공하면 자세한 정보 표시 모드를 요청하지 않는 한 출력이 표시되지 않을 수 있으며, 실패 시에는 세부 정보가 표시됩니다.

경고 메시지가 수정되었는지 확인하는 방법

관리자 개요 화면을 다시 열고 새 검사 후 무결성 경고가 사라졌는지 확인하십시오. 경고가 여전히 남아 있는 경우, 새 보고서를 저장된 사본과 비교하십시오. 경로가 동일하면 기본 파일이 복원되지 않았거나 잘못된 버전이 사용된 것입니다. 경로가 다르면 다른 문제가 있을 수 있습니다. 관련 코어 또는 앱 검사를 다시 실행하고 Nextcloud 로그에서 서명 오류를 검토하십시오. 또한 인스턴스가 정상적으로 로그인, 파일 탐색, 업로드 및 다운로드를 완료하는지 확인하십시오.

배포 후에도 경고가 다시 표시되면 서명된 코드 트리 내의 파일을 덮어쓰는 자동화, 플러그인 또는 수동 유지 관리 스크립트를 확인하십시오. 무결성 보고서에 오류가 없는데도 사용자가 여전히 오류를 보는 경우, 원래 문제는 다른 원인에 있을 수 있으므로 별도로 문제 해결을 진행해야 합니다. 호스팅된 Nextcloud의 경우, 제공업체에 정확한 보고서와 설치된 버전을 보내주십시오. 단, 암호, 개인 키 또는 사용자 파일 내용은 포함하지 마십시오.

버전별 세부 정보는 Nextcloud 코드 서명 및 무결성 문서 , OCC 무결성 검사 참조 , Nextcloud 업데이트 설명서 및 공식 다운로드 페이지를 참조하십시오 .