ownCloud 웹 페이지를 열었을 때 빈 페이지가 나타나는 경우 확인해야 할 사항

ownCloud 웹 페이지가 흰색 페이지로 열리는 경우, 먼저 시크릿 모드 창에서 최신 지원 브라우저를 사용하여 동일한 URL에 접속해 보세요. 그래도 접속이 안 되면 브라우저 개발자 도구를 열고 콘솔 및 네트워크 패널을 확인하세요. 실패한 요청을 바탕으로 브라우저 사이트 데이터를 삭제하거나, 누락된 웹 자산을 복구하거나, Infinite Scale 및 리버스 프록시 서비스를 점검할지 결정하세요. 이 점검을 완료하기 전에 서버 데이터를 삭제하거나 인스턴스를 재설치하지 마세요.

ownCloud Web은 Infinite Scale에 포함된 웹 인터페이스이지만, 관리자는 컴파일된 자산을 사용자 지정 빌드로 대체할 수 있습니다. 따라서 빈 페이지가 표시되는 이유는 브라우저 문제, 누락되거나 일치하지 않는 JavaScript 자산, 또는 인터페이스 로드를 방해하는 서버/프록시 응답 때문일 수 있습니다. 아래 단계는 이러한 경우들을 구분하여 설명합니다. 인터페이스 패널은 예시이며, 실제 브라우저 및 배포 출력과 비교해 보시기 바랍니다.

1. 문제가 로컬 문제인지 서버 전체 문제인지 파악합니다.

다른 직원에게 동일한 공용 URL을 열어보도록 요청하고, 본인은 개인 정보 보호 모드 창에서 접속해 보세요. 예를 들어, 한 직원이 빈 페이지만 보이는 반면 다른 직원은 파일을 탐색할 수 있다면 브라우저 관련 문제부터 점검해 보세요. 모든 직원이 동일한 페이지를 본다면 네트워크 및 서버 점검으로 바로 넘어가세요.

  1. ownCloud 웹에서 지원하는 데스크톱 브라우저를 사용하십시오. 현재 요구 사항 페이지에는 지원되는 데스크톱 운영 체제에서 최신 Chrome, Firefox 및 Edge 버전과 Safari 16 이상이 나열되어 있습니다.
  2. 개인 창에서 인스턴스를 엽니다. 인터페이스가 로드되면 일반 프로필에서 확장 프로그램을 하나씩 비활성화한 다음 ownCloud 호스트 이름에 대한 사이트 데이터만 삭제합니다. 사이트 데이터를 삭제하면 로그아웃될 수 있지만 서버에 저장된 파일은 삭제되지 않습니다.
  3. 개발자 도구가 열려 있는 상태에서 브라우저 캐시를 비활성화하고 빈 페이지를 새로 고침하세요. 여러 지원되는 브라우저와 여러 사용자 모두에서 동일한 오류가 계속 발생하는 경우 서버 측 또는 배포 문제일 가능성이 높습니다.

예시 클라우드 호스트 이름에서 완전히 빈 흰색 페이지가 표시되는 브라우저 창의 예시입니다.

증상 예시: 브라우저가 클라우드 호스트에 접속했지만 페이지 콘텐츠 영역이 비어 있는 상태입니다.

2. 실패한 요청을 사용하여 해결 방법을 선택하세요.

개발자 도구를 엽니다(일반적으로 Windows/Linux에서는 F12 또는 Ctrl+Shift+I, macOS에서는 Option+Command+I). 콘솔을 선택하여 JavaScript 오류를 확인한 다음 네트워크를 선택 하고 페이지를 새로 고침한 후 실패한 요청을 찾습니다. 상태 코드와 요청 유형은 흰색 화면만 보이는 것보다 문제 해결에 더 유용합니다.

  • JavaScript 또는 CSS 요청이 404 오류를 반환합니다. 이는 브라우저가 해당 URL에서 찾을 수 없는 자산을 요청했음을 의미합니다. 특정 브라우저 프로필에서만 이 문제가 발생하는 경우 해당 사이트의 캐시된 파일을 삭제하고 페이지를 새로고침하세요. 모든 브라우저에서 동일한 자산에 대한 요청이 실패하는 경우 자산 경로, 리버스 프록시 라우팅 및 사용자 지정 웹 빌드를 검사하세요.
  • 요청이 502, 503 오류 또는 연결 오류를 반환하는 경우: 프록시가 상위 서비스로부터 유효한 응답을 받지 못했거나 서비스를 사용할 수 없는 상태입니다. 브라우저 설정을 변경하기 전에 배포 상태 및 로그를 확인하십시오.
  • 콘솔에 요청 차단, 인증서 오류 또는 혼합 콘텐츠 경고가 표시되는 경우, 브라우저에서 사용하는 공개 호스트 이름과 HTTPS 스키마를 URL 및 프록시 구성과 비교하십시오. 최근에 도메인, TLS 종료 또는 프록시 규칙을 변경한 경우, 먼저 해당 변경 사항을 테스트하십시오.
  • 페이지는 200 응답으로 자산을 로드하지만 JavaScript 오류가 계속 발생합니다. 첫 번째 콘솔 오류와 ownCloud 웹/무한 확장 프로그램 버전을 기록해 주세요. 구문 오류 또는 런타임 오류는 호환되지 않는 사용자 지정 빌드 또는 확장 프로그램 때문일 수 있습니다. 200 응답만으로 이를 추론하지 마세요.

