올바른 파일을 복원하여 Nextcloud 무결성 경고를 해결하세요

Nextcloud의 "일부 파일의 무결성 검사를 통과하지 못했습니다" 경고를 해결하려면 먼저 관리 설정 → 개요 → 유효하지 않은 파일 목록…을 열고 보고서에 표시된 파일만 복원하거나 삭제하세요. signature.json무결성 검사를 편집하거나 비활성화하지 마십시오. 무결성 오류는 불완전한 업데이트, 실수로 인한 사용자 지정 또는 조사가 필요한 예상치 못한 파일을 나타낼 수 있습니다.

파일을 변경하기 전에 보고서를 읽으십시오.

해당 경고는 관리자 개요 페이지에 나타납니다. Nextcloud의 코드 서명 관련 문서에는 해당 페이지에서 유용한 두 가지 작업, 즉 유효하지 않은 파일 목록 보기와 재검사 실행에 대한 설명이 있습니다. 보고서는 구성 요소(예: core앱)별로 문제를 그룹화하고 오류 유형과 파일 경로를 제공합니다. 최신 Nextcloud 35 관리 설명서에도 이러한 작업과 무결성 명령에 대한 내용이 자세히 설명되어 있습니다 occ.

• INVALID_HASH파일의 해시값이 파일 서명에 기록된 해시값과 다릅니다. 로컬 편집, 업그레이드 중 불완전한 교체 또는 예기치 않은 수정이 원인일 수 있습니다.
• MISSING_FILE서명된 파일이 없습니다. 실수로 삭제되었거나 업데이트 중에 누락되었을 수 있습니다.
• EXTRA_FILE설치 폴더에 파일이 존재하지만 서명된 파일 세트에 포함되지 않았습니다. 로컬 파일이거나 이전 릴리스에서 남은 파일이거나 보안 검토가 필요한 파일일 수 있습니다.
• EXCEPTION검증자가 서명을 검증할 수 없습니다. 예를 들어 필수 서명 데이터가 누락되었거나 유효하지 않은 경우입니다. 해당 앱과 소스 코드를 확인하세요.

이 레이블은 검사 결과를 설명하는 것이지 원인을 설명하는 것이 아닙니다. 추가 파일이 있다고 해서 자동으로 악성 파일인 것은 아니며, 해시값이 일치하지 않는다고 해서 시스템이 침해되었다는 증거도 아닙니다. 구성 요소, 경로 및 오류를 기록하고 배포 방법 및 최근 변경 사항과 비교하십시오.

특정 항목에 대한 검사를 실행하세요

셸 액세스 권한이 있는 경우 occNextcloud 설치 디렉터리에서 웹 서버 사용자 계정으로 다음 명령을 실행하세요. 올바른 계정과 PHP 명령은 운영 체제, 컨테이너 이미지, Snap 또는 호스팅 제공업체에 따라 다를 수 있습니다. 일반적인 Debian 또는 Ubuntu Apache 설치 환경에서 Nextcloud가 설치된 디렉터리 /var/www/nextcloud와 웹 사용자 계정 으로 다음 명령을 www-data사용하세요.

cd /var/www/nextcloud
sudo -E -u www-data php occ integrity:check-core
sudo -E -u www-data php occ integrity:check-app calendar

보고서에 표시된 앱 식별자로 바꾸세요 calendar. 코어 검사는 Nextcloud 서버 파일을 확인하고, 앱 검사는 지정된 앱 하나를 확인합니다. Nextcloud 35 설명서에는 occ integrity:check-app --all설치된 앱을 확인하는 방법도 나와 있습니다. 검사가 성공적으로 완료되면 출력이 없을 수 있으므로, 확인이 필요할 때 사용하세요 . 설치 환경이 컨테이너화되었거나 패키지로 관리되는 경우, 해당 경로를 그대로 복사하는 대신 -v문서에 나와 있는 방식으로 실행하고 실제 웹 사용자 계정을 사용하세요 .occ

신뢰할 수 있는 출처에서 파일을 복원하세요

핵심 파일의 경우

