ownCloud 10 MySQL 연결 실패 문제 해결

ownCloud 10에서 "데이터베이스 연결 실패" 오류가 발생하면 먼저 MySQL에 연결할 수 없는지, 계정 접근이 거부되었는지, PHP 드라이버가 누락되었는지 확인하십시오. ownCloud에 저장된 데이터베이스 서비스, 호스트, 데이터베이스 이름, 사용자 이름을 확인한 config/config.php후, 권한을 변경하거나 설정을 다시 생성하기 전에 ownCloud 서버에서 해당 자격 증명을 테스트하십시오. 이 가이드는 MySQL 또는 MariaDB를 사용하는 ownCloud Server 10.16을 기준으로 작성되었습니다. 메뉴 레이블과 패키지 명령은 운영 체제 및 설치 방법에 따라 다를 수 있습니다.

오류 메시지가 무엇을 의미하는지 파악하세요

"데이터베이스 연결 실패"는 일반적인 메시지입니다. ownCloud 로그 또는 웹 서버 로그에 기록된 MySQL 또는 PHP 오류 메시지를 통해 원인을 파악할 수 있습니다. MySQL 오류 2002 또는 2003과 같은 연결 오류는 일반적으로 서비스 중지, 잘못된 소켓 또는 포트 사용, 네트워크 경로 차단, 또는 ownCloud에서 예상하는 위치에서 서버가 수신 대기하지 않는 경우를 나타냅니다. "액세스 거부" 메시지는 일반적으로 MySQL이 연결은 수신했지만 사용자 이름, 암호 또는 클라이언트 호스트를 허용하지 않았음을 의미합니다.

MySQL은 데이터베이스 서버를 의미하며, MariaDB는 ownCloud에서 지원하는 호환 데이터베이스 옵션입니다. PDO MySQL은 ownCloud가 이 두 데이터베이스 서버와 통신할 수 있도록 하는 PHP 데이터베이스 드라이버입니다. 조치: 정확한 오류 메시지와 타임스탬프를 기록해 두고, 모든 연결 실패를 잘못된 비밀번호로 간주하지 말고 아래의 확인 사항과 비교해 보세요.

설정을 변경하기 전에 준비하세요

  • ownCloud와 MySQL이 동일한 머신에서 실행되는지, 서로 다른 머신에서 실행되는지, 아니면 별도의 컨테이너에서 실행되는지 확인하십시오.
  • ownCloud 설치 경로, 데이터베이스 호스트, 포트 또는 소켓, 데이터베이스 이름 및 전용 데이터베이스 사용자 이름을 알아야 합니다.
  • 관리자 세션 또는 콘솔 액세스 권한을 유지하십시오. config/config.php편집하기 전에 백업하고, 지원 요청 시 데이터베이스 암호를 절대 게시하지 마십시오.
  • 필요한 경우에만 관리자 권한으로 명령을 실행하십시오. 예시 이름과 경로는 사용자의 설치 환경에 맞는 값으로 바꾸십시오.

초기 문제 해결 단계로 데이터베이스를 삭제하거나 다시 생성하지 마십시오. 기존 사용자 파일과 메타데이터는 데이터베이스에 의존합니다. 조치: 데이터베이스 수준의 변경 작업을 수행하기 전에 ownCloud 데이터 디렉터리와 데이터베이스 모두의 검증된 백업을 생성하십시오.

데이터베이스 서비스와 연결 경로를 확인하세요.

  1. MySQL 또는 MariaDB가 실행 중인지 확인하십시오. systemd Linux 호스트에서는 시스템에 설치된 이름을 사용하여 서비스를 검사하십시오.
sudo systemctl status mysql
sudo systemctl status mariadb