JavaScript 자산에 대한 404 응답 예시를 보여주는 브라우저 개발자 도구 콘솔 화면입니다.

진단 예시: JavaScript 자산에 대한 404 오류는 특정 원인을 입증하는 증거가 아니라 자산 URL과 제공 경로를 확인해야 한다는 단서입니다.

3. 웹 자산 및 서비스 상태를 확인합니다.

요청 실패가 자산과 관련된 경우, 먼저 인스턴스가 번들로 제공되는 ownCloud 웹 파일을 사용하는지 아니면 사용자 지정으로 컴파일된 파일을 사용하는지 확인하십시오. ownCloud 8.2 관리자 가이드에서는 WEB_ASSET_PATH사용자 지정으로 컴파일된 웹 클라이언트 자산을 가리킨다고 설명합니다. 이 변수를 설정한 경우, 실행 중인 배포 환경 내에 해당 경로가 존재하고, 전체 빌드 파일이 포함되어 있으며, 웹 인터페이스를 제공하는 프로세스에서 읽을 수 있는지 확인하십시오. 사용자 지정 자산을 사용하지 않는 경우, 임시 해결책으로 이 변수를 추가하지 마십시오.

Docker Compose를 사용하여 배포하려면 Compose 파일이 있는 디렉터리에서 다음 명령을 실행하십시오.

docker compose ps
docker compose logs --tail=100 ocis

첫 번째 명령은 서비스가 실행 중인지 여부를 보여주고, 두 번째 명령은 지정된 서비스의 최근 로그를 출력합니다 ocis. Compose 파일에서 다른 서비스 이름을 사용하거나 프런트엔드를 별도로 실행하는 경우, 실제 서비스 이름으로 바꿔 프록시/프런트엔드 로그도 확인하세요. 수동으로 설치했거나 오케스트레이션된 배포의 경우, 해당 플랫폼의 서비스 및 로그 명령을 사용하십시오. 페이지 로드 실패 시점에 서비스 시작 실패, 자산 경로 오류 또는 업스트림 연결 오류가 있는지 확인하십시오.

예시 출력 없이 `docker compose ps` 및 `docker compose logs` 명령어를 보여주는 터미널 화면입니다.

두 가지 Compose 검사의 예시입니다. 실제 서비스 이름과 로그 메시지는 배포 환경에 따라 다를 수 있습니다.

4. 공개 URL과 프록시 경로를 확인합니다.

요청이 이전 호스트 이름, 잘못된 스키마 또는 프록시에서 제공하지 않는 경로를 가리키는 경우, 공용 URL 구성 및 프록시 규칙을 확인하십시오. ownCloud 문서 OCIS_URL에는 Infinite Scale에 액세스하는 방법을 정의하는 데 사용되는 URL로 설명되어 있습니다. 리버스 프록시를 사용하는 배포 환경에서는 브라우저에서 보이는 HTTPS 주소, DNS 이름 및 라우팅 규칙이 구성된 공용 URL과 일치하는지 확인하십시오. 프록시 또는 도메인이 최근에 변경된 경우, 현재 구성을 마지막으로 정상 작동했던 버전과 비교하여 일치하지 않는 값만 수정하십시오.

WEB_ASSET_PATH사용자 지정 자산이 구성된 경우에만 확인하십시오 . OCIS_URL브라우저가 예기치 않은 호스트로 리디렉션되거나 잘못된 출처에서 자산을 요청할 때 프록시/TLS 설정을 확인하십시오. 이러한 설정은 배포 환경에 따라 다르므로 일반적인 예시 값을 프로덕션 환경에 붙여넣지 마십시오. 이러한 구성 영역에 대한 자세한 내용은 ownCloud 웹 사용자 지정 자산 가이드 , 프록시 서비스 설명서 및 TLS 가이드를 참조하십시오.