INVALID_HASH해당 버전 MISSING_FILE이하의 Nextcloud 릴리스를 사용 하려면 core현재 설치된 Nextcloud 릴리스 버전을 정확히 사용하십시오. 공식 다운로드 소스에서 깨끗한 아카이브를 다운로드하거나, 정상적인 백업 또는 배포 아티팩트에서 일치하는 파일을 복원하십시오. 파일을 교체하기 전에 설치된 버전을 비교하고, 사이트별 구성 및 데이터 디렉터리를 보존하십시오. 업그레이드 도중 여러 핵심 파일에 오류가 발생한 경우, 개별 파일을 임의로 교체하는 대신 배포를 복구하거나 해당 설치 유형에 대해 지원되는 업그레이드 프로세스를 다시 실행하십시오.

해당 파일의 경로를 검사하고 누가 생성했는지 확인 하십시오 EXTRA_FILE. 설치에 포함되지 않은 로컬 파일이라면 Nextcloud 코드 디렉터리 밖으로 이동시키십시오. 필요한 사용자 지정 작업이 포함되어 있을 수 있는 파일이라면 먼저 사본을 만들어 두십시오. 파일이 익숙하지 않거나 의심스러운 경우, 삭제하기 전에 조사를 위해 보존하고 액세스 로그 및 배포 기록을 검토하십시오. 경고를 없애기 위해 임의로 파일을 삭제하지 마십시오.

앱 파일의 경우

서명된 앱에 수정된 파일이나 누락된 파일이 있는 경우, 공식 Nextcloud 앱 스토어 또는 앱 관리자가 제공하는 신뢰할 수 있는 릴리스 채널에서 동일한 호환 버전의 앱을 다시 설치하세요. 로컬에서 변경한 내용이 있는 경우 앱 디렉터리를 먼저 백업하십시오. 사용자 지정 앱이나 서명되지 않은 앱의 경우, 무결성 메시지에 서명 상태 또는 구현 방식이 반영될 수 있습니다. 서명 데이터를 직접 생성하기보다는 개발자에게 문의하세요. Nextcloud 문서에서는 앱의 코드 서명을 수정하지 말라고 권장합니다 signature.json. 핵심 라이브러리와 앱에 대한 코드 서명은 변경 사항 및 불완전한 업그레이드를 감지하는 방법을 제공하므로, 기록된 해시 값을 변경하면 이러한 목적이 무의미해집니다.

FTP를 사용하여 대체 파일을 전송할 때 Nextcloud는 특히 바이너리 전송 모드를 권장합니다. 텍스트 모드 변환은 바이트를 변경하여 새로운 해시 불일치를 발생시킬 수 있습니다.

다시 스캔하고 결과를 확인하세요.

1. 해당 코어 또는 앱 무결성 명령을 다시 실행하거나 관리 설정 → 개요로 돌아가서 다시 스캔…을 선택하십시오 .
2. 해당 구성 요소가 더 이상 유효하지 않은 파일 목록에 나타나지 않는지 확인하십시오. CLI를 사용한 경우 앱 검사가 통과되면 출력이 표시되지 않거나, 자세한 검사를 실행하면 결과가 확인됩니다.
3. 개요 페이지를 새로고침하고 경고가 사라졌는지 확인하십시오. 경고가 여전히 남아 있으면 업데이트된 보고서를 열어보십시오. 다른 파일이나 다른 구성 요소가 경고의 원인일 수 있습니다.

동일한 오류가 즉시 다시 발생하는 경우 배포 프로세스, 사용자 지정 또는 마운트된 볼륨이 변경된 파일을 복원하는지 조사하십시오. 서명 예외의 경우 앱의 지원 릴리스를 확인하고 유지 관리자에게 문의하십시오. 보고서에서 원인을 파악할 수 없는 핵심 파일이 식별되면 보안 및 배포 문제로 간주하고 진행하기 전에 신뢰할 수 있는 백업 및 서버 로그를 검토하십시오.

Nextcloud 공식 코드 서명 및 무결성 문서 , Nextcloud 35 무결성 명령 참조 및 Nextcloud 서버 릴리스 아카이브를 참조하십시오 .