배포판에 서비스 이름이 존재하지 않을 수 있습니다. 서비스가 중지된 경우, 서비스를 다시 시작하기 전에 저널 및 데이터베이스 오류 로그를 확인하여 원인을 파악하십시오. 조치: ownCloud 자격 증명 문제를 해결하기 전에 디스크 용량 부족 또는 잘못된 데이터베이스 구성과 같은 시작 오류를 해결하십시오.

  1. ownCloud 머신의 호스트와 포트를 확인하십시오. 데이터베이스 호스트 및 포트(일반적으로 3306)에 대한 TCP 연결을 테스트하십시오. 원격 데이터베이스의 경우 이름 확인, 방화벽 규칙, 그리고 MySQL이 ownCloud 서버에서 접근 가능한 인터페이스에서 수신 대기하는지 확인하십시오. 3306 포트를 인터넷에 공개적으로 노출하지 마십시오.
  2. 로컬호스트 소켓의 차이점을 이해하십시오. 유닉스 계열 시스템에서 MySQL 클라이언트는 localhost종종 로컬 유닉스 소켓을 사용하여 연결하며, 127.0.0.1TCP 연결을 강제합니다. 데이터베이스가 로컬에 있지만 PHP와 MySQL이 서로 다른 소켓 경로를 사용하는 경우 이 차이가 중요합니다. 조치: 소켓 경로 및 호스트 설정을 데이터베이스 서버의 실제 구성과 비교하거나, 의도된 경로가 TCP인 경우 TCP 연결을 테스트하십시오.

ownCloud에서 사용하는 것과 동일한 데이터베이스 사용자 이름, 호스트 및 데이터베이스 이름을 사용하여 ownCloud 서버에서 로그인 테스트를 수행합니다.

mysql --protocol=TCP -h db.example.net -P 3306 -u oc_user -p owncloud

암호는 프롬프트에 입력하세요. 명령에 직접 입력하면 셸 기록에 저장될 수 있으므로 입력하지 마세요. 로컬 소켓 연결의 경우, 구성에 맞는 호스트와 소켓 모드를 테스트하세요. 로그인 성공은 MySQL이 해당 연결 경로와 계정을 허용한다는 것을 의미하지만, PHP 드라이버가 설치되어 있거나 ownCloud가 동일한 설정을 읽고 있다는 것을 보장하지는 않습니다. 조치: 이 명령이 실패하면 MySQL 오류 메시지를 사용하여 다음 확인 방법을 선택하세요.

ownCloud 설정, PHP 드라이버 및 권한을 확인하십시오.

ownCloud 설치 마법사는 데이터베이스 유형, 데이터베이스 이름, 사용자 이름, 암호, 호스트 및 테이블 접두사를 파일에 기록합니다 config/config.php. 암호를 로그나 채팅에 복사하지 않고 값을 주의 깊게 검토하십시오. 파일에는 dbhost호스트와 포트가 포함될 수 있습니다. 만약 로 표시되면 localhostPHP 프로세스에서 예상되는 소켓을 사용할 수 있는지 확인하십시오.

명령줄 클라이언트는 정상적으로 작동하지만 ownCloud가 여전히 작동하지 않는 경우, 웹 서버에서 사용하는 PHP 런타임이 pdo_mysql설치 및 활성화되었는지 확인하십시오. 셸 명령은 php -mCLI PHP 런타임만 표시하며, 이는 Apache 또는 PHP-FPM과 다를 수 있습니다. 조치: 활성 웹 PHP 구성을 검사하고 확장 기능을 활성화한 후 관련 웹/PHP 서비스를 다시 시작하십시오.

"액세스 거부" 오류가 발생하는 경우, MySQL에 사용자 이름과 데이터베이스에서 인식하는 클라이언트 호스트가 일치하는 계정이 있는지 확인하십시오. MySQL은 `username`과 `client host`와 같은 계정을 서로 다른 계정으로 처리합니다 'oc_user'@'localhost'. 'oc_user'@'10.0.0.5'ownCloud 앱이 컨테이너에 있는 경우, 데이터베이스는 `username` 대신 컨테이너 또는 브리지 주소를 인식할 수 있습니다 localhost. 조치: 데이터베이스 관리자에게 일치하는 계정과 권한을 확인하도록 요청하고, 필요한 ownCloud 호스트 또는 네트워크에서만 액세스 권한을 부여하십시오.