배포 확인을 위해 WEB_ASSET_PATH 및 OCIS_URL을 강조 표시하는 구성 편집기 예시

검토해야 할 구성 값의 예시입니다. 올바른 값은 공개 URL과 사용자 지정 자산 사용 여부에 따라 달라집니다.

수정 사항을 확인하세요

일반 브라우저 창에서 사이트를 새로고침하고 인터페이스가 제대로 표시되는지, 콘솔에 JavaScript 차단 오류가 없는지, 필수 JavaScript/CSS 요청에 더 이상 404 또는 5xx 응답이 반환되지 않는지 확인하십시오. 다른 사용자에게 동일한 공개 주소를 테스트하도록 요청하십시오. 자산은 성공적으로 로드되었지만 페이지가 여전히 비어 있는 경우, 첫 번째 콘솔 오류, 실패한 요청 세부 정보, Infinite Scale 버전 및 관련 서비스 로그를 관리자 또는 ownCloud 지원팀에 제공할 수 있도록 보관하십시오. 브라우저 캡처를 공유하기 전에 쿠키, 인증 헤더 및 토큰은 삭제하십시오.

댓글 남기기

적절한 백엔드를 사용하여 ownCloud 파일 잠금 시간 초과 문제를 해결하세요

데이터베이스 잠금 경합과 만료된 WebDAV 잠금을 구분한 다음, 적절한 ownCloud 10 해결 방법을 선택하고 구성하십시오.

ownCloud 웹 페이지를 열었을 때 빈 페이지가 나타나는 경우 확인해야 할 사항

ownCloud 웹 페이지를 열었을 때 빈 페이지가 나타나는 경우 확인해야 할 사항

대상 검사를 통해 빈 ownCloud 웹 화면이 나타나는 원인을 브라우저 캐시, 누락된 웹 자산, 서비스 오류 또는 역방향 프록시 URL 설정으로 추적할 수 있습니다.

ownCloud PHP 메모리 경고를 올바른 런타임에 해결하세요

ownCloud의 웹 PHP 메모리 제한을 설정하고, 해당 서비스를 재시작한 다음, CLI 설정이나 업로드 제한과 혼동하지 않고 활성 값을 확인하십시오.

ownCloud 10 MySQL 연결 실패 문제 해결

MySQL, PHP, 소켓 설정 또는 데이터베이스 권한이 ownCloud 10을 차단하는지 확인한 다음 안전한 해결 방법을 검증하세요.

ownCloud 공개 링크에 대한 확실한 만료 기한을 설정하세요

ownCloud 공개 링크에 대한 확실한 만료 기한을 설정하세요

ownCloud Classic에서 공개 링크 만료를 필수로 설정하고, 최대 유효 기간을 지정하고, 별도의 정리가 필요한 기존 공유를 확인합니다.

Keycloak을 사용하여 ownCloud Infinite Scale에 TOTP 2단계 인증 로그인을 추가하세요.

Keycloak을 사용하여 ownCloud Infinite Scale에 TOTP 2단계 인증 로그인을 추가하세요.

Keycloak을 통해 TOTP를 활성화하고, 사용자를 안전하게 등록하고, Infinite Scale의 경로 수준 MFA 설정이 적용되는 시점을 파악하세요.

클라이언트와 서버를 일치시켜 ownCloud 동기화를 복원하세요.

문제가 OC10과 7.x 버전 간의 호환성 문제인지, 아니면 CSync 저널 손상 때문인지 확인한 후, 동기화된 파일을 삭제하지 않고 적절한 해결 방법을 적용하십시오.

Let's Encrypt와 Nginx를 사용하여 ownCloud를 HTTPS에 연결하세요.

Let's Encrypt와 Nginx를 사용하여 ownCloud를 HTTPS에 연결하세요.

HTTP-01 또는 DNS-01을 선택하고 ownCloud 역방향 프록시를 구성한 다음 Certbot이 HTTPS 인증서를 자동으로 갱신하는지 확인하십시오.

사용자 로그인을 위해 ownCloud Infinite Scale을 LDAP에 연결합니다.

배포 전에 oCIS LDAP 로그인을 구성하고, 사용자 및 그룹 조회를 일치시키고, TLS 및 스키마 설정을 확인하십시오.

S3 버킷을 ownCloud 10에 외부 스토리지로 연결하기

S3 버킷을 ownCloud 10에 외부 스토리지로 연결하기

ownCloud 10에 Amazon S3 버킷을 추가하고, 호환되는 자격 증명 및 엔드포인트를 준비하고, 마운트와 기본 스토리지를 혼동하지 않고 액세스를 확인하세요.