OCC를 사용하여 분실한 Nextcloud 관리자 암호를 재설정하세요
Nextcloud의 OCC 명령어를 사용하여 서버 셸에서 관리자 암호를 재설정하는 방법을 안내합니다. 사용자 이름, 권한 및 외부 로그인 공급자에 대한 지침도 제공됩니다.
Nextcloud 앱 설치 시 인터넷 연결이 안 된다는 오류 메시지 표시 문제 해결
Nextcloud 33 버전부터 App Store 메타데이터 요청 시간 초과는 기본적으로 120초로 설정되어 있으며, `--getTimeout` 명령어를 통해 조정할 수 있습니다 occ. 이는 응답 속도 저하 문제를 해결하는 데 도움이 되지만, "서버에 인터넷 연결이 없어 앱을 설치할 수 없습니다"라는 메시지가 표시될 경우 브라우저가 아닌 Nextcloud가 실행 중인 서버 또는 컨테이너에서 먼저 확인해야 합니다.
Nextcloud 런타임에서 App Store 엔드포인트를 테스트한 다음, DNS, 아웃바운드 HTTPS, 프록시 구성, 인증서 신뢰 또는 App Store 설정과 같은 특정 오류를 수정하십시오. 해당 메시지는 일반적인 내용이며, 서버 전체가 오프라인 상태임을 나타내는 것은 아닙니다.
1. 설치가 실패한 부분을 확인하십시오.
모든 앱이 실패하는지 아니면 하나만 실패하는지 확인하세요. 카탈로그는 로드되지만 앱 하나가 설치되지 않는 경우, 해당 앱의 Nextcloud 버전 호환성과 앱 디렉터리 권한을 확인하세요. 이는 네트워크 문제만은 아닐 수 있습니다.
더 명확한 오류 메시지를 보려면 명령줄에서 설치를 시도해 보세요. 설치가 성공하면 앱이 설치되므로 원하는 앱 ID를 사용하세요. 파일 소유권을 유지하려면 HTTP 사용자 권한으로 실행하세요. Debian 또는 Ubuntu에서는 다음과 같이 하세요.
sudo -u www-data php /var/www/nextcloud/occ app:install newsnews필요한 앱 ID로 바꾸세요 . Docker 환경에서는 Nextcloud 앱 컨테이너 내부에서 웹 사용자 권한으로 명령어를 실행하세요. 전체 출력 결과를 비교해 보세요 nextcloud.log. 호환성 또는 권한 오류는 DNS 오류와는 다른 해결 방법이 필요합니다.
2. Nextcloud 런타임에서 DNS 및 HTTPS 테스트
Nextcloud의 PHP 프로세스가 실행되는 위치에서 다음 검사를 실행하십시오. 노트북이나 Docker 호스트에서 요청이 성공했다고 해서 앱 컨테이너가 동일한 네트워크 액세스 권한을 가지고 있다는 것을 의미하지는 않습니다.
getent ahosts apps.nextcloud.com
curl -sS --connect-timeout 10 --max-time 30 -o /dev/null -w 'HTTP %{http_code}' https://apps.nextcloud.com/api/v1/categories.json기본 앱 스토어 URL은 입니다 https://apps.nextcloud.com/api/v1. Nextcloud는 categories.json해당 URL에서 메타데이터를 가져옵니다. DNS는 주소를 반환해야 하고, HTTPS는 응답을 반환해야 합니다. 이름 확인 오류 또는 시간 초과는 DNS, 라우팅, 방화벽 또는 프록시 문제일 수 있으며, TLS 오류는 인증서 신뢰 또는 시스템 시간 문제일 수 있습니다. HTTP 오류는 서버가 응답했음을 의미하므로 URL과 프록시 응답을 확인하십시오.
Docker 환경에서 Nextcloud 애플리케이션 컨테이너 내에서 검사를 실행합니다. DNS가 제대로 작동하고 TCP 443 포트로의 아웃바운드 연결이 허용되었는지 확인합니다. 프록시 서버가 대상 연결을 필터링하는 경우, Nextcloud 로그에서 앱 스토어 다운로드 호스트 이름과 카탈로그 호스트 이름을 확인합니다.
3. 보안을 약화시키지 않고 프록시 또는 TLS 문제를 해결합니다.
외부 트래픽에 프록시가 필요한 경우 관리자 브라우저나 셸뿐만 아니라 Nextcloud의 PHP/HTTP 클라이언트에도 프록시를 구성해야 합니다. Nextcloud는 선택적 설정인 ` / proxyetc proxyuserpwd/ proxyexcludephp- HTTPS_PROXY...NO_PROXY
TLS 오류가 발생하는 경우 서버 시계를 확인하고 OS CA 번들을 업데이트하십시오. 승인된 회사 검사 프록시를 사용하는 경우 해당 프록시의 신뢰할 수 있는 CA를 PHP 런타임에 추가하십시오. curl -kApp Store 요청에 대해 TLS 검증 또는 사용을 비활성화하지 마십시오. 이는 가장된 다운로드 호스트에 대한 보안을 약화시킵니다.
4. 앱 스토어 URL 및 설치 권한을 확인하세요.
앱 스토어는 기본적으로 활성화되어 있으며 기본 URL은 다음과 같습니다 https://apps.nextcloud.com/api/v1. config/config.php다음 명령어를 사용하여 실제 값을 확인하거나 조회할 수 있습니다 occ.
sudo -u www-data php /var/www/nextcloud/occ config:system:get appstoreenabled
sudo -u www-data php /var/www/nextcloud/occ config:system:get appstoreurl명시적으로 false로 설정된 경우 appstoreenabled, 정책에서 공용 스토어를 허용하는 경우에만 활성화하십시오. appstoreurl이전 또는 연결할 수 없는 사용자 지정 스토어를 가리키는 경우, Nextcloud의 공용 앱 스토어를 사용하려는 경우에만 기본값으로 복원하십시오. 자체 호스팅 앱 스토어를 사용하는 조직은 해당 URL을 유지하고 DNS, 인증서 또는 액세스 경로를 수정해야 합니다.
카탈로그는 로드되지만 설치가 계속 실패하는 경우, apps_paths유효 구성 항목을 확인하십시오. 구성된 앱 디렉터리 중 하나 이상에 Nextcloud 웹 서버 사용자가 쓰기 권한이 있어야 합니다. 디렉터리 소유자 또는 그룹과 해당 디렉터리에 부여할 쓰기 권한을 수정하십시오. 디렉터리에 모든 사용자가 쓰기 권한을 갖도록 설정하지 마십시오. 조직의 허용 목록에 의해 차단되었거나 사용 중인 Nextcloud 릴리스와 호환되지 않는 앱의 경우, 네트워크 변경이 아닌 관리자 정책 또는 버전 결정이 필요합니다.
5. 다시 시도하고, 속도 저하의 원인이 확인될 경우에만 시간 제한을 조정하십시오.
DNS, HTTPS, 프록시, TLS 및 구성 검사가 완료되면 앱 페이지에서 또는 동일한 occ app:install명령어를 사용하여 설치를 다시 시도하십시오. 요청에 응답은 되지만 구성된 메타데이터 시간 초과보다 지속적으로 오래 걸리는 경우, Nextcloud 33 이상 버전에서는 시간 초과 값을 더 높게 설정할 수 있습니다. 예를 들면 다음과 같습니다.
sudo -u www-data php /var/www/nextcloud/occ config:app:set settings appstore-timeout --value=180이렇게 하면 대기 시간이 180초로 늘어납니다. 차단된 송신, 잘못된 인증서 또는 잘못된 저장소 URL은 복구되지 않습니다. Nextcloud 33 이상 버전에서 문서화된 기본값은 120초입니다. 재정의를 제거하고 기본값으로 되돌리려면 다음 명령을 사용하십시오.
sudo -u www-data php /var/www/nextcloud/occ config:app:delete settings appstore-timeout의도적으로 서버와 격리된 환경(에어갭)의 경우, 승인된 자체 호스팅 앱 스토어를 사용하는 것이 권장되는 구성 방식입니다. 장애 발생 시 임의의 앱 ZIP 파일을 다운로드하여 앱 디렉토리에 넣는 방식으로 해결하려고 하지 마십시오. 신뢰할 수 있는 출처에서 제공하는 앱을 사용하고, 해당 앱의 릴리스 버전이 서버에 적합한지 확인하십시오.
검증
앱 스토어 카탈로그가 제대로 로드되고, 설치하려는 앱이 활성화된 앱 목록에 나타나는지, 그리고 연결, TLS 또는 시간 초과 오류가 더 이상 로그에 기록되지 않는지 확인하십시오. Nextcloud 런타임에서 엔드포인트에 응답이 있지만 UI에 인터넷 연결이 없다고 표시되는 경우, 앱 스토어 URL과 설정을 비교하고, PHP-FPM과 CLI 간의 프록시 환경 차이를 검토하고, 특정 앱만 차단되었거나 호환되지 않는지 확인하십시오.
참고 자료: Nextcloud 앱 관리 및 앱 스토어 설정 ; Nextcloud OCC 앱 및 구성 명령 ; 프록시용 Nextcloud 구성 매개변수 ; Nextcloud 앱 스토어 메타데이터 엔드포인트 .
Nextcloud를 제공하는 HTTPS 엔드포인트에 HSTS 헤더를 추가하세요.
Apache, NGINX 또는 TLS 프록시에서 헤더를 설정하여 Nextcloud의 HSTS 경고를 해제한 다음 공개 HTTPS 응답을 안전하게 확인하십시오.
Nextcloud 앱 설치 시 인터넷 연결이 안 된다는 오류 메시지 표시 문제 해결
Nextcloud 서버 자체의 DNS, HTTPS, 프록시, TLS 또는 구성 문제로 인해 App Store 설치가 실패하는 경우 원인을 추적하십시오.
예약 대기열을 사용하여 Nextcloud 미리보기의 CPU 사용량 급증을 제어하세요
썸네일 작업을 제어된 백그라운드 일정으로 이동하고, 사용하지 않는 미리보기 크기를 줄이고, Nextcloud 서버에 과부하를 주지 않고 대기열을 검증하세요.
Nextcloud 데스크톱 동기화, "파일 처리 중" 문제 해결
Nextcloud 동기화를 방해하는 파일, 제외 규칙, 연결 문제 또는 클라이언트 데이터베이스 상태를 찾은 다음 업로드 및 다운로드가 안전하게 진행되는지 확인하십시오.
Nextcloud OPcache 경고를 해결하려면 적정 한도를 조정하세요.
Nextcloud 경고를 유발하는 PHP OPcache 제한을 찾아 올바른 웹 PHP 구성을 업데이트하고 안전하게 재시작한 후 결과를 확인하십시오.
Nextcloud를 CODE Docker에 연결하기: 설정 및 장단점
내장 CODE와 Docker 기반 CODE를 비교한 다음, 안전한 HTTPS 역방향 프록시를 통해 Collabora Online을 Nextcloud에 연결합니다.
Galera를 사용하여 안정적인 Nextcloud 클러스터를 구축하세요
공유 스토리지, Redis 잠금, 쿼럼 인식 MariaDB 라우팅 및 실용적인 장애 조치 점검을 통해 안정적인 Nextcloud 고가용성(HA) 배포를 계획하십시오.
직접 미디어 연결이 실패할 경우 Nextcloud Talk 통화를 연결하세요
방화벽이나 제한적인 NAT로 인해 직접 통화 매체가 차단되는 경우, Nextcloud Talk에 연결 가능한 TURN 릴레이를 구성하고 확인하십시오.
올바른 파일을 복원하여 Nextcloud 무결성 경고를 해결하세요
잘못된 파일 보고서를 사용하여 변경되었거나 누락되었거나 추가된 Nextcloud 코드를 식별하고, 신뢰할 수 있는 파일을 안전하게 복원하고, 결과를 확인할 수 있습니다.