데이터베이스가 존재하고 ownCloud 계정에서 해당 데이터베이스를 사용할 수 있는지 확인하십시오. ownCloud에서 전역 권한을 부여하거나 MySQL 루트 계정을 사용하지 마십시오. 필요한 권한은 초기 설치인지 기존 인스턴스인지에 따라 다를 수 있습니다. 조치: ownCloud의 데이터베이스 설정 지침을 단계별로 따르고, 관련 없는 데이터베이스의 소유권이나 권한을 변경하지 마십시오.

수정 사항을 적용하고 수정 사항을 확인합니다.

테스트에서 발견된 설정만 수정하십시오. 데이터베이스 서비스를 시작하거나, 접근 가능한 호스트 이름과 포트를 사용하거나, 소켓 불일치를 수정하거나, PHP 드라이버를 활성화하거나, 계정 암호를 수정하거나, 호스트별 데이터베이스 권한을 조정하십시오. 파일을 편집할 때는 config/config.php유효한 PHP 구문을 유지하고 먼저 백업을 만드십시오. 추측에 따라 데이터베이스 이름, 테이블 접두사 또는 자격 증명을 변경하지 마십시오.

변경 후 ownCloud를 다시 로드하고 데이터베이스 연결 경고 없이 페이지가 제대로 로드되는지 확인하십시오. ownCloud 로그에서 요청이 성공적으로 완료되었는지 확인하고 사용자가 기존 파일을 탐색할 수 있는지 확인하십시오. MySQL에서 연결 거부가 아닌 "서버 연결이 끊어졌습니다"라는 메시지가 표시되는 경우, 연결 끊김, 시간 초과 또는 패킷 크기와 관련된 다른 문제입니다. ownCloud 문서에서 해당 경우에 대한 MySQL 시간 초과 및 패킷 크기 설정을 참조하십시오. 조치: 해당 데이터베이스 문제 해결 지침을 따르고 로그에서 해당 진단을 뒷받침하는 경우에만 서버 제한을 ​​변경하십시오.

ownCloud의 최신 Server 10.16 설명서에서는 일반적인 데이터베이스 설정을 위해 설치 마법사를 사용할 것을 권장하며, 특히 pdo_mysqlMySQL 소켓 경로를 확인 사항으로 명시하고 있습니다. 정확한 패키지 이름, PHP 버전 및 서비스 이름은 호스트에 따라 다릅니다. 조치: ownCloud 서버에서 연결 테스트를 다시 실행하고 애플리케이션이 기존 데이터를 읽을 수 있는지 확인하십시오.

공식 참조

댓글 남기기

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 버킷을 추가하고, 호환되는 자격 증명 및 엔드포인트를 준비하고, 마운트와 기본 스토리지를 혼동하지 않고 액세스를 확인하세요.

안전한 야간 크론 작업을 사용하여 ownCloud 데이터베이스 덤프를 자동화하세요.

안전한 야간 크론 작업을 사용하여 ownCloud 데이터베이스 덤프를 자동화하세요.

ownCloud 서버에 대한 보호된 MariaDB 덤프를 예약하고, 유지 관리 모드를 안전하게 처리하며, 사용하기 전에 각 백업을 검증합니다.

지원되는 마이그레이션을 사용하여 ownCloud Classic을 oCIS로 이전하세요.

지원되는 앱, 순서대로 실행되는 명령, 신원 확인 절차, 그리고 별도로 처리해야 할 데이터 목록을 명확하게 작성하여 ownCloud 10에서 oCIS로의 마이그레이션을 계획하십시오.

브랜드 ownCloud Classic 10에 테마 앱과 CSS를 적용했습니다.

업그레이드 및 무결성 검사 관련 문제를 피하면서 테마 앱을 사용하여 ownCloud Classic 10 로고를 교체하고 웹 UI 색상을 조정하세요.